CKTIS / C++
Príznak funkcie a konfigurácia v čase kompilácie
Príznak nastavený pri zostavení vyberá variant programu. Príznak vyhodnocovaný počas behu mení správanie už zostaveného programu.
Verzia: 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) { /* ... */ }Príznak funkcie nastavený pri zostavení určuje, čo sa skompiluje. Po zmene jeho hodnoty treba dotknuté časti zostaviť znova. Naopak, nastavenie počas behu, napríklad hodnota načítaná z konfiguračného súboru, môže riadiť bežný if bez opätovnej kompilácie. Príznak nenahrádza kontrolu oprávnení.
Pre CKTIS_ENABLE_TRACE stanov hodnoty 0 a 1 a použi #ifndef na nastavenie predvolenej hodnoty 0, ak makro nie je definované. #if CKTIS_ENABLE_TRACE testuje hodnotu; #ifdef CKTIS_ENABLE_TRACE testuje iba existenciu definície, takže podmienka platí aj pre 0. Vynechaný kód sa syntakticky neanalyzuje ako C++. Použi #if, ak treba vynechať voliteľnú hlavičku alebo deklaráciu.
Na výber medzi príkazmi C++ použi constexpr bool s if constexpr. Preprocesor nedokáže v #if čítať hodnotu premennej C++. Obe vetvy if constexpr prejdú syntaktickou analýzou; mimo šablóny kompilátor kontroluje aj zahodenú vetvu. Pri vytváraní inštancie šablóny sa zahodená vetva neinštanciuje, ak podmienka už nie je závislá od hodnoty parametra šablóny.
V ISO C++23 makrá __cpp_* a __cpp_lib_* informujú o podpore vlastností jazyka alebo knižnice, nie o tom, či ich projekt chce používať. Podpora sa môže líšiť podľa implementácie. Pred testovaním knižničného makra vlož <version> alebo príslušnú hlavičku a porovnaj hodnotu s požadovanou revíziou. Príznaky ovplyvňujúce zdieľané definície v hlavičkách nastav rovnako vo všetkých prekladových jednotkách, ktoré ich používajú: rôzne definície tej istej funkcie inline môžu porušiť pravidlo jednej definície (ODR). Zostav a otestuj oba varianty.
Príklady
#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";
}
Výsledok
ready
V predvolenom nastavení program vypíše iba `ready`. Zostav ho znova s `CKTIS_ENABLE_TRACE=1` a na riadku pred `ready` sa vypíše `trace: enabled`. Pri hodnote `0` preprocesor vynechá definíciu `trace_startup` aj jej volanie.
Súvisiace lekcie
- C++ · Lekcia 60 · Pokročilá · Verzia: 3