你如何在自己的箱子里面使用宏?

时间:2015-03-16 02:22:04

标签: rust

我确信这是微不足道的,但我似乎无法使其发挥作用。

我看过http://doc.rust-lang.org/book/advanced-macros.html#scoping-and-macro-import/export,我很欣赏,一般来说,使用宏的方法是使用以下内容来定义它们:

#[macro_export]
macro_rules! background(($token:expr) => (($token >> (32 + 8)) & $crate::graphics::mask::Color));

...然后将它们导入另一个使用它们的上下文:

#[macro_use]
extern crate terminal;
...

但是,我想要做的就是在定义它们的包中使用宏。

如果我的文件结构是:

- lib.rs
- macros.rs
- foo
- foo/mod.rs
- foo/junk.rs

如何在junk.rs的macros.rs中使用宏?

我尝试了#[macro_use] mod macros等的各种组合,没有运气。文档建议如果宏在某个范围内定义,那么它在所有子模块中都可用...这是否意味着我必须在lib.rs中定义我的宏?

2 个答案:

答案 0 :(得分:50)

接受的答案是正确的,但对于将来发现此问题的其他人,我想补充一点,加载模块的订单非常重要。

例如,按此顺序:

pub mod terminal;
pub mod terminals;
pub mod graphics;

#[macro_use]
mod macros;

如果终端使用宏中的宏,它将工作; #[macro_use]必须出现在使用宏的任何其他模块之上:

#[macro_use]
mod macros;

pub mod terminal;
pub mod terminals;
pub mod graphics;

答案 1 :(得分:17)

您需要使用#[macro_export]标记宏,然后使用#[macro_use]标记模块:

#[macro_use]
mod macros {
    #[macro_export]
    macro_rules! my_macro(() => (42));
}

pub mod foo {
    pub mod junk {
        pub fn usage() -> u8 {
            my_macro!()
        }
    }
}

fn main() {
    println!("{:?}", foo::junk::usage());
}

从技术上讲,如果您希望宏可供您的箱子用户使用,则只需使用#[macro_export]

Playground link