WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

unreachable — einen unerreichbaren Pfad kennzeichnen

Das C23-Makro unreachable kennzeichnet einen Pfad, den die Ausführung niemals erreichen darf. Wird der Aufruf erreicht, tritt undefiniertes Verhalten auf.

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

Syntax

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

unreachable ist in C23 ein funktionsartiges Makro aus <stddef.h>. Der Aufruf unreachable() nimmt keine Argumente entgegen und wird zu einem Ausdruck vom Typ void erweitert, nicht zu einer gewöhnlichen Funktion.

Wird der Aufruf erreicht, tritt undefiniertes Verhalten auf. Das Makro dient weder der Validierung noch garantiert es den Programmabbruch: Der Compiler darf den Code unter der Annahme optimieren, dass dieser Pfad unerreichbar ist.

Im Beispiel setzt choose voraus, dass bit den Wert 0 oder 1 hat. Der default-Zweig drückt diese Voraussetzung aus, prüft sie aber nicht auf sichere Weise. Verwende bei externen Eingaben eine Fehlerbehandlung statt unreachable().

Beispiele

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

Ergebnis

10 20

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen