Share via

comment pragma

  • Artículo

Inserta un registro de comentario en un archivo objeto o ejecutable.

Sintaxis

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

Comentarios

El elemento comment-type es uno de los identificadores predefinidos (descrito más adelante) que especifica el tipo de registro del comentario. El elemento comment-string opcional es un literal de cadena que proporciona información adicional para algunos tipos de comentario. Dado que comment-string es un literal de cadena, obedece todas las reglas para los literales de cadena sobre el uso de caracteres de escape, comillas incrustadas (") y concatenación.

compiler

Coloca el nombre y número de versión del compilador en el archivo objeto. El vinculador no tiene en cuenta este registro de comentario. Si se proporciona un parámetro comment-string para este tipo de registro, el compilador genera una advertencia.

lib

Inserta un registro de búsqueda de biblioteca en el archivo objeto. Este tipo de comentario debe ir acompañado de un parámetro comment-string que tenga el nombre (y posiblemente la ruta de acceso) de la biblioteca que quiere que el enlazador busque. El nombre de la biblioteca sigue los registros predeterminados de búsqueda de biblioteca en el archivo objeto. El enlazador busca esta biblioteca igual que si la hubiera especificado en la línea de comandos, siempre y cuando la biblioteca no se especifique mediante /nodefaultlib. Puede colocar varios registros de búsqueda de biblioteca en el mismo archivo de origen. Cada registro aparece en el archivo objeto en el mismo orden en el que se encuentra en el archivo de origen.

Si el orden de la biblioteca predeterminada y una biblioteca agregada es importante, la compilación con el modificador /Zl evitará que el nombre de biblioteca predeterminado se sitúe en el módulo de objeto. Después, puede usarse una segunda directiva pragma de comentario para insertar el nombre de biblioteca predeterminada después de la biblioteca agregada. Las bibliotecas incluidas con estas directivas pragma aparecerán en el módulo de objeto en el mismo orden en que se encuentran en el código fuente.

vinculador

Coloca una opción del enlazador en el archivo objeto. Puede utilizar este tipo de comentario para especificar una opción del vinculador en lugar de pasarla a la línea de comandos o de especificarla en el entorno de desarrollo. Por ejemplo, puede especificar la opción /include para forzar la inclusión de un símbolo:

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

Solo las siguientes opciones del enlazador (comment-type) están disponibles para pasarlas al identificador del enlazador:

usuario

Coloca un comentario general en el archivo objeto. El parámetro comment-string contiene el texto del comentario. El vinculador no tiene en cuenta este registro de comentario.

Ejemplos

La siguiente directiva pragma hace que el enlazador busque la biblioteca EMAPI.LIB durante la vinculación. El enlazador busca primero en el directorio de trabajo actual y, luego, en la ruta de acceso especificada en la variable de entorno LIB.

#pragma comment( lib, "emapi" )

La directiva pragma siguiente hace que el compilador coloque el nombre y el número de versión del compilador en el archivo objeto:

#pragma comment( compiler )

Para los comentarios que toman un parámetro comment-string, se puede usar una macro en cualquier lugar donde usaría un literal de cadena, siempre y cuando la macro se expanda a un literal de cadena. También puede concatenar cualquier combinación de literales de cadena y macros que se expandan a literales de cadena. Por ejemplo, la siguiente instrucción es aceptable:

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

Consulte también

Directivas pragma y las palabras clave __pragma y _Pragma