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`,依配置設定而定。
- 前言
- 1.介紹
- 2.準備
- 2.1.安裝Rust
- 2.2.Hello, world!
- 2.3.Hello, Cargo!
- 3.學習Rust
- 3.1.猜猜看
- 3.2.哲學家就餐問題
- 3.3.其它語言中的Rust
- 4.高效Rust
- 4.1.棧和堆
- 4.2.測試
- 4.3.條件編譯
- 4.4.文檔
- 4.5.迭代器
- 4.6.并發
- 4.7.錯誤處理
- 4.8.外部語言接口
- 4.9.Borrow 和 AsRef
- 4.10.發布途徑
- 5.語法和語義
- 5.1.變量綁定
- 5.2.函數
- 5.3.原生類型
- 5.4.注釋
- 5.5.If語句
- 5.6.for循環
- 5.7.while循環
- 5.8.所有權
- 5.9.引用和借用
- 5.10.生命周期
- 5.11.可變性
- 5.12.結構體
- 5.13.枚舉
- 5.14.匹配
- 5.15.模式
- 5.16.方法語法
- 5.17.Vectors
- 5.18.字符串
- 5.19.泛型
- 5.20.Traits
- 5.21.Drop
- 5.22.if let
- 5.23.trait對象
- 5.24.閉包
- 5.25.通用函數調用語法
- 5.26.包裝箱和模塊
- 5.27.`const`和`static`
- 5.28.屬性
- 5.29.`type`別名
- 5.30.類型轉換
- 5.31.關聯類型
- 5.32.不定長類型
- 5.33.運算符和重載
- 5.34.`Deref`強制多態
- 5.35.宏
- 5.36.裸指針
- 6.Rust開發版
- 6.1.編譯器插件
- 6.2.內聯匯編
- 6.3.不使用標準庫
- 6.4.固有功能
- 6.5.語言項
- 6.6.鏈接參數
- 6.7.基準測試
- 6.8.裝箱語法和模式
- 6.9.切片模式
- 6.10.關聯常量
- 7.詞匯表
- 8.學院派研究
- 勘誤