Struct emf_core_base_rs::module::module_loader::NativeLoaderInternal

pub struct NativeLoaderInternal<'loader> { /* fields omitted */ }

Native library loader internal interface.

Implementations

impl<'a> NativeLoaderInternal<'a>

pub unsafe fn get_native_module<'module, O>(
    &self,
    module: &'module InternalModule<O>
) -> Result<NativeModuleInstance<'module, O>, Error> where
    O: ImmutableAccessIdentifier, 

Fetches the native module handle.

Failure

The function fails if module is invalid.

Return

Native module handle.

Safety

The function crosses the ffi boundary. Direct usage of a NativeLoaderInternal may break some invariants of the module api, if not handled with care.

pub unsafe fn get_native_module_interface<'module, O>(
    &self,
    module: &'module InternalModule<O>
) -> Result<NativeModule<'module, O>, Error> where
    O: ImmutableAccessIdentifier, 

Fetches the native module interface.

Failure

The function fails if module is invalid.

Return

Native module interface.

Safety

The function crosses the ffi boundary. Direct usage of a NativeLoaderInternal may break some invariants of the module api, if not handled with care.

Methods from Deref<Target = NonNullConst<NativeModuleLoaderInterface>>

pub unsafe fn into_mut(&self) -> NonNull<T>

Acquires a mutable version of the pointer.

Safety

It is undefined behavior if the underlying pointer is not already mutable.

pub unsafe fn as_ref(&self) -> &T

Returns a shared reference to the value.

Safety

The same restrictions as NonNull::as_ref apply.

Trait Implementations

impl<'loader> Clone for NativeLoaderInternal<'loader>

fn clone(&self) -> NativeLoaderInternal<'loader>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'loader> Copy for NativeLoaderInternal<'loader>

impl<'loader> Debug for NativeLoaderInternal<'loader>

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

Formats the value using the given formatter.

impl Deref for NativeLoaderInternal<'_>

type Target = NonNullConst<NativeModuleLoaderInterface>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for NativeLoaderInternal<'_>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'loader> Eq for NativeLoaderInternal<'loader>

impl<'a> ModuleLoaderAPI<'a> for NativeLoaderInternal<'a>

type InternalLoader = Self

Type of the internal loader.

fn to_interface(&self) -> NonNullConst<ModuleLoaderInterface>

Fetches a pointer that can be used with the interface.

unsafe fn from_interface(interface: NonNullConst<ModuleLoaderInterface>) -> Self

Construct a new instance from a pointer.

unsafe fn from_void_ptr(interface: NonNullConst<c_void>) -> Self

Construct a new instance from a void pointer.

unsafe fn add_module(
    &mut self,
    path: &impl AsRef<Path>
) -> Result<InternalModule<Owned>, Error>

Adds a new module.

unsafe fn remove_module(
    &mut self,
    module: InternalModule<Owned>
) -> Result<(), Error>

Removes a module.

unsafe fn load<O>(
    &mut self,
    module: &mut InternalModule<O>
) -> Result<(), Error> where
    O: MutableAccessIdentifier, 

Loads a module.

unsafe fn unload<O>(
    &mut self,
    module: &mut InternalModule<O>
) -> Result<(), Error> where
    O: MutableAccessIdentifier, 

Unloads a module.

unsafe fn initialize<O>(
    &mut self,
    module: &mut InternalModule<O>
) -> Result<(), Error> where
    O: MutableAccessIdentifier, 

Initializes a module.

unsafe fn terminate<O>(
    &mut self,
    module: &mut InternalModule<O>
) -> Result<(), Error> where
    O: MutableAccessIdentifier, 

Terminates a module.

unsafe fn fetch_status<O>(
    &self,
    module: &InternalModule<O>
) -> Result<ModuleStatus, Error> where
    O: ImmutableAccessIdentifier, 

Fetches the load status of a module.

unsafe fn get_interface<'module, O, T>(
    &self,
    module: &'module InternalModule<O>,
    interface: &InterfaceDescriptor,
    caster: impl FnOnce(Interface) -> T
) -> Result<Interface<'module, T>, Error> where
    O: ImmutableAccessIdentifier, 

Fetches an interface from a module.

unsafe fn get_module_info<'module, O>(
    &self,
    module: &'module InternalModule<O>
) -> Result<&'module ModuleInfo, Error> where
    O: ImmutableAccessIdentifier, 

Fetches the module info from a module.

unsafe fn get_module_path<'module, O>(
    &self,
    module: &'module InternalModule<O>
) -> Result<&'module [OSPathChar], Error> where
    O: ImmutableAccessIdentifier, 

Fetches the path a module was loaded from.

unsafe fn get_load_dependencies<'module, O>(
    &self,
    module: &'module InternalModule<O>
) -> Result<&'module [InterfaceDescriptor], Error> where
    O: ImmutableAccessIdentifier, 

Fetches the load dependencies of a module.

unsafe fn get_runtime_dependencies<'module, O>(
    &self,
    module: &'module InternalModule<O>
) -> Result<&'module [InterfaceDescriptor], Error> where
    O: ImmutableAccessIdentifier, 

Fetches the runtime dependencies of a module.

unsafe fn get_exportable_interfaces<'module, O>(
    &self,
    module: &'module InternalModule<O>
) -> Result<&'module [InterfaceDescriptor], Error> where
    O: ImmutableAccessIdentifier, 

Fetches the exportable interfaces of a module.

unsafe fn get_internal_interface(&self) -> Self::InternalLoader

Fetches a pointer to the internal loader interface.

impl<'loader> Ord for NativeLoaderInternal<'loader>

fn cmp(&self, other: &NativeLoaderInternal<'loader>) -> Ordering

This method returns an Ordering between self and other.

#[must_use]

pub fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]

pub fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]

pub fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl<'loader> PartialEq<NativeLoaderInternal<'loader>> for NativeLoaderInternal<'loader>

fn eq(&self, other: &NativeLoaderInternal<'loader>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &NativeLoaderInternal<'loader>) -> bool

This method tests for !=.

impl<'loader> PartialOrd<NativeLoaderInternal<'loader>> for NativeLoaderInternal<'loader>

fn partial_cmp(&self, other: &NativeLoaderInternal<'loader>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]

pub fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

pub fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]

pub fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

pub fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Send for NativeLoaderInternal<'_>

impl<'loader> StructuralEq for NativeLoaderInternal<'loader>

impl<'loader> StructuralPartialEq for NativeLoaderInternal<'loader>

impl Sync for NativeLoaderInternal<'_>