Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

Unión etiquetada en C

Una unión etiquetada combina un campo `enum` con datos de tipo `union`. La etiqueta indica qué variante se almacenó y qué miembro se debe leer.

Versión: ISO C23; implementation support may vary

Sintaxis

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

Una unión etiquetada es un patrón, no una construcción independiente del lenguaje C. Una struct contiene la etiqueta kind de tipo enum y los datos value de tipo union. Los miembros de la unión comparten almacenamiento: se almacena el valor de como máximo un miembro a la vez. El nombre de tipo Metric en struct Metric no es la etiqueta almacenada en el objeto.

El programa debe mantener el invariante: CPU_MS indica un valor almacenado en cpu_ms, y REQUESTS, uno almacenado en requests. Cuando cambies de variante, escribe tanto los nuevos datos como su etiqueta correspondiente. Examina kind con switch antes de leer el miembro correspondiente. default rechaza una etiqueta desconocida, pero no detecta una incoherencia si la etiqueta es conocida. Leer otro miembro puede reinterpretar la representación del objeto y no es una alternativa portable a la conversión de valores.

En un inicializador designado, .miembro = valor selecciona un miembro por nombre en lugar de por posición. En .value = { .cpu_ms = 120 }, las llaves internas corresponden a la unión value, por lo que { .cpu_ms = 120 } selecciona cpu_ms. El designador encadenado .value.cpu_ms = 120 selecciona el mismo miembro anidado. Esta sintaxis forma parte del estándar desde C99 y no requiere C23.

NULL, disponible en <stddef.h>, es una macro que se expande a una constante de puntero nulo, no un número de elementos. print_metrics(NULL, 0) trata explícitamente el caso vacío sin acceder a ningún elemento; print_metrics(NULL, 1) rechaza argumentos incoherentes. Si el puntero no es nulo, quien llama debe garantizar que n elementos inicializados sigan vivos y sean accesibles.

Ejemplos

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

Resultado

cpu_ms=120
requests=7
empty
invalid input

El programa imprime dos valores de variantes distintas y luego muestra cómo se tratan un recuento cero y uno positivo con `NULL`.

Lecciones relacionadas

  • C · Lección 78 · Avanzado · Versión: 3

Fuentes