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

CKTIS / C++

std::endian — ordre des octets

std::endian, défini dans <bit>, décrit l’ordre des octets des types scalaires dans l’environnement d’exécution. Comparez native à little et big, en prenant aussi en compte les cas particuliers.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

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

std::endian est une énumération à portée (enum class) définie dans <bit>. std::endian::little désigne l’ordre où l’octet de poids faible vient en premier, tandis que std::endian::big désigne celui où l’octet de poids fort vient en premier, lorsque les adresses mémoire augmentent.

std::endian::native décrit l’environnement d’exécution : sa valeur est std::endian::little si tous les types scalaires sont little-endian, ou std::endian::big s’ils sont tous big-endian. Dans les autres cas, elle peut ne correspondre à aucune de ces valeurs. Ne supposez donc pas que si ce n’est pas little, c’est forcément big.

Si tous les types scalaires occupent un octet, les trois valeurs sont égales. Sinon, little et big sont distinctes. L’exemple vérifie d’abord ce cas particulier, puis sélectionne la branche appropriée avec if constexpr.

Il s’agit d’informations sur la représentation, pas d’une opération de permutation des octets ni d’un mécanisme complet de sérialisation. Le paramètre de compilation C++23 d’un dépôt ne permet pas d’établir les propriétés de son environnement d’exécution en production.

Exemples

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

Résultat

little-endian

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources