5.3.条件编译
优质
小牛编辑
122浏览
2023-12-01
Rust 有一个特殊的属性,#[cfg]
,它允许你基于一个传递给编译器的标记编译代码。它有两种形式:
#[cfg(foo)]
# fn foo() {}
#[cfg(bar = "baz")]
# fn bar() {}
它还有一些帮助选项:
#[cfg(any(unix, windows))]
# fn foo() {}
#[cfg(all(unix, target_pointer_width = "32"))]
# fn bar() {}
#[cfg(not(foo))]
# fn not_foo() {}
这些选项可以任意嵌套:
#[cfg(any(not(unix), all(target_os="macos", target_arch = "powerpc")))]
# fn foo() {}
至于如何启用和禁用这些开关,如果你使用 Cargo 的话,它们可以在你Cargo.toml
中的[features]
部分设置:
[features]
# no features by default
default = []
# Add feature "foo" here, then you can use it.
# Our "foo" feature depends on nothing else.
foo = []
当你这么做的时候,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)]
# fn foo() {}
如果a
通过cfg
属性设置了的话这与#[b]
相同,否则不起作用。
cfg!
语法扩展也让你可以在你的代码中使用这类标记:
if cfg!(target_os = "macos") || cfg!(target_os = "ios") {
println!("Think Different!");
}
这会在编译时被替换为一个true
或false
,依配置设定而定。