comment pragma

Umieszcza rekord komentarza w pliku obiektu lub pliku wykonywalnym.

Składnia

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

Uwagi

Typ komentarza jest jednym ze wstępnie zdefiniowanych identyfikatorów opisanych poniżej, który określa typ rekordu komentarza. Opcjonalny ciąg komentarza to literał ciągu, który udostępnia dodatkowe informacje dla niektórych typów komentarzy. Ponieważ ciąg-komentarz jest literałem ciągu, przestrzega wszystkich reguł literałów ciągów w zakresie używania znaków ucieczki, osadzonych cudzysłowów (") i łączenia.

— kompilator

Umieszcza nazwę i numer wersji kompilatora w pliku obiektu. Ten rekord komentarza jest ignorowany przez konsolidator. Jeśli podasz parametr ciągu komentarza dla tego typu rekordu, kompilator generuje ostrzeżenie.

Lib

Umieszcza rekord wyszukiwania biblioteki w pliku obiektu. Ten typ komentarza musi być dołączony przez parametr ciągu komentarza, który ma nazwę (i ewentualnie ścieżkę) biblioteki, którą chcesz wyszukać w konsolidatorze. Nazwa biblioteki jest zgodna z domyślnymi rekordami wyszukiwania biblioteki w pliku obiektu. Konsolidator wyszukuje tę bibliotekę w taki sam sposób, jak w przypadku określenia jej w wierszu polecenia, o ile biblioteka nie jest określona przy użyciu polecenia /nodefaultlib. W tym samym pliku źródłowym można umieścić wiele rekordów wyszukiwania biblioteki. Każdy rekord jest wyświetlany w pliku obiektu w tej samej kolejności, w których znajduje się w pliku źródłowym.

Jeśli kolejność biblioteki domyślnej i dodanej biblioteki jest ważna, kompilowanie z /Zl przełącznikiem uniemożliwi umieszczenie domyślnej nazwy biblioteki w module obiektu. Następnie drugi komentarz pragma może służyć do wstawiania nazwy biblioteki domyślnej po dodaniu biblioteki. Biblioteki wymienione za pomocą tych pragma dyrektyw będą wyświetlane w module obiektu w tej samej kolejności, w której znajdują się w kodzie źródłowym.

konsolidator

Umieszcza opcję konsolidatora w pliku obiektu. Tego typu komentarza można użyć do określenia opcji konsolidatora zamiast przekazywania jej do wiersza polecenia lub określania go w środowisku dewelopera. Można na przykład określić /include opcję wymuszenia włączenia symbolu:

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

Do identyfikatora konsolidatora konsolidatora dostępne są tylko następujące opcje konsolidatora (typ komentarza):

• /DEFAULTLIB

• /EXPORT

• /INCLUDE

• /MANIFESTDEPENDENCY

• /MERGE

• /SECTION

użytkownik

Umieszcza ogólny komentarz w pliku obiektu. Parametr comment-string zawiera tekst komentarza. Ten rekord komentarza jest ignorowany przez konsolidator.

Przykłady

pragma Poniżej przedstawiono przyczynę wyszukiwania konsolidatora EMAPI. Biblioteka LIB podczas łączenia. Konsolidator wyszukuje najpierw w bieżącym katalogu roboczym, a następnie w ścieżce określonej w zmiennej środowiskowej LIB.

#pragma comment( lib, "emapi" )

pragma Następujące przyczyny powoduje, że kompilator umieszcza nazwę i numer wersji kompilatora w pliku obiektu:

#pragma comment( compiler )

W przypadku komentarzy, które przyjmują parametr ciągu komentarza, można użyć makra w dowolnym miejscu, w którym można użyć literału ciągu, o ile makro rozszerza się do literału ciągu. Można również połączyć dowolną kombinację literałów ciągów i makr, które rozszerzają się na literały ciągu. Na przykład następująca instrukcja jest akceptowalna:

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

Zobacz też

Dyrektywy Pragma i __pragma słowa kluczowe i _Pragma