// boost/endian/buffers.hpp ----------------------------------------------------------// // (C) Copyright Darin Adler 2000 // (C) Copyright Beman Dawes 2006, 2009, 2014 // (C) Copyright Peter Dimov 2019 // Distributed under the Boost Software License, Version 1.0. // See http://www.boost.org/LICENSE_1_0.txt // See library home page at http://www.boost.org/libs/endian //--------------------------------------------------------------------------------------// // Original design developed by Darin Adler based on classes developed by Mark // Borgerding. Four original class templates were combined into a single endian // class template by Beman Dawes, who also added the unrolled_byte_loops sign // partial specialization to correctly extend the sign when cover integer size // differs from endian representation size. // TODO: When a compiler supporting constexpr becomes available, try possible uses. #ifndef BOOST_ENDIAN_BUFFERS_HPP #define BOOST_ENDIAN_BUFFERS_HPP #if defined(_MSC_VER) # pragma warning(push) # pragma warning(disable: 4127) // conditional expression is constant #endif #include #include #include #include #include #include #include #include #include #include #include #if defined(__BORLANDC__) || defined( __CODEGEARC__) # pragma pack(push, 1) #endif # if CHAR_BIT != 8 # error Platforms with CHAR_BIT != 8 are not supported # endif # ifdef BOOST_NO_CXX11_DEFAULTED_FUNCTIONS # define BOOST_ENDIAN_DEFAULT_CONSTRUCT {} // C++03 # else # define BOOST_ENDIAN_DEFAULT_CONSTRUCT = default; // C++0x # endif // g++ pre-4.6 does not support unrestricted unions, but we have no Config macro for that # if (defined(BOOST_NO_CXX11_DEFAULTED_FUNCTIONS) || BOOST_WORKAROUND(BOOST_GCC, < 40600)) && defined(BOOST_ENDIAN_FORCE_PODNESS) # define BOOST_ENDIAN_NO_CTORS # endif //---------------------------------- synopsis ----------------------------------------// namespace boost { namespace endian { BOOST_SCOPED_ENUM_START(align) {no, yes # ifdef BOOST_ENDIAN_DEPRECATED_NAMES , unaligned = no, aligned = yes # endif }; BOOST_SCOPED_ENUM_END template class endian_buffer; // aligned big endian signed integer buffers typedef endian_buffer big_int8_buf_at; typedef endian_buffer big_int16_buf_at; typedef endian_buffer big_int32_buf_at; typedef endian_buffer big_int64_buf_at; // aligned big endian unsigned integer buffers typedef endian_buffer big_uint8_buf_at; typedef endian_buffer big_uint16_buf_at; typedef endian_buffer big_uint32_buf_at; typedef endian_buffer big_uint64_buf_at; // aligned little endian signed integer buffers typedef endian_buffer little_int8_buf_at; typedef endian_buffer little_int16_buf_at; typedef endian_buffer little_int32_buf_at; typedef endian_buffer little_int64_buf_at; // aligned little endian unsigned integer buffers typedef endian_buffer little_uint8_buf_at; typedef endian_buffer little_uint16_buf_at; typedef endian_buffer little_uint32_buf_at; typedef endian_buffer little_uint64_buf_at; // aligned floating point buffers typedef endian_buffer big_float32_buf_at; typedef endian_buffer big_float64_buf_at; typedef endian_buffer little_float32_buf_at; typedef endian_buffer little_float64_buf_at; // aligned native endian typedefs are not provided because // types are superior for this use case // unaligned big endian signed integer buffers typedef endian_buffer big_int8_buf_t; typedef endian_buffer big_int16_buf_t; typedef endian_buffer big_int24_buf_t; typedef endian_buffer big_int32_buf_t; typedef endian_buffer big_int40_buf_t; typedef endian_buffer big_int48_buf_t; typedef endian_buffer big_int56_buf_t; typedef endian_buffer big_int64_buf_t; // unaligned big endian unsigned integer buffers typedef endian_buffer big_uint8_buf_t; typedef endian_buffer big_uint16_buf_t; typedef endian_buffer big_uint24_buf_t; typedef endian_buffer big_uint32_buf_t; typedef endian_buffer big_uint40_buf_t; typedef endian_buffer big_uint48_buf_t; typedef endian_buffer big_uint56_buf_t; typedef endian_buffer big_uint64_buf_t; // unaligned little endian signed integer buffers typedef endian_buffer little_int8_buf_t; typedef endian_buffer little_int16_buf_t; typedef endian_buffer little_int24_buf_t; typedef endian_buffer little_int32_buf_t; typedef endian_buffer little_int40_buf_t; typedef endian_buffer little_int48_buf_t; typedef endian_buffer little_int56_buf_t; typedef endian_buffer little_int64_buf_t; // unaligned little endian unsigned integer buffers typedef endian_buffer little_uint8_buf_t; typedef endian_buffer little_uint16_buf_t; typedef endian_buffer little_uint24_buf_t; typedef endian_buffer little_uint32_buf_t; typedef endian_buffer little_uint40_buf_t; typedef endian_buffer little_uint48_buf_t; typedef endian_buffer little_uint56_buf_t; typedef endian_buffer little_uint64_buf_t; # if BOOST_ENDIAN_BIG_BYTE // unaligned native endian signed integer buffers typedef big_int8_buf_t native_int8_buf_t; typedef big_int16_buf_t native_int16_buf_t; typedef big_int24_buf_t native_int24_buf_t; typedef big_int32_buf_t native_int32_buf_t; typedef big_int40_buf_t native_int40_buf_t; typedef big_int48_buf_t native_int48_buf_t; typedef big_int56_buf_t native_int56_buf_t; typedef big_int64_buf_t native_int64_buf_t; // unaligned native endian unsigned integer buffers typedef big_uint8_buf_t native_uint8_buf_t; typedef big_uint16_buf_t native_uint16_buf_t; typedef big_uint24_buf_t native_uint24_buf_t; typedef big_uint32_buf_t native_uint32_buf_t; typedef big_uint40_buf_t native_uint40_buf_t; typedef big_uint48_buf_t native_uint48_buf_t; typedef big_uint56_buf_t native_uint56_buf_t; typedef big_uint64_buf_t native_uint64_buf_t; # else // unaligned native endian signed integer buffers typedef little_int8_buf_t native_int8_buf_t; typedef little_int16_buf_t native_int16_buf_t; typedef little_int24_buf_t native_int24_buf_t; typedef little_int32_buf_t native_int32_buf_t; typedef little_int40_buf_t native_int40_buf_t; typedef little_int48_buf_t native_int48_buf_t; typedef little_int56_buf_t native_int56_buf_t; typedef little_int64_buf_t native_int64_buf_t; // unaligned native endian unsigned integer buffers typedef little_uint8_buf_t native_uint8_buf_t; typedef little_uint16_buf_t native_uint16_buf_t; typedef little_uint24_buf_t native_uint24_buf_t; typedef little_uint32_buf_t native_uint32_buf_t; typedef little_uint40_buf_t native_uint40_buf_t; typedef little_uint48_buf_t native_uint48_buf_t; typedef little_uint56_buf_t native_uint56_buf_t; typedef little_uint64_buf_t native_uint64_buf_t; # endif // unaligned floating point buffers typedef endian_buffer big_float32_buf_t; typedef endian_buffer big_float64_buf_t; typedef endian_buffer little_float32_buf_t; typedef endian_buffer little_float64_buf_t; typedef endian_buffer native_float32_buf_t; typedef endian_buffer native_float64_buf_t; // Stream inserter template std::basic_ostream& operator<<(std::basic_ostream& os, const endian_buffer& x) { return os << x.value(); } // Stream extractor template std::basic_istream& operator>>(std::basic_istream& is, endian_buffer& x) { T i; if (is >> i) x = i; return is; } //---------------------------------- end synopsis ------------------------------------// // endian_buffer class template specializations --------------------------------------// // Specializations that represent unaligned bytes. // Taking an integer type as a parameter provides a nice way to pass both // the size and signedness of the desired integer and get the appropriate // corresponding integer type for the interface. // Q: Should endian_buffer supply "value_type operator value_type() const noexcept"? // A: No. The rationale for endian_buffers is to prevent high-cost hidden // conversions. If an implicit conversion operator is supplied, hidden conversions // can occur. // unaligned endian_buffer specialization template< BOOST_SCOPED_ENUM(order) Order, class T, std::size_t n_bits > class endian_buffer { private: BOOST_STATIC_ASSERT( (n_bits/8)*8 == n_bits ); unsigned char value_[ n_bits / 8 ]; public: typedef T value_type; #ifndef BOOST_ENDIAN_NO_CTORS endian_buffer() BOOST_ENDIAN_DEFAULT_CONSTRUCT explicit endian_buffer( T val ) BOOST_NOEXCEPT { boost::endian::endian_store( value_, val ); } #endif endian_buffer& operator=( T val ) BOOST_NOEXCEPT { boost::endian::endian_store( value_, val ); return *this; } value_type value() const BOOST_NOEXCEPT { return boost::endian::endian_load( value_ ); } unsigned char const * data() const BOOST_NOEXCEPT { return value_; } unsigned char * data() BOOST_NOEXCEPT { return value_; } }; // aligned specializations; only n_bits == 16/32/64 supported // aligned endian_buffer specialization template< BOOST_SCOPED_ENUM(order) Order, class T, std::size_t n_bits > class endian_buffer { private: BOOST_STATIC_ASSERT( (n_bits/8)*8 == n_bits ); BOOST_STATIC_ASSERT( sizeof(T) == n_bits/8 ); union { unsigned char value_[ n_bits / 8 ]; T align_; }; public: typedef T value_type; #ifndef BOOST_ENDIAN_NO_CTORS endian_buffer() BOOST_ENDIAN_DEFAULT_CONSTRUCT explicit endian_buffer( T val ) BOOST_NOEXCEPT { boost::endian::endian_store( value_, val ); } #endif endian_buffer& operator=( T val ) BOOST_NOEXCEPT { boost::endian::endian_store( value_, val ); return *this; } value_type value() const BOOST_NOEXCEPT { return boost::endian::endian_load( value_ ); } unsigned char const * data() const BOOST_NOEXCEPT { return value_; } unsigned char * data() BOOST_NOEXCEPT { return value_; } }; // aligned native endian_buffer specialization template< class T, std::size_t n_bits > class endian_buffer { private: BOOST_STATIC_ASSERT( (n_bits/8)*8 == n_bits ); BOOST_STATIC_ASSERT( sizeof(T) == n_bits/8 ); T value_; public: typedef T value_type; #ifndef BOOST_ENDIAN_NO_CTORS endian_buffer() BOOST_ENDIAN_DEFAULT_CONSTRUCT explicit endian_buffer( T val ) BOOST_NOEXCEPT: value_( val ) { } #endif endian_buffer& operator=( T val ) BOOST_NOEXCEPT { value_ = val; return *this; } value_type value() const BOOST_NOEXCEPT { return value_; } unsigned char const * data() const BOOST_NOEXCEPT { return reinterpret_cast< unsigned char const* >( &value_ ); } unsigned char * data() BOOST_NOEXCEPT { return reinterpret_cast< unsigned char* >( &value_ ); } }; } // namespace endian } // namespace boost #if defined(__BORLANDC__) || defined( __CODEGEARC__) # pragma pack(pop) #endif #if defined(_MSC_VER) # pragma warning(pop) #endif #endif // BOOST_ENDIAN_BUFFERS_HPP