Udostępnij za pośrednictwem


comment (C/C++)

Umieszcza rekordu komentarza do obiektu pliku lub plik wykonywalny.

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

Uwagi

Typ komentarza jest jednym z identyfikatorów wstępnie zdefiniowanych, opisane poniżej, który określa typ rekordu komentarz.Opcjonalny commentstring jest ciągiem literał, który zawiera dodatkowe informacje dla niektórych typów komentarz.Ponieważ commentstring jest ciągiem znaków literalnych, przestrzega on zasady literały ciągów znaków w odniesieniu do znaków escape, osadzone cudzysłowy (") i łączenia.

  • Kompilator
    Umieszcza nazwę i numer wersji kompilatora w pliku obiektu.Rekord ten komentarz jest ignorowany przez program łączący.Jeśli podasz commentstring parametr dla tego typu rekordu, kompilator generuje ostrzeżenie.

  • exestr
    Miejsca commentstring w pliku obiektu.W czasie łączy ten ciąg jest umieszczana w pliku wykonywalnego.Ciąg nie jest ładowany do pamięci podczas ładowania pliku wykonywalnego; Jednakże można go znaleźć z programem, który wyszukuje ciągi znaków drukowalnych w plikach.Jednym z zastosowań tego typu rekordu komentarz jest osadzenie numer wersji lub podobne informacje w pliku wykonywalnym.

    exestrjest przestarzała i zostaną usunięte w przyszłej wersji; Program łączący nie może przetwarzać rekordu komentarz.

  • lib
    Umieszcza rekordu wyszukiwania biblioteki w pliku obiektu.Ten typ komentarza musi towarzyszyć commentstring parametr zawierający nazwę (i ewentualnie ścieżki) biblioteki, który program łączący do wyszukiwania.Nazwa biblioteki następuje domyślne rekordy wyszukiwania biblioteki w pliku obiektu; Program łączący przeszukuje dla tej biblioteki, tak jak gdyby miał nazwany go w wierszu polecenia pod warunkiem, że biblioteka nie jest określony z /nodefaultlib.Wiele rekordów wyszukiwania biblioteki można umieścić w tym samym pliku źródłowego; Każdy rekord występuje w pliku obiektu w tej samej kolejności, w której jest napotkał w pliku źródłowym.

    Jeśli ważne jest kolejność domyślna biblioteka i biblioteki dodane kompilacji z /Zl przełącznik uniemożliwi domyślna nazwa biblioteki zostanie umieszczona w module obiektu.Drugi pragma comment następnie można wstawić nazwę domyślną bibliotekę po dodano biblioteki.Biblioteki, wymienionych w tych pragmas pojawi się w module obiekt w tej samej kolejności, które znajdują się w kodzie źródłowym.

  • Program łączący
    Miejsca opcję w pliku obiektu.Typ komentarza można użyć, aby określić opcję linker zamiast przekazaniem go do wiersza polecenia lub związany z nią w środowisku programistycznym.Na przykład, można określić / include opcję, aby wymusić włączenie symbolu:

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

    Jedynie następujące (typ komentarza) mają być przekazywane do identyfikatora linker dostępnych opcji linker:

  • użytkownik
    Umieszcza ogólny komentarz w pliku obiektu.commentstring Parametr zawiera tekst komentarza.Rekord ten komentarz jest ignorowany przez program łączący.

Następujące pragma powoduje, że program łączący do wyszukiwania EMAPI.Biblioteka LIB podczas łączenia.Program łączący przeszukuje najpierw w bieżącym katalogu roboczym, a następnie w ścieżce, określonej w polu Zmienna środowiskowa LIB.

#pragma comment( lib, "emapi" )

Następujące pragma powoduje, że kompilator nazwa i numer wersji kompilatora należy umieścić w pliku obiektu:

#pragma comment( compiler )

[!UWAGA]

Dla komentarze tego commentstring , parametr, można użyć makra w dowolnym miejscu, gdzie można użyć literału ciągu, pod warunkiem, że makro rozwija do literał ciągu znaków.Można także łączyć dowolną kombinację literały ciągów znaków i makra, które rozwija literały ciągów znaków.Na przykład poniższa instrukcja jest dopuszczalne:

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

Zobacz też

Informacje

Dyrektywy pragma i __Pragma słowa kluczowego