Compartilhar 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 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

  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 Property Pages caixa de diálogo. Para obter detalhes, consulte:Como: Abrir páginas de propriedades do projeto.

  3. Clique o C/C++ pasta.

  4. Clique o 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 esta 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 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.

Consulte também

Referência

Opções do compilador

Definindo opções do compilador