comment
pragma
Hiermee plaatst u een opmerkingsrecord in een objectbestand of uitvoerbaar bestand.
Syntaxis
#pragma comment(
opmerkingstype [,
"" ])
Opmerkingen
Het opmerkingstype is een van de vooraf gedefinieerde id's die hieronder worden beschreven, waarmee het type opmerkingsrecord wordt opgegeven. De optionele opmerking-tekenreeks is een letterlijke tekenreeks die aanvullende informatie biedt voor sommige opmerkingstypen. Omdat opmerkingstekenreeks een letterlijke tekenreeks is, voldoet deze aan alle regels voor letterlijke tekenreeksen voor het gebruik van escapetekens, ingesloten aanhalingstekens ("
) en samenvoeging.
compiler
Hiermee plaatst u de naam en het versienummer van de compiler in het objectbestand. Deze opmerkingrecord wordt genegeerd door de linker. Als u een parameter voor opmerkingsreeksen opgeeft voor dit recordtype, genereert de compiler een waarschuwing.
Lib
Hiermee wordt een bibliotheekzoekrecord in het objectbestand geplaatst. Dit opmerkingstype moet vergezeld gaan van een opmerkingstekenreeks parameter met de naam (en mogelijk het pad) van de bibliotheek waarnaar u de linker wilt zoeken. De naam van de bibliotheek volgt de standaardrecords voor bibliotheekzoekopdrachten in het objectbestand. De linker zoekt op dezelfde manier naar deze bibliotheek als als u deze hebt opgegeven op de opdrachtregel, zolang de bibliotheek niet is opgegeven met behulp van /nodefaultlib
. U kunt meerdere records voor bibliotheekzoekopdrachten in hetzelfde bronbestand plaatsen. Elke record wordt weergegeven in het objectbestand in dezelfde volgorde als in het bronbestand.
Als de volgorde van de standaardbibliotheek en een toegevoegde bibliotheek belangrijk is, wordt bij het compileren met de schakeloptie /Zl
voorkomen dat de standaardbibliotheeknaam in de objectmodule wordt geplaatst. Een tweede opmerking pragma vervolgens kan worden gebruikt om de naam van de standaardbibliotheek in te voegen na de toegevoegde bibliotheek. De bibliotheken die worden vermeld met deze pragma instructies, worden weergegeven in de objectmodule in dezelfde volgorde als in de broncode.
linker
Hiermee plaatst u een linkeroptie in het objectbestand. U kunt dit opmerkingstype gebruiken om een linkeroptie op te geven in plaats van deze door te geven aan de opdrachtregel of door te geven in de ontwikkelomgeving. U kunt bijvoorbeeld de optie /include opgeven om het opnemen van een symbool af te dwingen:
#pragma comment(linker, "/include:__mySymbol")
Alleen de volgende linkeropties (opmerkingstype) kunnen worden doorgegeven aan de linker-id:
gebruiker
Hiermee plaatst u een algemene opmerking in het objectbestand. De parameter comment-string bevat de tekst van de opmerking. Deze opmerkingrecord wordt genegeerd door de linker.
Voorbeelden
De volgende pragma zorgt ervoor dat de linker naar de EMAPI zoekt. LIB-bibliotheek tijdens het koppelen. De linker zoekt eerst in de huidige werkmap en vervolgens in het pad dat is opgegeven in de lib-omgevingsvariabele.
#pragma comment( lib, "emapi" )
De volgende pragma zorgt ervoor dat de compiler de naam en het versienummer van de compiler in het objectbestand plaatst:
#pragma comment( compiler )
Voor opmerkingen die een parameter voor opmerking-tekenreeksen, kunt u een macro gebruiken op elke plaats waar u een letterlijke tekenreeks gebruikt, zolang de macro wordt uitgebreid naar een letterlijke tekenreeks. U kunt ook elke combinatie van letterlijke tekenreeksen en macro's samenvoegen die uitvouwen tot letterlijke tekenreeksen. De volgende instructie is bijvoorbeeld acceptabel:
#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ )