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

  • Artykuł

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

/Yc[filename]

Argumenty

  • filename
    Określa plik nagłówka (.h).Jeśli ten argument jest używany, kompilator kompiluje całego kodu, w tym pliku .h.

Uwagi

Gdy /Yc jest określona bez argumentu, kompilator kompiluje cały kod do końca pliku źródłowego podstawowej lub do punktu w pliku bazy gdzie hdrstop występuje.Wynikowy plik .pch ma taką samą nazwę podstawowego jako plik źródłowy podstawowej, chyba że określisz nazwę innego pliku za pomocą hdrstop pragma lub /Fp opcji.

Wstępnie skompilowana kod jest zapisywany w pliku o nazwie, utworzona na podstawie nazwy pliku podanego w /Yc opcji i rozszerzenie .pch.Można również użyć /Fp (Nazwa pliku .Pch) opcję, aby określić nazwę pliku nagłówka wstępnie skompilowana.

Jeśli używasz /Ycfilename, kompilator kompiluje cały kod do i włącznie z określonego pliku do użytku późniejszego z /Yu opcji.

Jeśli opcje /Ycfilename i /Yu (Korzystaj z prekompilowanego pliku nagłówka)filename występują w tym samym wierszu polecenia i obie odwołać lub oznacza taką samą nazwę, /Ycfilename ma pierwszeństwo.Ta funkcja ułatwia pisanie makefile.

Aby uzyskać więcej informacji w nagłówkach wstępnie skompilowanym zobacz:

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

  1. Wybierz plik programu CPP.Plik CPP musi #include plik .h zawierający informacje nagłówka wstępnie skompilowana.Projekt /Yc ustawienie można zastąpić na poziomie pliku.

  2. Otwórz okno dialogowe Strony właściwości projektu.Szczegółowe informacje – zobacz: Porady: otwieranie stron właściwości projektów.

  3. Kliknij folder C/C++.

  4. Kliknij przycisk Wstępnie skompilowana nagłówki strona właściwości.

  5. Modyfikowanie PCH poprzez tworzenie/Użyj pliku właściwość lub Utwórz/używać wstępnie skompilowana nagłówka właściwości.

Aby programowo ustawić tę opcję kompilatora

Przykład

Rozważmy następujący kod:

#include <afxwin.h>   // Include header for class library
#include "resource.h" // Include resource definitions
#include "myapp.h"    // Include information specific to this app
...

Kiedy ten kod jest skompilowany z poleceniem CL /YcMYAPP.H PROG.CPP, kompilator zapisuje wszystkie przerób dla AFXWIN.h, RESOURCE.h, i MYAPP.h w wstępnie skompilowanym nagłówka pliku o nazwie MYAPP.pch.

Zobacz też

Informacje

Opcje kompilatora

Ustawianie opcji kompilatora