Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

Union étiquetée en C

Une union étiquetée associe un champ `enum` à des données de type `union`. L’étiquette indique quelle variante a été stockée et quel membre lire.

Version : ISO C23; implementation support may vary

Syntaxe

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

Une union étiquetée est un patron de conception, pas une construction distincte du langage C. Une struct contient l’étiquette kind de type enum et les données value de type union. Les membres de l’union partagent la même mémoire : au plus une valeur de membre y est stockée à la fois. Le nom de type Metric dans struct Metric n’est pas l’étiquette stockée dans l’objet.

Le programme doit respecter l’invariant : CPU_MS indique une valeur stockée dans cpu_ms, et REQUESTS une valeur stockée dans requests. Lors d’un changement de variante, écrivez les nouvelles données et l’étiquette correspondante. Examinez kind avec switch avant de lire le membre correspondant. default rejette une étiquette inconnue, mais ne détecte pas une incohérence si l’étiquette est reconnue. Lire un autre membre peut réinterpréter la représentation de l’objet et ne remplace pas une conversion de valeur portable.

Dans un initialiseur désigné, .membre = valeur sélectionne un membre par son nom plutôt que par sa position. Dans .value = { .cpu_ms = 120 }, les accolades internes concernent l’union value : { .cpu_ms = 120 } sélectionne donc cpu_ms. Le désignateur chaîné .value.cpu_ms = 120 sélectionne le même membre imbriqué. Cette syntaxe est normalisée depuis C99 et ne nécessite pas C23.

NULL, fourni par <stddef.h>, est une macro qui se développe en constante de pointeur nul, pas un nombre d’éléments. print_metrics(NULL, 0) traite explicitement le cas vide sans accéder à un élément ; print_metrics(NULL, 1) rejette les arguments incohérents. Si le pointeur est non nul, l’appelant doit garantir que n éléments initialisés sont encore vivants et accessibles.

Exemples

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

Résultat

cpu_ms=120
requests=7
empty
invalid input

Le programme affiche deux valeurs de variantes différentes, puis montre comment un nombre d’éléments nul ou positif est traité avec `NULL`.

Leçons associées

  • C · Leçon 78 · Avancé · Version : 3

Sources