# Dylink
  
## Overview
Dylink is a 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.
## Supported platforms
Dylink has been implemented for all major platforms, but has only been locally tested on Windows and Linux.
| YES | YES | Untested | Untested |
## Usage
Add this to your `Cargo.toml`
```toml
[dependencies]
dylink = "0.2"
```
## Example
Below is a basic working example on how to use the macro. For windows, the `.dll` file extension is *optional*, but still recommended.
```rust
use dylink::dylink;
#[dylink(name = "Kernel32.dll")]
extern "stdcall" {
fn GetLastError() -> u32;
fn SetLastError(_: u32);
}
fn main() {
unsafe {
SetLastError(52);
println!("{}", GetLastError());
}
}
```
Output:
```text
52
```
### License
Licensed under either of
* Apache License, Version 2.0
([LICENSE-APACHE](LICENSE-APACHE) or <http://www.apache.org/licenses/LICENSE-2.0>)
* MIT license
([LICENSE-MIT](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.