comment pragma
Megjegyzésrekordot helyez el egy objektumfájlban vagy végrehajtható fájlban.
Szintaxis
#pragma comment(megjegyzés típusú [,"megjegyzéssztring" ])
Megjegyzések
A megjegyzés típusú az alábbiakban ismertetett előre definiált azonosítók egyike, amely meghatározza a megjegyzésrekord típusát. Az opcionális megjegyzéssztring- egy sztringkonstans, amely további információkat biztosít egyes megjegyzéstípusokhoz. Mivel megjegyzés-sztring egy sztringkonstans, betartja a sztringkonstansokra vonatkozó összes szabályt a feloldó karakterek, a beágyazott idézőjelek (") és az összefűzés használatára.
fordítóprogram
A fordító nevét és verziószámát az objektumfájlba helyezi. A hivatkozás figyelmen kívül hagyja ezt a megjegyzésrekordot. Ha ehhez a rekordtípushoz megjegyzéssztring paramétert ad meg, a fordító figyelmeztetést hoz létre.
Lib
Tárkeresési rekordot helyez el az objektumfájlban. Ezt a megjegyzéstípust egy megjegyzéssztring paraméternek kell kísérnie, amely tartalmazza annak a kódtárnak a nevét (és esetleg elérési útját), amelyet a hivatkozáskészítőnek keresnie kell. Az erőforrástár neve az objektumfájl alapértelmezett könyvtárkeresési rekordjait követi. A linker ugyanúgy keresi ezt a kódtárat, mintha a parancssorban adta volna meg, feltéve, hogy a kódtár nincs megadva a /nodefaultlibhasználatával. Több könyvtárkeresési rekordot is elhelyezhet ugyanabban a forrásfájlban. Minden rekord ugyanabban a sorrendben jelenik meg az objektumfájlban, mint a forrásfájlban.
Ha fontos az alapértelmezett kódtár és a hozzáadott kódtár sorrendje, a /Zl kapcsolóval történő összeállítás megakadályozza, hogy az alapértelmezett kódtár neve bekerüljön az objektummodulba. A második megjegyzés pragma ezután az alapértelmezett kódtár nevének beszúrására használható a hozzáadott kódtár után. Az ezen pragma irányelvekben felsorolt kódtárak a forráskódban található sorrendben jelennek meg az objektummodulban.
szerkesztő
Egy csatolási beállítást helyez az objektumfájlba. Ezzel a megjegyzéstípussal megadhat egy hivatkozási beállítást ahelyett, hogy a parancssorba továbbítja, vagy a fejlesztési környezetben adja meg. Megadhatja például a /include lehetőséget, hogy kényszerítse egy szimbólum felvételét:
#pragma comment(linker, "/include:__mySymbol")
Csak a következő (megjegyzés típusú) hivatkozási lehetőségek adhatók át a hivatkozásazonosítónak:
felhasználó
Általános megjegyzést helyez el az objektumfájlban. A megjegyzéssztring paraméter tartalmazza a megjegyzés szövegét. A hivatkozás figyelmen kívül hagyja ezt a megjegyzésrekordot.
Példák
Az alábbi pragma hatására a linker megkeresi az EMAPI-t. LIB-kódtár csatolás közben. A linker először az aktuális munkakönyvtárban, majd a LIB környezeti változóban megadott elérési úton keres.
#pragma comment( lib, "emapi" )
Az alábbi pragma hatására a fordító a fordító nevét és verziószámát az objektumfájlba helyezi:
#pragma comment( compiler )
Az megjegyzés-sztring paramétert használó megjegyzések esetén a makrót bármely olyan helyen használhatja, ahol sztringkonstanst használna, amíg a makró sztringkonstansra bővül. A sztringkonstansok és makrók tetszőleges kombinációját is összefűzheti, amelyek sztringkonstansokra bonthatók. A következő utasítás például elfogadható:
#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ )
Lásd még:
Pragma irányelvei, valamint a __pragma és _Pragma kulcsszavak