comment (C/C++)

Speichert einen Datensatz Kommentar in einer Objektdatei oder in eine ausführbare Datei.

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

Hinweise

Kommentar TYPE ist einer der vordefinierten Bezeichner im Folgenden beschriebene Kommentar, der den Typ des Datensatzes angibt.Optionale commentstring ist ein Zeichenfolgenliteral, das zusätzliche Informationen für eine Kommentar Typen bereitstellt.Da commentstring ein Zeichenfolgenliteral ist, entspricht er alle Regeln für die Zeichenfolgenliterale in Zusammenhang mit Escapezeichen**„**und eingebettete Anführungszeichen (Verkettung).

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

• exestr
  Platziert commentstring in der Objektdatei.An der Verknüpfungszeit wird diese Zeichenfolge in die ausführbare Datei platziert.Die Zeichenfolge wird nicht in den Arbeitsspeicher geladen, wenn die ausführbare Datei geladen wird. Allerdings kann sie mit einem Programm, das druckbaren Zeichenfolgen in Dateien sucht.Eine Verwendung für diesen Kommentar RECORD-Typ ist, eine Versionsnummer oder ähnliche Informationen in einer ausführbaren Datei einzubetten.

  exestr ist veraltet und wird in einer der nächsten Versionen entfernt. Nicht verarbeitet der Linker den Kommentar Datensatz.

• lib
  Setzt einen SEARCH-Datensatz Bibliothek in der Objektdatei.Dieser Typ muss von einem Kommentar commentstring-Parameter begleitet werden, der den Namen enthält (und ggf. den Pfad) der Bibliothek, den der Linker suchen soll.Der Name der Bibliothek SEARCH-Datensätzen Bibliothek den standardmäßigen folgt in der Objektdatei; Die Linker sucht diese Bibliothek, als ob Sie sie in der Befehlszeile genannt haben, vorausgesetzt, dass die Bibliothek nicht mit /nodefaultlibangegeben wird.Sie können mehrere Bibliotheken SEARCH-Datensätze in derselben Quelldatei platzieren. jeden Datensatz wird in der Objektdatei in der gleichen Reihenfolge, in der sie in der Quelldatei erreicht wird.

  Wenn die Reihenfolge der Benutzerbibliothek und der hinzugefügten Bibliothek wichtig ist, verhindert die Kompilierung mit dem Schalter /Zl den Standardbibliotheksnamen in das Objektmodul gespeichert werden.Ein zweites comment-Pragma können dann den Namen der Benutzerbibliothek nach der hinzugefügten Bibliothek eingefügt werden soll.Die Bibliotheken, die diesen Pragmas aufgeführt sind, werden im Objektmodul in der gleichen Reihenfolge, in der sie im Quellcode gefunden werden.

• Linker
  Platziert Linkeroption in der Objektdatei.Sie können dieses Kommentars TYPE verwenden, um eine Linkeroption festlegen, anstatt sie an die Befehlszeile übergeben oder in der Entwicklungsumgebung anzugeben.Beispielsweise können Sie die /include- angeben, die die Aufnahme eines Symbols zu erzwingen:

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

  Nur die folgenden Linkeroptionen (Kommentar)TYPEsverfügbar sind, an den Linker übergeben werden Programmbezeichner:

  • /DEFAULTLIB

  • /EXPORT

  • /INCLUDE

  • /MANIFESTDEPENDENCY

  • /MERGE

  • /SECTION

• Benutzer
  Setzt einen allgemeinen Kommentar in der Objektdatei.Der commentstring-Parameter enthält den Text des Kommentars.Dieser Kommentar Datensatz wird vom Linker ignoriert.

Im folgenden Pragma veranlasst den Linker, für die EMAPI.LIB-Bibliothek beim Verknüpfen zu suchen.Der Linker sucht zunächst im aktuellen Arbeitsverzeichnis und anschließend im Pfad, der in der LIB-Umgebungsvariablen angegeben wird.

#pragma comment( lib, "emapi" )

Im folgenden Pragma bewirkt, dass der Compiler den Namen und die Versionsnummer des Compilers in Objektdatei zu speichern:

#pragma comment( compiler )

Hinweis

Für Kommentare, die einen commentstring-Parameter akzeptieren, können Sie ein Makro in einem beliebigen Ort, an dem Sie ein Zeichenfolgenliteral verwenden würden, vorausgesetzt, dass das Makro in einem Zeichenfolgenliteral erstreckt.Sie können jede beliebige Kombination aus Zeichenfolgenliteralen und Makros auch verketten, die für Zeichenfolgenliterale erweitern.Beispielsweise ist die folgende Anweisung zulässig:

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

Siehe auch

Referenz

Pragma-Direktiven und das __Pragma-Schlüsselwort