comment
pragma
Coloca um registro de comentário em um arquivo de objeto ou executável.
Sintaxe
#pragma comment(
tipo de comentário [,
"cadeia de caracteres de comentário" ])
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__ )