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

CKTIS / C

unreachable — marquer un chemin inaccessible

La macro unreachable de C23 marque un chemin que l’exécution ne doit jamais atteindre. Si l’invocation est atteinte, cela entraîne un comportement indéfini.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stddef.h>
/* Makro / macro: */
unreachable();

unreachable est une macro de type fonction de C23, définie dans <stddef.h>. L’invocation unreachable() ne prend aucun argument et se développe en une expression de type void, et non en une fonction ordinaire.

Atteindre l’invocation entraîne un comportement indéfini. Ce n’est ni une validation ni une garantie d’arrêt du programme : le compilateur peut optimiser le code en supposant que ce chemin est inaccessible.

Dans l’exemple, choose exige que bit vaille 0 ou 1. La branche default exprime cette exigence, mais ne la vérifie pas de manière sûre. Pour des entrées externes, utilisez plutôt une gestion des erreurs que unreachable().

Exemples

#include <stddef.h>
#include <stdio.h>

#ifndef unreachable
#error "This example requires the C23 unreachable macro from <stddef.h>"
#endif

static int choose(unsigned int bit)
{
    switch (bit) {
    case 0: return 10;
    case 1: return 20;
    default: unreachable();
    }
}

int main(void)
{
    printf("%d %d\n", choose(0), choose(1));
    return 0;
}

Résultat

10 20

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources