Läs på engelska

Dela via


comment pragma

Placerar en kommentarspost i en objektfil eller körbar fil.

Syntax

#pragma comment( kommentarstyp [ , "kommentarssträng" ] )

Anmärkningar

kommentarstyp är en av de fördefinierade identifierare som beskrivs nedan och som anger typen av kommentarspost. Den valfria kommentarssträngen är en strängliteral som ger ytterligare information för vissa kommentarstyper. Eftersom kommentarssträng är en strängliteral följer den alla regler för strängliteraler vid användning av escape-tecken, inbäddade citattecken (") och sammanlänkning.

kompilator

Placerar kompilatorns namn och versionsnummer i objektfilen. Den här kommentarsposten ignoreras av länkaren. Om du anger en parameter för den här posttypen genererar kompilatorn en varning.

Lib

Placerar en bibliotekssökningspost i objektfilen. Den här kommentarstypen måste åtföljas av en kommentarssträng parameter som har namnet (och eventuellt sökvägen) för biblioteket som du vill att länkaren ska söka i. Biblioteksnamnet följer standardposterna för bibliotekssökning i objektfilen. Länkaren söker efter det här biblioteket på samma sätt som om du angav det på kommandoraden, så länge biblioteket inte anges med hjälp av /nodefaultlib. Du kan placera flera bibliotekssökningsposter i samma källfil. Varje post visas i objektfilen i samma ordning som den finns i källfilen.

Om ordningen på standardbiblioteket och ett tillagt bibliotek är viktigt förhindrar kompilering med växeln /Zl att standardbiblioteksnamnet placeras i objektmodulen. En andra kommentar pragma kan sedan användas för att infoga namnet på standardbiblioteket efter det tillagda biblioteket. Biblioteken som anges med dessa pragma-direktiv visas i objektmodulen i samma ordning som de hittas i källkoden.

Länkare

Placerar ett -länkalternativ i objektfilen. Du kan använda den här kommentarstypen för att ange ett länkalternativ i stället för att skicka det till kommandoraden eller ange det i utvecklingsmiljön. Du kan till exempel ange alternativet /include för att framtvinga inkluderingen av en symbol:

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

Det är bara följande () länkalternativ som kan skickas till länksidentifieraren:

användare

Placerar en allmän kommentar i objektfilen. Parametern kommentarssträng innehåller kommentarens text. Den här kommentarsposten ignoreras av länkaren.

Exempel

Följande pragma gör att länkaren söker efter EMAPI. LIB-bibliotek vid länkning. Länkaren söker först i den aktuella arbetskatalogen och sedan i sökvägen som anges i LIB-miljövariabeln.

#pragma comment( lib, "emapi" )

Följande pragma gör att kompilatorn placerar kompilatorns namn och versionsnummer i objektfilen:

#pragma comment( compiler )

För kommentarer som tar en kommentarssträng parameter kan du använda ett makro på valfri plats där du använder en strängliteral, så länge makrot expanderas till en strängliteral. Du kan också sammanfoga valfri kombination av strängliteraler och makron som expanderar till strängliteraler. Följande instruktion är till exempel acceptabel:

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

Se även

Pragma-direktiv och nyckelorden __pragma och _Pragma