4.3.条件编译

最后更新于:2022-04-01 00:43:07

Rust有一个特殊的属性,`#[cfg]`,它允许你基于一个传递给编译器的标记编译代码。它有两种形式: ~~~ #[cfg(foo)] #[cfg(bar = "baz")] ~~~ 它还有一些帮助选项: ~~~ #[cfg(any(unix, windows))] #[cfg(all(unix, target_pointer_width = "32"))] #[cfg(not(foo))] ~~~ 这些选项可以任意嵌套: ~~~ #[cfg(any(not(unix), all(target_os="macos", target_arch = "powerpc")))] ~~~ 至于如何启用和禁用这些开关,如果你使用Cargo的话,它们可以在你`Cargo.toml`中的[`[features]`部分](http://doc.crates.io/manifest.html#the-%5Bfeatures%5D-section)设置: ~~~ [features] # no features by default default = [] # The “secure-password” feature depends on the bcrypt package. secure-password = ["bcrypt"] ~~~ 当你这么做的时候,Cargo传递给`rustc`一个标记: ~~~ --cfg feature="${feature_name}" ~~~ 这些`cfg`标记集合会决定哪些功能被启用,并且因此,哪些代码会被编译。让我们看看这些代码: ~~~ #[cfg(feature = "foo")] mod foo { } ~~~ 如果你用`cargo build --features "foo"`编译,他会向`rustc`传递`--cfg feature="foo"`标记,并且输出中将会包含`mod foo`。如果我们使用常规的`cargo build`编译,则不会传递额外的标记,因此,(输出)不会存在`foo`模块。 ## cfg_attr 你也可以通过一个基于`cfg`变量的`cfg_attr`来设置另一个属性: ~~~ #[cfg_attr(a, b)] ~~~ 如果`a`通过`cfg`属性设置了的话这与`#[b]`相同,否则不起作用。 # cfg! `cfg!`[语法扩展](http://doc.rust-lang.org/nightly/book/compiler-plugins.html)也让你可以在你的代码中使用这类标记: ~~~ if cfg!(target_os = "macos") || cfg!(target_os = "ios") { println!("Think Different!"); } ~~~ 这会在编译时被替换为一个`true`或`false`,依配置设定而定。
';