# 条件编译
> [conditional-compilation.md](https://github.com/rust-lang/rust/blob/master/src/doc/book/conditional-compilation.md)
commit 024aa9a345e92aa1926517c4d9b16bd83e74c10d
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]`部分](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)]
# fn foo() {}
~~~
如果`a`通过`cfg`属性设置了的话这与`#[b]`相同,否则不起作用。
# cfg!
`cfg!`[语法扩展](#)也让你可以在你的代码中使用这类标记:
~~~
if cfg!(target_os = "macos") || cfg!(target_os = "ios") {
println!("Think Different!");
}
~~~
这会在编译时被替换为一个`true`或`false`,依配置设定而定。
- 前言
- 贡献者
- 1.介绍
- 2.准备
- 3.学习 Rust
- 3.1.猜猜看
- 3.2.哲学家就餐问题
- 3.3.其它语言中的 Rust
- 4.语法和语义
- 4.1.变量绑定
- 4.2.函数
- 4.3.原生类型
- 4.4.注释
- 4.5.If语句
- 4.6.循环
- 4.7.所有权
- 4.8.引用和借用
- 4.9.生命周期
- 4.10.可变性
- 4.11.结构体
- 4.12.枚举
- 4.13.匹配
- 4.14.模式
- 4.15.方法语法
- 4.16.Vectors
- 4.17.字符串
- 4.18.泛型
- 4.19.Traits
- 4.20.Drop
- 4.21.if let
- 4.22.trait 对象
- 4.23.闭包
- 4.24.通用函数调用语法
- 4.25.crate 和模块
- 4.26.const和static
- 4.27.属性
- 4.28.type别名
- 4.29.类型转换
- 4.30.关联类型
- 4.31.不定长类型
- 4.32.运算符和重载
- 4.33.Deref强制多态
- 4.34.宏
- 4.35.裸指针
- 4.36.不安全代码
- 5.高效 Rust
- 5.1.栈和堆
- 5.2.测试
- 5.3.条件编译
- 5.4.文档
- 5.5.迭代器
- 5.6.并发
- 5.7.错误处理
- 5.8.选择你的保证
- 5.9.外部函数接口
- 5.10.Borrow 和 AsRef
- 5.11.发布途径
- 5.12.不使用标准库
- 6.Rust 开发版
- 6.1.编译器插件
- 6.2.内联汇编
- 6.4.固有功能
- 6.5.语言项
- 6.6.链接进阶
- 6.7.基准测试
- 6.8.装箱语法和模式
- 6.9.切片模式
- 6.10.关联常量
- 6.11.自定义内存分配器
- 7.词汇表
- 8.语法索引
- 9.参考文献
- 附录:名词中英文对照