Skip to main content

pamoja_keyexpr_canonize

Function pamoja_keyexpr_canonize 

Source
#[unsafe(no_mangle)]
pub unsafe extern "C" fn pamoja_keyexpr_canonize( key: *const c_char, ) -> *mut PamojaString
Expand description

Rewrites a key expression into its canonical form.

Two expressions that select the same data have one canonical form, so canonizing before comparing or routing avoids treating a/**/**/b and a/**/b as different.

§Arguments

  • key - the expression to canonize, as null-terminated UTF-8.

§Returns

A string the caller must release with pamoja_string_free, or null if the expression is malformed or key is null.

§Safety

key must be a valid null-terminated UTF-8 string for the duration of the call, or null.