Skip to main content

copperlace_ruleset_render_structured_json

Function copperlace_ruleset_render_structured_json 

Source
#[unsafe(no_mangle)]
pub unsafe extern "C" fn copperlace_ruleset_render_structured_json( handle: *const CopperlaceRuleSet, rule: *const c_char, format_json: bool, out_json: *mut *mut c_char, out_error: *mut *mut c_char, ) -> c_int
Expand description

Renders a named structured rule from a ruleset handle as JSON text.

On success, writes an owned UTF-8 JSON string to out_json and returns COPPERLACE_OK. When format_json is false, the JSON is compact. When true, it is formatted with tab indentation. On failure, writes null to out_json, writes an owned error string to out_error when provided, and returns a nonzero status code. Returned output and error strings must be released with copperlace_string_free.

ยงSafety

handle must be a live ruleset handle returned by Copperlace. rule must point to a valid NUL-terminated UTF-8 string. out_json must be a valid writable pointer. out_error must be valid for writing when non-null. Any returned output or error string must be released with copperlace_string_free.