Struct lv2_sys::_LV2_URID_Map

#[repr(C)]
pub struct _LV2_URID_Map {
    pub handle: LV2_URID_Map_Handle,
    pub map: Option<unsafe extern "C" fn(handle: LV2_URID_Map_Handle, uri: *const c_char) -> LV2_URID>,
}

URID Map Feature (LV2_URID__map)

Fields

handle: LV2_URID_Map_Handle

Opaque pointer to host data.

This MUST be passed to map_uri() whenever it is called. Otherwise, it must not be interpreted in any way.

map: Option<unsafe extern "C" fn(handle: LV2_URID_Map_Handle, uri: *const c_char) -> LV2_URID>

Get the numeric ID of a URI.

If the ID does not already exist, it will be created.

This function is referentially transparent; any number of calls with the same arguments is guaranteed to return the same value over the life of a plugin instance. Note, however, that several URIs MAY resolve to the same ID if the host considers those URIs equivalent.

This function is not necessarily very fast or RT-safe: plugins SHOULD cache any IDs they might need in performance critical situations.

The return value 0 is reserved and indicates that an ID for that URI could not be created for whatever reason. However, hosts SHOULD NOT return 0 from this function in non-exceptional circumstances (i.e. the URI map SHOULD be dynamic).

@param handle Must be the callback_data member of this struct. @param uri The URI to be mapped to an integer ID.

Trait Implementations

impl Clone for _LV2_URID_Map

fn clone(&self) -> _LV2_URID_Map

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for _LV2_URID_Map

impl Debug for _LV2_URID_Map

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.