Struct LibraryHandle 

pub struct LibraryHandle(/* private fields */);

Available on macOS only.

A RAII wrapper around a dlopen handle.

Opens a dynamic library on construction and closes it on drop. After an explicit close, the destructor is disarmed.

Implementations

impl LibraryHandle

pub fn open(path: &CStr) -> Result<Self, LoadError>

Loads the dynamic library at path with RTLD_LAZY binding.

Returns a handle that keeps the library mapped until it is closed or dropped.

Errors

Returns LoadError if the library cannot be loaded.

pub unsafe fn symbol(&self, name: &CStr) -> Result<LibrarySymbol, LoadError>

Resolves a named symbol from the loaded library.

The returned LibrarySymbol is typically transmuted into a typed function pointer via core::mem::transmute.

Safety

The caller must ensure that:

• name identifies a symbol whose actual signature matches the type it will be transmuted to.
• The resulting LibrarySymbol (or any pointer derived from it) is not used after this handle is closed or dropped.

Errors

Returns LoadError if the symbol cannot be found in the library.

pub unsafe fn close(self) -> Result<(), LoadError>

Explicitly closes the library handle and returns any error from dlclose.

After this call the destructor is disarmed; dropping the handle is a no-op.

Errors

Returns LoadError if dlclose fails.

Safety

The caller must ensure that no LibrarySymbol (or function pointer derived from one) obtained from this handle is used after this call returns.

Trait Implementations

impl Debug for LibraryHandle

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

Formats the value using the given formatter.

impl Drop for LibraryHandle

fn drop(&mut self)

Executes the destructor for this type.

impl Send for LibraryHandle

impl Sync for LibraryHandle