Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

Flaga funkcji i konfiguracja w czasie kompilacji

Flaga czasu kompilacji wybiera wariant programu podczas budowania. Flaga czasu wykonania zmienia zachowanie już zbudowanego programu.

Wersja: ISO C++23; implementation support may vary

Składnia

#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) { /* ... */ }

Flaga funkcji ustawiana podczas budowania wybiera, co zostanie skompilowane. Zmiana jej wartości wymaga ponownego zbudowania dotkniętych nią części programu. Z kolei ustawienie czasu wykonania, na przykład odczytane z pliku konfiguracyjnego, może sterować zwykłym if bez rekompilacji. Flaga nie zastępuje kontroli uprawnień.

Ustal, że CKTIS_ENABLE_TRACE przyjmuje 0 albo 1, i przez #ifndef ustaw domyślne 0, jeśli makra nie zdefiniowano. #if CKTIS_ENABLE_TRACE sprawdza wartość, a #ifdef CKTIS_ENABLE_TRACE jedynie istnienie definicji, więc jest prawdziwe nawet dla 0. Pominięty kod nie trafia do analizy składniowej C++. Użyj #if, gdy trzeba wykluczyć opcjonalny nagłówek lub deklarację.

Jeśli wybierasz między instrukcjami C++, użyj stałej constexpr bool i if constexpr. Preprocesor nie odczyta wartości zmiennej C++ w #if. Obie gałęzie if constexpr podlegają analizie składniowej; poza szablonem kompilator sprawdza także poprawność odrzuconej gałęzi. Przy konkretyzacji szablonu odrzucona gałąź nie jest konkretyzowana, jeśli warunek nie zależy już od wartości parametrów szablonu.

W ISO C++23 makra __cpp_* i __cpp_lib_* informują o obsłudze możliwości języka lub biblioteki, a nie o decyzji projektu, czy ich używać. Obsługa zależy od implementacji. Przed sprawdzeniem makra bibliotecznego dołącz <version> lub właściwy nagłówek i porównaj wartość z wymaganą. Ustawiaj flagi wpływające na wspólne definicje w nagłówkach jednakowo we wszystkich jednostkach translacji, które z nich korzystają; różne definicje tej samej funkcji inline mogą naruszyć regułę jednej definicji (ODR). Buduj i testuj oba warianty.

Przykłady

#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";
}

Wynik

ready

Domyślnie program wypisuje tylko `ready`. Zbuduj go ponownie z `CKTIS_ENABLE_TRACE=1`: przed `ready` pojawi się wiersz `trace: enabled`. Przy wartości `0` preprocesor pomija zarówno definicję `trace_startup`, jak i jej wywołanie.

Powiązane lekcje

  • C++ · Lekcja 60 · Zaawansowany · Wersja: 3

Źródła