/Yc (создать предварительно скомпилированный заголовочный файл)

Статья
10/12/2023

Указывает компилятору создать предварительно скомпилированный файл заголовка (PCH), представляющий состояние компиляции в определенной точке.

Синтаксис

/Yc
/Ycfilename

Аргументы

filename
Задает файл заголовка (H). При использовании этого аргумента компилятор компилирует весь код вплоть до H-файла.

Замечания

Если параметр /Yc указан без аргумента, компилятор компилирует весь код до конца базового исходного файла или до точки в базовом файле, где происходит директива hdrstop . Результирующий PCH-файл имеет то же базовое имя, что и базовый исходный файл, если не указать другое имя файла с помощью pragma hdrstop или параметра /Fp .

Предварительно скомпилированный код сохраняется в файле с именем, созданным из базового имени файла, указанного с параметром /Yc и расширением PCH. Вы также можете использовать /Fp (Name). Параметр Pch File) указывает имя предварительно скомпилированного файла заголовка.

Если используется имя файла /Yc, компилятор компилирует весь код до указанного файла и включает указанный файл для последующего использования с параметром /Yu (использовать предварительно скомпилированный файл заголовка).

Если параметры /Ycfilename и /Yufilename происходят в одной командной строке и как ссылке, либо подразумевают, то имя файла /Ycимеет приоритет. Эта функция упрощает написание файлов makefile.

Дополнительные сведения о предварительно скомпилированных заголовках см. в следующем разделе:

Установка данного параметра компилятора в среде разработки Visual Studio

Выберите файл .cpp. Файл .cpp должен #include H-файл, содержащий предварительно скомпилированные сведения о заголовке. Параметр /Yc проекта можно переопределить на уровне файла.
Откройте диалоговое окно Страницы свойств проекта. Подробнее см. в статье Настройка компилятора C++ и свойства сборки в Visual Studio.
Откройте страницу свойств конфигурации, C/C++, предварительно скомпилированные заголовки .
Измените свойство предварительно скомпилированного заголовка .
Чтобы задать имя файла, измените свойство предварительно скомпилированного файла заголовка.

Установка данного параметра компилятора программным способом

Ознакомьтесь с разделами PrecompiledHeaderThrough и UsePrecompiledHeader.

Пример

Рассмотрим следующий код:

// prog.cpp
// compile with: cl /c /Ycmyapp.h prog.cpp
#include <afxwin.h>   // Include header for class library
#include "resource.h" // Include resource definitions
#include "myapp.h"    // Include information specific to this app
// ...

При компиляции этого кода с помощью команды CL /YcMYAPP.H PROG.CPPкомпилятор сохраняет все препроцессы для AFXWIN.h, RESOURCE.h и MYAPP.h в предварительно скомпилированном файле заголовка с именем MYAPP.pch.

См. также

Параметры компилятора MSVC
Синтаксис командной строки компилятора MSVC
Файлы предварительно скомпилированных заголовков

Поделиться через