/YU (použití kompilovaných hlavičky souboru)
Pokyn použít existující soubor předkompilovaný záhlaví (.pch) v aktuální kompilace kompilátoru.
/Yu[filename]
Arguments
- název_souboru
Název záhlaví souboru, který je součástí zdrojového souboru pomocí #include direktivu preprocesoru.
Poznámky
Název souboru začlenění musí být stejné pro oba /Yc možnost, která vytvoří předkompilovaný záhlaví a všechny následné /Yu možnost označující použití kompilovaných záhlaví.
Pro /Yc, filename Určuje bod, ve které precompilation zastaví; Kompilátor však precompiles veškerý kód filename a názvy výsledné předkompilovaný záhlaví pomocí základní název souboru začlenění a rozšíření .pch.
.Pch soubor musí být vytvořen pomocí /Yc.
Kompilátor zpracovává veškerý kód vzniklé před souboru soubor s příponou h jako předkompilovaný.Přeskočí na právě mimo #include přidružené k souboru soubor s příponou h směrnice používá kód obsažený v souboru .pch a potom kompiluje všechen kód po filename.
Na příkazovém řádku je povolen bez mezery mezi /Yu a filename.
Při zadávání /Yu musí obsahovat možnost bez názvu souboru zdrojový program hdrstop # pragma pragma, který určuje název souboru předkompilovaný hlavičky souboru .pch.V takovém případě použije kompilátor předkompilovaný názvem záhlaví (soubor .pch) /FP (název.Soubor pch).Kompilátor přeskočí umístění dané pragma obnoví zkompilovaném stavu ze souboru předkompilovaný záhlaví pragma určené a potom kompiluje pouze kód, který následuje pragma.Pokud #pragma hdrstop neurčuje název souboru, kompilátor hledá soubor s názvem odvozené od základní název zdrojového souboru s příponou .pch.Můžete také použít /Fp možnost určit soubor různých .pch.
Pokud zadáte /Yu možnost bez názvu souboru a určit selhání hdrstop pragma, je vygenerována chybová zpráva a kompilace se nezdaří.
Pokud /Ycfilename a /Yufilename možnosti na stejný příkazový řádek a jak odkazovat na stejný název souboru /Ycfilename přednost precompiling veškerý kód do a včetně pojmenovaný soubor.Tato funkce zjednodušuje zápis makefiles.
Protože .pch soubory obsahují informace o prostředí počítače, stejně jako paměť adresa informace o programu, používejte pouze soubor pch v počítači, kde byla vytvořena.
Další informace o záhlaví předkompilovaný naleznete:
Chcete-li nastavit tuto možnost kompilátoru ve vývojovém prostředí Visual Studio
Určit /Yc (vytvořit soubor předkompilovaný záhlaví) na cpp souboru v projektu.
Otevřete dialogové okno projektu Stránky vlastností.Další informace naleznete v tématu Jak: otevření stránky vlastností projektu.
Klepněte C/C++ složky.
Klepněte Předkompilována záhlaví stránky vlastností.
Změnit Vytvořit na použití PCH prostřednictvím souboru vlastnost nebo Záhlaví předkompilována vytvořit na použití vlastnost.
Programově nastavit tuto volbu kompilátoru
- 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 dodržováno příkazového řádku CL /YuMYAPP.H PROG.CPP, kompilátor zpracovat tři zahrnují příkazy, ale používá předkompilována kód z MYAPP.pch, a tím ukládání času v úpravě před zpracováním všechny tři soubory (a všechny soubory, například).
Můžete použít /FP (název.Soubor pch) možnost se /Yu možnost určit název souboru .pch, pokud je odlišné od buď argument názvu souboru na název /Yc nebo základní název zdrojového souboru, jako v následujícím:
CL /YuMYAPP.H /FpMYPCH.pch PROG.CPP
Tento příkaz určuje předkompilovaný záhlaví souboru s názvem MYPCH.pch.Kompilátor používá obnovení předkompilovaný stavu všech záhlaví souborů do a včetně MYAPP.h jeho obsah.Kompilátor pak kompiluje kód, po MYAPP.h include prohlášení.