Compartilhar via


/Yc (criar arquivo de cabeçalho pré-compilado)

Instrui o compilador para criar um arquivo de cabeçalho .pch pré-compilado () que representa o estado de compilação em algum ponto.

/Yc[filename]

Arguments

  • filename
    Especifica um cabeçalho () .h arquivo. Quando esse argumento for usado, o compilador cria qualquer código até o arquivo de .h.

Comentários

Quando /Yc é especificado sem um argumento, o compilador cria qualquer código até o fim do arquivo de origem de base, ou para o ponto no arquivo de base hdrstop onde ocorre. O arquivo resultante de .pch tem o mesmo nome de base que o arquivo de origem de base a menos que você especifique um nome de arquivo diferente usando o pragma de hdrstop ou a opção de /Fp .

O código pré-compilado é salvo em um arquivo com um nome criado de nome de arquivo especificado com a opção de /Yc e uma extensão de .pch. Você também pode usar a opção de /Fp (nomear arquivo .Pch) especifique um nome para o arquivo de cabeçalho pré-compilado.

Se você usar /Ycfilename, o compilador cria qualquer código até o arquivo especificado para uso subsequente com a opção de /Yu .

Se as opções /Ycfilename e /Yu (usar arquivo de cabeçalho pré-compilado)filename ocorrem na mesma linha de comando e em ambos referência, ou isso, o mesmo nome de arquivo, /Ycfilename terá precedência. Esse recurso simplifica a gravação de makefiles.

Para obter mais informações sobre cabeçalhos pré-compilados, consulte:

Para definir esta opção do compilador no ambiente de desenvolvimento do Visual Studio

  1. Selecione um arquivo .cpp. O arquivo .cpp deve #include o arquivo de .h que contém informações de cabeçalho pré-compilado. Defina de /Yc de projeto pode ser substituído no nível de arquivo.

  2. Abra a caixa de diálogo Páginas de Propriedade do projeto. Para obter detalhes, consulte Como abrir páginas de propriedade do projeto.

  3. Clique na pasta C/C++.

  4. Clique na página de propriedades de Cabeçalhos Pré-Compilados .

  5. Modifique a propriedade de Criar/uso com PCH Arquivo ou a propriedade de Cabeçalho pré-compilado criar/uso .

Para definir essa opção do compilador via programação

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 é criado com o comando CL /YcMYAPP.H PROG.CPP, o compilador salva qualquer 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

Definindo opções do compilador