Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::byte — bajt bez semantyki liczbowej

std::byte z nagłówka <cstddef> służy do reprezentowania surowych danych bajtowych. Jest odrębnym typem wyliczeniowym, a nie aliasem unsigned char. Obsługuje operacje bitowe, lecz nie zwykłą arytmetykę ani niejawne konwersje na liczby całkowite.

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

Składnia

#include <cstddef>

std::byte b{0x2A};
auto masked = b & std::byte{0x0F};
auto value = std::to_integer<unsigned int>(masked);

std::byte jest zadeklarowany w <cstddef> jako enum class byte : unsigned char {}; w przestrzeni nazw std. Używaj go, gdy wartość reprezentuje surowe dane bajtowe, a nie znak tekstu lub liczbę przeznaczoną do obliczeń. To odrębny typ, nie alias unsigned char.

Zapis std::byte b{0x2A}; bezpośrednio inicjalizuje bajt liczbą całkowitą. Taka inicjalizacja wymaga, aby konwersja do typu bazowego nie była zawężająca. Zapis std::byte b = 42; jest niepoprawny: nie ma niejawnej konwersji z liczby całkowitej. Konwersję w drugą stronę wykonaj jawnie, np. przez std::to_integer<unsigned int>(b); parametr szablonu musi być typem całkowitym.

Dostępne są operatory binarne &, |, ^, << i >> oraz odpowiadające im operatory przypisania złożonego: &=, |=, ^=, <<= i >>=. Dostępny jest też jednoargumentowy operator negacji bitowej ~, który nie ma odpowiednika wśród operatorów przypisania złożonego. Wszystkie te operacje są constexpr i noexcept. Argument przesunięcia musi mieć typ całkowity. Zwykłe działania takie jak b + b czy ++b nie są obsługiwane.

Przykład nakłada maskę 0x0F na 0x2A, pozostawiając wartość 10. Przed wypisaniem wynik jest konwertowany przez std::to_integer<unsigned int>; biblioteka nie udostępnia bezpośredniego operatora wypisywania std::byte do std::cout.

Przykłady

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

Wynik

10

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła