Share via

/E (Preprocesar para stdout)

  • Artículo

Preprocesa archivos de origen de C y C++ y copia los archivos preprocesados en el dispositivo de salida estándar.

Sintaxis

/E

Comentarios

En este proceso, se llevan a cabo todas las directivas de preprocesador, se realizan expansiones de macros y se quitan los comentarios. Para conservar los comentarios en la salida preprocesada, use también la opción del compilador /C (Conservar comentarios durante el preprocesamiento).

/E agrega directivas de #line a la salida al principio y al final de cada archivo incluido y alrededor de las líneas quitadas por las directivas de preprocesador para la compilación condicional. Estas directivas vuelven a numerar las líneas del archivo preprocesado. Por este motivo, los errores generados durante las fases posteriores del procesamiento hacen referencia a los números de línea del primer archivo de origen, en vez de a las líneas del archivo preprocesado.

La opción /E suprime la compilación. Debe volver a enviar el archivo preprocesado para su compilación. /E también suprime los archivos de salida de las opciones /FA, /Fa y /Fm. Para más información, consulte /FA, /Fa (Archivo de listas) y /Fm (Asignar nombre al archivo de asignaciones).

Para suprimir directivas de #line, use la opción /EP (Preprocesamiento para stdout sin directivas #line) en su lugar.

Para enviar la salida preprocesada a un archivo en lugar de a stdout, use la opción /P (Preprocesamiento a un archivo) en su lugar.

Para suprimir directivas de #line y enviar la salida preprocesada a un archivo, use /P y /EP juntos.

No se pueden usar encabezados precompilados con la opción /E.

Tenga en cuenta que, al preprocesar en un archivo independiente, los espacios no se emiten después de los tokens. Esto puede dar lugar a un programa ilegal o tener efectos secundarios no deseados. El programa siguiente se compila correctamente:

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

Sin embargo, si compila con:

cl -E test.cpp > test2.cpp

int main en test2.cpp será intmain incorrectamente.

Para establecer esta opción del compilador en el entorno de desarrollo de Visual Studio

  1. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para más información, vea Establecimiento del compilador de C++ y de propiedades de compilación en Visual Studio.

  2. Seleccione la página de propiedades Propiedades de configuración>C/C++>Línea de comandos.

  3. Escriba la opción del compilador en el cuadro Opciones adicionales.

Para establecer esta opción del compilador mediante programación

Ejemplo

La siguiente línea de comandos preprocesa ADD.C, conserva los comentarios, agrega directivas de #line y muestra el resultado en el dispositivo de salida estándar:

CL /E /C ADD.C

Consulte también

Opciones del compilador de MSVC
Sintaxis de la línea de comandos del compilador MSVC