Macro core::include_str

1.0.0 · source ·
macro_rules! include_str {
    ($file:expr $(,)?) => { ... };
}
Expand description

包含 UTF-8 编码的文件作为字符串。

该文件相对于当前文件位于 (类似于查找模块的方式)。 提供的路径在编译时以特定于平台的方式进行解释。 因此,例如,使用 Windows 路径包含反斜杠 \ 的调用将无法在 Unix 上正确编译。

该宏将产生 &'static str 类型的表达式,该表达式是文件的内容。

Examples

假设在同一目录中有两个文件,其内容如下:

文件 ‘spanish.in’:

adiós

文件 ‘main.rs’:

fn main() {
    let my_str = include_str!("spanish.in");
    assert_eq!(my_str, "adiós\n");
    print!("{my_str}");
}
Run

编译 ‘main.rs’ 并运行生成的二进制文件将打印 “adiós”。