89 typedef char storage_type;
90 typedef const char value_type;
91 typedef qptrdiff difference_type;
92 typedef qsizetype size_type;
93 typedef value_type &reference;
94 typedef value_type &const_reference;
95 typedef value_type *pointer;
96 typedef value_type *const_pointer;
98 typedef pointer iterator;
99 typedef const_pointer const_iterator;
100 typedef std::reverse_iterator<iterator> reverse_iterator;
101 typedef std::reverse_iterator<const_iterator> const_reverse_iterator;
104 template <
typename Byte>
105 using if_compatible_byte =
106 typename std::enable_if_t<QtPrivate::IsCompatibleByteType<Byte>::value,
bool>;
108 template <
typename Pointer>
109 using if_compatible_pointer =
110 typename std::enable_if_t<QtPrivate::IsCompatibleByteArrayPointer<Pointer>::value,
113 template <
typename T>
114 using if_compatible_qbytearray_like =
115 typename std::enable_if_t<std::is_same_v<T, QByteArray>,
bool>;
117 template <
typename T>
118 using if_compatible_container =
119 typename std::enable_if_t<QtPrivate::IsContainerCompatibleWithQByteArrayView<T>::value,
122 template <
typename Container>
123 static constexpr qsizetype lengthHelperContainer(
const Container &c)
noexcept
125 return qsizetype(std::size(c));
128 static constexpr qsizetype lengthHelperCharArray(
const char *data, size_t size)
noexcept
130 const auto it = std::char_traits<
char>::find(data, size,
'\0');
131 const auto end = it ? it : std::next(data, size);
132 return qsizetype(std::distance(data, end));
135 template <
typename Byte>
136 static const storage_type *castHelper(
const Byte *data)
noexcept
137 {
return reinterpret_cast<
const storage_type*>(data); }
138 static constexpr const storage_type *castHelper(
const storage_type *data)
noexcept
142 constexpr QByteArrayView() =
default;
143 constexpr QByteArrayView(std::nullptr_t)
noexcept
144 : QByteArrayView() {}
146 template <
typename Byte, if_compatible_byte<Byte> =
true>
147 constexpr QByteArrayView(
const Byte *data, qsizetype len)
148#if QT_VERSION >= QT_VERSION_CHECK(7
, 0
, 0
) || defined(QT_BOOTSTRAPPED)
149 : m_data(castHelper(data)),
150 m_size((Q_ASSERT(len >= 0), Q_ASSERT(data || !len), len)) {}
152 : m_size((Q_ASSERT(len >= 0), Q_ASSERT(data || !len), len)),
153 m_data(castHelper(data)) {}
156 template <
typename Byte, if_compatible_byte<Byte> =
true>
157 constexpr QByteArrayView(
const Byte *first,
const Byte *last)
158 : QByteArrayView(first, last - first) {}
161 template <
typename Byte>
162 constexpr QByteArrayView(
const Byte *data)
noexcept;
164 template <
typename Pointer, if_compatible_pointer<Pointer> =
true>
165 constexpr QByteArrayView(
const Pointer &data)
noexcept
167 data, data ? QtPrivate::lengthHelperPointer(data) : 0) {}
171 QByteArrayView(
const QByteArray &data)
noexcept;
173 template <
typename ByteArray, if_compatible_qbytearray_like<ByteArray> =
true>
174 QByteArrayView(
const ByteArray &ba)
noexcept
175 : QByteArrayView{ba.begin(), ba.size()} {}
178 template <
typename Container, if_compatible_container<Container> =
true>
179 constexpr QByteArrayView(
const Container &c)
noexcept
180 : QByteArrayView(std::data(c), lengthHelperContainer(c)) {}
181 template <size_t Size>
182 constexpr QByteArrayView(
const char (&data)[Size])
noexcept
183 : QByteArrayView(data, lengthHelperCharArray(data, Size)) {}
185 template <
typename Byte, if_compatible_byte<Byte> =
true>
186 constexpr QByteArrayView(
const Byte (&data)[])
noexcept
187 : QByteArrayView(&*data) {}
190 template <
typename Byte, size_t Size>
192 template <
typename Byte, size_t Size, if_compatible_byte<Byte> =
true>
194 [[nodiscard]]
constexpr static QByteArrayView fromArray(
const Byte (&data)[Size])
noexcept
195 {
return QByteArrayView(data, Size); }
196 [[nodiscard]]
inline QByteArray toByteArray()
const;
198 [[nodiscard]]
constexpr qsizetype size()
const noexcept {
return m_size; }
199 [[nodiscard]]
constexpr const_pointer data()
const noexcept {
return m_data; }
200 [[nodiscard]]
constexpr const_pointer constData()
const noexcept {
return data(); }
202 [[nodiscard]]
constexpr char operator[](qsizetype n)
const
203 { verify(n, 1);
return m_data[n]; }
208 [[nodiscard]]
constexpr char at(qsizetype n)
const {
return (*
this)[n]; }
210 [[nodiscard]]
constexpr QByteArrayView first(qsizetype n)
const
211 { verify(0, n);
return sliced(0, n); }
212 [[nodiscard]]
constexpr QByteArrayView last(qsizetype n)
const
213 { verify(0, n);
return sliced(size() - n, n); }
214 [[nodiscard]]
constexpr QByteArrayView sliced(qsizetype pos)
const
215 { verify(pos, 0);
return QByteArrayView(data() + pos, size() - pos); }
216 [[nodiscard]]
constexpr QByteArrayView sliced(qsizetype pos, qsizetype n)
const
217 { verify(pos, n);
return QByteArrayView(data() + pos, n); }
219 constexpr QByteArrayView &slice(qsizetype pos)
220 { *
this = sliced(pos);
return *
this; }
221 constexpr QByteArrayView &slice(qsizetype pos, qsizetype n)
222 { *
this = sliced(pos, n);
return *
this; }
224 [[nodiscard]]
constexpr QByteArrayView chopped(qsizetype len)
const
225 { verify(0, len);
return sliced(0, size() - len); }
227 [[nodiscard]]
constexpr QByteArrayView left(qsizetype n)
const
228 {
if (n < 0 || n > size()) n = size();
return QByteArrayView(data(), n); }
229 [[nodiscard]]
constexpr QByteArrayView right(qsizetype n)
const
230 {
if (n < 0 || n > size()) n = size();
if (n < 0) n = 0;
return QByteArrayView(data() + size() - n, n); }
231 [[nodiscard]]
constexpr QByteArrayView mid(qsizetype pos, qsizetype n = -1)
const
233 using namespace QtPrivate;
234 auto result = QContainerImplHelper::mid(size(), &pos, &n);
235 return result == QContainerImplHelper::Null ? QByteArrayView()
236 : QByteArrayView(m_data + pos, n);
239 constexpr void truncate(qsizetype n)
240 { verify(0, n); m_size = n; }
241 constexpr void chop(qsizetype n)
242 { verify(0, n); m_size -= n; }
245 [[nodiscard]] QByteArrayView trimmed()
const noexcept
246 {
return QtPrivate::trimmed(*
this); }
247 [[nodiscard]]
short toShort(
bool *ok =
nullptr,
int base = 10)
const
248 {
return QtPrivate::toIntegral<
short>(*
this, ok, base); }
249 [[nodiscard]] ushort toUShort(
bool *ok =
nullptr,
int base = 10)
const
250 {
return QtPrivate::toIntegral<ushort>(*
this, ok, base); }
251 [[nodiscard]]
int toInt(
bool *ok =
nullptr,
int base = 10)
const
252 {
return QtPrivate::toIntegral<
int>(*
this, ok, base); }
253 [[nodiscard]] uint toUInt(
bool *ok =
nullptr,
int base = 10)
const
254 {
return QtPrivate::toIntegral<uint>(*
this, ok, base); }
255 [[nodiscard]]
long toLong(
bool *ok =
nullptr,
int base = 10)
const
256 {
return QtPrivate::toIntegral<
long>(*
this, ok, base); }
257 [[nodiscard]] ulong toULong(
bool *ok =
nullptr,
int base = 10)
const
258 {
return QtPrivate::toIntegral<ulong>(*
this, ok, base); }
259 [[nodiscard]] qlonglong toLongLong(
bool *ok =
nullptr,
int base = 10)
const
260 {
return QtPrivate::toIntegral<qlonglong>(*
this, ok, base); }
261 [[nodiscard]] qulonglong toULongLong(
bool *ok =
nullptr,
int base = 10)
const
262 {
return QtPrivate::toIntegral<qulonglong>(*
this, ok, base); }
263 [[nodiscard]]
float toFloat(
bool *ok =
nullptr)
const
265 const auto r = QtPrivate::toFloat(*
this);
268 return r.value_or(0.0f);
270 [[nodiscard]]
double toDouble(
bool *ok =
nullptr)
const
272 const auto r = QtPrivate::toDouble(*
this);
275 return r.value_or(0.0);
278 [[nodiscard]]
bool startsWith(QByteArrayView other)
const noexcept
279 {
return QtPrivate::startsWith(*
this, other); }
280 [[nodiscard]]
constexpr bool startsWith(
char c)
const noexcept
281 {
return !empty() && front() == c; }
283 [[nodiscard]]
bool endsWith(QByteArrayView other)
const noexcept
284 {
return QtPrivate::endsWith(*
this, other); }
285 [[nodiscard]]
constexpr bool endsWith(
char c)
const noexcept
286 {
return !empty() && back() == c; }
288 [[nodiscard]] qsizetype indexOf(QByteArrayView a, qsizetype from = 0)
const noexcept
289 {
return QtPrivate::findByteArray(*
this, from, a); }
290 [[nodiscard]] qsizetype indexOf(
char ch, qsizetype from = 0)
const noexcept
291 {
return QtPrivate::findByteArray(*
this, from, ch); }
293 [[nodiscard]]
bool contains(QByteArrayView a)
const noexcept
294 {
return indexOf(a) != qsizetype(-1); }
295 [[nodiscard]]
bool contains(
char c)
const noexcept
296 {
return indexOf(c) != qsizetype(-1); }
298 [[nodiscard]] qsizetype lastIndexOf(QByteArrayView a)
const noexcept
299 {
return lastIndexOf(a, size()); }
300 [[nodiscard]] qsizetype lastIndexOf(QByteArrayView a, qsizetype from)
const noexcept
301 {
return QtPrivate::lastIndexOf(*
this, from, a); }
302 [[nodiscard]] qsizetype lastIndexOf(
char ch, qsizetype from = -1)
const noexcept
303 {
return QtPrivate::lastIndexOf(*
this, from, ch); }
305 [[nodiscard]] qsizetype count(QByteArrayView a)
const noexcept
306 {
return QtPrivate::count(*
this, a); }
307 [[nodiscard]] qsizetype count(
char ch)
const noexcept
308 {
return QtPrivate::count(*
this, QByteArrayView(&ch, 1)); }
310 inline int compare(QByteArrayView a, Qt::CaseSensitivity cs = Qt::CaseSensitive)
const noexcept;
312 [[nodiscard]]
inline bool isValidUtf8()
const noexcept {
return QtPrivate::isValidUtf8(*
this); }
317 [[nodiscard]]
constexpr const_iterator begin()
const noexcept {
return data(); }
318 [[nodiscard]]
constexpr const_iterator end()
const noexcept {
return data() + size(); }
319 [[nodiscard]]
constexpr const_iterator cbegin()
const noexcept {
return begin(); }
320 [[nodiscard]]
constexpr const_iterator cend()
const noexcept {
return end(); }
321 [[nodiscard]]
constexpr const_reverse_iterator rbegin()
const noexcept {
return const_reverse_iterator(end()); }
322 [[nodiscard]]
constexpr const_reverse_iterator rend()
const noexcept {
return const_reverse_iterator(begin()); }
323 [[nodiscard]]
constexpr const_reverse_iterator crbegin()
const noexcept {
return rbegin(); }
324 [[nodiscard]]
constexpr const_reverse_iterator crend()
const noexcept {
return rend(); }
326 [[nodiscard]]
constexpr bool empty()
const noexcept {
return size() == 0; }
327 [[nodiscard]]
constexpr char front()
const { Q_ASSERT(!empty());
return m_data[0]; }
328 [[nodiscard]]
constexpr char back()
const { Q_ASSERT(!empty());
return m_data[m_size - 1]; }
330 [[nodiscard]]
constexpr Q_IMPLICIT operator std::string_view()
const noexcept
331 {
return std::string_view(m_data, size_t(m_size)); }
333 [[nodiscard]]
constexpr qsizetype max_size()
const noexcept {
return maxSize(); }
338 [[nodiscard]]
constexpr bool isNull()
const noexcept {
return !m_data; }
339 [[nodiscard]]
constexpr bool isEmpty()
const noexcept {
return empty(); }
340 [[nodiscard]]
constexpr qsizetype length()
const noexcept
342 [[nodiscard]]
constexpr char first()
const {
return front(); }
343 [[nodiscard]]
constexpr char last()
const {
return back(); }
345 [[nodiscard]]
static constexpr qsizetype maxSize()
noexcept
348 return QtPrivate::MaxAllocSize - 1;
352 Q_ALWAYS_INLINE
constexpr void verify([[maybe_unused]] qsizetype pos = 0,
353 [[maybe_unused]] qsizetype n = 1)
const
356 Q_ASSERT(pos <= size());
358 Q_ASSERT(n <= size() - pos);
362 comparesEqual(
const QByteArrayView &lhs,
const QByteArrayView &rhs)
noexcept
364 return lhs.size() == rhs.size()
365 && (!lhs.size() || memcmp(lhs.data(), rhs.data(), lhs.size()) == 0);
367 friend Qt::strong_ordering
368 compareThreeWay(
const QByteArrayView &lhs,
const QByteArrayView &rhs)
noexcept
370 const int res = QtPrivate::compareMemory(lhs, rhs);
371 return Qt::compareThreeWay(res, 0);
373 Q_DECLARE_STRONGLY_ORDERED(QByteArrayView)
376 friend Q_CORE_EXPORT
bool
377 comparesEqual(
const QByteArrayView &lhs,
const QChar &rhs)
noexcept;
378 friend Q_CORE_EXPORT Qt::strong_ordering
379 compareThreeWay(
const QByteArrayView &lhs,
const QChar &rhs)
noexcept;
380 friend Q_CORE_EXPORT
bool
381 comparesEqual(
const QByteArrayView &lhs,
char16_t rhs)
noexcept;
382 friend Q_CORE_EXPORT Qt::strong_ordering
383 compareThreeWay(
const QByteArrayView &lhs,
char16_t rhs)
noexcept;
384#if !defined(QT_NO_CAST_FROM_ASCII) && !defined(QT_RESTRICTED_CAST_FROM_ASCII)
385 Q_DECLARE_STRONGLY_ORDERED(QByteArrayView, QChar, QT_ASCII_CAST_WARN)
386 Q_DECLARE_STRONGLY_ORDERED(QByteArrayView,
char16_t, QT_ASCII_CAST_WARN)
389#if QT_VERSION >= QT_VERSION_CHECK(7
, 0
, 0
) || defined(QT_BOOTSTRAPPED)
390 const storage_type *m_data =
nullptr;
391 qsizetype m_size = 0;
393 qsizetype m_size = 0;
394 const storage_type *m_data =
nullptr;