1/****************************************************************************
2**
3** Copyright (C) 2017 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the QtCore module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 3 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPL3 included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 3 requirements
23** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
24**
25** GNU General Public License Usage
26** Alternatively, this file may be used under the terms of the GNU
27** General Public License version 2.0 or (at your option) the GNU General
28** Public license version 3 or any later version approved by the KDE Free
29** Qt Foundation. The licenses are as published by the Free Software
30** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
31** included in the packaging of this file. Please review the following
32** information to ensure the GNU General Public License requirements will
33** be met: https://www.gnu.org/licenses/gpl-2.0.html and
34** https://www.gnu.org/licenses/gpl-3.0.html.
35**
36** $QT_END_LICENSE$
37**
38****************************************************************************/
39
40#ifndef QENDIAN_P_H
41#define QENDIAN_P_H
42
43//
44// W A R N I N G
45// -------------
46//
47// This file is not part of the Qt API. It exists purely as an
48// implementation detail. This header file may change from version to
49// version without notice, or even be removed.
50//
51// We mean it.
52//
53
54#include <QtCore/qendian.h>
55
56QT_BEGIN_NAMESPACE
57
58// Note if using multiple of these bitfields in a union; the underlying storage type must
59// match. Since we always use an unsigned storage type, unsigned and signed versions may
60// be used together, but different bit-widths may not.
61template<class S, int pos, int width>
62class QSpecialIntegerBitfield
63{
64protected:
65 typedef typename S::StorageType T;
66 typedef typename std::make_unsigned<T>::type UT;
67
68 static constexpr UT mask()
69 {
70 return ((UT(1) << width) - 1) << pos;
71 }
72public:
73 // FIXME: val is public until qtdeclarative is fixed to not access it directly.
74 UT val;
75
76 QSpecialIntegerBitfield &operator=(T t)
77 {
78 UT i = S::fromSpecial(val);
79 i &= ~mask();
80 i |= (UT(t) << pos) & mask();
81 val = S::toSpecial(i);
82 return *this;
83 }
84 operator T() const
85 {
86 if (std::is_signed<T>::value) {
87 UT i = S::fromSpecial(val);
88 i <<= (sizeof(T) * 8) - width - pos;
89 T t = T(i);
90 t >>= (sizeof(T) * 8) - width;
91 return t;
92 }
93 return (S::fromSpecial(val) & mask()) >> pos;
94 }
95
96 bool operator!() const { return !(val & S::toSpecial(mask())); }
97 bool operator==(QSpecialIntegerBitfield<S, pos, width> i) const
98 {
99 return ((val ^ i.val) & S::toSpecial(mask())) == 0;
100 }
101 bool operator!=(QSpecialIntegerBitfield<S, pos, width> i) const
102 {
103 return ((val ^ i.val) & S::toSpecial(mask())) != 0;
104 }
105
106 QSpecialIntegerBitfield &operator+=(T i) { return (*this = (T(*this) + i)); }
107 QSpecialIntegerBitfield &operator-=(T i) { return (*this = (T(*this) - i)); }
108 QSpecialIntegerBitfield &operator*=(T i) { return (*this = (T(*this) * i)); }
109 QSpecialIntegerBitfield &operator/=(T i) { return (*this = (T(*this) / i)); }
110 QSpecialIntegerBitfield &operator%=(T i) { return (*this = (T(*this) % i)); }
111 QSpecialIntegerBitfield &operator|=(T i) { return (*this = (T(*this) | i)); }
112 QSpecialIntegerBitfield &operator&=(T i) { return (*this = (T(*this) & i)); }
113 QSpecialIntegerBitfield &operator^=(T i) { return (*this = (T(*this) ^ i)); }
114 QSpecialIntegerBitfield &operator>>=(T i) { return (*this = (T(*this) >> i)); }
115 QSpecialIntegerBitfield &operator<<=(T i) { return (*this = (T(*this) << i)); }
116};
117
118template<typename T, int pos, int width>
119using QLEIntegerBitfield = QSpecialIntegerBitfield<QLittleEndianStorageType<T>, pos, width>;
120
121template<typename T, int pos, int width>
122using QBEIntegerBitfield = QSpecialIntegerBitfield<QBigEndianStorageType<T>, pos, width>;
123
124template<int pos, int width>
125using qint32_le_bitfield = QLEIntegerBitfield<int, pos, width>;
126template<int pos, int width>
127using quint32_le_bitfield = QLEIntegerBitfield<uint, pos, width>;
128template<int pos, int width>
129using qint32_be_bitfield = QBEIntegerBitfield<int, pos, width>;
130template<int pos, int width>
131using quint32_be_bitfield = QBEIntegerBitfield<uint, pos, width>;
132
133QT_END_NAMESPACE
134
135#endif // QENDIAN_P_H
136