如何在 Rust 中使用条件编译宏的示例

Question

我已关注quite a bit 或the documentation 并尝试关注reuse an example，但我的代码无法正常工作。

我的 Cargo.toml 看起来像这样：

[package]
name = "Blahblah"
version = "0.3.0"
authors = ["ergh <derngummit@ahwell.com"]
[dependencies]

[[bin]]
name = "target"
path = "src/main.rs"

[features]
default=["mmap_enabled"]
no_mmap=[]
mmap_enabled=[]

我想根据我传递给cargo build 命令的功能配置，使用不同于 mmap 的缓冲区来源在本地测试我的代码。我的代码中有这个：

if cfg!(mmap_enabled) {
    println!("mmap_enabled bro!");
    ...
}
if cfg!(no_mmap) {
    println!("now it's not");
    ...
}

编译器在if 语句体中都看不到代码，所以我知道cfg! 语句的计算结果都是假的。为什么？

我已阅读 Conditional compilation in Rust 0.10?，我知道这不是完全重复的，因为我正在寻找一个有效的示例。

Answer 1

测试功能的正确方法是feature = "name"，如果您稍微滚动一下，您可以在the documentation you linked 中看到：

至于如何启用或禁用这些开关，如果您使用 Cargo， 它们被设置在你的Cargo.toml 的[features] section 中：

[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 {
}

在您使用cfg! 宏的情况下，这将映射到cfg!(feature = "foo")。