Struct lv2rs_core::Feature

#[repr(C)]
pub struct Feature { /* fields omitted */ }

Feature.

Features allow hosts to make additional functionality available to plugins without requiring modification to the LV2 API. Extensions may define new features and specify the uri and data to be used if necessary. Some features, such as lv2:isLive, do not require the host to pass data.

Methods

impl Feature

pub fn uri(&self) -> Option<&CStr>

Try to get the URI of the feature.

None if the URI is pointing to null.

pub unsafe fn data<T>(&mut self) -> Option<&mut T>

Try to get a pointer to the feature's data.

None if the internal feature is pointing to null.

This function is unsafe, since we don't know if the data really has type T. It's your responsibility to ensure that the data has the correct type.

pub fn get_feature_raw(
    features: &FeaturesList,
    uri: &CStr
) -> Option<*mut c_void>

Try to find a feature in the features list by it's URI.

This function is safe, since the data pointer is not touched at all and therefore, no UB can be triggered.

pub unsafe fn get_feature<T>(
    features: &FeaturesList,
    uri: &CStr
) -> Option<&'static mut T>

Try to find a feature in the features list and cast the data.

This function in unsafe, since it can not check if the data is of type T. It is your responsibility to ensure the soundness of the cast.