CKTIS / C++
Příznak funkce a konfigurace v době překladu
Příznak nastavený při sestavení vybírá variantu programu. Příznak vyhodnocovaný za běhu mění chování již sestaveného programu.
Verze: ISO C++23; implementation support may vary
Syntaxe
#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) { /* ... */ }Příznak funkce nastavený při sestavení určuje, co se přeloží. Po změně jeho hodnoty je nutné dotčené části sestavit znovu. Naproti tomu nastavení za běhu, například hodnota načtená z konfiguračního souboru, může řídit běžný if bez nového překladu. Příznak nenahrazuje kontrolu oprávnění.
Pro CKTIS_ENABLE_TRACE stanov hodnoty 0 a 1 a pomocí #ifndef nastav výchozí hodnotu 0, pokud makro není definováno. #if CKTIS_ENABLE_TRACE testuje hodnotu; #ifdef CKTIS_ENABLE_TRACE testuje jen existenci definice, takže podmínka platí i pro 0. Vynechaný kód neprochází syntaktickou analýzou C++. Použij #if, pokud má být vynechán volitelný hlavičkový soubor nebo deklarace.
Pro výběr mezi příkazy C++ použij constexpr bool s if constexpr. Preprocesor nemůže v #if číst hodnotu proměnné C++. Obě větve if constexpr procházejí syntaktickou analýzou; mimo šablonu překladač kontroluje i odhozenou větev. Při vytváření instance šablony se odhozená větev neinstanciuje, pokud podmínka již není závislá na hodnotě parametru šablony.
V ISO C++23 makra __cpp_* a __cpp_lib_* informují o podpoře vlastností jazyka nebo knihovny, nikoli o tom, zda je projekt chce používat. Podpora se může lišit podle implementace. Před testováním knihovního makra vlož <version> nebo příslušný hlavičkový soubor a porovnej hodnotu s požadovanou revizí. Příznaky ovlivňující sdílené definice v hlavičkových souborech nastav stejně ve všech překladových jednotkách, které je používají: různé definice téže funkce inline mohou porušit pravidlo jedné definice (ODR). Sestav a otestuj obě varianty.
Pří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ýsledek
ready
Ve výchozím nastavení program vypíše pouze `ready`. Sestav jej znovu s `CKTIS_ENABLE_TRACE=1` a na řádku před `ready` se vypíše `trace: enabled`. Při hodnotě `0` preprocesor vynechá definici `trace_startup` i její volání.
Související lekce
- C++ · Lekce 60 · Pokročilá · Verze: 3