Dylink

Dylink provides a run-time dynamic linking framework for lazily evaluating shared libraries such as .dll files for windows and .so files for unix. When functions are loaded they are evaluated through a thunk for first time calls, which loads the function from it's respective library. Proceeding calls after initialization have no overhead or additional branching checks, as the thunk is replaced by the loaded function.

Related links:

• API Documentation
• Release notes

Supported platforms

Dylink has been implemented for all major platforms aside from WASM, but has only been locally tested on Windows and Linux.

Usage

Add this to your Cargo.toml

[dependencies]

dylink = "0.5"

Example

Below is a basic working example on how to use the macro on windows. For windows, the .dll file extension is optional, but still recommended.

use dylink::dylink;

#[dylink(name = "Kernel32.dll")]
extern "stdcall" {
    fn GetLastError() -> u32;
    fn SetLastError(_: u32);
}

fn main() {
   unsafe {
      SetLastError(52);
      assert_eq!(52, GetLastError());
   }
}

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.