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-Literalconcat!(str0, str1, ...)— legt Strings aneinandercompile_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 mitformat!.
✅ Wichtige Erkenntnisse
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.