Sdílet prostřednictvím

/Yl (Vložit referenci PCH do ladicí knihovny)

  • Článek

Možnost /Yl vygeneruje jedinečný symbol v předkompilovaném souboru hlavičky a odkaz na tento symbol se vloží do všech souborů objektů, které používají předkompilovanou hlavičku.

Syntaxe

/Yl
/Ylname
/Yl-

Argumenty

Jméno
Volitelný název použitý jako součást jedinečného symbolu.

-
Pomlčka (-) explicitně zakáže možnost kompilátoru /Yl .

Poznámky

Možnost kompilátoru /Yl vytvoří jedinečnou definici symbolu v předkompilovaném souboru hlaviček vytvořeném pomocí možnosti /Yc . Odkazy na tento symbol se automaticky vloží do všech souborů, které obsahují předkompilované záhlaví pomocí možnosti kompilátoru /Yu . Možnost /Yl je ve výchozím nastavení povolena, pokud se k vytvoření předkompilovaného hlavičkového souboru použije /Yc .

Možnost /Ylname se používá k vytvoření identifikovatelného symbolu v předkompilovaného souboru hlaviček. Kompilátor používá argument názvu jako součást názvu dekorovaného symbolu, který vytvoří, podobně jako __@@_PchSym_@00@...@nametři tečky (...) představuje jedinečný řetězec znaků vygenerovaný kompilátorem. Pokud argument názvu vynecháte, kompilátor automaticky vygeneruje název symbolu. Za normálních okolností nemusíte znát název symbolu. Pokud však váš projekt používá více než jeden předkompilovaný hlavičkový soubor, může být možnost /Ylname užitečná k určení, které soubory objektů používají předkompilovanou hlavičku. Název můžete použít jako hledaný řetězec k vyhledání odkazu na symbol v souboru s výpisem paměti.

/Yl- zakáže výchozí chování a nevloží do předkompilovaného hlavičkového souboru identifikační symbol. Kompilované soubory, které obsahují tuto předkompilovanou hlavičku, nemají společný odkaz na symboly.

Pokud není zadán parametr /Yc , nemá žádná možnost /Yl žádný vliv, ale pokud je zadaná, musí odpovídat jakékoli možnosti /Yl předané při zadání /Yc .

Pokud používáte možnosti /Yl-, /Yc a /Z7 k sestavení předkompilovaného hlavičkového souboru, informace o ladění jsou uloženy v souboru objektu pro zdrojový soubor použitý k vytvoření předkompilované hlavičky, a ne do samostatného souboru .pdb. Pokud je tento soubor objektu pak součástí knihovny, LNK1211 chyby nebo LNK4206 upozornění mohou nastat v buildech, které používají tuto knihovnu, a předkompilovaný hlavičkový soubor, pokud zdrojový soubor použitý k vytvoření předkompilovaného souboru hlaviček nedefinuje žádné symboly samotné. Linker může vyloučit soubor objektu z odkazu spolu s přidruženými informacemi o ladění, pokud v klientovi knihovny není odkazováno na nic v souboru objektu. Chcete-li tento problém vyřešit, zadejte /Yl (nebo odeberte možnost /Yl- při použití /Yc k vytvoření předkompilovaného hlavičkového souboru. Tím se zajistí, že se soubor objektu z knihovny, která obsahuje informace o ladění, propojil v sestavení.

Další informace o předkompilovaných hlavičkách najdete tady:

Nastavení tohoto parametru kompilátoru ve vývojovém prostředí Visual Studio

  1. Otevřete dialogové okno Stránky vlastností projektu. Podrobnosti najdete v tématu Nastavení kompilátoru C++ a vlastností sestavení v sadě Visual Studio.

  2. Vyberte stránku vlastností příkazového řádku C/C++>Vlastnosti>konfigurace.

  3. Do pole Další možnosti přidejte možnost kompilátoru /Ylname. Kliknutím na OK uložte provedené změny.

Programové nastavení tohoto parametru kompilátoru

Viz také

Parametry kompilátoru MSVC
Syntaxe příkazového řádku kompilátoru MSVC