/Yu (Použít předkompilovaný hlavičkový soubor)
Dá pokyn kompilátoru, chcete-li použít existující soubor předkompilované hlavičky (.pch) v aktuální kompilace.
/Yu[filename]
Arguments
- název souboru
Název souboru hlaviček, který je součástí zdrojového souboru pomocí #include direktivy preprocesoru.
Poznámky
Název souboru začlenění musí být stejné pro oba /Yc možnost, která vytvoří předkompilované hlavičky a všech dalších /Yu možnost použití předkompilovaných hlaviček.
Pro /Yc, filename Určuje bod, ve které předkompilace zastaví; Kompilátor však překompiluje celý kód filename a pojmenuje výsledné použití základní název souboru začlenění a rozšíření .pch předkompilované hlavičky.
.Pch soubor musí být vytvořen pomocí /Yc.
Kompilátor zpracovává veškerý kód vzniklé před .h soubor jako předkompilované.Přeskočí na právě mimo #include přidružené k souboru .h směrnice používá kód obsažený v souboru .pch a pak zkompiluje celý kód po filename.
Na příkazovém řádku je povolen bez mezery mezi /Yu a filename.
Při zadání /Yu musí obsahovat možnost bez názvu souboru zdrojový program #pragma hdrstop pragma, který určuje název souboru předkompilované hlavičky souboru .pch.V tomto případě kompilátor použije předkompilované hlavičky (soubor .pch), pojmenované podle /Fp (název souboru .Pch).Kompilátor přeskočí na umístění dané pragma, obnoví zkompilovaný od předkompilované hlavičky souboru určeného parametrem záhlaví pragma a pak zkompiluje pouze kód, který následuje záhlaví pragma.Pokud #pragma hdrstop neurčuje název souboru, bude kompilátor hledat soubor s názvem odvozené od základní název zdrojového souboru s příponou .pch.Můžete použít také /Fp možnost, chcete-li určit soubor různých .pch.
Zadáte-li /Yu možnost bez názvu souboru a nepodařilo se určit hdrstop pragma, je generována chybová zpráva a kompilace se nezdaří.
Pokud /Ycfilename a /Yufilename možnosti na stejném příkazovém řádku a obě odkazují na stejný název, /Ycfilename přednost předkompilace veškerý kód až do a včetně uvedeného souboru.Tato funkce zjednodušuje psaní makefiles.
Protože soubory obsahují informace o prostředí počítače a informací o programu na adrese paměti, používejte pouze soubor pch v počítači, kde byla vytvořena.
Další informace o předkompilovaných hlavičkách naleznete v následujících tématech:
Chcete-li nastavit tuto možnost kompilátoru ve vývojovém prostředí Visual Studio
Zadejte /Yc (Vytvořit předkompilovaný hlavičkový soubor) na cpp soubor ve vašem projektu.
Otevřete dialogové okno projektu Stránky vlastností.Další informace naleznete v tématu Postupy: Otevření stránek vlastností projektu.
Klikněte na složku C/C++.
Klepněte Předkompilované hlavičky stránky vlastností.
Změnit Vytvoření/použití PCH přes soubor vlastnost nebo Vytvoření/použití předkompilovaných hlaviček vlastnost.
Chcete-li tuto možnost kompilátoru nastavit v programu
- Více o tématu v PrecompiledHeaderThrough a UsePrecompiledHeader.
Příklady
Pokud následující kód:
#include <afxwin.h> // Include header for class library
#include "resource.h" // Include resource definitions
#include "myapp.h" // Include information specific to this app
...
je zkompilován z příkazového řádku CL /YuMYAPP.H PROG.CPP, kompilátor zpracovat tři obsahují příkazy, ale používá předkompilovaný kód z MYAPP.pch, a tím uložení času účastní předzpracování všechny tři soubory (a všech souborů, například).
Lze použít /Fp (název souboru .Pch) u možnosti /Yu lze zadat název souboru .pch, pokud se liší od buď argument názvu souboru na název /Yc nebo základní název zdrojového souboru, jako v následující:
CL /YuMYAPP.H /FpMYPCH.pch PROG.CPP
Tento příkaz určuje předkompilovaného souboru hlaviček s názvem MYPCH.pch.Kompilátor používá k obnovení stavu Předkompilované soubory hlaviček až do a včetně MYAPP.h jeho obsah.Kompilátor pak zkompiluje kód, k němuž dochází po MYAPP.h include prohlášení.