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