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

CKTIS / C++

std::endian — ordem dos bytes

std::endian, de <bit>, descreve a ordem dos bytes dos tipos escalares no ambiente de execução. Compara native com little e big, tendo também em conta os casos especiais.

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

Sintaxe

#include <bit>
std::endian::native
std::endian::little
std::endian::big

std::endian é uma enumeração com âmbito (enum class) de <bit>. std::endian::little indica a ordem em que o byte menos significativo surge primeiro, enquanto std::endian::big indica a ordem em que o byte mais significativo surge primeiro, com endereços de memória crescentes.

std::endian::native descreve o ambiente de execução: é igual a std::endian::little quando todos os tipos escalares são little-endian, ou a std::endian::big quando todos são big-endian. Caso contrário, pode não ser igual a nenhum desses valores. Por isso, não pressuponhas que não ser little significa ser big.

Se todos os tipos escalares ocuparem um byte, os três valores são iguais. Nos restantes casos, little e big são distintos. O exemplo verifica primeiro este caso especial e, em seguida, seleciona o ramo adequado com if constexpr.

Esta é informação sobre representação, não uma operação para reordenar bytes nem um mecanismo completo de serialização. A definição do compilador C++23 num repositório não estabelece as propriedades do respetivo ambiente de execução em produção.

Exemplos

#include <bit>
#include <iostream>

int main() {
    if constexpr (std::endian::little == std::endian::big) {
        std::cout << "all scalar types occupy one byte\n";
    } else if constexpr (std::endian::native == std::endian::little) {
        std::cout << "little-endian\n";
    } else if constexpr (std::endian::native == std::endian::big) {
        std::cout << "big-endian\n";
    } else {
        std::cout << "neither uniform little nor uniform big\n";
    }
}

Resultado

little-endian

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