Struct emf_core_base_rs::library::library_loader::NativeLoaderInternal

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

Native library loader internal interface.

Implementations

impl NativeLoaderInternal<'_>

pub unsafe fn load_ext(
    &mut self,
    path: &impl AsRef<Path>,
    flags: i32
) -> Result<InternalLibrary<Owned>, Error>

Loads a library. The resulting handle is unique.

The argument flags is passed to dlopen.

Failure

The function fails if path is invalid or the call to dlopen fails.

Return

Handle on success, error otherwise.

Safety

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

pub unsafe fn get_native_handle<O>(
    &self,
    internal: &InternalLibrary<O>
) -> Result<NativeLibraryHandle, Error> where
    O: ImmutableAccessIdentifier, 

Returns the underlying handle of a library.

Failure

The function fails if internal is invalid.

Return

Handle on success, error otherwise.

Safety

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

Methods from Deref<Target = NonNullConst<NativeLibraryLoaderInterface>>

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<NativeLibraryLoaderInterface>

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> LibraryLoaderAPI<'a> for NativeLoaderInternal<'a>

type InternalLoader = Self

Type of the internal loader.

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

Fetches a pointer that can be used with the interface.

unsafe fn from_interface(
    interface: NonNullConst<LibraryLoaderInterface>
) -> 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 load(
    &mut self,
    path: &impl AsRef<Path>
) -> Result<InternalLibrary<Owned>, Error>

Loads a library. The resulting handle is unique.

unsafe fn unload(
    &mut self,
    internal: InternalLibrary<Owned>
) -> Result<(), Error>

Unloads a library.

unsafe fn get_data_symbol<O, U>(
    &self,
    internal: &InternalLibrary<O>,
    symbol: &impl AsRef<CStr>,
    caster: impl FnOnce(NonNullConst<c_void>) -> &'a U
) -> Result<Symbol<'a, &'a U>, Error> where
    O: ImmutableAccessIdentifier, 

Fetches a data symbol from a library.

unsafe fn get_function_symbol<O, U>(
    &self,
    internal: &InternalLibrary<O>,
    symbol: &impl AsRef<CStr>,
    caster: impl FnOnce(CBaseFn) -> U
) -> Result<Symbol<'a, U>, Error> where
    O: ImmutableAccessIdentifier, 

Fetches a function symbol from a library.

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

Fetches a pointer to the internal 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<'_>