Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

Flag di funzionalità e configurazione in fase di compilazione

Un flag di compilazione seleziona una variante del programma durante la build. Un flag di runtime cambia il comportamento di un programma già compilato.

Versione: ISO C++23; implementation support may vary

Sintassi

#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) { /* ... */ }

Un flag di funzionalità impostato durante la build determina che cosa viene compilato. Per cambiarne il valore occorre ricostruire le parti interessate. Un’impostazione di runtime, come un valore letto da un file di configurazione, può invece controllare un normale if senza ricompilare. Un flag non sostituisce i controlli di autorizzazione.

Stabilisci che CKTIS_ENABLE_TRACE valga 0 o 1 e usa #ifndef per assegnargli il valore predefinito 0 se la macro non è definita. #if CKTIS_ENABLE_TRACE verifica il valore; #ifdef CKTIS_ENABLE_TRACE verifica solo che la macro sia definita, quindi la condizione risulta vera anche con 0. Il codice omesso non viene analizzato sintatticamente come C++. Usa #if per escludere un header facoltativo o una dichiarazione.

Per scegliere tra istruzioni C++, usa un constexpr bool con if constexpr. Il preprocessore non può leggere il valore di una variabile C++ in #if. Entrambi i rami di if constexpr vengono analizzati sintatticamente; al di fuori di un template, il compilatore verifica anche il ramo scartato. Durante l’istanziazione di un template, il ramo scartato non viene istanziato se la condizione non è più dipendente da un valore del template.

In ISO C++23, le macro __cpp_* e __cpp_lib_* indicano il supporto di funzionalità del linguaggio o della libreria, non la scelta del progetto di usarle. Il supporto può variare a seconda dell’implementazione. Prima di verificare una macro di libreria, includi <version> o l’header pertinente e confronta il suo valore con la revisione richiesta. Mantieni coerenti i flag che influenzano le definizioni condivise negli header in tutte le unità di traduzione che le usano: definizioni diverse della stessa funzione inline possono violare la regola della definizione unica (ODR). Esegui la build e i test per entrambe le varianti.

Esempi

#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";
}

Risultato

ready

Per impostazione predefinita, il programma stampa solo `ready`. Ricompilalo con `CKTIS_ENABLE_TRACE=1` per stampare `trace: enabled` nella riga prima di `ready`. Con `0`, il preprocessore omette sia la definizione di `trace_startup` sia la sua chiamata.

Lezioni correlate

  • C++ · Lezione 60 · Avanzato · Versione: 3

Fonti