Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

Unija z oznako v C

Unija z oznako združuje polje tipa `enum` in podatke tipa `union`. Oznaka pove, katera različica je shranjena in kateri član je treba prebrati.

Različica: ISO C23; implementation support may vary

Sintaksa

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

Unija z oznako je načrtovalski vzorec, ne posebna konstrukcija jezika C. Struktura struct vsebuje oznako kind tipa enum in podatke value tipa union. Člani unije si delijo pomnilnik: hkrati je lahko shranjena vrednost največ enega člana. Ime tipa Metric v struct Metric ni oznaka, shranjena v objektu.

Program mora ohranjati invarianto: CPU_MS pomeni vrednost, shranjeno v cpu_ms, REQUESTS pa vrednost, shranjeno v requests. Ob menjavi različice zapiši tako nove podatke kot ustrezno oznako. Pred branjem ustreznega člana preveri kind z switch. Veja default zavrne neznano oznako, ne zazna pa neskladja pri znani oznaki. Branje drugega člana lahko drugače interpretira predstavitev objekta in ni prenosljiv nadomestek za pretvorbo vrednosti.

V inicializatorju z določilom .član = vrednost izbere člana po imenu namesto po položaju. V zapisu .value = { .cpu_ms = 120 } se notranji zaviti oklepaji nanašajo na unijo value, zato { .cpu_ms = 120 } izbere cpu_ms. Verižno določilo .value.cpu_ms = 120 izbere istega ugnezdenega člana. Ta skladnja je standardna od C99 in ne zahteva C23.

NULL iz <stddef.h> je makro, ki se razširi v konstanto ničelnega kazalca, ne število elementov. print_metrics(NULL, 0) izrecno obravnava prazen primer brez dostopa do elementov; print_metrics(NULL, 1) zavrne neskladne argumente. Če kazalec ni ničeln, mora klicatelj zagotoviti, da je n inicializiranih elementov še živih in dostopnih.

Primeri

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

Rezultat

cpu_ms=120
requests=7
empty
invalid input

Program izpiše dve vrednosti iz različnih različic, nato pa pokaže, kako pri `NULL` obravnava ničelno in pozitivno število elementov.

Povezane lekcije

  • C · Lekcija 78 · Napredna · Različica: 3

Viri