comment pragma

  • Artikel

Platziert einen Kommentardatensatz in einer Objektdatei oder ausführbaren Datei.

Syntax

#pragma comment(comment-type [ , "comment-string" ] )

Hinweise

Der Kommentartyp ist einer der vordefinierten Bezeichner, die unten beschrieben werden, und gibt den Typ des Kommentardatensatzes an. Die optionale Kommentarzeichenfolge ist ein Zeichenfolgenliteral, das zusätzliche Informationen für einige Kommentartypen bereitstellt. Da kommentarzeichenfolge ein Zeichenfolgenliteral ist, befolgt sie alle Regeln für Zeichenfolgenliterale bei Verwendung von Escapezeichen, eingebetteten Anführungszeichen (") und Verkettung.

compiler

Platziert den Namen und die Versionsnummer des Compilers in der Objektdatei. Dieser Kommentardatensatz wird vom Linker ignoriert. Wenn Sie einen Kommentarzeichenfolgenparameter für diesen Datensatztyp angeben, generiert der Compiler eine Warnung.

lib

Platziert einen einen Datensatz für Bibliothekssuchvorgänge in der Objektdatei. Dieser Kommentartyp muss von einem Kommentarzeichenfolgenparameter begleitet werden, der den Namen (und möglicherweise den Pfad) der Bibliothek enthält, die der Linker durchsuchen soll. Der Bibliotheksname folgt den Standarddatensätzen für die Bibliothekssuche in der Objektdatei. Der Linker sucht diese Bibliothek auf die gleiche Weise wie bei der Angabe in der Befehlszeile, solange die Bibliothek nicht mithilfe /nodefaultlibvon . Sie können mehrere Bibliothekssuchdatensätze in derselben Quelldatei platzieren. Jeder Datensatz wird in der Objektdatei in derselben Reihenfolge angezeigt, in der er in der Quelldatei gefunden wird.

Wenn die Reihenfolge der Standardbibliothek und eine hinzugefügte Bibliothek wichtig ist, verhindert die Kompilierung mit der /Zl Option, dass der Standardbibliotheksname im Objektmodul platziert wird. Ein zweiter Kommentar pragma kann dann verwendet werden, um den Namen der Standardbibliothek nach der hinzugefügten Bibliothek einzufügen. Die mit diesen pragma Direktiven aufgelisteten Bibliotheken werden im Objektmodul in derselben Reihenfolge angezeigt, in der sie im Quellcode gefunden werden.

Linker

Platziert eine Linkeroption in der Objektdatei. Sie können diesen Kommentartyp verwenden, um eine Linkeroption anzugeben, statt sie an die Befehlszeile zu übergeben oder in der Entwicklungsumgebung anzugeben. Beispielsweise können Sie die /include-Option angeben, um das Einfügen eines Symbols zu erzwingen:

#pragma comment(linker, "/include:__mySymbol")

Es stehen nur die folgenden Linkeroptionen (Kommentartyp) zur Verfügung, die an den Linkerbezeichner übergeben werden können:

Benutzer

Platziert einen allgemeinen Kommentar in der Objektdatei. Der Parameter "comment-string " enthält den Text des Kommentars. Dieser Kommentardatensatz wird vom Linker ignoriert.

Beispiele

Im Folgenden pragma wird der Linker nach der EMAPI suchen. LIB-Bibliothek beim Verknüpfen. Der Linker durchsucht zuerst im aktuellen Arbeitsverzeichnis und dann im Pfad, der in der LIB-Umgebungsvariable angegeben ist.

#pragma comment( lib, "emapi" )

Im Folgenden pragma wird der Compiler den Namen und die Versionsnummer des Compilers in der Objektdatei platzieren:

#pragma comment( compiler )

Für Kommentare, die einen Kommentarzeichenfolgenparameter verwenden, können Sie ein Makro an jeder Stelle verwenden, an der Sie ein Zeichenfolgenliteral verwenden würden, solange das Makro auf ein Zeichenfolgenliteral erweitert wird. Sie können auch jede beliebige Kombination aus Zeichenfolgenliteralen und Makros verketten, die als Zeichenfolgenliterale erweitert werden. Beispielsweise ist die folgende Anweisung akzeptabel.

#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ )

Siehe auch

Pragma-Direktiven und die __pragma und _Pragma Schlüsselwort (keyword)