CKTIS / C
Únia s diskriminátorom v C
Únia s diskriminátorom spája pole typu `enum` s údajmi typu `union`. Diskriminátor určuje, ktorý variant bol uložený a ktorý člen treba čítať.
Verzia: 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 };Únia s diskriminátorom je návrhový vzor, nie samostatná konštrukcia jazyka C. Štruktúra struct obsahuje diskriminátor kind typu enum a údaje value typu union. Členy únie zdieľajú pamäť: naraz môže byť uložená hodnota najviac jedného člena. Názov typu Metric v struct Metric nie je diskriminátor uložený v objekte.
Program musí zachovať invariant: CPU_MS označuje hodnotu uloženú v cpu_ms a REQUESTS hodnotu uloženú v requests. Pri zmene variantu zapíš nové údaje aj zodpovedajúci diskriminátor. Skôr než prečítaš príslušný člen, skontroluj kind pomocou switch. Vetva default odmietne neznámy diskriminátor, ale neodhalí nesúlad pri známom diskriminátore. Čítanie iného člena môže inak interpretovať reprezentáciu objektu a nie je prenosnou náhradou za konverziu hodnoty.
V inicializátore s designátorom vyberá .člen = hodnota člen podľa názvu, nie podľa pozície. V zápise .value = { .cpu_ms = 120 } sa vnútorné zložené zátvorky vzťahujú na úniu value, takže { .cpu_ms = 120 } vyberá cpu_ms. Reťazený designátor .value.cpu_ms = 120 vyberá ten istý vnorený člen. Táto syntax je štandardná od C99 a nevyžaduje C23.
NULL z <stddef.h> je makro, ktoré sa expanduje na konštantu nulového ukazovateľa, nie na počet prvkov. print_metrics(NULL, 0) výslovne ošetrí prázdny prípad bez prístupu k prvkom; print_metrics(NULL, 1) odmietne nezlučiteľné argumenty. Ak ukazovateľ nie je nulový, volajúci musí zabezpečiť, aby bolo n inicializovaných prvkov stále živých a prístupných.
Prí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ýsledok
cpu_ms=120 requests=7 empty invalid input
Program vypíše dve hodnoty z rôznych variantov a potom ukáže, ako sa pri `NULL` spracuje nulový a kladný počet prvkov.
Súvisiace lekcie
- C · Lekcia 78 · Pokročilá · Verzia: 3