/Yc (criar arquivo de cabeçalho pré-compilado)
Instrui o compilador a criar um arquivo de cabeçalho pré-compilado (.pch) que representa o estado da compilação em um certo ponto.
/Yc[filename]
Argumentos
- filename
Especifica um arquivo de cabeçalho (. h). Quando esse argumento é usado, o compilador compila todo o código até e incluindo o arquivo. h.
Comentários
Quando /Yc for especificado sem um argumento, o compilador compila todo o código até o final do arquivo de origem de base ou ao ponto em que o arquivo de base onde uma hdrstop ocorre. O arquivo resultante de .pch tem o mesmo nome de base como seu arquivo de origem de base, a menos que você especifique um nome de arquivo diferente usando o hdrstop pragma ou o /Fp opção.
O código pré-compilado é salvo em um arquivo com um nome criado a partir do nome do arquivo especificado com base na /Yc opção e uma extensão de .pch. Você também pode usar o /FP (nome.Arquivo de pch) opção para especificar um nome para o arquivo de cabeçalho pré-compilado.
Se você usar /Ycfilename, o compilador compila todo o código até e incluindo o arquivo especificado para uso subseqüente com o /Yu opção.
Se as opções de /Ycfilename e /Yu (arquivo de cabeçalho pré-compilado de uso)filename ocorrer na mesma linha de comando, e ambos referência, ou implicam, o mesmo nome de arquivo /Ycfilename terá precedência. Esse recurso simplifica a elaboração makefiles.
Para obter mais informações sobre cabeçalhos pré-compilados, consulte:
Para definir esta opção de compilador no ambiente de desenvolvimento Visual Studio
Selecione um arquivo. cpp. O arquivo. cpp deve # incluir o arquivo. h que contém informações de cabeçalho pré-compilado. O projeto /Yc configuração pode ser substituída no nível de arquivo.
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.
Exemplo
Considere 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
...
Quando esse código é compilado com o comando CL /YcMYAPP.H PROG.CPP, o compilador de salva todo o pré-processamento de AFXWIN.h, RESOURCE.h e MYAPP.h em um arquivo de cabeçalho pré-compilado chamado MYAPP.pch.