Struct libloading::Symbol[][src]

pub struct Symbol<'lib, T: 'lib> { /* fields omitted */ }

Symbol from a library.

This type is a safeguard against using dynamically loaded symbols after a Library is unloaded. Primary method to create an instance of a Symbol is via Library::get.

The Deref trait implementation allows use of Symbol as if it was a function or variable itself, without taking care to “extract” function or variable manually most of the time.

Implementations

impl<'lib, T> Symbol<'lib, T>[src]

pub unsafe fn into_raw(self) -> Symbol<T>[src]

Extract the wrapped os::platform::Symbol.

Safety

Using this function relinquishes all the lifetime guarantees. It is up to programmer to ensure the resulting Symbol is not used past the lifetime of the Library this symbol was loaded from.

Examples

unsafe {
    let lib = Library::new("/path/to/awesome.module").unwrap();
    let symbol: Symbol<*mut u32> = lib.get(b"symbol\0").unwrap();
    let symbol = symbol.into_raw();
}

pub unsafe fn from_raw<L>(sym: Symbol<T>, library: &'lib L) -> Symbol<'lib, T>[src]

Wrap the os::platform::Symbol into this safe wrapper.

Note that, in order to create association between the symbol and the library this symbol came from, this function requires a reference to the library.

Safety

The library reference must be exactly the library sym was loaded from.

Examples

unsafe {
    let lib = Library::new("/path/to/awesome.module").unwrap();
    let symbol: Symbol<*mut u32> = lib.get(b"symbol\0").unwrap();
    let symbol = symbol.into_raw();
    let symbol = Symbol::from_raw(symbol, &lib);
}

impl<'lib, T> Symbol<'lib, Option<T>>[src]

pub fn lift_option(self) -> Option<Symbol<'lib, T>>[src]

Lift Option out of the symbol.

Examples

unsafe {
    let lib = Library::new("/path/to/awesome.module").unwrap();
    let symbol: Symbol<Option<*mut u32>> = lib.get(b"symbol\0").unwrap();
    let symbol: Symbol<*mut u32> = symbol.lift_option().expect("static is not null");
}

Trait Implementations

impl<'lib, T> Clone for Symbol<'lib, T>[src]

impl<'lib, T> Debug for Symbol<'lib, T>[src]

impl<'lib, T> Deref for Symbol<'lib, T>[src]

type Target = T

The resulting type after dereferencing.

impl<'lib, T: Send> Send for Symbol<'lib, T>[src]

impl<'lib, T: Sync> Sync for Symbol<'lib, T>[src]

Auto Trait Implementations

impl<'lib, T> RefUnwindSafe for Symbol<'lib, T> where
    T: RefUnwindSafe
[src]

impl<'lib, T> Unpin for Symbol<'lib, T> where
    T: Unpin
[src]

impl<'lib, T> UnwindSafe for Symbol<'lib, T> where
    T: RefUnwindSafe + UnwindSafe
[src]

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.