WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

Union mit Typkennzeichen in C

Eine Union mit Typkennzeichen kombiniert ein `enum`-Feld mit einer `union`. Das Kennzeichen zeigt, welche Variante gespeichert ist und welches Mitglied gelesen werden soll.

Version: ISO C23; implementation support may vary

Syntax

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

Eine Union mit Typkennzeichen ist ein Entwurfsmuster, kein eigenes Sprachkonstrukt in C. Eine struct enthält das enum-Kennzeichen kind und die Variantendaten value vom Typ union. Die Mitglieder der Union teilen sich den Speicher: Es ist jeweils höchstens der Wert eines Mitglieds gespeichert. Der Typname Metric in struct Metric ist nicht das im Objekt gespeicherte Kennzeichen.

Das Programm muss die Invariante einhalten: CPU_MS steht für einen in cpu_ms gespeicherten Wert, REQUESTS für einen in requests gespeicherten Wert. Beim Variantenwechsel sind sowohl die neuen Daten als auch das passende Kennzeichen zu schreiben. Prüfe kind mit switch, bevor du das entsprechende Mitglied liest. default weist unbekannte Kennzeichen zurück, erkennt aber keine Abweichung bei einem bekannten Kennzeichen. Das Lesen eines anderen Mitglieds kann die Objektrepräsentation neu interpretieren und ist kein portabler Ersatz für eine Wertkonvertierung.

In einem designierten Initialisierer wählt .mitglied = wert ein Mitglied nach Namen statt nach Position aus. In .value = { .cpu_ms = 120 } beziehen sich die inneren Klammern auf die Union value, sodass { .cpu_ms = 120 } das Mitglied cpu_ms auswählt. Der verkettete Designator .value.cpu_ms = 120 wählt dasselbe verschachtelte Mitglied. Diese Syntax ist seit C99 standardisiert und setzt C23 nicht voraus.

NULL aus <stddef.h> ist ein Makro, das zu einer Nullzeigerkonstante expandiert, keine Elementanzahl. print_metrics(NULL, 0) behandelt den leeren Fall ausdrücklich, ohne auf ein Element zuzugreifen; print_metrics(NULL, 1) weist widersprüchliche Argumente zurück. Bei einem Zeiger ungleich null muss der Aufrufer sicherstellen, dass n initialisierte Elemente noch leben und zugänglich sind.

Beispiele

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

Ergebnis

cpu_ms=120
requests=7
empty
invalid input

Das Programm gibt zwei Werte verschiedener Varianten aus und zeigt anschließend, wie eine Anzahl von null und eine positive Anzahl bei `NULL` behandelt werden.

Zugehörige Lektionen

  • C · Lektion 78 · Fortgeschritten · Version: 3

Quellen