Modül dosyalarında bir makroyu nasıl kullanabilirim?

Aynı sandık içinde, kasanın macro_rulesetkinleştirildiği ayrı dosyalarda iki modülüm var . Bir modülde tanımlanan makroları başka bir modülde kullanmak istiyorum.

// 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?

Şu anda " macro undefined: 'my_macro'" derleyici hatasıyla karşılaşıyorum ... bu mantıklı; makro sistemi, modül sisteminden önce çalışır. Bunun etrafında nasıl çalışırım?

Aynı sandık içindeki makrolar

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

bar!();    // works

Makroyu aynı kasada kullanmak istiyorsanız, makronuzun tanımlandığı modülün niteliğe ihtiyacı vardır #[macro_use].

Makrolar yalnızca tanımlandıktan sonra kullanılabilir . Bu, bunun çalışmadığı anlamına gelir:

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

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

Kasalar arasında makrolar

macro_rules!Makronuzu diğer kasalardan kullanmak için , makronun kendisinin özniteliğe ihtiyacı vardır #[macro_export]. İçe aktarma kasası daha sonra makroyu aracılığıyla içe aktarabilir use crate_name::macro_name;.

Sandık util

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

Sandık user

use util::foo;

foo!();

Makroların her zaman bir kasanın en üst seviyesinde bulunduğunu unutmayın; Hatta eğer öyleyse foobir iç olacağını mod bar {}, usersandık hala yazma olurdu use util::foo;ve değil use util::bar::foo; .

Rust 2018 önce, özellik ekleyerek diğer sandıklardan ithalat makro zorunda #[macro_use]için extern crate util;açıklamada. Bu, tüm makroları util. Alternatif olarak, #[macro_use(cat, dog)]yalnızca makroları içe aktarmak için kullanılabilir catve dog. Bu sözdizimi artık gerekli olmamalı.

Daha fazla bilgi, makrolarla ilgili Rust Programlama Dili bölümünde mevcuttur .

Bu cevap Rust 1.1.0 kararlı olduğu için modası geçmiş durumda.

Makrolar Kılavuzu'nda belirtildiği gibi #![macro_escape]üst kısmına eklemeniz macros.rsve eklemeniz gerekir .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

Gelecekte referans olması için,

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

#![macro_use]Makro içeren dosyanızın en üstüne eklemek , tüm makroların main.rs.'ye çekilmesine neden olacaktır.

Örneğin, bu dosyanın node.rs olduğunu varsayalım:

#![macro_use]

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

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

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

Main.rs'ınız bazen aşağıdaki gibi görünebilir:

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

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

Son olarak, şu makroları da gerektiren toad.rs adında bir dosyanız olduğunu varsayalım:

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

pub fn a_thing() {
  test!();

  node::fun_times();
}

Bir kez dosyalar main.rs'e çekildikten sonra mod, dosyalarınızın geri kalanının onlara useanahtar sözcük aracılığıyla eriştiğine dikkat edin .

Ben var aynı sorun üzerinde geldi Rust 1.44.1 yılında, ve bu çözüm (Rust 1.7 için çalışan bilinir) sonraki sürümleri için çalışır.

Diyelim ki yeni bir projeniz var:

src/
    main.rs
    memory.rs
    chunk.rs

Gelen main.rs , aksi halde, bu sizin için yapmayacağım, sen kaynağından makro ithal ediyoruz o açıklama yaparak gerekir.

#[macro_use]
mod memory;
mod chunk;

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

Böylece memory.rs'de makroları tanımlayabilirsiniz ve ek açıklamalara ihtiyacınız yoktur:

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

Son olarak chunk.rs içinde kullanabilirsiniz ve makroyu buraya eklemenize gerek yoktur, çünkü main.rs'de yapılır:

grow_capacity!(8);

Upvoted cevap ile benim için karışıklığa neden örnek, bu doküman , çok yararlı olacaktır.