CKTIS / C++
Featureflag en configuratie tijdens compilatie
Een compilatieflag kiest tijdens het bouwen een programmavariant. Een runtimeflag verandert het gedrag van een programma dat al is gebouwd.
Versie: ISO C++23; implementation support may vary
Syntax
#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) { /* ... */ }Een featureflag die je bij het bouwen instelt, bepaalt wat er wordt gecompileerd. Als de waarde verandert, moet je de betrokken delen opnieuw bouwen. Een runtime-instelling, bijvoorbeeld een waarde uit een configuratiebestand, kan daarentegen een gewone if aansturen zonder hercompilatie. Een flag vervangt geen autorisatiecontroles.
Spreek af dat CKTIS_ENABLE_TRACE 0 of 1 is en gebruik #ifndef om 0 als standaardwaarde in te stellen als de macro niet gedefinieerd is. #if CKTIS_ENABLE_TRACE test de waarde; #ifdef CKTIS_ENABLE_TRACE test alleen of de macro gedefinieerd is en is dus ook waar bij 0. Overgeslagen code wordt niet als C++ geparseerd. Gebruik #if om een optionele header of declaratie weg te laten.
Gebruik een constexpr bool met if constexpr om tussen C++-instructies te kiezen. De preprocessor kan in #if geen waarde van een C++-variabele lezen. Beide takken van if constexpr worden geparseerd; buiten een template controleert de compiler ook de verworpen tak. Bij het instantiëren van een template wordt de verworpen tak niet geïnstantieerd zodra de voorwaarde niet meer waardeafhankelijk is.
In ISO C++23 geven __cpp_* en __cpp_lib_* aan welke taal- of bibliotheekfuncties worden ondersteund, niet of je project ervoor kiest ze te gebruiken. Ondersteuning kan per implementatie verschillen. Neem vóór het testen van een bibliotheekmacro <version> of de betreffende header op en vergelijk de waarde met de vereiste revisie. Houd flags die gedeelde definities in headers beïnvloeden consistent in alle vertaaleenheden die ze gebruiken: verschillende definities van dezelfde inline-functie kunnen de one-definition rule (ODR) schenden. Bouw en test beide varianten.
Voorbeelden
#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";
}
Resultaat
ready
Standaard drukt het programma alleen `ready` af. Bouw het opnieuw met `CKTIS_ENABLE_TRACE=1` om `trace: enabled` af te drukken op de regel vóór `ready`. Bij `0` laat de preprocessor zowel de definitie van `trace_startup` als de aanroep ervan weg.
Gerelateerde lessen
- C++ · Les 60 · Gevorderd · Versie: 3