comment pragma
Umístí záznam komentáře do souboru objektu nebo spustitelného souboru.
Syntaxe
#pragma comment(comment-type [,"comment-string" ])
Poznámky
Typ komentáře je jedním z předdefinovaných identifikátorů popsaných níže, který určuje typ záznamu komentáře. Volitelný řetězec komentáře je řetězcový literál, který poskytuje další informace pro některé typy komentářů. Vzhledem k tomu , že řetězec komentáře je řetězcový literál, dodržuje všechna pravidla pro řetězcové literály při použití řídicích znaků, vložených uvozovek (") a zřetězení.
– kompilátor
Umístí název a číslo verze kompilátoru do souboru objektu. Tento záznam komentáře linker ignoruje. Pokud zadáte parametr comment-string pro tento typ záznamu, kompilátor vygeneruje upozornění.
osvobození
Umístí záznam hledání knihovny do souboru objektu. Tento typ komentáře musí být doprovázen parametrem řetězce komentáře , který má název (a případně cestu) knihovny, kterou má linker prohledávat. Název knihovny se řídí výchozími záznamy hledání knihovny v souboru objektu. Linker vyhledá tuto knihovnu stejným způsobem, jako kdybyste ji zadali na příkazovém řádku, pokud není knihovna určena pomocí /nodefaultlib. Do stejného zdrojového souboru můžete umístit více záznamů hledání v knihovně. Každý záznam se zobrazí v souboru objektu ve stejném pořadí, v jakém se nachází ve zdrojovém souboru.
Pokud je důležité pořadí výchozí knihovny a přidané knihovny, kompilace přepínače /Zl zabrání umístění výchozího názvu knihovny do modulu objektu. Druhý komentář pragma pak můžete použít k vložení názvu výchozí knihovny za přidanou knihovnu. Knihovny uvedené s těmito pragma direktivami se zobrazí v modulu objektů ve stejném pořadí, v jakém se nacházejí ve zdrojovém kódu.
linker
Umístí do souboru objektu možnost linkeru. Tento typ komentáře můžete použít k určení možnosti linkeru místo jeho předání do příkazového řádku nebo jeho zadání ve vývojovém prostředí. Můžete například zadat možnost /include, která vynutí zahrnutí symbolu:
#pragma comment(linker, "/include:__mySymbol")
K dispozici jsou pouze následující možnosti linkeru (typu komentáře):
user
Umístí obecný komentář do souboru objektu. Parametr comment-string obsahuje text komentáře. Tento záznam komentáře linker ignoruje.
Příklady
Následující pragma způsobí, že linker vyhledá EMAPI. Knihovna LIB při propojování Linker nejprve vyhledá v aktuálním pracovním adresáři a pak v cestě zadané v proměnné prostředí LIB.
#pragma comment( lib, "emapi" )
Následující pragma způsobí, že kompilátor umístí název a číslo verze kompilátoru do souboru objektu:
#pragma comment( compiler )
Pro komentáře, které mají parametr řetězce komentáře, můžete použít makro na libovolném místě, kde byste použili řetězcový literál, pokud se makro rozšíří na řetězcový literál. Můžete také zřetězení jakékoli kombinace řetězcových literálů a maker, které se rozbalí na řetězcové literály. Například následující příkaz je přijatelný:
#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ )