pub fn find_library(name: &str) -> Result<Library, String>
Simple shortcut for using all default options for finding a library.
+
+ Prefix searches with a type followed by a colon (e.g.
+ fn:) to restrict the search to a given type.
+
+ Accepted types are: fn, mod,
+ struct, enum,
+ trait, typedef (or
+ tdef).
+
+ Search functions by type signature (e.g.
+ vec -> usize)
+
pub fn target_supported() -> bool
+ Prefix searches with a type followed by a colon (e.g.
+ fn:) to restrict the search to a given type.
+
+ Accepted types are: fn, mod,
+ struct, enum,
+ trait, typedef (or
+ tdef).
+
+ Search functions by type signature (e.g.
+ vec -> usize)
+
A build dependency for Cargo libraries to find system artifacts through the
+pkg-config utility.
This library will shell out to pkg-config as part of build scripts and
+probe the system to determine how to link to a specified library. The
+Config structure serves as a method of configuring how pkg-config is
+invoked in a builder style.
A number of environment variables are available to globally configure how
+this crate will invoke pkg-config:
PKG_CONFIG_ALLOW_CROSS - if this variable is not set, then pkg-config
+will automatically be disabled for all cross compiles.FOO_NO_PKG_CONFIG - if set, this will disable running pkg-config when
+probing for the library named foo.There are also a number of environment variables which can configure how a
+library is linked to (dynamically vs statically). These variables control
+whether the --static flag is passed. Note that this behavior can be
+overridden by configuring explicitly on Config. The variables are checked
+in the following order:
FOO_STATIC - pass --static for the library fooFOO_DYNAMIC - do not pass --static for the library fooPKG_CONFIG_ALL_STATIC - pass --static for all librariesPKG_CONFIG_ALL_DYNAMIC - do not pass --static for all librariesAfter running pkg-config all appropriate Cargo metadata will be printed on
+stdout if the search was successful.
Find the system library named foo.
+extern crate pkg_config; + +fn main() { + pkg_config::find_library("foo").unwrap(); +} ++ +
Configure how library foo is linked to.
+extern crate pkg_config; + +fn main() { + pkg_config::Config::new().statik(true).find("foo").unwrap(); +} ++
| Config | ++ + | +
| Library | ++ + | +
| find_library | +
+ Simple shortcut for using all default options for finding a library. + + |
+
| target_supported | ++ + | +
+ Prefix searches with a type followed by a colon (e.g.
+ fn:) to restrict the search to a given type.
+
+ Accepted types are: fn, mod,
+ struct, enum,
+ trait, typedef (or
+ tdef).
+
+ Search functions by type signature (e.g.
+ vec -> usize)
+
pub struct Config {
+ // some fields omitted
+}impl Configfn new() -> ConfigCreates a new set of configuration options which are all initially set +to "blank".
+fn statik(&mut self, statik: bool) -> &mut ConfigIndicate whether the --static flag should be passed.
This will override the inference from environment variables described in +the crate documentation.
+fn atleast_version(&mut self, vers: &str) -> &mut ConfigIndicate that the library must be at least version vers.
fn arg<S: AsRef<OsStr>>(&mut self, arg: S) -> &mut ConfigAdd an argument to pass to pkg-config.
+ +It's placed after all of the arguments generated by this library.
+fn find(&self, name: &str) -> Result<Library, String>Run pkg-config to find the library name.
This will use all configuration previously set to specify how
+pkg-config is run.
fn get_variable(package: &str, variable: &str) -> Result<String, String>Run pkg-config to get the value of a variable from a package using
+--variable.
impl Clone for Configfn clone(&self) -> Configfn clone_from(&mut self, source: &Self)
+ Prefix searches with a type followed by a colon (e.g.
+ fn:) to restrict the search to a given type.
+
+ Accepted types are: fn, mod,
+ struct, enum,
+ trait, typedef (or
+ tdef).
+
+ Search functions by type signature (e.g.
+ vec -> usize)
+
pub struct Library {
+ pub libs: Vec<String>,
+ pub link_paths: Vec<PathBuf>,
+ pub frameworks: Vec<String>,
+ pub framework_paths: Vec<PathBuf>,
+ pub include_paths: Vec<PathBuf>,
+ pub version: String,
+ // some fields omitted
+}libs | |
link_paths | |
frameworks | |
framework_paths | |
include_paths | |
version |
impl Debug for Library
+ Prefix searches with a type followed by a colon (e.g.
+ fn:) to restrict the search to a given type.
+
+ Accepted types are: fn, mod,
+ struct, enum,
+ trait, typedef (or
+ tdef).
+
+ Search functions by type signature (e.g.
+ vec -> usize)
+