Macro rustc_link_lib

macro_rules! rustc_link_lib {
    (to: $stream:expr, $name:expr $(,)?) => { ... };
    (to: $stream:expr, $name:expr => $kind:expr $(,)?) => { ... };
    (to: $stream:expr, $($name:expr $(=> $kind:expr)?),+ $(,)?) => { ... };
    ($name:expr $(,)?) => { ... };
    ($name:expr => $kind:expr $(,)?) => { ... };
    ($($name:expr $(=> $kind:expr)?),+ $(,)?) => { ... };
}

Tells Cargo to pass $lib to the compiler as a -l flag.

This is equivalent to:

println!("cargo:rustc-link-lib=[$kind=]$name");

Examples

Useful for telling the linker what libraries should be linked.

cargo_emit::rustc_link_lib!(
    "ssl", // same as `=> "dylib"`
    "ruby" => "static",
    "CoreFoundation" => "framework",
);

or, in case you want it to emit to a custom stream:

let mut stdout = std::io::stdout();
cargo_emit::rustc_link_lib!(
    to: stdout,
    "ssl", // same as `=> "dylib"`
    "ruby" => "static",
    "CoreFoundation" => "framework",
);