Jak używasz makra z jego własnej skrzynki?

Question

Jestem pewien, że to jest trywialne, ale nie mogę sprawić, żeby działało.

Szukałem na http://doc.rust-lang.org/book/advanced-macros.html#scoping-and-macro-import/export i doceniam, że ogólnie rzecz biorąc, sposób używania makr jest definiować je za pomocą:

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

... a następnie importować je do innego kontekstu, który z nich korzysta używając:

#[macro_use] 
extern crate terminal; 
... 

Jednak ja chcę użyć makr z poziomu skrzynki, w której są zdefiniowane.

Jeśli moja struktura plików jest:

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

Jak korzystać z makr w macros.rs z junk.rs?

Próbowałem różnych kombinacji #[macro_use] mod macros itp. Bez powodzenia. Dokumentacja sugeruje, że jeśli makro jest zdefiniowane w pewnym zakresie, to jest dostępne we wszystkich modułach potomnych ... Czy to znaczy, że muszę zdefiniować moje makra w lib.rs?

Answer 1

Trzeba zaznaczyć swoją makro z #[macro_export] a następnie zaznaczyć moduł z #[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()); 
} 

Technicznie rzecz biorąc, trzeba tylko użyć #[macro_export] jeśli chcesz makro mają być dostępne dla użytkowników swojej skrzyni.

(Playpen link)

Answer 2

Zaakceptowanych odpowiedź jest poprawna, ale dla każdego, kto znajdzie na to pytanie w przyszłości, chciałbym dodać, że zamówienie w której moduły są ładowane jest ważne.

Na przykład, w tej kolejności:

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

#[macro_use] 
mod macros; 

Jeżeli terminal używa makro z makra, będzie nie pracy; #[macro_use] musi nastąpić powyżej każdy inny moduł, który używa makra:

#[macro_use] 
mod macros; 

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