Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

union — armazenamento partilhado para membros alternativos

A palavra-chave `union` define um tipo classe cujos membros de dados não estáticos partilham o mesmo armazenamento. No máximo, um membro pode estar ativo de cada vez; a utilização correta exige acompanhar os tempos de vida dos membros.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

union Name { Type1 member1; Type2 member2; };

union define um tipo classe que armazena valores alternativos num espaço partilhado. O seu tamanho é suficiente para o maior membro de dados não estático, mas não tem de ser exatamente igual ao tamanho desse membro. Uma union não regista automaticamente qual é o membro ativo.

Um membro está ativo quando o seu tempo de vida começou e ainda não terminou. No exemplo, Value value{42} ativa count. A atribuição value.ratio = 0.5 inicia o tempo de vida de ratio e termina o de count. Esta mudança simples funciona para os tipos escalares apresentados; não a generalize a tipos classe arbitrários.

A leitura de um membro inativo causa, em geral, comportamento indefinido — não é uma forma portátil de reinterpretar bits. Existem exceções restritas, como examinar a sequência inicial comum de estruturas standard-layout quando se verificam as condições do standard. Depois da mudança no exemplo, não leia value.count.

Membros com construtores ou destrutores não triviais podem exigir destruição e construção explícitas através de placement new. Esta entrada diz respeito a C++23; a fonte fornecida é um rascunho de trabalho em evolução, não uma publicação C++23 definitiva e imutável.

Exemplos

#include <iostream>

union Value {
    int count;
    double ratio;
};

int main() {
    Value value{42};
    std::cout << value.count << '\n';

    value.ratio = 0.5;
    std::cout << value.ratio << '\n';
}

Resultado

42
0.5

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes