Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje