/**************************************************************************** ** ** Copyright (C) 2017 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the QtCore module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 3 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL3 included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 3 requirements ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 2.0 or (at your option) the GNU General ** Public license version 3 or any later version approved by the KDE Free ** Qt Foundation. The licenses are as published by the Free Software ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-2.0.html and ** https://www.gnu.org/licenses/gpl-3.0.html. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QENDIAN_P_H #define QENDIAN_P_H // // W A R N I N G // ------------- // // This file is not part of the Qt API. It exists purely as an // implementation detail. This header file may change from version to // version without notice, or even be removed. // // We mean it. // #include #include QT_BEGIN_NAMESPACE // Note if using multiple of these bitfields in a union; the underlying storage type must // match. Since we always use an unsigned storage type, unsigned and signed versions may // be used together, but different bit-widths may not. template class QSpecialIntegerBitfield { protected: typedef typename S::StorageType T; typedef typename std::make_unsigned::type UT; static Q_DECL_CONSTEXPR UT mask() { return ((UT(1) << width) - 1) << pos; } public: // FIXME: val is public until qtdeclarative is fixed to not access it directly. UT val; QSpecialIntegerBitfield &operator =(T t) { UT i = S::fromSpecial(val); i &= ~mask(); i |= (UT(t) << pos) & mask(); val = S::toSpecial(i); return *this; } operator T() const { if (std::is_signed::value) { UT i = S::fromSpecial(val); i <<= (sizeof(T) * 8) - width - pos; T t = T(i); t >>= (sizeof(T) * 8) - width; return t; } return (S::fromSpecial(val) & mask()) >> pos; } bool operator !() const { return !(val & S::toSpecial(mask())); } bool operator ==(QSpecialIntegerBitfield i) const { return ((val ^ i.val) & S::toSpecial(mask())) == 0; } bool operator !=(QSpecialIntegerBitfield i) const { return ((val ^ i.val) & S::toSpecial(mask())) != 0; } QSpecialIntegerBitfield &operator +=(T i) { return (*this = (T(*this) + i)); } QSpecialIntegerBitfield &operator -=(T i) { return (*this = (T(*this) - i)); } QSpecialIntegerBitfield &operator *=(T i) { return (*this = (T(*this) * i)); } QSpecialIntegerBitfield &operator /=(T i) { return (*this = (T(*this) / i)); } QSpecialIntegerBitfield &operator %=(T i) { return (*this = (T(*this) % i)); } QSpecialIntegerBitfield &operator |=(T i) { return (*this = (T(*this) | i)); } QSpecialIntegerBitfield &operator &=(T i) { return (*this = (T(*this) & i)); } QSpecialIntegerBitfield &operator ^=(T i) { return (*this = (T(*this) ^ i)); } QSpecialIntegerBitfield &operator >>=(T i) { return (*this = (T(*this) >> i)); } QSpecialIntegerBitfield &operator <<=(T i) { return (*this = (T(*this) << i)); } }; template using QLEIntegerBitfield = QSpecialIntegerBitfield, pos, width>; template using QBEIntegerBitfield = QSpecialIntegerBitfield, pos, width>; template using qint32_le_bitfield = QLEIntegerBitfield; template using quint32_le_bitfield = QLEIntegerBitfield; template using qint32_be_bitfield = QBEIntegerBitfield; template using quint32_be_bitfield = QBEIntegerBitfield; enum class QSpecialIntegerBitfieldInitializer {}; constexpr QSpecialIntegerBitfieldInitializer QSpecialIntegerBitfieldZero{}; template class QSpecialIntegerStorage { public: using UnsignedStorageType = typename std::make_unsigned::type; constexpr QSpecialIntegerStorage() = default; constexpr QSpecialIntegerStorage(QSpecialIntegerBitfieldInitializer) : val(0) {} constexpr QSpecialIntegerStorage(UnsignedStorageType initial) : val(initial) {} UnsignedStorageType val; }; template class QSpecialIntegerAccessor; template class QSpecialIntegerConstAccessor { Q_DISABLE_COPY(QSpecialIntegerConstAccessor) public: using Storage = const QSpecialIntegerStorage; using Type = T; using UnsignedType = typename std::make_unsigned::type; QSpecialIntegerConstAccessor(QSpecialIntegerConstAccessor &&) noexcept = default; QSpecialIntegerConstAccessor &operator=(QSpecialIntegerConstAccessor &&) noexcept = default; operator Type() const noexcept { if (std::is_signed::value) { UnsignedType i = S::fromSpecial(storage->val); i <<= (sizeof(Type) * 8) - width - pos; Type t = Type(i); t >>= (sizeof(Type) * 8) - width; return t; } return (S::fromSpecial(storage->val) & mask()) >> pos; } bool operator!() const noexcept { return !(storage->val & S::toSpecial(mask())); } static constexpr UnsignedType mask() noexcept { return ((UnsignedType(1) << width) - 1) << pos; } private: template friend class QSpecialIntegerBitfieldUnion; friend class QSpecialIntegerAccessor; explicit QSpecialIntegerConstAccessor(Storage *storage) : storage(storage) {} friend bool operator==(const QSpecialIntegerConstAccessor &i, const QSpecialIntegerConstAccessor &j) noexcept { return ((i.storage->val ^ j.storage->val) & S::toSpecial(mask())) == 0; } friend bool operator!=(const QSpecialIntegerConstAccessor &i, const QSpecialIntegerConstAccessor &j) noexcept { return ((i.storage->val ^ j.storage->val) & S::toSpecial(mask())) != 0; } Storage *storage; }; template class QSpecialIntegerAccessor { Q_DISABLE_COPY(QSpecialIntegerAccessor) public: using Const = QSpecialIntegerConstAccessor; using Storage = QSpecialIntegerStorage; using Type = T; using UnsignedType = typename std::make_unsigned::type; QSpecialIntegerAccessor(QSpecialIntegerAccessor &&) noexcept = default; QSpecialIntegerAccessor &operator=(QSpecialIntegerAccessor &&) noexcept = default; QSpecialIntegerAccessor &operator=(Type t) { UnsignedType i = S::fromSpecial(storage->val); i &= ~Const::mask(); i |= (UnsignedType(t) << pos) & Const::mask(); storage->val = S::toSpecial(i); return *this; } operator Const() { return Const(storage); } private: template friend class QSpecialIntegerBitfieldUnion; explicit QSpecialIntegerAccessor(Storage *storage) : storage(storage) {} Storage *storage; }; template class QSpecialIntegerBitfieldUnion { public: constexpr QSpecialIntegerBitfieldUnion() = default; constexpr QSpecialIntegerBitfieldUnion(QSpecialIntegerBitfieldInitializer initial) : storage(initial) {} constexpr QSpecialIntegerBitfieldUnion( typename QSpecialIntegerStorage::UnsignedStorageType initial) : storage(initial) {} template void set(typename A::Type value) { member() = value; } template typename A::Type get() const { return member(); } typename QSpecialIntegerStorage::UnsignedStorageType data() const { return storage.val; } private: template struct Contains : std::false_type { }; template struct Contains : std::is_same { }; template struct Contains : std::conditional::value, std::true_type, Contains>::type {}; template using IsAccessor = Contains; template A member() { Q_STATIC_ASSERT(IsAccessor::value); return A(&storage); } template typename A::Const member() const { Q_STATIC_ASSERT(IsAccessor::value); return typename A::Const(&storage); } QSpecialIntegerStorage storage; }; template using QLEIntegerBitfieldUnion = QSpecialIntegerBitfieldUnion, Accessors...>; template using QBEIntegerBitfieldUnion = QSpecialIntegerBitfieldUnion, Accessors...>; template using qint32_le_bitfield_union = QLEIntegerBitfieldUnion; template using quint32_le_bitfield_union = QLEIntegerBitfieldUnion; template using qint32_be_bitfield_union = QBEIntegerBitfieldUnion; template using quint32_be_bitfield_union = QBEIntegerBitfieldUnion; template using qint32_le_bitfield_member = QSpecialIntegerAccessor, pos, width, T>; template using quint32_le_bitfield_member = QSpecialIntegerAccessor, pos, width, T>; template using qint32_be_bitfield_member = QSpecialIntegerAccessor, pos, width, T>; template using quint32_be_bitfield_member = QSpecialIntegerAccessor, pos, width, T>; QT_END_NAMESPACE #endif // QENDIAN_P_H