Bagaimana cara menggunakan makro di seluruh file modul?

Saya memiliki dua modul dalam file terpisah dalam peti yang sama, di mana peti telah macro_rulesdiaktifkan. Saya ingin menggunakan makro yang ditentukan dalam satu modul di modul lain.

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

Saat ini saya menemukan kesalahan kompilator " macro undefined: 'my_macro'" ... yang masuk akal; sistem makro berjalan sebelum sistem modul. Bagaimana cara mengatasinya?

Makro dalam peti yang sama

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

bar!();    // works

Jika Anda ingin menggunakan makro di peti yang sama, modul yang ditentukan makro Anda membutuhkan atribut #[macro_use].

Makro hanya dapat digunakan setelah ditentukan. Ini berarti ini tidak berhasil:

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

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

Makro melintasi peti

Untuk menggunakan macro_rules!makro Anda dari peti lain, makro itu sendiri membutuhkan atribut #[macro_export]. Peti pengimpor kemudian dapat mengimpor makro melalui use crate_name::macro_name;.

Peti util

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

Peti user

use util::foo;

foo!();

Perhatikan bahwa makro selalu berada di level teratas dari sebuah peti; jadi meskipun fooakan berada di dalam a mod bar {}, userpeti itu masih harus menulis use util::foo;dan tidak use util::bar::foo; .

Sebelum Rust 2018, Anda harus mengimpor makro dari peti lain dengan menambahkan atribut #[macro_use]ke extern crate util;pernyataan tersebut. Itu akan mengimpor semua makro dari util. Atau, #[macro_use(cat, dog)]dapat digunakan untuk hanya mengimpor makro catdan dog. Sintaks ini seharusnya tidak diperlukan lagi.

Informasi lebih lanjut tersedia di bab Bahasa Pemrograman Rust pada makro .

Jawaban ini sudah usang karena Rust 1.1.0-stable.

Anda perlu menambahkan #![macro_escape]di bagian atas macros.rsdan memasukkannya menggunakan mod macros;seperti yang disebutkan di Panduan Makro .

$ 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

Untuk referensi di masa mendatang,

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

Menambahkan #![macro_use]ke bagian atas file Anda yang berisi makro akan menyebabkan semua makro ditarik ke main.rs.

Misalnya, file ini bernama node.rs:

#![macro_use]

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

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

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

Rumah utama Anda akan terlihat seperti berikut ini:

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

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

Terakhir, katakanlah Anda memiliki file bernama toad.rs yang juga membutuhkan makro berikut:

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

pub fn a_thing() {
  test!();

  node::fun_times();
}

Perhatikan bahwa setelah file ditarik ke main.rs dengan mod, sisa file Anda memiliki akses ke sana melalui usekata kunci.

Saya telah menemukan masalah yang sama di Rust 1.44.1, dan solusi ini berfungsi untuk versi yang lebih baru (dikenal berfungsi untuk Rust 1.7).

Katakanlah Anda memiliki proyek baru sebagai:

src/
    main.rs
    memory.rs
    chunk.rs

Di main.rs , Anda perlu memberi keterangan bahwa Anda mengimpor makro dari sumber, jika tidak, itu tidak akan berhasil untuk Anda.

#[macro_use]
mod memory;
mod chunk;

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

Jadi di memory.rs Anda dapat menentukan makro, dan Anda tidak memerlukan anotasi:

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

Akhirnya Anda bisa menggunakannya di chunk.rs , dan Anda tidak perlu menyertakan makro di sini, karena sudah selesai di main.rs:

grow_capacity!(8);

The jawaban upvoted menyebabkan kebingungan bagi saya, dengan doc ini dengan contoh , akan membantu juga.