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

CKTIS / C

Unie s diskriminátorem v C

Unie s diskriminátorem spojuje pole typu `enum` s daty typu `union`. Diskriminátor určuje, která varianta byla uložena a který člen se má číst.

Verze: ISO C23; implementation support may vary

Syntaxe

enum Kind { CPU_MS, REQUESTS };
struct Metric {
    enum Kind kind;
    union { int cpu_ms; unsigned requests; } value;
};

struct Metric m = { .kind = CPU_MS, .value = { .cpu_ms = 120 } };
/* Equivalent initialization with a chained designator: */
struct Metric same = { .kind = CPU_MS, .value.cpu_ms = 120 };

Unie s diskriminátorem je návrhový vzor, nikoli samostatná konstrukce jazyka C. Struktura struct obsahuje diskriminátor kind typu enum a data value typu union. Členy unie sdílejí paměť: současně může být uložena hodnota nejvýše jednoho členu. Název typu Metric v struct Metric není diskriminátor uložený v objektu.

Program musí zachovat invariant: CPU_MS označuje hodnotu uloženou v cpu_ms a REQUESTS hodnotu uloženou v requests. Při změně varianty zapiš nová data i odpovídající diskriminátor. Než přečteš příslušný člen, zkontroluj kind pomocí switch. Větev default odmítne neznámý diskriminátor, ale neodhalí nesoulad u známého diskriminátoru. Čtení jiného členu může jinak interpretovat reprezentaci objektu a není přenositelnou náhradou za převod hodnoty.

V inicializátoru s designátorem vybírá .člen = hodnota člen podle názvu, nikoli podle pozice. V zápisu .value = { .cpu_ms = 120 } se vnitřní složené závorky vztahují k unii value, takže { .cpu_ms = 120 } vybírá cpu_ms. Řetězený designátor .value.cpu_ms = 120 vybírá stejný vnořený člen. Tato syntaxe je standardní od C99 a nevyžaduje C23.

NULL z <stddef.h> je makro, které se rozvine na konstantu nulového ukazatele, nikoli na počet prvků. print_metrics(NULL, 0) výslovně ošetří prázdný případ bez přístupu k prvkům; print_metrics(NULL, 1) neslučitelné argumenty odmítne. Není-li ukazatel nulový, volající musí zajistit, aby bylo n inicializovaných prvků stále živých a přístupných.

Příklady

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

enum Kind { CPU_MS, REQUESTS };

struct Metric {
    enum Kind kind;
    union {
        int cpu_ms;
        unsigned requests;
    } value;
};

static void print_metrics(const struct Metric *metrics, size_t n)
{
    if (metrics == NULL) {
        puts(n == 0 ? "empty" : "invalid input");
        return;
    }

    for (size_t i = 0; i < n; ++i) {
        switch (metrics[i].kind) {
        case CPU_MS:
            printf("cpu_ms=%d\n", metrics[i].value.cpu_ms);
            break;
        case REQUESTS:
            printf("requests=%u\n", metrics[i].value.requests);
            break;
        default:
            puts("invalid tag");
            return;
        }
    }
}

int main(void)
{
    const struct Metric metrics[] = {
        { .kind = CPU_MS, .value = { .cpu_ms = 120 } },
        { .kind = REQUESTS, .value.requests = 7u }
    };

    print_metrics(metrics, sizeof metrics / sizeof metrics[0]);
    print_metrics(NULL, 0);
    print_metrics(NULL, 1);
    return 0;
}

Výsledek

cpu_ms=120
requests=7
empty
invalid input

Program vypíše dvě hodnoty z různých variant a poté ukáže, jak se při `NULL` zachází s nulovým a kladným počtem prvků.

Související lekce

  • C · Lekce 78 · Pokročilá · Verze: 3

Zdroje