comment pragma

  • Artigo

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

Sintaxe

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

Comentários

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

compiler

Coloque 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 comment-string 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 um parâmetro comment-string que tem o nome (e possivelmente o caminho) da biblioteca que você deseja que o vinculador pesquise. O nome da biblioteca segue os registros de pesquisa de biblioteca padrão no arquivo de objeto. O vinculador pesquisa essa biblioteca da mesma maneira que se você a tivesse especificado 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 uma biblioteca adicionada for importante, compilar com a opção/Zl evitará que o nome da biblioteca padrão seja colocado no módulo de objeto. Um segundo comentário pragma 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 que são localizadas no código-fonte.

vinculador

Coloca uma opção de vinculador 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 de especificá-la na 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")

Apenas as seguintes opções de vinculador (comment-type) estão disponíveis para ser passadas para o identificador do vinculador:

usuário

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

O seguinte pragma faz com que o vinculador procure pela biblioteca EMAPI.LIB na vinculação. O vinculador procura primeiro no diretório de trabalho atual e depois no caminho especificado na variável de ambiente LIB.

#pragma comment( lib, "emapi" )

O 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 os comentários que possuem um parâmetro comment-string, você pode usar uma macro em qualquer local onde você usaria um literal de cadeia de caracteres, desde que a macro expanda-se 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 cadeias de caracteres. Por exemplo, a seguinte instrução é aceitável:

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

Confira também

Diretivas do Pragma e as palavras-chave do __pragma e _Pragma