Partilhar via


comment pragma

Coloca um registro de comentário em um arquivo de objeto ou arquivo executável.

Sintaxe

#pragma comment( tipo de comentário [ , "comment-string" ] )

Comentários

O de tipo de comentário é um dos identificadores predefinidos, descritos abaixo, que especifica o tipo de registro de comentário. O opcional comment-string é um literal de cadeia de caracteres que fornece informações adicionais para alguns tipos de comentários. Como de cadeia de comentários é um literal de cadeia de caracteres, ele obedece a todas as regras para literais de cadeia de caracteres no uso de caracteres de escape, aspas incorporadas (") e concatenação.

Compilador

Coloca o nome e o número da versão do compilador no arquivo de objeto. Esse registro de comentário é ignorado pelo vinculador. Se você fornecer um parâmetro de cadeia de comentários para esse tipo de registro, o compilador gerará um aviso.

Lib

Coloca um registro de pesquisa de biblioteca no arquivo de objeto. Esse tipo de comentário deve ser acompanhado por uma parâmetro de de cadeia de caracteres de comentário que tenha o nome (e possivelmente o caminho) da biblioteca que você deseja que o vinculador pesquise. O nome da biblioteca segue os registros padrão de pesquisa de biblioteca no arquivo de objeto. O vinculador procura essa biblioteca da mesma forma como se você a especificasse na linha de comando, desde que a biblioteca não seja especificada usando /nodefaultlib. Você pode colocar vários registros de pesquisa de biblioteca no mesmo arquivo de origem. Cada registro aparece no arquivo de objeto na mesma ordem em que é encontrado no arquivo de origem.

Se a ordem da biblioteca padrão e de uma biblioteca adicionada for importante, a compilação com a opção /Zl impedirá que o nome da biblioteca padrão seja colocado no módulo de objeto. Um segundo comentário pragma então pode ser usado para inserir o nome da biblioteca padrão após a biblioteca adicionada. As bibliotecas listadas com essas diretivas pragma aparecerão no módulo de objeto na mesma ordem em que são encontradas no código-fonte.

vinculador

Coloca uma opção de vinculador de no arquivo de objeto. Você pode usar esse tipo de comentário para especificar uma opção de vinculador em vez de passá-la para a linha de comando ou especificá-la no ambiente de desenvolvimento. Por exemplo, você pode especificar a opção /include para forçar a inclusão de um símbolo:

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

Somente as seguintes opções de vinculador (tipo comentário) estão disponíveis para serem passadas para o identificador do vinculador:

utilizador

Coloca um comentário geral no arquivo de objeto. O parâmetro comment-string contém o texto do comentário. Esse registro de comentário é ignorado pelo vinculador.

Exemplos

A pragma a seguir faz com que o vinculador procure o EMAPI. Biblioteca LIB durante a vinculação. O vinculador pesquisa primeiro no diretório de trabalho atual e, em seguida, no caminho especificado na variável de ambiente LIB.

#pragma comment( lib, "emapi" )

A seguinte pragma faz com que o compilador coloque o nome e o número da versão do compilador no arquivo de objeto:

#pragma comment( compiler )

Para comentários que usam um parâmetro de de cadeia de comentários, você pode usar uma macro em qualquer lugar onde usaria um literal de cadeia de caracteres, desde que a macro se expanda para um literal de cadeia de caracteres. Você também pode concatenar qualquer combinação de literais de cadeia de caracteres e macros que se expandem para literais de cadeia de caracteres. Por exemplo, a seguinte declaração é aceitável:

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

Ver também

diretivas Pragma e as palavras-chave __pragma e _Pragma