Compartilhar via

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

  • Artigo

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

Sintaxe

/Yc
/Ycfilename

Argumentos

filename
Especifica um arquivo de cabeçalho (.h). Quando esse argumento for utilizado, o compilador compilará todo o código até e incluindo o arquivo .h.

Comentários

Quando /Yc é especificado sem um argumento, o compilador compila todo o código até o final do arquivo de origem base ou até o ponto no arquivo base em que uma diretiva hdrstop ocorre. O arquivo .pch resultante tem o mesmo nome base que o arquivo de origem base, a menos que especifique um nome de arquivo diferente usando o pragma hdrstop ou a opção /Fp.

O código pré-compilado é salvo em um arquivo com um nome criado a partir do nome base do arquivo especificado com a opção /Yc e uma extensão .pch. Também é possível usar a opção /Fp (Name .Pch File) para especificar um nome para o arquivo de cabeçalho pré-compilado.

Se você usar /Ycfilename, o compilador compilará todo o código até e incluindo o arquivo especificado para uso subsequente com a opção /Yu (Usar arquivo de cabeçalho pré-compilado).

Se as opções /Ycfilename e /Yufilename ocorrerem na mesma linha de comando e ambos fizerem referência ou implicarem o mesmo nome de arquivo, /Ycfilename terá prioridade. Esse recurso simplifica a gravação de makefiles.

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

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

  1. Selecione um arquivo .cpp. O arquivo .cpp deverá #incluir o arquivo .h que contém as informações de cabeçalho pré-compilado. A configuração /Yc do projeto pode ser substituída no nível do arquivo.

  2. Abra a caixa de diálogo Páginas de Propriedades do projeto. Para obter detalhes, confira Definir as propriedades de build e do compilador do C++ no Visual Studio.

  3. Abra a página de propriedades Propriedades da Configuração, C/C++, Cabeçalhos Pré-Compilados.

  4. Modifique a propriedade Cabeçalho Pré-compilado.

  5. Para definir o nome do arquivo, modifique a propriedade Arquivo de Cabeçalho Pré-Compilado.

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

Exemplo

Considere o seguinte código:

// prog.cpp
// compile with: cl /c /Ycmyapp.h prog.cpp
#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 for compilado com o comando CL /YcMYAPP.H PROG.CPP, o compilador salvará todo o pré-processamento para AFXWIN.h, RESOURCE.h e MYAPP.h em um arquivo de cabeçalho pré-compilado chamado MYAPP.pch.

Confira também

Opções do compilador MSVC
Sintaxe da linha de comando do compilador MSVC
Arquivos de cabeçalho pré-compilado