Skip to content
Modul 19 — Makros: Code schreiben, der Code schreibt
4

Built-In Makros: file!, line!, stringify!

Lektion 4 von 7

Compiler-Makros

Einige Makros sind in rustc fest verdrahtet und könnten mit macro_rules! allein nicht gebaut werden:

  • file!() — die Datei, in der der Aufruf steht (als String-Literal)
  • line!() — die aktuelle Zeilennummer (u32, ab 1)
  • column!() — die aktuelle Spalte (u32, ab 1)
  • module_path!() — der Rust-Modulpfad wie "fernlib::fronds"
  • stringify!(...tokens...) — die Tokens als String-Literal
  • concat!(str0, str1, ...) — legt Strings aneinander
  • compile_error!("msg") — bricht die Compilierung mit einer Meldung ab

stringify! in Aktion

fn main() {
    let s = stringify!(1 + 2);
    println!("{s}"); // druckt: 1 + 2

    // Makro-Aufrufe werden NICHT expandiert:
    let t = stringify!(line!());
    println!("{t}"); // druckt: line!()
}

assert! nutzt stringify!, um eine Fehlermeldung zu erzeugen, die den Original-Code der Assertion enthält.

compile_error! für bessere Fehlermeldungen

Makros geben sonst kryptische Fehler wie "no rules expected". Mit einem Muster, das häufige Benutzerfehler abfängt, liefert dein Makro eine klare Meldung:

macro_rules! brauche_zwei {
    ($a:expr, $b:expr) => { $a + $b };
    ($($x:expr),*) => {
        compile_error!("brauche_zwei! erwartet genau zwei Argumente")
    };
}

Woher weiß file!/line! den Ort?

file!, line! und column! melden den Ort des ersten Makro-Aufrufs. Ruft Makro A Makro B auf, das in einer anderen Datei steht, liefert file!() die Datei des ersten Aufrufs — also des Anwenders, nicht der Makro-Definition.

⚠ Häufiger Fehler: stringify!(1 + 2) liefert den Text "1 + 2", nicht "5" — das Makro quotet nur die Tokens, wertet nichts aus und expandiert auch keine inneren Makros. Wer einen Wert als Text braucht, formatiert ihn erst zur Laufzeit mit format!.

✅ Wichtige Erkenntnisse

0/3

Haken setzen, um deinen Lernfortschritt zu markieren:

  • Rufe dir die Kernpunkte in Erinnerung, bevor du die Liste aufdeckst.

Erinnerungstraining

Tippe den fehlenden Begriff aus dem Gedächtnis ein und prüfe.

meldet den Ort des ersten Makro-Aufrufs — als Datei bzw. Zeilennummer, nicht den der Makro-Definition.
macht aus den Tokens 1 + 2 den String "1 + 2" — und expandiert Makro-Aufrufe im Argument nicht.
Mit bricht dein Makro die Kompilierung mit einer eigenen, verständlichen Meldung ab — statt eines kryptischen Fehlers.
0 von 3 richtig

This site uses essential cookies for Stripe payments. No tracking cookies.