/YU (Użyj wstępnie skompilowana nagłówek pliku)
Nakazuje kompilatorowi użyć istniejącego pliku nagłówka wstępnie skompilowanym (.pch) w bieżącej kompilacji.
/Yu[filename]
Argumenty
- Nazwa pliku
Nazwa pliku nagłówka, który znajduje się przy użyciu pliku źródłowego #include dyrektywy preprocesora.
Uwagi
Nazwa pliku dołączanego musi być taka sama dla obu /Yc opcja, która tworzy prekompilowany nagłówek i wszystkie kolejne /Yu opcji użycia wstępnie skompilowana nagłówka wskazujący.
Dla /Yc, filename określa punkt, który zatrzymuje wstępnej kompilacji; Kompilator prekompiluje cały kod, chociaż filename i nazwy wynikowej nagłówka wstępnie skompilowane przy użyciu nazwa podstawowa pliku dołączanego i rozszerzenie .pch.
Plik .pch musi być utworzony przy użyciu /Yc.
Kompilator traktuje cały kod występujących przed plik .h jako wstępnie skompilowana.To przeskakuje do właśnie poza #include dyrektywy skojarzony plik .h używa kod zawarty w pliku .pch, a następnie kompiluje wszystkie kod po filename.
W wierszu polecenia bez spacji jest dozwolona pomiędzy /Yu i filename.
Podczas określania /Yu opcji bez nazwy pliku, program źródłowy musi zawierać hdrstop # pragma pragma, który określa nazwę pliku nagłówka wstępnie skompilowanym pliku .pch.W tym przypadku kompilator będzie używać wstępnie skompilowana nagłówka (plik .pch) o nazwie przez / Ol (nazwa.Plik pch).Kompilator przeskakuje do lokalizacji tego pragma, przywraca stan skompilowany z pliku wstępnie skompilowana nagłówek określony przez pragma i następnie kompiluje jedynie następujący kod pragma.Jeśli #pragma hdrstop nie określa nazwy pliku, kompilator szuka pliku o nazwie, pochodzące z nazwa podstawowa pliku źródłowego z rozszerzeniem .pch.Można również użyć /Fp opcję, aby określić plik różnych .pch.
Jeśli określisz /Yu opcję bez nazwy pliku i nie można określić hdrstop pragma, generowany jest komunikat o błędzie i kompilacji kończy się niepowodzeniem.
Jeśli /Ycfilename i /Yufilename opcje występują w tym samym wierszu polecenia, a następnie odwołać zarówno samą nazwę pliku /Ycfilename ma pierwszeństwo przed autorski, ale także cały kod do i włącznie z nazwanym plikiem.Ta funkcja ułatwia zapisywanie Makefile.
Ponieważ pliki .pch zawierają informacje o środowisku komputera, jak również informacji dotyczących programu adresu pamięci, należy używać tylko plik pch na komputerze, w którym została utworzona.
Aby uzyskać więcej informacji na wstępnie skompilowana nagłówki zobacz:
Aby ustawić tę opcję kompilatora w środowisku projektowym programu Visual Studio
Określ /Yc (Tworzenie wstępnie skompilowanym pliku nagłówka) w pliku .cpp w projekcie.
Otwórz projekt Stron właściwości okno dialogowe.Aby uzyskać szczegółowe informacje, zobacz Jak: Otwórz strony właściwości projektu.
Kliknij przycisk C i C++ folder.
Kliknij przycisk Wstępnie skompilowana nagłówki stronę właściwości.
Modyfikowanie Tworzenie/Użyj PCH za pośrednictwem pliku właściwość lub Wyk Utwórz wstępnie skompilowana nagłówka właściwości.
Aby programowo ustawić tę opcję kompilatora
Przykłady
Jeśli 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
...
została skompilowana z wiersza polecenia CL /YuMYAPP.H PROG.CPP, kompilator nie może przetwarzać trzy obejmują instrukcje, ale kod zastosowań wstępnie skompilowana z MYAPP.pch, a tym samym oszczędności czasu zaangażowanych w wstępnego przetwarzania wszystkie trzy pliki (i wszystkie pliki, mogą one obejmować).
Można użyć / Ol (nazwa.Plik pch) opcji z /Yu opcję, aby określić nazwę pliku .pch, jeśli nazwa różni się od albo argument nazwy pliku do /Yc lub nazwa podstawowa pliku źródłowego, jak w następującym:
CL /YuMYAPP.H /FpMYPCH.pch PROG.CPP
Polecenie to określa nagłówek wstępnie skompilowanym pliku o nazwie MYPCH.pch.Kompilator używa jego zawartość do przywrócenia stanu wstępnie skompilowana wszystkie pliki nagłówków do i włącznie z MYAPP.h.Kompilator kompiluje następnie kod, który występuje po MYAPP.h include instrukcji.