Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

Unia ze znacznikiem w C

Unia ze znacznikiem łączy pole `enum` z polem `union`. Znacznik wskazuje, który wariant zapisano i który człon należy odczytać.

Wersja: ISO C23; implementation support may vary

Składnia

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

Unia ze znacznikiem to wzorzec, a nie osobna konstrukcja języka C. Struktura struct zawiera znacznik kind typu enum oraz dane wariantu w polu value typu union. Człony unii współdzielą pamięć: unia przechowuje wartość najwyżej jednego z nich naraz. Nazwa typu, np. Metric w struct Metric, nie jest znacznikiem zapisanym w obiekcie.

Program musi zachować niezmiennik: CPU_MS oznacza zapis w cpu_ms, a REQUESTS zapis w requests. Przy zmianie wariantu zapisuj zarówno nową wartość, jak i odpowiadający jej znacznik. Najpierw sprawdź kind instrukcją switch, a dopiero potem odczytaj właściwy człon. default odrzuca nieznany znacznik, ale nie wykryje rozbieżności przy rozpoznanym znaczniku. Odczyt innego członu może zreinterpretować reprezentację obiektu i nie zastępuje przenośnej konwersji wartości.

W inicjalizatorze desygnowanym .pole = wartość wybiera człon według nazwy, nie pozycji. W .value = { .cpu_ms = 120 } wewnętrzne klamry odnoszą się do unii value, dlatego { .cpu_ms = 120 } wybiera cpu_ms. Zapis .value.cpu_ms = 120 oznacza ten sam zagnieżdżony człon. Ta składnia jest standardowa od C99; nie wymaga C23.

NULL z <stddef.h> to makro rozwijane do stałej wskaźnika pustego, a nie liczba elementów. print_metrics(NULL, 0) jawnie obsługuje pusty przypadek bez dostępu do elementów, a print_metrics(NULL, 1) odrzuca niespójne argumenty. Dla niepustego wskaźnika wywołujący musi zapewnić dostęp do n żyjących, zainicjalizowanych elementów.

Przykłady

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

Wynik

cpu_ms=120
requests=7
empty
invalid input

Program wypisuje dwie wartości z różnych wariantów, a następnie pokazuje, jak zerowa i dodatnia liczba elementów są traktowane przy `NULL`.

Powiązane lekcje

  • C · Lekcja 78 · Zaawansowany · Wersja: 3

Źródła