Partilhar via


/E (pré-processar em stdout)

Pré-processa arquivos de origem em C e C++ e copia os arquivos pré-processados para o dispositivo de saída padrão.

Sintaxe

/E

Comentários

Nesse processo, todas as diretivas do pré-processador são realizadas, as expansões de macro são executadas e os comentários são removidos. Para preservar comentários na saída pré-processada, use também a opção do compilador /C (Preservar comentários durante o pré-processamento).

/E adiciona diretivas #line à saída no início e no final de cada arquivo incluído e em torno de linhas removidas por diretivas de pré-processador para compilação condicional. Essas diretivas renumeram as linhas do arquivo pré-processado. Como resultado, os erros gerados durante os estágios posteriores do processamento referem-se aos números de linha do arquivo de origem inicial em vez das linhas no arquivo pré-processado.

A opção /E suprime a compilação. Você deve reenviar o arquivo pré-processado para compilação. A /E também suprime os arquivos de saída das opções /FA, /Fa e /Fm. Para obter mais informações, confira /FA, /Fa (Arquivo de listagem) e /Fm (Mapfile de nome).

Para suprimir diretivas #line, use a opção /EP (Pré-processar para stdout sem diretivas #line).

Para enviar a saída pré-processada para um arquivo em vez de stdout, use a opção /P (Pré-processar para um arquivo).

Para suprimir diretivas #line e enviar a saída pré-processada para um arquivo, use /P e /EP juntos.

Você não pode usar cabeçalhos pré-compilados com a opção /E.

Observe que, ao pré-processar em um arquivo separado, os espaços não são emitidos após os tokens. Isso poderá resultar em um programa inválido ou ter efeitos colaterais não intencionais. O programa a seguir é compilado com êxito:

#define m(x) x
m(int)main( )
{
   return 0;
}

No entanto, se você compilar com:

cl -E test.cpp > test2.cpp

int main no test2.cpp será intmainincorretamente.

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 a página de propriedades Propriedades de Configuração>C/C++>Linha de Comando.

  3. Digite a opção do compilador na caixa Opções Adicionais.

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

Exemplo

A linha de comando a seguir pré-processa ADD.C, preserva comentários, adiciona diretivas #line e exibe o resultado no dispositivo de saída padrão:

CL /E /C ADD.C

Confira também

Opções do compilador MSVC
Sintaxe da linha de comando do compilador MSVC