Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

unreachable — označení nedosažitelné cesty

Makro unreachable z C23 označuje cestu, kterou běh programu nesmí nikdy dosáhnout. Pokud je volání dosaženo, dojde k nedefinovanému chování.

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

Syntaxe

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

unreachable je v C23 makro podobné funkci z hlavičky <stddef.h>. Volání unreachable() nepřijímá žádné argumenty a rozvine se na výraz typu void, nikoli na běžnou funkci.

Dosažení volání způsobí nedefinované chování. Makro neslouží k ověřování správnosti ani nezaručuje ukončení programu: kompilátor může optimalizovat kód za předpokladu, že tato cesta je nedosažitelná.

V příkladu funkce choose vyžaduje, aby bit mělo hodnotu 0 nebo 1. Větev default tento požadavek vyjadřuje, ale bezpečně ho nekontroluje. U externích vstupních dat použijte místo unreachable() ošetření chyb.

Příklady

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

Výsledek

10 20

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje