Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

Indicateur de fonctionnalité et configuration à la compilation

Un indicateur de compilation sélectionne une variante du programme à construire. Un indicateur d’exécution modifie le comportement d’un programme déjà construit.

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

Un indicateur de fonctionnalité fixé lors de la construction détermine ce qui est compilé. Modifier sa valeur impose de reconstruire les parties concernées. À l’inverse, un réglage d’exécution, lu par exemple dans un fichier de configuration, peut piloter un if ordinaire sans recompilation. Un indicateur ne remplace pas un contrôle d’autorisation.

Limitez CKTIS_ENABLE_TRACE à 0 ou 1 et utilisez #ifndef pour lui donner la valeur 0 par défaut si la macro n’est pas définie. #if CKTIS_ENABLE_TRACE teste sa valeur ; #ifdef CKTIS_ENABLE_TRACE vérifie seulement si elle est définie et réussit donc même avec 0. Le code écarté n’est pas analysé syntaxiquement comme du C++. Utilisez #if pour exclure un en-tête facultatif ou une déclaration.

Pour choisir entre des instructions C++, utilisez un constexpr bool avec if constexpr. Le préprocesseur ne peut pas lire la valeur d’une variable C++ dans #if. Les deux branches de if constexpr font l’objet d’une analyse syntaxique ; hors d’un template, le compilateur vérifie aussi la branche écartée. Lors de l’instanciation d’un template, la branche écartée n’est pas instanciée dès lors que la condition n’est plus dépendante d’une valeur de template.

En ISO C++23, les macros __cpp_* et __cpp_lib_* indiquent la prise en charge d’une fonctionnalité du langage ou de la bibliothèque, pas le choix du projet de l’utiliser. Cette prise en charge peut varier selon l’implémentation. Avant de tester une macro de bibliothèque, incluez <version> ou l’en-tête concerné et comparez sa valeur à la révision requise. Utilisez des valeurs cohérentes pour les indicateurs qui affectent les définitions communes dans les en-têtes, dans toutes les unités de traduction concernées : des définitions différentes d’une même fonction inline peuvent enfreindre la règle de définition unique (ODR). Construisez et testez les deux variantes.

Exemples

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

Résultat

ready

Par défaut, le programme affiche uniquement `ready`. Reconstruisez-le avec `CKTIS_ENABLE_TRACE=1` pour afficher `trace: enabled` sur la ligne qui précède `ready`. Avec `0`, le préprocesseur écarte à la fois la définition de `trace_startup` et son appel.

Leçons associées

  • C++ · Leçon 60 · Avancé · Version : 3

Sources