/Yu (arquivo de cabeçalho pré-compilado de uso)
Instrui o compilador a utilizar um arquivo de cabeçalho pré-compilado (.pch) existente na compilação atual.
/Yu[filename]
Argumentos
- nome do arquivo
O nome de um arquivo de cabeçalho, o que está incluído no arquivo de origem usando um #include diretiva de pré-processamento.
Comentários
O nome do arquivo de inclusão deve ser a mesma para ambos os /Yc opção que cria o cabeçalho pré-compilado e qualquer subseqüentes /Yu opção indicam o uso de cabeçalho pré-compilado.
Para /Yc, filename Especifica o ponto no quais paradas de pré-compilação; o compilador pré-compila todo código Embora filename e nomes de cabeçalho pré-compilado resultante usando o nome base do arquivo de inclusão e uma extensão de .pch.
O arquivo de .pch deve ter sido criado usando /Yc.
O compilador trata todo o código que ocorrem antes do arquivo. h como pré-compilado. Ele ignora apenas superiores a #include diretiva associada ao arquivo. h, usa o código contido no arquivo .pch e então compila todo o código depois de filename.
Na linha de comando, não são permitidos espaços entre /Yu e filename.
Quando você especificar o /Yu opção sem um nome de arquivo, seu programa de origem deve conter um # pragma hdrstop pragma que especifica o nome do arquivo de cabeçalho pré-compilado, o arquivo de .pch. Nesse caso, o compilador usará o cabeçalho pré-compilado (arquivo de .pch), nomeado por /FP (nome.Arquivo de pch). O compilador ignora o local do que pragma, restaura o estado de compilado a partir do arquivo de cabeçalho pré-compilado especificado pelo pragma e, em seguida, compila somente o código que segue o pragma. Se #pragma hdrstop não especifica um nome de arquivo, o compilador procura um arquivo com um nome derivado do nome de base do arquivo de origem com uma extensão de .pch. Você também pode usar o /Fp opção para especificar um arquivo de .pch diferentes.
Se você especificar o /Yu a opção sem um nome de arquivo e falha especificar um hdrstop pragma, uma mensagem de erro é gerada 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 terá precedência, a pré-compilação de todo o código até e incluindo o arquivo nomeado. Esse recurso simplifica a elaboração makefiles.
Como os arquivos de .pch contêm informações sobre o ambiente de máquina, bem como informações de endereço de memória sobre o programa, você só deve usar um arquivo de pch na máquina onde ele foi criado.
Para obter mais informações sobre cabeçalhos pré-compilados, consulte:
Para definir esta opção de compilador no ambiente de desenvolvimento Visual Studio
Especificar /Yc (criar arquivo de cabeçalho pré-compilado) em um arquivo. cpp no projeto.
Abra o projeto Property Pages caixa de diálogo. Para obter detalhes, consulte:Como: Abrir páginas de propriedades do projeto.
Clique o C/C++ pasta.
Clique o Cabeçalhos pré-compilados página de propriedades.
Modificar o Criar/usar PCH através do arquivo propriedade ou o Create/Use Precompiled Header propriedade.
Para definir esta opção de compilador programaticamente
- 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 incluem instruções, mas o código usa pré-compilado de MYAPP.pch, assim, economizando o tempo envolvido em todos os três arquivos (e todos os arquivos podem incluir) de pré-processamento.
Você pode usar o /FP (nome.Arquivo de pch) a opção com o /Yu opção para especificar o nome do arquivo .pch se o nome for diferente do que o argumento de nome de arquivo para /Yc ou o nome de base do arquivo de origem, conforme mostrado 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. O compilador então compila o código que ocorre após a MYAPP.h include instrução.