/Yu (arquivo de cabeçalho pré-compilados de uso)
Instrui o compilador a usar um arquivo de cabeçalho pré-compilado (.pch) existente na compilação corrente.
/Yu[filename]
Argumentos
- nome do arquivo
O nome de um arquivo de cabeçalho, que está incluído na arquivo de fonte usando um #include diretiva de pré-processador.
Comentários
O nome do arquivo de inclusão deve ser o mesmo para o /Yc opção que cria o cabeçalho pré-compilado e qualquer subseqüentes /Yu opção que indica o uso de cabeçalho pré-compilado.
For /Yc, filename Especifica o ponto no qual pré-compilação pára; o compilador pré-compila todo o código que filename e nomeia o cabeçalho pré-compilado resultante usando o nome base do arquivo de inclusão e uma extensão do .pch.
O arquivo .pch deve ter sido criado usando /Yc.
O compilador trata todo o código que ocorrem antes do arquivo .h sistema autônomo pré-compilado.Ele passará para além do #include diretiva associada ao arquivo .h, usa o código contido no arquivo .pch e, em seguida, compila todo o código após filename.
Na linha de comando, nenhum espaço é permitido entre /Yu e filename.
Quando você especifica o /Yu opção sem um nome de arquivo, seu programa de fonte deve conter um # pragma hdrstop pragma que especifica o nome de arquivo do cabeçalho da pré-compilado, o arquivo .pch.Nesse caso, o compilador deverá usar cabeçalho pré-compilado (arquivo .pch) nomeado por /Fp (.pch de nome de arquivo). O compilador ignora o local desse pragma, restaura o estado compilado do arquivo de cabeçalho pré-compilado especificado pelo pragma e, em seguida, compila somente código que segue o pragma.If #pragma hdrstop não especifica um nome de arquivo, o compilador procura um arquivo com um nome derivado do nome do arquivo de fonte com uma extensão .pch base. Você também pode usar o /Fp opção para especificar um arquivo .pch diferentes.
Se você especificar o /Yu a opção sem um nome de arquivo e não especificar um hdrstop pragma, uma mensagem de erro é gerado e a compilação não for bem-sucedida.
Se o /Ycfilename e /Yufilename opções ocorrem na mesma linha de comando e ambos referenciar o mesmo nome de arquivo /Ycfilename precedência, todo o código de pré-compilação até e incluindo o arquivo nomeado. Esse recurso simplifica a elaboração makefiles.
sistema autônomo sistema autônomo arquivos .pch contêm informações sobre o ambiente de computador, bem sistema autônomo informações de endereço de memória sobre o programa, você só deve usar um arquivo pch na computador onde foi criado.
Para obter mais informações sobre cabeçalhos pré-compilados, consulte:
Para conjunto esta opção do compilador no ambiente de desenvolvimento do Visual Studio
Especificar /Yc (criar arquivo de cabeçalho pré-compilados) em um arquivo .cpp em seu projeto.
em aberto propriedade Páginas caixa de diálogo.Para obter detalhes, consulte:Como: Abrir o Projeto Propriedade Páginas.
clicar no C/C++ pasta.
clicar no Cabeçalhos pré-compilados página de propriedades.
Modificar o Criar/Usar PCH através do arquivo propriedade ou o Criar/usar cabeçalho pré-compiladopropriedade .
Para conjunto esta opção do compilador por meio de programação
- Consulte PrecompiledHeaderThrough e UsePrecompiledHeader.
Exemplos
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 com a linha de comando CL /YuMYAPP.H PROG.CPP, o compilador não processa as três incluir instruções mas pré-usa compilado código de MYAPP.pch, assim, economizando o time envolvido na pré-processamento de todos os três arquivos (e quaisquer arquivos que eles podem incluir).
Você pode usar o /Fp (.pch de nome de arquivo) a opção com o /Yu opção para especificar o nome do arquivo .pch se o nome for diferente do ou o argumento de nome de arquivo para /Yc ou o nome base do arquivo de fonte, sistema autônomo 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 Sumário restauração o estado de todos os arquivos de cabeçalho até e incluindo MYAPP.h pré-compilado.O compilador então compila o código que ocorre após o MYAPP.h include demonstrativo.