/Yc (Utwórz prekompilowany plik nagłówka)
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
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.
Otwórz okno dialogowe Strony właściwości projektu.Szczegółowe informacje – zobacz: Porady: otwieranie stron właściwości projektów.
Kliknij folder C/C++.
Kliknij przycisk Wstępnie skompilowana nagłówki strona właściwości.
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
- Zobacz PrecompiledHeaderThrough i UsePrecompiledHeader.
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.