Partilhar via


/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 até o ponto no 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 ocorrem na mesma linha de comando e ambos referenciar 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

  1. 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.

  2. Abra o projeto Páginas de propriedades caixa de diálogo.Para obter detalhes, consulte:Como: abrir páginas de propriedades do projeto.

  3. Clique no C/C++ pasta.

  4. Clique no Cabeçalhos pré-compilados página de propriedades.

  5. 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

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 salva todo o pré-processamento para AFXWIN.h, RESOURCE.h, e MYAPP.h em um arquivo de cabeçalho pré-compilado chamado MYAPP.pch.

Consulte também

Referência

Opções do compilador

Configurando opções de compilador