CKTIS / C++
Feature-Flag und Konfiguration zur Kompilierzeit
Ein Flag zur Kompilierzeit wählt beim Build eine Programmvariante. Ein Laufzeit-Flag ändert das Verhalten eines bereits gebauten Programms.
Version: 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) { /* ... */ }Ein beim Build gesetztes Feature-Flag bestimmt, was kompiliert wird. Ändert sich sein Wert, müssen die betroffenen Programmteile neu gebaut werden. Eine Laufzeiteinstellung, etwa ein Wert aus einer Konfigurationsdatei, kann dagegen ein gewöhnliches if ohne Neukompilierung steuern. Ein Flag ersetzt keine Berechtigungsprüfung.
Lege für CKTIS_ENABLE_TRACE die Werte 0 und 1 fest und setze das Makro mit #ifndef standardmäßig auf 0, wenn es nicht definiert ist. #if CKTIS_ENABLE_TRACE prüft den Wert; #ifdef CKTIS_ENABLE_TRACE prüft nur, ob das Makro definiert ist, und trifft daher auch bei 0 zu. Übersprungener Code wird nicht als C++ geparst. Verwende #if, wenn ein optionaler Header oder eine Deklaration weggelassen werden soll.
Für die Auswahl zwischen C++-Anweisungen eignet sich ein constexpr bool mit if constexpr. Der Präprozessor kann den Wert einer C++-Variablen in #if nicht lesen. Beide Zweige von if constexpr werden geparst; außerhalb eines Templates prüft der Compiler auch den verworfenen Zweig. Bei der Instanziierung eines Templates wird der verworfene Zweig nicht instanziiert, sobald die Bedingung nicht mehr wertabhängig ist.
In ISO C++23 zeigen __cpp_* und __cpp_lib_* an, welche Sprach- oder Bibliotheksmerkmale unterstützt werden, nicht ob das Projekt sie nutzt. Die Unterstützung kann je nach Implementierung variieren. Binde vor der Prüfung eines Bibliotheksmakros <version> oder den passenden Header ein und vergleiche den Wert mit dem benötigten Revisionsstand. Halte Flags, die gemeinsame Header-Definitionen beeinflussen, in allen zugehörigen Übersetzungseinheiten konsistent: Unterschiedliche Definitionen derselben inline-Funktion können die One-Definition Rule (ODR) verletzen. Baue und teste beide Varianten.
Beispiele
#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";
}
Ergebnis
ready
Standardmäßig gibt das Programm nur `ready` aus. Baue es mit `CKTIS_ENABLE_TRACE=1` neu: Dann steht `trace: enabled` in der Zeile vor `ready`. Bei `0` lässt der Präprozessor sowohl die Definition von `trace_startup` als auch ihren Aufruf weg.
Zugehörige Lektionen
- C++ · Lektion 60 · Fortgeschritten · Version: 3