Filename and line information

Ändert die Zeilennummer des Quellcodes und optional den aktuellen Dateinamen im Präprozessor.

Syntax

Erklärung

1) Ändert die aktuelle Präprozessor-Zeilennummer zu lineno . Erweiterungen des Makros __LINE__ nach diesem Punkt werden zu lineno plus der Anzahl der tatsächlich seitdem angetroffenen Quellcode-Zeilen erweitert.

2) Ändert auch den aktuellen Präprozessor-Dateinamen zu filename . Erweiterungen des Makros __FILE__ ab diesem Punkt werden filename erzeugen.

Jede Präprozessor-Token (Makrokonstanten oder Ausdrücke) sind als Argumente für #line zulässig, solange sie zu einer gültigen dezimalen Ganzzahl erweitert werden, der optional eine gültige Zeichenkette folgt.

lineno muss eine Folge von mindestens einer Dezimalziffer sein (das Programm ist andernfalls fehlerhaft) und wird stets als Dezimalzahl interpretiert (selbst wenn es mit 0 beginnt).

Wenn lineno gleich 0 oder größer als 32767 (bis C++11) 2147483647 (seit C++11) ist, ist das Verhalten undefiniert.

Hinweise

Diese Direktive wird von einigen automatischen Codegenerierungswerkzeugen verwendet, die C++-Quelldateien aus einer in einer anderen Sprache geschriebenen Datei erzeugen. In diesem Fall können #line Direktiven in die generierte C++-Datei eingefügt werden, die auf Zeilennummern und den Dateinamen der ursprünglichen (durch Menschen bearbeitbaren) Quelldatei verweisen.

Beispiel

#include <cassert>
#define FNAME "test.cc"
int main()
{
#line 777 FNAME
        assert(2+2 == 5);
}

test: test.cc:777: int main(): Assertion `2+2 == 5' failed.

Referenzen

Siehe auch