/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, 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 o mesmo para ambos os /Yc opção que cria o cabeçalho pré-compilado e qualquer subseqüentes /Yu opção indicando o uso do cabeçalho pré-compilado.
Para /Yc, filename Especifica o ponto no qual pré-compilação pára; o compilador pré-compila todo código porém filename e nomeia o cabeçalho pré-compilado resultante usando o nome do arquivo de inclusão de base 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, em seguida, 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ê especifica o /Yu opção sem um nome de arquivo, seu programa de origem deve conter um hdrstop # pragma pragma que especifica o nome do arquivo de cabeçalho pré-compilado, o arquivo .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 desse pragma, restaura o estado de compilação 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 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 a /Ycfilename e /Yufilename opções ocorrem na mesma linha de comando e ambos referenciar o mesmo nome de arquivo, /Ycfilename terá precedência, pré-compilar 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 em que 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 Páginas de propriedades caixa de diálogo.Para obter detalhes, consulte:Como: abrir páginas de propriedades do projeto.
Clique no C/C++ pasta.
Clique no 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 essa 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 os três incluem instruções, mas o código pré-compilado de usos de MYAPP.pch, assim, economizando o tempo envolvido na pré-processamento todos os três arquivos (e todos eles podem incluir os arquivos).
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, como no exemplo a seguir:
CL /YuMYAPP.H /FpMYPCH.pch PROG.CPP
Esse 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.