Пространства имён
Варианты
Действия

std::byte

Материал из cppreference.com
< cpp‎ | types
 
 
Библиотека метапрограммирования
Свойства типов
Категории типов
(C++11)
(C++14)  
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Свойства типов
(C++11)
(C++11)
(C++14)
(C++11)
(C++11)(до C++20*)
(C++11)(устарело в C++20)
(C++11)
Константы свойств типа
Метафункции
(C++17)
Поддерживаемые операции
Запросы отношений и свойств
Модификации типов
Преобразования типов
(C++11)(устарело в C++23)
(C++11)(устарело в C++23)
(C++11)
(C++11)
(C++17)

(C++11)(до C++20*)(C++17)
Рациональная арифметика времени компиляции
Целочисленные последовательности времени компиляции
 
Определено в заголовочном файле <cstddef>
enumclass byte :unsignedchar{};
(начиная с C++17)

std::byte это особый тип, который реализует концепцию байта, указанную в определении языка C++.

Подобно unsignedchar, его можно использовать для доступа к сырой памяти, занятой другими объектами (представление объекта), но в отличие от unsignedchar, std::byte не символьный тип и не арифметический тип. std::byte моделирует простой набор битов, поддерживая только побитовые операции и операции сравнения.

Содержание

[править]Функции, не являющиеся элементами

std::to_integer

template<class IntegerType>
 constexpr IntegerType to_integer( std::byte b )noexcept;
(начиная с C++17)

Эквивалентно: return IntegerType(b); Эта перегрузка участвует в разрешении перегрузки, только если std::is_integral_v<IntegerType> равно true.

std::operator<<=,operator>>=

template<class IntegerType>
 constexpr std::byte& operator<<=( std::byte& b, IntegerType shift )noexcept;
(1) (начиная с C++17)
template<class IntegerType>
 constexpr std::byte& operator>>=( std::byte& b, IntegerType shift )noexcept;
(2) (начиная с C++17)
1) Эквивалентно: return b = b << shift; Эта перегрузка участвует в разрешении перегрузки, только если std::is_integral_v<IntegerType> равно true.
2) Эквивалентно: return b = b >> shift;

Эта перегрузка участвует в разрешении перегрузки, только если std::is_integral_v<IntegerType> равно true.

std::operator<<,operator>>

template<class IntegerType>
 constexpr std::byte operator <<( std::byte b, IntegerType shift )noexcept;
(1) (начиная с C++17)
template<class IntegerType>
 constexpr std::byte operator >>( std::byte b, IntegerType shift )noexcept;
(2) (начиная с C++17)
1) Эквивалентно: return std::byte(static_cast<unsignedint>(b)<< shift); Эта перегрузка участвует в разрешении перегрузки, только если std::is_integral_v<IntegerType> равно true.
2) Эквивалентно: return std::byte(static_cast<unsignedint>(b)>> shift);

Эта перегрузка участвует в разрешении перегрузки, только если std::is_integral_v<IntegerType> равно true.

std::operator|=,operator&=,operator^=

constexpr std::byte& operator|=( std::byte& l, std::byte r )noexcept;
(1) (начиная с C++17)
constexpr std::byte& operator&=( std::byte& l, std::byte r )noexcept;
(2) (начиная с C++17)
constexpr std::byte& operator^=( std::byte& l, std::byte r )noexcept;
(3) (начиная с C++17)
1) Эквивалентно: return l = l | r;.
2) Эквивалентно: return l = l & r;.
3) Эквивалентно: return l = l ^ r;.

std::operator|,operator&,operator^,operator~

constexpr std::byte operator|( std::byte l, std::byte r )noexcept;
(1) (начиная с C++17)
constexpr std::byte operator&( std::byte l, std::byte r )noexcept;
(2) (начиная с C++17)
constexpr std::byte operator^( std::byte l, std::byte r )noexcept;
(3) (начиная с C++17)
constexpr std::byte operator~( std::byte b )noexcept;
(4) (начиная с C++17)
1) Эквивалентно: return std::byte(static_cast<unsignedint>(l)|static_cast<unsignedint>(r));.
2) Эквивалентно: return std::byte(static_cast<unsignedint>(l)&static_cast<unsignedint>(r));.
3) Эквивалентно: return std::byte(static_cast<unsignedint>(l)^static_cast<unsignedint>(r));.
4) Эквивалентно: return std::byte(~static_cast<unsignedint>(b));

[править]Примечание

Числовое значение n может быть преобразовано в байтовое значение с помощью std::byte{n}, из-за упрощённых правил инициализации класса enum C++17.

Байт может быть преобразован в числовое значение (например, для создания целочисленного хэша объекта) обычным способом с помощью явного преобразования или альтернативно с помощью std::to_integer.

Макрос Тестирования функциональностиЗначениеСтандартФункциональность
__cpp_lib_byte201603L(C++17)std::byte

[править]Пример

#include <iostream>#include <cstddef>#include <bitset>   std::ostream& operator<<(std::ostream& os, std::byte b){return os <<std::bitset<8>(std::to_integer<int>(b));}   int main(){ std::byte b{42};std::cout<<"1. "<< b <<'\n';   // b *= 2 ошибка компиляции b <<=1;std::cout<<"2. "<< b <<'\n';   b >>=1;std::cout<<"3. "<< b <<'\n';   std::cout<<"4. "<<(b <<1)<<'\n';std::cout<<"5. "<<(b >>1)<<'\n';   b |= std::byte{0b11110000};std::cout<<"6. "<< b <<'\n';   b &= std::byte{0b11110000};std::cout<<"7. "<< b <<'\n';   b ^= std::byte{0b11111111};std::cout<<"8. "<< b <<'\n';}

Вывод:

1. 00101010 2. 01010100 3. 00101010 4. 01010100 5. 00010101 6. 11111010 7. 11110000 8. 00001111
close