CKTIS / C++
std::byte — bajt bez číselné sémantiky
std::byte z <cstddef> představuje surová bajtová data. Jde o samostatný výčtový typ, nikoli alias pro unsigned char. Podporuje bitové operace, ale ne běžnou aritmetiku ani implicitní převody na celočíselné typy.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cstddef>
std::byte b{0x2A};
auto masked = b & std::byte{0x0F};
auto value = std::to_integer<unsigned int>(masked);std::byte je deklarován v <cstddef> v prostoru jmen std jako enum class byte : unsigned char {};. Používejte ho, když hodnota představuje surová bajtová data, nikoli textový znak nebo číslo určené k výpočtům. Jde o samostatný typ, nikoli alias pro unsigned char.
Deklarace std::byte b{0x2A}; přímo inicializuje bajt celým číslem. Tato inicializace vyžaduje převod na podkladový typ bez zúžení. Deklarace std::byte b = 42; je neplatná: implicitní převod z celého čísla neexistuje. Zpět převádějte explicitně, například pomocí std::to_integer<unsigned int>(b); argument šablony musí být celočíselný typ.
Binárním operátorům &, |, ^, << a >> odpovídají operátory složeného přiřazení &=, |=, ^=, <<= a >>=. Podporován je také unární operátor bitové negace ~, který nemá variantu se složeným přiřazením. Všechny tyto operace jsou constexpr a noexcept. Počet bitových pozic, o které se hodnota posouvá, musí mít celočíselný typ. Běžná aritmetika, například b + b nebo ++b, není podporována.
Příklad použije masku 0x0F na hodnotu 0x2A, takže zůstane hodnota 10. Před výpisem se výsledek převede pomocí std::to_integer<unsigned int>(low); knihovna neposkytuje přímý vkládací operátor pro zápis std::byte do std::cout.
Příklady
#include <cstddef>
#include <iostream>
int main() {
constexpr std::byte value{0x2A};
constexpr std::byte mask{0x0F};
constexpr std::byte low = value & mask;
static_assert(std::to_integer<unsigned int>(low) == 10u);
std::cout << std::to_integer<unsigned int>(low) << '\n';
}
Výsledek
10
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.