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

CKTIS / C++

std::bit_cast — créer une valeur à partir d’une représentation binaire

std::bit_cast<To>(from) crée un nouvel objet à partir des bits de l’objet source. Les deux types doivent avoir la même taille et être trivialement copiables ; il ne s’agit ni d’une conversion numérique ni d’un accès à la source par alias.

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

Syntaxe

#include <bit>
template<class To, class From>
constexpr To std::bit_cast(const From& from) noexcept;

std::bit_cast<To>(from)

std::bit_cast, fourni par <bit>, renvoie un nouvel objet de type To. Les bits de sa représentation de valeur correspondent aux bits de la représentation objet de from. La fonction n’effectue aucune conversion numérique et ne crée aucune référence vers la source. From est généralement déduit.

L’appel exige sizeof(To) == sizeof(From) et que les deux types soient trivialement copiables. Ces conditions ne rendent pas à elles seules sûrs des motifs de bits arbitraires : le résultat doit représenter une valeur valide du type de destination. Les bits de remplissage du résultat ne sont pas spécifiés ; évitez les données non initialisées et le transfert de bits de remplissage vers des bits de valeur.

La fonction est noexcept. Sa déclaration constexpr ne signifie pas que chaque appel peut être évalué à la compilation. L’exemple utilise unsigned char et std::byte pour illustrer cette conversion sans supposer d’ordre des octets ni de format en virgule flottante.

Cette entrée porte sur C++23. Le document lié est un projet de travail évolutif, et non une édition figée de C++23 ; ses règles plus récentes ne doivent pas être appliquées automatiquement à C++23. Un indicateur de compilation dans un dépôt n’atteste pas de la compatibilité de l’environnement d’exécution de production.

Exemples

#include <bit>
#include <cstddef>
#include <iostream>

int main() {
    constexpr unsigned char source = 42;
    constexpr auto bits = std::bit_cast<std::byte>(source);
    constexpr auto restored = std::bit_cast<unsigned char>(bits);
    static_assert(restored == source);
    std::cout << static_cast<unsigned int>(restored) << '\n';
}

Résultat

42

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