CKTIS / C
Union met een tag in C
Een union met een tag combineert een `enum`-veld met gegevens van het type `union`. De tag geeft aan welke variant is opgeslagen en welk lid je moet lezen.
Versie: 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 };Een union met een tag is een ontwerppatroon, geen aparte constructie in C. Een struct bevat de enum-tag kind en de variantgegevens value van het type union. De leden van de union delen opslagruimte: er is hoogstens één lid tegelijk waarvan de waarde is opgeslagen. De typenaam Metric in struct Metric is niet de tag die in het object is opgeslagen.
Het programma moet de invariant bewaken: CPU_MS betekent dat de waarde is opgeslagen in cpu_ms, en REQUESTS dat de waarde is opgeslagen in requests. Schrijf bij een variantwissel zowel de nieuwe gegevens als de bijbehorende tag. Controleer eerst kind met switch en lees daarna pas het bijbehorende lid. default wijst een onbekende tag af, maar kan een inconsistentie bij een bekende tag niet opsporen. Het lezen van een ander lid kan de objectrepresentatie herinterpreteren en is geen portable alternatief voor waardeconversie.
In een aangewezen initializer selecteert .lid = waarde een lid op naam in plaats van op positie. In .value = { .cpu_ms = 120 } horen de binnenste accolades bij de union value, dus kiest { .cpu_ms = 120 } het lid cpu_ms. De gekoppelde designator .value.cpu_ms = 120 selecteert hetzelfde geneste lid. Deze syntaxis is standaard sinds C99 en vereist geen C23.
NULL uit <stddef.h> is een macro die expandeert tot een nullpointerconstante, geen elementaantal. print_metrics(NULL, 0) handelt het lege geval expliciet af zonder een element te benaderen; print_metrics(NULL, 1) wijst tegenstrijdige argumenten af. Als de pointer niet null is, moet de aanroeper ervoor zorgen dat n geïnitialiseerde elementen nog bestaan en toegankelijk zijn.
Voorbeelden
#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;
}Resultaat
cpu_ms=120 requests=7 empty invalid input
Het programma drukt twee waarden van verschillende varianten af en laat daarna zien hoe een aantal van nul en een positief aantal worden afgehandeld met `NULL`.
Gerelateerde lessen
- C · Les 78 · Gevorderd · Versie: 3