CKTIS / C
Обединение с етикет в C
Обединението с етикет съчетава поле от тип `enum` с данни от тип `union`. Етикетът показва кой вариант е записан и кой член трябва да се прочете.
Версия: ISO C23; implementation support may vary
Синтаксис
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 };Обединението с етикет е шаблон, а не самостоятелна конструкция в C. Структурата struct съдържа етикета kind от тип enum и данните value от тип union. Членовете на обединението споделят памет: в даден момент може да е записана стойността на най-много един член. Името на типа Metric в struct Metric не е етикетът, записан в обекта.
Програмата трябва да поддържа инварианта: CPU_MS означава стойност, записана в cpu_ms, а REQUESTS — стойност, записана в requests. При смяна на варианта запиши и новите данни, и съответния етикет. Провери kind със switch, преди да прочетеш съответния член. Клонът default отхвърля непознат етикет, но не открива несъответствие при разпознат етикет. Четенето на друг член може да интерпретира представянето на обекта по друг начин и не е преносим заместител на преобразуването на стойност.
В инициализатор с обозначител .член = стойност избира член по име, а не по позиция. В .value = { .cpu_ms = 120 } вътрешните фигурни скоби се отнасят за обединението value, затова { .cpu_ms = 120 } избира cpu_ms. Верижният обозначител .value.cpu_ms = 120 избира същия вложен член. Синтаксисът е стандартизиран от C99 и не изисква C23.
NULL от <stddef.h> е макрос, който се разгъва до константа за нулев указател, а не брой елементи. print_metrics(NULL, 0) обработва изрично празния случай, без да достъпва елементи; print_metrics(NULL, 1) отхвърля несъвместимите аргументи. Ако указателят не е нулев, извикващият код трябва да осигури достъп до n инициализирани елемента, чийто срок на живот не е изтекъл.
Примери
#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;
}Резултат
cpu_ms=120 requests=7 empty invalid input
Програмата отпечатва две стойности от различни варианти и след това показва как при `NULL` се обработват нулев и положителен брой елементи.
Свързани уроци
- C · Урок 78 · Напреднало · Версия: 3