UCE Docs / component_render

Signature

void component_render(String name, [DValue props], [Request& context])

Renders another .uce file as a component and writes the result directly to the current output buffer.

This is the direct-output counterpart to component().

Component props are passed through context.props, and name:COMPONENTFUNC may be used to select a named handler exported by COMPONENT:COMPONENTFUNC(Request& context).

When name starts with :, the runtime resolves that named handler against the current .uce file.

If the target file defines ONCE(Request& context), that hook runs once per request before the file's first component or render entrypoint.

Use component_render() when you want to write component output directly from C++ code instead of capturing it as a String.

Example

Example

component_render("examples/sample_unit");
print("\n");
Output
hello from the sample component