/Fp (nome do arquivo .pch)

  • Artigo

Fornece um nome de caminho para um cabeçalho pré-compilado, em vez de usar o nome de caminho padrão.

Sintaxe

/Fpnome do caminho

Comentários

Use a opção /Fp com /Yc (criar arquivo de cabeçalho pré-compilado) ou /Yu (usar arquivo de cabeçalho pré-compilado) para especificar o caminho e o nome de arquivo de PCH (cabeçalho pré-compilado). Por padrão, a opção /Yc cria um nome de arquivo PCH usando o nome base do arquivo de origem e uma extensão pch.

Se não especificar uma extensão como parte do nome do caminho, uma extensão pch assumirá. Ao especificar um nome de diretório usando uma barra (/) no final do nome do caminho, o nome do arquivo padrão será vcversão0.pch, em que versão será a versão principal do conjunto de ferramentas do Visual Studio. Esse diretório deverá existir ou o erro C1083 será gerado.

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

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

  2. Selecione Propriedades de Configuração>C/C++>Cabeçalhos pré-compilados na página de propriedades.

  3. Modifique a propriedade Arquivo de Saída de Cabeçalho Pré-compilado.

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

Exemplos

Para criar uma versão nomeada separada do arquivo de cabeçalho pré-compilado para a compilação de depuração do programa, você poderá especificar um comando como:

CL /DDEBUG /Zi /Yc /FpDPROG.PCH PROG.CPP

O comando a seguir especifica o uso de um arquivo de cabeçalho pré-compilado denominado MYPCH.pch. O compilador pré-compila o código-fonte em PROG.cpp até o final de MYAPP.h e coloca o código pré-compilado em MYPCH.pch. Em seguida, usará o conteúdo de MYPCH.pch e compilará o restante de PROG.cpp para criar um arquivo .obj. A saída desse exemplo é um arquivo chamado PROG.exe.

CL /YuMYAPP.H /FpMYPCH.PCH PROG.CPP

Confira também

Opções do arquivo de saída (/F)
Opções do compilador MSVC
Sintaxe da linha de comando do compilador MSVC
Especificando o nome de caminho