Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

Zastavica funkcionalnosti in konfiguracija ob prevajanju

Zastavica ob prevajanju določi različico programa pri gradnji. Zastavica med izvajanjem spremeni obnašanje že zgrajenega programa.

Različica: ISO C++23; implementation support may vary

Sintaksa

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

Zastavica funkcionalnosti, nastavljena ob gradnji, določa, kaj se prevede. Če vrednost spremeniš, moraš znova zgraditi zadevne dele programa. Nastavitev med izvajanjem, na primer vrednost iz konfiguracijske datoteke, pa lahko upravlja navadni if brez ponovnega prevajanja. Zastavica ne nadomesti preverjanja dovoljenj.

Določi, da ima CKTIS_ENABLE_TRACE vrednost 0 ali 1, in z #ifndef nastavi privzeto vrednost 0, če makro ni definiran. #if CKTIS_ENABLE_TRACE preveri vrednost; #ifdef CKTIS_ENABLE_TRACE preveri le, ali je makro definiran, zato je pogoj resničen tudi pri 0. Izpuščena koda se ne razčlenjuje kot C++. Uporabi #if, kadar želiš izpustiti neobvezno glavo ali deklaracijo.

Za izbiro med stavki C++ uporabi constexpr bool z if constexpr. Predprocesor v #if ne more prebrati vrednosti spremenljivke C++. Obe veji if constexpr se skladenjsko razčlenita; zunaj predloge prevajalnik preveri tudi zavrženo vejo. Pri ustvarjanju primerka predloge se zavržena veja ne instancira, če pogoj ni več odvisen od vrednosti parametra predloge.

V ISO C++23 makri __cpp_* in __cpp_lib_* sporočajo, katere zmožnosti jezika ali knjižnice so podprte, ne pa, ali jih projekt želi uporabiti. Podpora se lahko razlikuje glede na implementacijo. Pred preverjanjem knjižničnega makra vključi <version> ali ustrezno glavo in vrednost primerjaj z zahtevano revizijo. Zastavice, ki vplivajo na skupne definicije v glavah, nastavi enako v vseh prevajalnih enotah, ki jih uporabljajo: različne definicije iste funkcije inline lahko kršijo pravilo ene definicije (ODR). Zgradi in preizkusi obe različici.

Primeri

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

Rezultat

ready

Program privzeto izpiše le `ready`. Znova ga zgradi s `CKTIS_ENABLE_TRACE=1`, da se v vrstici pred `ready` izpiše `trace: enabled`. Pri `0` predprocesor izpusti definicijo `trace_startup` in njen klic.

Povezane lekcije

  • C++ · Lekcija 60 · Napredna · Različica: 3

Viri