/////////////////////////////////////////////////////////////////////////////// // // Copyright (c) 2015 Microsoft Corporation. All rights reserved. // // This code is licensed under the MIT License (MIT). // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN // THE SOFTWARE. // /////////////////////////////////////////////////////////////////////////////// #pragma once #ifndef GSL_BYTE_H #define GSL_BYTE_H #include <type_traits> #ifdef _MSC_VER #pragma warning(push) // don't warn about function style casts in byte related operators #pragma warning(disable : 26493) #ifndef GSL_USE_STD_BYTE // this tests if we are under MSVC and the standard lib has std::byte and it is enabled #if _MSC_VER >= 1911 && (!defined(_HAS_STD_BYTE) || _HAS_STD_BYTE) #define GSL_USE_STD_BYTE 1 #else // _MSC_VER >= 1911 && (!defined(_HAS_STD_BYTE) || _HAS_STD_BYTE) #define GSL_USE_STD_BYTE 0 #endif // _MSC_VER >= 1911 && (!defined(_HAS_STD_BYTE) || _HAS_STD_BYTE) #endif // GSL_USE_STD_BYTE #else // _MSC_VER #ifndef GSL_USE_STD_BYTE // this tests if we are under GCC or Clang with enough -std:c++1z power to get us std::byte #if defined(__cplusplus) && (__cplusplus >= 201703L) #define GSL_USE_STD_BYTE 1 #include <cstddef> #else // defined(__cplusplus) && (__cplusplus >= 201703L) #define GSL_USE_STD_BYTE 0 #endif //defined(__cplusplus) && (__cplusplus >= 201703L) #endif // GSL_USE_STD_BYTE #endif // _MSC_VER namespace gsl { #if GSL_USE_STD_BYTE using std::byte; using std::to_integer; #else // GSL_USE_STD_BYTE // This is a simple definition for now that allows // use of byte within span<> to be standards-compliant enum class byte : unsigned char { }; template <class IntegerType, class = std::enable_if_t<std::is_integral<IntegerType>::value>> inline constexpr byte& operator<<=(byte& b, IntegerType shift) noexcept { return b = byte(static_cast<unsigned char>(b) << shift); } template <class IntegerType, class = std::enable_if_t<std::is_integral<IntegerType>::value>> inline constexpr byte operator<<(byte b, IntegerType shift) noexcept { return byte(static_cast<unsigned char>(b) << shift); } template <class IntegerType, class = std::enable_if_t<std::is_integral<IntegerType>::value>> inline constexpr byte& operator>>=(byte& b, IntegerType shift) noexcept { return b = byte(static_cast<unsigned char>(b) >> shift); } template <class IntegerType, class = std::enable_if_t<std::is_integral<IntegerType>::value>> inline constexpr byte operator>>(byte b, IntegerType shift) noexcept { return byte(static_cast<unsigned char>(b) >> shift); } inline constexpr byte& operator|=(byte& l, byte r) noexcept { return l = byte(static_cast<unsigned char>(l) | static_cast<unsigned char>(r)); } inline constexpr byte operator|(byte l, byte r) noexcept { return byte(static_cast<unsigned char>(l) | static_cast<unsigned char>(r)); } inline constexpr byte& operator&=(byte& l, byte r) noexcept { return l = byte(static_cast<unsigned char>(l) & static_cast<unsigned char>(r)); } inline constexpr byte operator&(byte l, byte r) noexcept { return byte(static_cast<unsigned char>(l) & static_cast<unsigned char>(r)); } inline constexpr byte& operator^=(byte& l, byte r) noexcept { return l = byte(static_cast<unsigned char>(l) ^ static_cast<unsigned char>(r)); } inline constexpr byte operator^(byte l, byte r) noexcept { return byte(static_cast<unsigned char>(l) ^ static_cast<unsigned char>(r)); } inline constexpr byte operator~(byte b) noexcept { return byte(~static_cast<unsigned char>(b)); } template <class IntegerType, class = std::enable_if_t<std::is_integral<IntegerType>::value>> inline constexpr IntegerType to_integer(byte b) noexcept { return static_cast<IntegerType>(b); } #endif // GSL_USE_STD_BYTE template <bool E, typename T> inline constexpr byte to_byte_impl(T t) noexcept { static_assert( E, "gsl::to_byte(t) must be provided an unsigned char, otherwise data loss may occur. " "If you are calling to_byte with an integer contant use: gsl::to_byte<t>() version."); return static_cast<byte>(t); } template <> inline constexpr byte to_byte_impl<true, unsigned char>(unsigned char t) noexcept { return byte(t); } template <typename T> inline constexpr byte to_byte(T t) noexcept { return to_byte_impl<std::is_same<T, unsigned char>::value, T>(t); } template <int I> inline constexpr byte to_byte() noexcept { static_assert(I >= 0 && I <= 255, "gsl::byte only has 8 bits of storage, values must be in range 0-255"); return static_cast<byte>(I); } } // namespace gsl #ifdef _MSC_VER #pragma warning(pop) #endif // _MSC_VER #endif // GSL_BYTE_H