/headerName
(Создание единицы заголовка из указанного заголовка)
Создайте указанный файл заголовка в единицу заголовка (.ifc
файл).
Синтаксис
/headerName:quote
header-filename
/headerName:angle
header-filename
Аргументы
header-filename
Имя файла заголовка, который компилятор должен скомпилировать в единицу заголовка (.ifc
файл).
Замечания
/headerName:angle
Параметры /headerName:quote
компилятора доступны начиная с Visual Studio 2019 версии 16.10.
Параметры /headerName
компилятора во всех их формах требуют /std:c++20
или более поздней версии параметра компилятора (например /std:c++latest
).
Если указать /headerName
параметр, необходимо также указать /exportHeader
.
/headerName:quote
header-filename
ищет те же правила, что#include "header-filename"
и создает его как блок заголовка (.ifc
файл)./headerName:angle
header-filename
ищет те же правила, что#include <header-filename>
и создает его как блок заголовка (.ifc
файл).
Дополнительные сведения о правилах поиска пути для включенных файлов в кавычки или угловые скобки см#include
. в директиве.
Примеры
Учитывая проект, ссылающийся на файл заголовка, который он определяет, параметр компилятора для компиляции его в блок заголовков m.h
выглядит примерно так:
cl /std:c++latest /exportHeader /headerName:quote m.h /Fom.h.obj
/headerName:angle
Параметры /headerName:quote
действуют как флаг и не нуждаются в аргументе. Ниже приведены допустимые примеры.
cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm
cl /std:c++latest /exportHeader /headerName:quote /MP /Fo.\ my-utilities.h a/b/my-core.h
Можно указать несколько /headerName
параметров в одной командной строке. Каждый аргумент после /headerName
обработки параметра с указанными правилами подстановки файлов для кавычек или угловых квадратных скобок до следующего /headerName
параметра. В следующем примере все заголовки обрабатываются так же, как и в предыдущих двух примерах командной строки. Он ищет заголовки с помощью правил подстановки, применяемых, как если бы они были указаны как: #include <vector>
, , #include <iostream>
, #include <algorithm>
#include "my-utilties.h"
и #include "a/b/my-core.h"
:
cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm /headerName:quote my-utilities.h a/b/my-core.h
Установка данного параметра компилятора в среде разработки Visual Studio
Примечание.
Обычно этот параметр не следует задавать в среде разработки Visual Studio. Он устанавливается системой сборки.
Откройте диалоговое окно Страницы свойств проекта. Подробнее см. в статье Настройка компилятора C++ и свойства сборки в Visual Studio.
Установите раскрывающийся список "Конфигурация" для всех конфигураций. В раскрывающемся списке Платформа выберите пункт Все платформы.
Перейдите на страницу свойств Свойства конфигурации>C/C++>Командная строка.
Измените свойство "Дополнительные параметры", чтобы добавить или
/headerName:angle
параметры/headerName:quote
и имена заголовков, к которые применяются параметры. Затем нажмите кнопку "ОК" или "Применить", чтобы сохранить изменения.
См. также
/exportHeader
(создание единиц заголовков)
/headerUnit
(использование IFC для единицы заголовка)
/reference
(использование IFC для именованного модуля)
/translateInclude
(преобразование директив include в директивы import)