Function lv2_raw::atomutils::lv2_atom_object_query [−] [src]

pub unsafe fn lv2_atom_object_query(
    obj: *mut LV2AtomObject, 
    query: *mut LV2AtomObjectQuery
) -> i32

Get an object's values for various keys.

The value pointer of each item in query will be set to the location of the corresponding value in object. Every value pointer in query MUST be initialised to NULL. This function reads object in a single linear sweep. By allocating query on the stack, objects can be "queried" quickly without allocating any memory. This function is realtime safe.

This function can only do "flat" queries, it is not smart enough to match variables in nested objects.

For example: @code const LV2_Atom* name = NULL; const LV2_Atom* age = NULL; LV2_Atom_Object_Query q[] = { { urids.eg_name, &name }, { urids.eg_age, &age }, LV2_ATOM_OBJECT_QUERY_END }; lv2_atom_object_query(obj, q); // name and age are now set to the appropriate values in obj, or NULL. @endcode