Sdílet prostřednictvím


comment (C/C++)

Komentář záznamu umístí do spustitelného souboru nebo souboru objektu.

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

Poznámky

Typ poznámky je jeden z předdefinované identifikátorů, popsáno níže, který určuje typ záznamu komentář.Nepovinný commentstring je řetězcový literál, který poskytuje další informace pro některé typy komentář.Protože commentstring je řetězec literálu ji obeys všechna pravidla pro řetězcové literály se řídicí znaky uvozovek vložené (") a zřetězení.

  • Kompilátor
    Soubor objektu umístí název a číslo verze kompilátoru.Tento záznam komentáře ignorováno vytvořeném propojovacím programem.Zadáte-li commentstring parametr pro tento typ záznamu, kompilátor generuje varování.

  • exestr
    Míst commentstring v souboru objektu.V okamžiku propojení tohoto řetězce do spustitelného souboru.Řetězec nebyl načten do paměti při načtení spustitelného souboru; však je možné najít s programem, který najde tisknutelné řetězců v souborech.Je jedno použití pro tento typ záznamu komentář vložit číslo verze nebo podobné informace do spustitelného souboru.

    exestrse již nepoužívá a budou odstraněny v budoucím vydání; vytvořeném propojovacím nezpracovává záznam komentáře.

  • lib
    Umístí soubor objektu knihovny hledání záznamu.Tento typ komentáře musí být přiložen commentstring parametr obsahující název (a případně cestu) knihovny, která má linker hledání.Název knihovny se řídí výchozí knihovny vyhledávání záznamů v souboru objektu. vytvořeném propojovacím hledá pro tuto knihovnu stejně, jako by vám měl je pojmenovaná na příkazovém řádku v za předpokladu, že není zadán knihovny s /nodefaultlib.Více záznamů knihovna hledání můžete umístit do stejného zdrojového souboru; Zobrazí každý záznam v souboru objektu ve stejném pořadí, v němž došlo ve zdrojovém souboru.

    Pokud je důležité pořadí výchozí knihovny a přidané knihovny, kompilace se /Zl přepínače zabrání výchozí název knihovny byly umístěny v objektu modulu.Druhý komentář pragma pak lze vložit název výchozí knihovny po přidané knihovny.Knihovny uvedeny tyto pragmas se zobrazí v modulu objektu ve stejném pořadí, které jsou nalezeny ve zdrojovém kódu.

  • Linker
    Místa linker možnost v souboru objektu.Tento typ poznámky můžete zadat linker možnost namísto předání do příkazového řádku nebo určení ve vývojovém prostředí.Můžete například zadat / možnost vynucení zařazení symbol:

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

    Pouze následující (Typ poznámky) jsou k dispozici má být předán identifikátor linker linker možnosti:

  • uživatel
    Soubor objektu umístí obecné komentáře.commentstring Parametr obsahuje text poznámky.Tento záznam komentáře ignorováno vytvořeném propojovacím programem.

Následující záhlaví pragma způsobí linker hledání EMAPI.LIB knihovny při propojování.Vytvořeném propojovacím prohledá nejprve aktuální pracovní adresář a pak v cestě zadané v proměnné prostředí LIB.

#pragma comment( lib, "emapi" )

Následující záhlaví pragma způsobuje kompilátoru v souboru objekt umístit název a číslo verze kompilátoru:

#pragma comment( compiler )

[!POZNÁMKA]

Pro komentáře že vzít commentstring parametr, můžete použít makro v jakémkoli místě, kde by použít řetězcový literál, za předpokladu, že makro rozšíří řetězcový literál.Můžete také zřetězit libovolnou kombinaci řetězcové literály a makra rozbalit do řetězcové literály.Přijatelné je například následující příkaz:

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

Viz také

Referenční dokumentace

Pragma směrnic a __Pragma klíčové slovo