モジュールファイル間でマクロを使用するにはどうすればよいですか？

同じクレート内の別々のファイルに2つのモジュールがあり、クレートがmacro_rules有効になっています。あるモジュールで定義されたマクロを別のモジュールで使用したい。

// macros.rs
#[macro_export] // or not? is ineffectual for this, afaik
macro_rules! my_macro(...)

// something.rs
use macros;
// use macros::my_macro; <-- unresolved import (for obvious reasons)
my_macro!() // <-- how?

私は現在、コンパイラエラー " macro undefined: 'my_macro'" ...をヒットしました。これは理にかなっています。マクロシステムは、モジュールシステムの前に実行されます。どうすればそれを回避できますか？

同じクレート内のマクロ

#[macro_use]
mod foo {
    macro_rules! bar {
        () => ()
    }
}

bar!();    // works

同じクレートでマクロを使用する場合、マクロが定義されているモジュールには属性が必要です#[macro_use]。

マクロは、定義された後でのみ使用できます。これは、これが機能しないことを意味します。

bar!();  // ERROR: cannot find macro `bar!` in this scope

#[macro_use]
mod foo {
    macro_rules! bar {
        () => ()
    }
}

木枠全体のマクロ

macro_rules!他のクレートからマクロを使用するには、マクロ自体に属性が必要です#[macro_export]。インポートするクレートは、を介してマクロをインポートできuse crate_name::macro_name;ます。

クレート util

#[macro_export]
macro_rules! foo {
    () => ()
}

クレート user

use util::foo;

foo!();

マクロは常にクレートのトップレベルに存在することに注意してください。したがって、のfoo中にあるmod bar {}としても、userクレートは書く必要があり、書く必要はuse util::foo;ありません use util::bar::foo;。

Rust 2018より前#[macro_use]は、extern crate util;ステートメントに属性を追加して、他のクレートからマクロをインポートする必要がありました。これにより、からすべてのマクロがインポートされutilます。または、#[macro_use(cat, dog)]マクロcatとをインポートするためにのみ使用できますdog。この構文はもう必要ないはずです。

詳細については、マクロに関するRustプログラミング言語の章を参照してください。

この回答は、Rust1.1.0の時点では古くなっています-安定しています。

マクロガイドに記載されているように、#![macro_escape]上部に追加し、macros.rsを使用しmod macros;て含める必要があります。

$ cat macros.rs
#![macro_escape]

#[macro_export]
macro_rules! my_macro {
    () => { println!("hi"); }
}

$ cat something.rs
#![feature(macro_rules)]
mod macros;

fn main() {
    my_macro!();
}

$ rustc something.rs
$ ./something
hi

将来の参考のために、

$ rustc -v
rustc 0.13.0-dev (2790505c1 2014-11-03 14:17:26 +0000)

#![macro_use]マクロを含むファイルの先頭に追加すると、すべてのマクロがmain.rsにプルされます。

たとえば、このファイルの名前がnode.rsであると仮定します。

#![macro_use]

macro_rules! test {
    () => { println!("Nuts"); }
}

macro_rules! best {
    () => { println!("Run"); }
}

pub fn fun_times() {
    println!("Is it really?");
}

main.rsは、次のようになります。

mod node;  //We're using node.rs
mod toad;  //Also using toad.rs

fn main() {
    test!();
    best!();
    toad::a_thing();
}

最後に、次のマクロも必要とするtoad.rsというファイルがあるとします。

use node; //Notice this is 'use' not 'mod'

pub fn a_thing() {
  test!();

  node::fun_times();
}

ファイルがでmain.rsにプルされるとmod、残りのファイルはuseキーワードを介してそれらにアクセスできることに注意してください。

私がしている同じ問題に出くわした錆1.44.1に、この溶液は（錆1.7のために働いて知られている）それ以降のバージョンで動作します。

次のような新しいプロジェクトがあるとします。

src/
    main.rs
    memory.rs
    chunk.rs

ではmain.rs、あなたはそうでない場合、それはあなたのためにしないだろう、あなたはソースからのマクロをインポートしていることを注釈する必要があります。

#[macro_use]
mod memory;
mod chunk;

fn main() {
    println!("Hello, world!");
}

したがって、memory.rsではマクロを定義でき、注釈は必要ありません。

macro_rules! grow_capacity {
    ( $x:expr ) => {
        {
            if $x < 8 { 8 } else { $x * 2 }
        }
    };
}

最後に、chunk.rsで使用できます。また、main.rsで実行されるため、ここにマクロを含める必要はありません。

grow_capacity!(8);

upvoted答えはで、私のために混乱を引き起こした例により、このdoc、それはあまりにも役立つだろう。