/Yc (Utwórz prekompilowany plik nagłówka)

  • Artykuł

Nakazuje kompilatorowi utworzenie wstępnie skompilowanego pliku nagłówka (pch), który reprezentuje stan kompilacji w pewnym momencie.

Składnia

/Yc
/Ycnazwa pliku

Argumenty

Pod nazwą
Określa plik nagłówka (h). Gdy ten argument jest używany, kompilator kompiluje cały kod do pliku h i dołącza go.

Uwagi

Gdy /Yc jest określony bez argumentu, kompilator kompiluje cały kod do końca pliku źródłowego podstawowego lub do punktu w pliku podstawowym, w którym występuje dyrektywa hdrstop . Wynikowy plik pch ma taką samą nazwę bazową jak plik źródłowy podstawowy, chyba że określisz inną nazwę pliku przy użyciu pragma hdrstop lub opcji /Fp .

Wstępnie skompilowany kod jest zapisywany w pliku o nazwie utworzonej na podstawie podstawowej nazwy pliku określonego za pomocą opcji /Yc i rozszerzenia pch. Można również użyć /Fp (nazwa . Opcja Pch File ( Plik Pch) umożliwiająca określenie nazwy prekompilowanego pliku nagłówka.

Jeśli używasz /Ycnazwy pliku, kompilator kompiluje cały kod do i dołącza określony plik do późniejszego użycia z /Yu (Użyj prekompilowanego pliku nagłówka) opcji.

Jeśli opcje /Ycnazwa pliku i /Yunazwa pliku występują w tym samym wierszu polecenia i oba odwołania lub implikują, taka sama nazwa pliku / Ycma pierwszeństwo. Ta funkcja upraszcza pisanie plików make.

Aby uzyskać więcej informacji na temat wstępnie skompilowanych nagłówków, zobacz:

Aby ustawić tę opcję kompilatora w środowisku programowania Visual Studio

  1. Wybierz plik cpp. Plik cpp musi #include pliku .h zawierającego wstępnie skompilowane informacje nagłówka. Ustawienie /Yc projektu można zastąpić na poziomie pliku.

  2. Otwórz okno dialogowe Strony właściwości projektu. Aby uzyskać szczegółowe informacje, zobacz Set C++ compiler and build properties in Visual Studio (Ustawianie właściwości kompilatora języka C++ i kompilowania w programie Visual Studio).

  3. Otwórz stronę właściwości Właściwości konfiguracji, C/C++, Prekompilowane nagłówki.

  4. Zmodyfikuj właściwość Prekompiled Header .

  5. Aby ustawić nazwę pliku, zmodyfikuj właściwość Prekompiled Header File .

Aby programowo ustawić tę opcję kompilatora

Przykład

Rozważ następujący kod:

// 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
// ...

Gdy ten kod jest kompilowany za pomocą polecenia CL /YcMYAPP.H PROG.CPP, kompilator zapisuje wszystkie wstępne przetwarzanie dla AFXWIN.h, RESOURCE.h i MYAPP.h w prekompilowanym pliku nagłówka o nazwie MYAPP.pch.

Zobacz też

Opcje kompilatora MSVC
Składnia wiersza polecenia kompilatora MSVC
Prekompilowane pliki nagłówka