Preprocesador

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requerimientos denominados

Macros de prueba de características (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de metaprogramación (C++11)

Biblioteca de diagnósticos

Biblioteca de servicios generales

Biblioteca de cadenas

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca numérica

Biblioteca de localizaciones

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de expresiones regulares (C++11)

Biblioteca de apoyo de concurrencia (C++11)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Lenguaje C++

Temas generales
Preprocesador Comentarios	Palabras clave Secuencias de escape
Control de flujo
Instrucciones de ejecución condicionales
if	switch
Instrucciones de iteración (bucles)
for bucle for basado en rango (C++11)	while do-while
Declaraciones de salto
continue - break	goto - return
Funciones
Declaración de funciones
Declaración de funciones lambda
Especificador inline
Especificación de excepciones (hasta C++20)
Especificador noexcept (C++11)
Excepciones
Expresión throw	Bloque try-catch
Espacios de nombres
Declaración de espacios de nombres	Alias de espacios de nombres
Tipos
Tipos fundamentales Tipos de enumeración Tipos de función	Tipos compuestos Tipos de unión
Especificadores
decltype (C++11) auto (C++11) alignas (C++11)	const/volatile constexpr (C++11)
Especificadores de duración de almacenamiento
Inicialización
Inicialización por defecto Inicialización de valor Inicialización cero Inicialización de copia Inicialización directa	Inicialización de agregados Inicialización de lista (C++11) Inicialización constante Inicialización de referencia

Expresiones
Categorías de valor Orden de evaluación	Operadores Precedencia de operadores
Representaciones alternas
Literales
Booleanos - Enteros - De punto flotante
De carácter - De cadena - nullptr (C++11)
Definidos por el usuario (C++11)
Utilidades
Atributos (C++11)
Tipos
Declaración de typedef
Declaración de alias de tipo (C++11)
Conversiones
Conversiones implícitas - Conversiones explícitas
static_cast - dynamic_cast
const_cast - reinterpret_cast
Asignación de memoria
Expresión new	Expresión delete
Clases
Declaración de clases Listas de inicializadores El puntero this	Especificadores de acceso Especificador friend
Propiedades de funciones específicas de la clase
Función virtual Especificador override (C++11) Especificador final (C++11)	explicit (C++11) static
Funciones miembro especiales
Constructor por defecto Constructor de copia Constructor de movimiento (C++11)	Operador de asignación de copia Operador de asignación de movimiento (C++11) Destructor
Plantillas
Plantillas de clase Plantillas de función	Especialización de plantillas Paquetes de parámetros (C++11)
Misceláneos
Ensamblador inline	Historia de C++

 

Preprocesador

#if #ifdef #ifndef #else #elif #endif

#define #undef operadores # y ##

#include

#warning

#error

#pragma

#line

 

El preprocesador se ejecuta en la fase 4 de traducción, antes comenzar la compilación. El resultado del preprocesamiento es un único archivo que después se pasa al compilador propiamente dicho.

Directivas

Las directivas de preprocesamiento controlan el comportamiento del preprocesador. Cada directiva ocupa una línea y tiene el siguiente formato:

• el carácter #;
• instrucción de preprocesamiento (una de las siguientes: define, undef, include, if, ifdef, ifndef, else, elif, elifdef, elifndef (desde C++23), endif, line, error, pragma);
• argumentos (dependen de la instrucción);
• salto de línea.

La directiva nula (# seguido por un salto de línea) está permitida y no tiene ningún efecto.

Las directivas de módulo e importación también son directivas de preprocesamiento.

(desde C++20)

Las directivas de preprocesamiento no deben de venir de una expansión de macro.

#define VACIO
VACIO   #   include <file.h> // no es una directiva de preprocesamiento

Funcionalidades

El preprocesador tiene la capacidad de modificar archivos fuentes antes de la compilación:

• Compilar condicionalmente partes del archivo fuente (controlado por las directivas #if, #ifdef, #ifndef, #else, #elif, #elifdef, #elifndef (desde C++23) y #endif).
• Reemplazar macros de texto, con la posibilidad de concatenar o entrecomillar identificadores (controlado por las directivas #define y #undef, y los operadores # y ##).
• Incluir otros archivos (controlado por la directiva #include y comprobar la inclusión con la directiva __has_include (desde C++17)
• Causar un error (controlado por la directiva #error).

Se pueden controlar los siguientes aspectos del preprocesador:

• Comportamiento definido por la implementación (controlado por la directiva #pragma y el operador _Pragma (desde C++11)). Además, algunos compiladores soportan (en varios grados) el operador __pragma como una extensión no estándar.
• Nombre de archivo e información de línea disponible para el preprocesador (controlado por la directiva #line).

Véase también

Documentación de C++ para Símbolos de macro predefinidos

Documentación de C++ para Índice de símbolos de macro

Documentación de C de preprocesador