Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje