comment (C/C++)

将注释记录为对象文件或可执行文件。

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

备注

注释类型 是某个预定义的标识符，下述，指定注释记录的类型。选项 commentstring 是为这些注释类型提供附加信息的字符串。由于 commentstring 是字符串，它遵循字符串的所有规则有关转义字符、嵌入的引号 (“) 和串联。

• 编译器
  在对象文件将编译器的名称和版本号。此注释记录由链接器忽略。如果提供此记录类型的一个 commentstring 参数，编译器会生成警告。

• exestr
  在对象文件放置 commentstring 。在链接时该字符串在可执行文件放置。，在可执行文件加载时，该字符串不加载到内存;但是，可以找到具有查看文件的可打印的字符串的过程。此注释记录类型的一个用途是嵌入版本号或类似的信息在可执行文件。

  exestr 已弃用，并将从未来版本中;链接器未处理注释记录。

• lib
  在对象文件放置库搜索记录。必须由包含名称 (可能路径) 库的 commentstring 参数与该注释类型需要链接器搜索。库名遵循在对象文件的默认库中搜索日志;链接器搜索该库，就象命名为在命令行上，在库未指定与 /nodefaultlib条件下。可以在同一个源文件可以将多个库搜索日志;每个记录显示在对象文件按其在源文件遇到的顺序。

  如果默认库和已添加的库的顺序很重要，编译 /Zl 切换到对象模块将阻止默认库名称放置。第二个注释杂注可将用于插入默认库的名称在添加的库之后。它们在源代码中找到的库列出了与这些说明将出现在对象模块的顺序。

• 链接器
  在对象文件放置 链接器选项 。可以使用注释类型的此指定链接器选项而不是传递到命令行或指定它在开发环境中。例如，可以指定 /include 选项强制符号包括:

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

  只有以下注释(类型的) 链接器选项可用传递给链接器标识符:

  • /DEFAULTLIB

  • /EXPORT

  • /INCLUDE

  • /MANIFESTDEPENDENCY

  • /MERGE

  • /SECTION

• User — 用户
  在对象文件中放置一个通常批注。commentstring 参数包含注释的文本。此注释记录由链接器忽略。

以下说明导致链接器搜索 EMAPI.LIB 库，在链接时。链接器搜索首先在当前工作目录然后在 LIB 环境变量指定的路径。

#pragma comment( lib, "emapi" )

以下说明在对象文件导致编译器将编译器的名称和版本号:

#pragma comment( compiler )

说明
为接受 commentstring 参数的注释，您可以在中使用字符串的所有位置使用宏，，在宏扩展到字符串的条件下。还可以连接的字符串和宏的任意组合扩展为字符串。例如，下面的语句可接受:

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

请参见

参考

杂注指令和__Pragma关键字