/Yu (Usar arquivo de cabeçalho pré-compilado)

Instrui o compilador a usar um arquivo de cabeçalho pré-compilado ( .pch ) existente na compilação atual.

Syntax

/Yu[nome do arquivo]

Argumentos

filename
O nome de um arquivo de cabeçalho, que é incluído no arquivo de origem usando uma diretiva de #include pré-processador.

Comentários

O nome do arquivo de inclusão deve ser o mesmo para a /Yc opção que cria o cabeçalho pré-compilado e para qualquer opção posterior /Yu que indica o uso do cabeçalho pré-compilado.

Para /Yc , filename especifica o ponto em que a pré-compilação é interrompida; o compilador pré-compila todos os códigos, embora o nome do arquivo, e nomeia o cabeçalho pré-compilado resultante usando o nome de base do arquivo de inclusão e uma extensão do .pch .

O .pch arquivo deve ter sido criado usando /Yc .

O compilador trata todo o código que ocorre antes do arquivo. h como pré-compilado. Ele ignora apenas além da diretiva associada .h ao arquivo, usa o código contido no arquivo e, em seguida, compila todo o código após o #includenomedo .pch arquivo.

Na linha de comando, nenhum espaço é permitido entre /Yu e filename.

Quando você especifica a /Yu opção sem um nome de arquivo, o programa de origem deve conter um #pragma hdrstop pragma que especifica o nome do arquivo do cabeçalho pré-compilado, .pch arquivo. Nesse caso, o compilador usará o cabeçalho pré-compilado ( .pch arquivo) nomeado por /Fp (Name .pch file) . O compilador pula para o local desse pragma e restaura o estado compilado do arquivo de cabeçalho pré-compilado especificado. Em seguida, ele compila apenas o código que segue o pragma. Se #pragma hdrstop o não especificar um nome de arquivo, o compilador procurará um arquivo com um nome derivado do nome base do arquivo de origem com uma .pch extensão. Você também pode usar a /Fp opção para especificar um arquivo diferente .pch .

Se você especificar a /Yu opção sem um nome de arquivo e falhar ao especificar um hdrstop pragma, uma mensagem de erro será gerada e a compilação não será bem-sucedida.

Se as /Yc opções filename e /Yufilename ocorrerem na mesma linha de comando e fizerem referência ao mesmo nome de arquivo, /Ycfilename terá precedência, Precompilando todo o código até e incluindo o arquivo nomeado. Esse recurso simplifica a gravação de makefiles.

Como .pch os arquivos contêm informações sobre o ambiente de computador e as informações de endereço de memória sobre o programa, você deve usar apenas um .pch arquivo no computador em que ele foi criado.

Para obter mais informações sobre cabeçalhos pré-compilados, consulte:

Para definir esta opção do compilador no ambiente de desenvolvimento do Visual Studio

  1. Especifique /Yc (criar arquivo de cabeçalho pré-compilado) em um arquivo. cpp em seu projeto.

  2. Abra a caixa de diálogo Páginas de Propriedades do projeto. Para obter detalhes, confira Definir as propriedades de build e do compilador do C++ no Visual Studio.

  3. Selecione a página de propriedade decabeçalhos pré-compilados de Propriedades> de configuraçãoC/C++> .

  4. Modifique a propriedade de cabeçalho pré-compilada , a propriedade Criar/usar PCH por arquivo ou a propriedade Criar/usar cabeçalho pré-compilado .

Para definir essa opção do compilador via programação

Exemplo

Se o código a seguir:

#include <afxwin.h>   // Include header for class library
#include "resource.h" // Include resource definitions
#include "myapp.h"    // Include information specific to this app
...

é compilado usando a linha CL /YuMYAPP.H PROG.CPP de comando, o compilador não processa as três instruções include. Em vez disso, ele usa código pré-compilado do MYAPP.pch , que economiza o tempo envolvido no pré-processamento de todos os três arquivos (e quaisquer arquivos que possam incluir).

Você pode usar a /Fp (Name .pch file) opção com a /Yu opção de especificar o nome do .pch arquivo se o nome for diferente do argumento /Ycfilename ou do nome base do arquivo de origem, como no exemplo a seguir:

CL /YuMYAPP.H /FpMYPCH.pch PROG.CPP

Este comando especifica um arquivo de cabeçalho pré-compilado chamado MYPCH.pch . O compilador usa seu conteúdo para restaurar o estado pré-compilado de todos os arquivos de cabeçalho até e incluindo MYAPP.h . Em seguida, o compilador compila o código que ocorre após a #include "MYAPP.h" diretiva *.

Consulte também

Opções do compilador MSVC
Sintaxe da linha de comando do compilador MSVC