komentarz (C/C++)
Umieszcza rekord komentarza w pliku obiektu lub pliku wykonywalnym.
#pragma comment( comment-type [,"commentstring"] )
Uwagi
Typ komentarza jest jednym ze wstępnie zdefiniowanych identyfikatorów, opisanych poniżej, który określa typ rekordu komentarza.Opcjonalny commentstring to literał w postaci ciągu, który zawiera dodatkowe informacje dla niektórych typów komentarza.Ponieważ commentstring jest literałem w postaci ciągu, przestrzega zasady literałów w postaci ciągu, w odniesieniu do znaków ucieczki, osadzonych cudzysłowów (") i łączenia.
compiler
Umieszcza nazwę i numer wersji kompilatora w pliku obiektu.Ten rekord komentarza jest ignorowany przez konsolidator.Jeśli zostanie podany parametr commentstring dla tego typu rekordu, kompilator generuje ostrzeżenie.exestr
Umieszcza commentstring w pliku obiektu.W czasie łączenia ciąg zostanie umieszczony w pliku wykonywalnym.Ciąg nie zostanie załadowany do pamięci podczas ładowania pliku wykonywalnego; jednak można go odnaleźć za pomocą programu, który znajduje ciągi możliwe do wydrukowania w plikach.Jednym z zastosowań dla tego typu rekordu komentarza jest osadzenie numeru wersji lub podobnych informacji w pliku wykonywalnym.exestr jest przestarzałe i zostanie usunięte w przyszłej wersji; konsolidator nie będzie przetwarzać rekordu komentarza.
lib
Umieszcza rekord wyszukiwania w bibliotece w pliku obiektu.Temu typowi komentarza musi towarzyszyć parametr commentstring zawierający nazwę (i ewentualnie ścieżkę) biblioteki, którą ma przeszukać konsolidator.Nazwa biblioteki pochodzi z domyślnych rekordów wyszukiwania w bibliotece; konsolidator przeszukuje tę bibliotekę, tak jak gdyby jej nazwa została podana w wierszu polecenia pod warunkiem, że nie określono biblioteki z parametrem /nodefaultlib.W tym samym pliku z kodem źródłowym można umieścić wiele rekordów wyszukiwania w bibliotece; każdy rekord pojawi się w pliku obiektu w tej samej kolejności w której został umieszczony w pliku z kodem źródłowym.Jeśli ważna jest kolejność domyślnej biblioteki i biblioteki dodanej, należy kompilacja z przełącznikiem /Zl uniemożliwi umieszczenie domyślnej nazwy biblioteki w module obiektu.Druga dyrektywa komentarza może zostać użyta do wstawienia nazwy domyślnej biblioteki po dodanej bibliotece.Biblioteki wymienione z tą dyrektywą pojawią się w module obiektu w tej samej kolejności, w której zostaną znalezione w kodzie źródłowym.
linker
Umieszcza opcję konsolidatora w pliku obiektu.Typ komentarza służy do określania opcji konsolidatora zamiast przekazywania jej w wierszu polecenia lub określania w środowisku programistycznym.Na przykład, można określić opcję /include, aby wymusić włączenie symbolu:#pragma comment(linker, "/include:__mySymbol")Do identyfikatora konsolidatora można przekazywać jedynie następujące opcje konsolidatora (typ komentarza):
user
Umieszcza ogólny komentarz w pliku obiektu.Parametr commentstring zawiera tekst komentarza.Ten rekord komentarza jest ignorowany przez konsolidator.
Następujące dyrektywy powodują wyszukiwanie biblioteki EMAPI.LIB przez konsolidator podczas łączenia.Konsolidator najpierw wyszukuje w bieżącym katalogu roboczym, a następnie w ścieżce określonej w zmiennej środowiskowej LIB.
#pragma comment( lib, "emapi" )
Następująca dyrektywa powoduje umieszczenie nazwy i numeru wersji przez kompilator w pliku obiektu:
#pragma comment( compiler )
[!UWAGA]
Dla komentarzy przyjmujących parametr commentstring, można użyć makra w każdym miejscu, gdzie można użyć literału ciągu, pod warunkiem, że makro rozwija zmienną do literału ciągu znaków.Można również łączyć dowolną kombinację literałów ciągów i makr, które rozwijają zmienną do literału ciągów znaków.Na przykład następująca instrukcja jest do przyjęcia:
#pragma comment( user, "Compiled on " __DATE__ " at " __TIME__ )