Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

Bandera de funcionalidad y configuración en tiempo de compilación

Una bandera de compilación selecciona una variante al construir el programa. Una bandera de ejecución cambia el comportamiento de un programa ya construido.

Versión: ISO C++23; implementation support may vary

Sintaxis

#ifndef CKTIS_ENABLE_TRACE
#define CKTIS_ENABLE_TRACE 0
#endif

#if CKTIS_ENABLE_TRACE
// C++ declarations or statements included when the flag is 1.
#endif

// Alternative for selecting between C++ statements:
constexpr bool use_trace = CKTIS_ENABLE_TRACE != 0;
// Inside a function: if constexpr (use_trace) { /* ... */ }

Una bandera de funcionalidad fijada al construir el programa determina qué se compila. Cambiar su valor exige volver a construir las partes afectadas. En cambio, un ajuste de ejecución, por ejemplo un valor leído de un archivo de configuración, puede controlar un if ordinario sin recompilar. Una bandera no sustituye a las comprobaciones de autorización.

Limita CKTIS_ENABLE_TRACE a 0 o 1 y usa #ifndef para darle el valor 0 por defecto si la macro no está definida. #if CKTIS_ENABLE_TRACE comprueba su valor; #ifdef CKTIS_ENABLE_TRACE solo comprueba si está definida, por lo que se cumple incluso con 0. El código omitido no se analiza sintácticamente como C++. Usa #if cuando debas excluir una cabecera opcional o una declaración.

Para elegir entre sentencias de C++, usa un constexpr bool con if constexpr. El preprocesador no puede leer el valor de una variable de C++ en #if. Ambas ramas de if constexpr se analizan sintácticamente; fuera de una plantilla, el compilador comprueba también la rama descartada. Al instanciar una plantilla, la rama descartada no se instancia si la condición ya no depende de un valor de la plantilla.

En ISO C++23, las macros __cpp_* y __cpp_lib_* indican la compatibilidad con funcionalidades del lenguaje o de la biblioteca, no la decisión del proyecto de usarlas. La compatibilidad puede variar según la implementación. Antes de comprobar una macro de biblioteca, incluye <version> o la cabecera correspondiente y compara su valor con la revisión requerida. Mantén coherentes las banderas que afectan a definiciones compartidas en cabeceras en todas las unidades de traducción que las usan: distintas definiciones de una misma función inline pueden infringir la regla de definición única (ODR). Construye y prueba ambas variantes.

Ejemplos

#include <iostream>

#ifndef CKTIS_ENABLE_TRACE
#define CKTIS_ENABLE_TRACE 0
#endif

#if CKTIS_ENABLE_TRACE
void trace_startup() {
    std::cout << "trace: enabled\n";
}
#endif

int main() {
#if CKTIS_ENABLE_TRACE
    trace_startup();
#endif
    std::cout << "ready\n";
}

Resultado

ready

Por defecto, el programa solo imprime `ready`. Vuelve a construirlo con `CKTIS_ENABLE_TRACE=1` para que imprima `trace: enabled` en la línea anterior a `ready`. Con `0`, el preprocesador omite tanto la definición de `trace_startup` como su llamada.

Lecciones relacionadas

  • C++ · Lección 60 · Avanzado · Versión: 3

Fuentes