Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

unreachable — assinalar um caminho inalcançável

A macro unreachable de C23 assinala um caminho que a execução nunca deve alcançar. Se a invocação for alcançada, ocorre comportamento indefinido.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

unreachable é uma macro semelhante a uma função de C23, definida em <stddef.h>. A invocação unreachable() não recebe argumentos e expande-se para uma expressão do tipo void, não para uma função comum.

Alcançar a invocação provoca comportamento indefinido. Não é uma forma de validação nem garante que o programa termine: o compilador pode otimizar o código partindo do princípio de que esse caminho é inalcançável.

No exemplo, choose exige que bit seja 0 ou 1. O ramo default exprime esse requisito, mas não o verifica de forma segura. Para dados de entrada externos, utiliza tratamento de erros em vez de unreachable().

Exemplos

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

Resultado

10 20

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes