comment (C/C++)

Задает запись примечаний в объектный файл или исполняемый файл.

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

Заметки

комментарий-тип один из стандартных идентификаторов, описанных ниже, которое указывает тип записи комментариев.Необязательно commentstring строковый литерал, который предоставляет дополнительные сведения для некоторых типов комментария.Поскольку commentstring строковый литерал, он повинуется всем правилам для строковых литералов по отношению к escape-символ, внедренные кавычки («), и соединения.

• компилятор
  Задает имя и номер версии компилятора в объектном файле.Эта запись комментария не учитывается компоновщиком.Если указать a commentstring параметр для данного типа записей, компилятор выдает предупреждение.

• exestr
  десятичных разрядов commentstring в объектном файле.Во время соединения эта строка помещается в исполняемом файле.Строка не будет загружена в память при загрузке исполняемый файл; тем не менее, можно найти с помощью программы, которая находит непечатаемым строки в файлах.Одна использование для данного типа комментарий-записи внедрить номер версии или аналогичное сведения в исполняемом файле.

  exestr нерекомендуемый, а также в будущей версии; компоновщик не рассматривает запись комментария.

• lib
  Задает запись библиотека-поиска в объектном файле.Этот тип должен быть сопровождается a comment commentstring параметр, содержащий имя (и, возможно, путь) библиотеки, что компоновщик поиск.Имя библиотеки по умолчанию библиотека-поиска за записями в объектном файле; компоновщик выполняет поиск этой библиотеки как в случае с именем его в командной строке при условии, что библиотека не определена с /nodefaultlib.Можно установить несколько записей библиотека-поиска в том же файле источника. каждая запись появилась в объектный файл в том же порядке, в котором она обнаружена в файле источника.

  Если порядок библиотеки по умолчанию и добавленной библиотеки важен, то с компилирующ /Zl параметр приведет к тому, что имя библиотеки по умолчанию из располагаться в модуле объекта.Вторую директивы pragma comment затем можно использовать для вставки имя библиотеки по умолчанию после добавленной библиотеки.Библиотеки с этими прагмами, перечисленные в предметный модуль в том же порядке, в котором они расположены в исходном коде.

• компоновщик
  устанавливает a параметр компоновщика в объектном файле.Можно использовать этот комментарий-тип для указания параметра компоновщика вместо передачи его в командной строке, либо указав ее в интегрированной среде разработки.Например, можно указать параметр /include обеспечить включение символов:

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

  (Только следующие действиякомментарий-типпараметры компоновщика) доступны по идентификатору компоновщика:

  • /DEFAULTLIB

  • /EXPORT

  • /INCLUDE

  • /MANIFESTDEPENDENCY

  • /MERGE

  • /SECTION

• пользователь
  Задает общий комментарий в объектном файле.commentstring параметр содержащая текст комментария.Эта запись комментария не учитывается компоновщиком.

Следующая директива pragma вызывает компоновщик поиск библиотеки EMAPI.LIB при компоновке.Поиск компоновщика сначала в рабочей папке, а затем в пути, указанном в переменной среды LIB.

#pragma comment( lib, "emapi" )

Следующая директива pragma указывает компилятору задать имя и номер версии компилятора в объектном файле:

#pragma comment( compiler )

Примечание
Для комментариев, которые принимают a commentstring параметр можно использовать в любом месте, где можно использовать строковый литерал, при условии, что макрос развернуть к строковому литералу.Также можно сцепить все строковые литералы и макросы сочетание, развернут в строковые литералы.Например, следующий оператор приемлема:

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

См. также

Ссылки

Директивы pragma и ключевое слово __Pragma