Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qbytearray.h
Go to the documentation of this file.
1// Copyright (C) 2022 The Qt Company Ltd.
2// Copyright (C) 2016 Intel Corporation.
3// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
4// Qt-Security score:critical reason:data-parser
5
6#ifndef QBYTEARRAY_H
7#define QBYTEARRAY_H
8
9#include <QtCore/qrefcount.h>
10#include <QtCore/qnamespace.h>
11#include <QtCore/qarraydata.h>
12#include <QtCore/qarraydatapointer.h>
13#include <QtCore/qcompare.h>
14#include <QtCore/qcontainerfwd.h>
15#include <QtCore/qbytearrayalgorithms.h>
16#include <QtCore/qbytearrayview.h>
17
18#include <stdlib.h>
19#include <string.h>
20
21#include <string>
22#include <iterator>
23
24#ifndef QT5_NULL_STRINGS
25// Would ideally be off, but in practice breaks too much (Qt 6.0).
26#define QT5_NULL_STRINGS 1
27#endif
28
29#ifdef truncate
30#error qbytearray.h must be included before any header file that defines truncate
31#endif
32
33#if defined(Q_OS_DARWIN) || defined(Q_QDOC)
34Q_FORWARD_DECLARE_CF_TYPE(CFData);
35Q_FORWARD_DECLARE_OBJC_CLASS(NSData);
36#endif
37
38#if defined(Q_OS_WASM) || defined(Q_QDOC)
39namespace emscripten {
40 class val;
41}
42#endif
43
44class tst_QByteArray;
45
46QT_BEGIN_NAMESPACE
47
48class QString;
49class QDataStream;
50
51using QByteArrayData = QArrayDataPointer<char>;
52
53# define QByteArrayLiteral(str)
54 (QByteArray(QByteArrayData(nullptr, const_cast<char *>(str), sizeof(str) - 1)))
55 /**/
56
57class Q_CORE_EXPORT QByteArray
58{
59public:
60 using DataPointer = QByteArrayData;
61private:
62 typedef QTypedArrayData<char> Data;
63
64 DataPointer d;
65 static const char _empty;
66
67 friend class ::tst_QByteArray;
68
69 template <typename InputIterator>
70 using if_input_iterator = QtPrivate::IfIsInputIterator<InputIterator>;
71public:
72 enum Base64Option {
73 Base64Encoding = 0,
74 Base64UrlEncoding = 1,
75
76 KeepTrailingEquals = 0,
77 OmitTrailingEquals = 2,
78
79 IgnoreBase64DecodingErrors = 0,
80 AbortOnBase64DecodingErrors = 4,
81 };
82 Q_DECLARE_FLAGS(Base64Options, Base64Option)
83
84 enum class Base64DecodingStatus {
85 Ok,
86 IllegalInputLength,
87 IllegalCharacter,
88 IllegalPadding,
89 };
90
91 constexpr QByteArray() noexcept = default;
92 QByteArray(const char *, qsizetype size = -1);
93 QByteArray(qsizetype size, char c);
94 QByteArray(qsizetype size, Qt::Initialization);
95 explicit QByteArray(QByteArrayView v) : QByteArray(v.data(), v.size()) {}
96 Q_DECL_CONSTEXPR_DTOR QByteArray(const QByteArray &other) noexcept : d(other.d) {}
97#if QT_VERSION < QT_VERSION_CHECK(7, 0, 0) && !defined(QT_BOOTSTRAPPED)
98 Q_DECL_CONSTEXPR_DTOR ~QByteArray() = default;
99#endif
100
101 QT_CORE_CONSTEXPR_DTOR_INLINE_SINCE(6, 13)
102 QByteArray &operator=(const QByteArray &) noexcept;
103 QByteArray &operator=(const char *str);
104 Q_DECL_CONSTEXPR_DTOR QByteArray(QByteArray &&other) noexcept = default;
105 Q_DECL_CONSTEXPR_DTOR
106 QT_MOVE_ASSIGNMENT_OPERATOR_IMPL_VIA_PURE_SWAP(QByteArray)
107 constexpr void swap(QByteArray &other) noexcept
108 { d.swap(other.d); }
109
110 constexpr bool isEmpty() const noexcept { return size() == 0; }
111 void resize(qsizetype size);
112 void resize(qsizetype size, char c);
113 void resizeForOverwrite(qsizetype size);
114
115 QByteArray &fill(char c, qsizetype size = -1);
116
117 inline qsizetype capacity() const;
118 inline void reserve(qsizetype size);
119 inline void squeeze();
120
121#ifndef QT_NO_CAST_FROM_BYTEARRAY
122 inline operator const char *() const;
123 inline operator const void *() const;
124#endif
125
126 // Some compilers consider this conversion ambiguous, so
127 // we're not offering it there:
128 // * QCC 8.3 on QNX
129 // * GHS 2022.1.4 on INTEGRITY
130#if (!defined(Q_OS_QNX) || !defined(Q_CC_GNU_ONLY) || Q_CC_GNU_ONLY > 803) &&
131 (!defined(Q_CC_GHS) || !defined(__GHS_VERSION_NUMBER) || __GHS_VERSION_NUMBER > 202214)
132# define QT_BYTEARRAY_CONVERTS_TO_STD_STRING_VIEW
133 constexpr Q_IMPLICIT operator std::string_view() const noexcept
134 { return std::string_view(data(), std::size_t(size())); }
135#endif
136
137 inline char *data();
138 constexpr
139 inline const char *data() const noexcept;
140 constexpr
141 const char *constData() const noexcept { return data(); }
142 inline void detach();
143 inline bool isDetached() const;
144 inline bool isSharedWith(const QByteArray &other) const noexcept
145 { return data() == other.data() && size() == other.size(); }
146 void clear();
147
148 constexpr
149 inline char at(qsizetype i) const;
150 constexpr
151 inline char operator[](qsizetype i) const;
152 [[nodiscard]] inline char &operator[](qsizetype i);
153 [[nodiscard]] constexpr char front() const { return at(0); }
154 [[nodiscard]] inline char &front();
155 [[nodiscard]] constexpr char back() const { return at(size() - 1); }
156 [[nodiscard]] inline char &back();
157
158 QT_CORE_INLINE_SINCE(6, 8)
159 qsizetype indexOf(char c, qsizetype from = 0) const;
160 qsizetype indexOf(QByteArrayView bv, qsizetype from = 0) const
161 { return QByteArrayView(begin(), size()).indexOf(bv, from); }
162
163 QT_CORE_INLINE_SINCE(6, 8)
164 qsizetype lastIndexOf(char c, qsizetype from = -1) const;
165 qsizetype lastIndexOf(QByteArrayView bv) const
166 { return lastIndexOf(bv, size()); }
167 qsizetype lastIndexOf(QByteArrayView bv, qsizetype from) const
168 { return QByteArrayView(begin(), size()).lastIndexOf(bv, from); }
169
170 inline bool contains(char c) const;
171 inline bool contains(QByteArrayView bv) const;
172 qsizetype count(char c) const;
173 qsizetype count(QByteArrayView bv) const
174 { return QByteArrayView(begin(), size()).count(bv); }
175
176 inline int compare(QByteArrayView a) const noexcept;
177 inline int compare(QByteArrayView a, Qt::CaseSensitivity cs) const noexcept;
178
179#if QT_CORE_REMOVED_SINCE(6, 7)
180 QByteArray left(qsizetype len) const;
181 QByteArray right(qsizetype len) const;
182 QByteArray mid(qsizetype index, qsizetype len = -1) const;
183 QByteArray first(qsizetype n) const;
184 QByteArray last(qsizetype n) const;
185 QByteArray sliced(qsizetype pos) const;
186 QByteArray sliced(qsizetype pos, qsizetype n) const;
187 QByteArray chopped(qsizetype len) const;
188#else
189 [[nodiscard]] QByteArray left(qsizetype n) const &
190 {
191 if (n >= size())
192 return *this;
193 return first(qMax(n, 0));
194 }
195 [[nodiscard]] QByteArray left(qsizetype n) &&
196 {
197 if (n >= size())
198 return std::move(*this);
199 return std::move(*this).first(qMax(n, 0));
200 }
201 [[nodiscard]] QByteArray right(qsizetype n) const &
202 {
203 if (n >= size())
204 return *this;
205 return last(qMax(n, 0));
206 }
207 [[nodiscard]] QByteArray right(qsizetype n) &&
208 {
209 if (n >= size())
210 return std::move(*this);
211 return std::move(*this).last(qMax(n, 0));
212 }
213 [[nodiscard]] QByteArray mid(qsizetype index, qsizetype len = -1) const &;
214 [[nodiscard]] QByteArray mid(qsizetype index, qsizetype len = -1) &&;
215
216 [[nodiscard]] QByteArray first(qsizetype n) const &
217 { verify(0, n); return sliced(0, n); }
218 [[nodiscard]] QByteArray last(qsizetype n) const &
219 { verify(0, n); return sliced(size() - n, n); }
220 [[nodiscard]] QByteArray sliced(qsizetype pos) const &
221 { verify(pos, 0); return sliced(pos, size() - pos); }
222 [[nodiscard]] QByteArray sliced(qsizetype pos, qsizetype n) const &
223 { verify(pos, n); return QByteArray(d.data() + pos, n); }
224 [[nodiscard]] QByteArray chopped(qsizetype len) const &
225 { verify(0, len); return sliced(0, size() - len); }
226
227 [[nodiscard]] QByteArray first(qsizetype n) &&
228 {
229 verify(0, n);
230 resize(n); // may detach and allocate memory
231 return std::move(*this);
232 }
233 [[nodiscard]] QByteArray last(qsizetype n) &&
234 { verify(0, n); return sliced_helper(*this, size() - n, n); }
235 [[nodiscard]] QByteArray sliced(qsizetype pos) &&
236 { verify(pos, 0); return sliced_helper(*this, pos, size() - pos); }
237 [[nodiscard]] QByteArray sliced(qsizetype pos, qsizetype n) &&
238 { verify(pos, n); return sliced_helper(*this, pos, n); }
239 [[nodiscard]] QByteArray chopped(qsizetype len) &&
240 { verify(0, len); chop(len); return std::move(*this); }
241#endif
242
243 bool startsWith(QByteArrayView bv) const
244 { return QByteArrayView(begin(), size()).startsWith(bv); }
245 bool startsWith(char c) const { return size() > 0 && front() == c; }
246
247 bool endsWith(char c) const { return size() > 0 && back() == c; }
248 bool endsWith(QByteArrayView bv) const
249 { return QByteArrayView(begin(), size()).endsWith(bv); }
250
251 bool isUpper() const;
252 bool isLower() const;
253
254 [[nodiscard]] bool isValidUtf8() const noexcept
255 {
256 return QtPrivate::isValidUtf8(qToByteArrayViewIgnoringNull(*this));
257 }
258
259 void truncate(qsizetype pos);
260 void chop(qsizetype n);
261
262 QByteArray &slice(qsizetype pos)
263 { verify(pos, 0); return remove(0, pos); }
264 QByteArray &slice(qsizetype pos, qsizetype n)
265 {
266 verify(pos, n);
267 if (isNull())
268 return *this;
269 resize(pos + n);
270 return remove(0, pos);
271 }
272
273#if !defined(Q_QDOC)
274 [[nodiscard]] QByteArray toLower() const &
275 { return toLower_helper(*this); }
276 [[nodiscard]] QByteArray toLower() &&
277 { return toLower_helper(*this); }
278 [[nodiscard]] QByteArray toUpper() const &
279 { return toUpper_helper(*this); }
280 [[nodiscard]] QByteArray toUpper() &&
281 { return toUpper_helper(*this); }
282 [[nodiscard]] QByteArray trimmed() const &
283 { return trimmed_helper(*this); }
284 [[nodiscard]] QByteArray trimmed() &&
285 { return trimmed_helper(*this); }
286 [[nodiscard]] QByteArray simplified() const &
287 { return simplified_helper(*this); }
288 [[nodiscard]] QByteArray simplified() &&
289 { return simplified_helper(*this); }
290#else
291 [[nodiscard]] QByteArray toLower() const;
292 [[nodiscard]] QByteArray toUpper() const;
293 [[nodiscard]] QByteArray trimmed() const;
294 [[nodiscard]] QByteArray simplified() const;
295#endif
296
297 [[nodiscard]] QByteArray leftJustified(qsizetype width, char fill = ' ', bool truncate = false) const;
298 [[nodiscard]] QByteArray rightJustified(qsizetype width, char fill = ' ', bool truncate = false) const;
299
300 QByteArray &prepend(char c)
301 { return insert(0, QByteArrayView(&c, 1)); }
302 inline QByteArray &prepend(qsizetype count, char c);
303 QByteArray &prepend(const char *s)
304 { return insert(0, QByteArrayView(s, qsizetype(qstrlen(s)))); }
305 QByteArray &prepend(const char *s, qsizetype len)
306 { return insert(0, QByteArrayView(s, len)); }
307 QByteArray &prepend(const QByteArray &a);
308 QByteArray &prepend(QByteArrayView a)
309 { return insert(0, a); }
310
311 QByteArray &append(char c);
312 inline QByteArray &append(qsizetype count, char c);
313 QByteArray &append(const char *s)
314 { return append(s, -1); }
315 QByteArray &append(const char *s, qsizetype len)
316 { return append(QByteArrayView(s, len < 0 ? qsizetype(qstrlen(s)) : len)); }
317 QByteArray &append(const QByteArray &a);
318 QByteArray &append(QByteArrayView a)
319 { return insert(size(), a); }
320
321 QByteArray &assign(QByteArrayView v);
322 QByteArray &assign(qsizetype n, char c)
323 {
324 Q_ASSERT(n >= 0);
325 return fill(c, n);
326 }
327 template <typename InputIterator, if_input_iterator<InputIterator> = true>
328 QByteArray &assign(InputIterator first, InputIterator last)
329 {
330 if constexpr (std::is_same_v<InputIterator, iterator> || std::is_same_v<InputIterator, const_iterator>)
331 return assign(QByteArrayView(first, last));
332 d->assign(first, last);
333 if (d.data())
334 d.data()[d.size] = '\0';
335 return *this;
336 }
337
338 QByteArray &insert(qsizetype i, QByteArrayView data);
339 inline QByteArray &insert(qsizetype i, const char *s)
340 { return insert(i, QByteArrayView(s)); }
341 inline QByteArray &insert(qsizetype i, const QByteArray &data)
342 { return insert(i, QByteArrayView(data)); }
343 QByteArray &insert(qsizetype i, qsizetype count, char c);
344 QByteArray &insert(qsizetype i, char c)
345 { return insert(i, QByteArrayView(&c, 1)); }
346 QByteArray &insert(qsizetype i, const char *s, qsizetype len)
347 { return insert(i, QByteArrayView(s, len)); }
348
349 QByteArray &remove(qsizetype index, qsizetype len);
350 QByteArray &removeAt(qsizetype pos)
351 { return size_t(pos) < size_t(size()) ? remove(pos, 1) : *this; }
352 QByteArray &removeFirst() { return !isEmpty() ? remove(0, 1) : *this; }
353 QByteArray &removeLast() { return !isEmpty() ? remove(size() - 1, 1) : *this; }
354
355 template <typename Predicate>
356 QByteArray &removeIf(Predicate pred)
357 {
358 removeIf_helper(pred);
359 return *this;
360 }
361
362 QByteArray &replace(qsizetype index, qsizetype len, const char *s, qsizetype alen)
363 { return replace(index, len, QByteArrayView(s, alen)); }
364 QByteArray &replace(qsizetype index, qsizetype len, QByteArrayView s);
365 QByteArray &replace(char before, QByteArrayView after)
366 { return replace(QByteArrayView(&before, 1), after); }
367 QByteArray &replace(const char *before, qsizetype bsize, const char *after, qsizetype asize)
368 { return replace(QByteArrayView(before, bsize), QByteArrayView(after, asize)); }
369 QByteArray &replace(QByteArrayView before, QByteArrayView after);
370 QByteArray &replace(char before, char after);
371
372 QByteArray &operator+=(char c)
373 { return append(c); }
374 QByteArray &operator+=(const char *s)
375 { return append(s); }
376 QByteArray &operator+=(const QByteArray &a)
377 { return append(a); }
378 QByteArray &operator+=(QByteArrayView a)
379 { return append(a); }
380
381 QList<QByteArray> split(char sep) const;
382
383 [[nodiscard]] QByteArray repeated(qsizetype times) const;
384
385#if !defined(QT_NO_CAST_FROM_ASCII) && !defined(QT_RESTRICTED_CAST_FROM_ASCII)
386#if QT_CORE_REMOVED_SINCE(6, 8)
387 QT_ASCII_CAST_WARN inline bool operator==(const QString &s2) const;
388 QT_ASCII_CAST_WARN inline bool operator!=(const QString &s2) const;
389 QT_ASCII_CAST_WARN inline bool operator<(const QString &s2) const;
390 QT_ASCII_CAST_WARN inline bool operator>(const QString &s2) const;
391 QT_ASCII_CAST_WARN inline bool operator<=(const QString &s2) const;
392 QT_ASCII_CAST_WARN inline bool operator>=(const QString &s2) const;
393#endif // QT_CORE_REMOVED_SINCE(6, 8)
394#endif // !defined(QT_NO_CAST_FROM_ASCII) && !defined(QT_RESTRICTED_CAST_FROM_ASCII)
395
396 short toShort(bool *ok = nullptr, int base = 10) const;
397 ushort toUShort(bool *ok = nullptr, int base = 10) const;
398 int toInt(bool *ok = nullptr, int base = 10) const;
399 uint toUInt(bool *ok = nullptr, int base = 10) const;
400 long toLong(bool *ok = nullptr, int base = 10) const;
401 ulong toULong(bool *ok = nullptr, int base = 10) const;
402 qlonglong toLongLong(bool *ok = nullptr, int base = 10) const;
403 qulonglong toULongLong(bool *ok = nullptr, int base = 10) const;
404 float toFloat(bool *ok = nullptr) const;
405 double toDouble(bool *ok = nullptr) const;
406 QByteArray toBase64(Base64Options options = Base64Encoding) const;
407 QByteArray toHex(char separator = '\0') const;
408 QByteArray toPercentEncoding(const QByteArray &exclude = QByteArray(),
409 const QByteArray &include = QByteArray(),
410 char percent = '%') const;
411#if QT_CORE_REMOVED_SINCE(6, 11)
412 [[nodiscard]] QByteArray percentDecoded(char percent = '%') const;
413#else
414 [[nodiscard]] QByteArray percentDecoded(char percent = '%') const &
415 { return fromPercentEncoding(*this, percent); }
416 [[nodiscard]] QByteArray percentDecoded(char percent = '%') &&
417 { return fromPercentEncoding(std::move(*this), percent); }
418#endif
419
420 inline QByteArray &setNum(short, int base = 10);
421 inline QByteArray &setNum(ushort, int base = 10);
422 inline QByteArray &setNum(int, int base = 10);
423 inline QByteArray &setNum(uint, int base = 10);
424 inline QByteArray &setNum(long, int base = 10);
425 inline QByteArray &setNum(ulong, int base = 10);
426 QByteArray &setNum(qlonglong, int base = 10);
427 QByteArray &setNum(qulonglong, int base = 10);
428 inline QByteArray &setNum(float, char format = 'g', int precision = 6);
429 QByteArray &setNum(double, char format = 'g', int precision = 6);
430 QByteArray &setRawData(const char *a, qsizetype n);
431
432 [[nodiscard]] static QByteArray number(int, int base = 10);
433 [[nodiscard]] static QByteArray number(uint, int base = 10);
434 [[nodiscard]] static QByteArray number(long, int base = 10);
435 [[nodiscard]] static QByteArray number(ulong, int base = 10);
436 [[nodiscard]] static QByteArray number(qlonglong, int base = 10);
437 [[nodiscard]] static QByteArray number(qulonglong, int base = 10);
438 [[nodiscard]] static QByteArray number(double, char format = 'g', int precision = 6);
439 [[nodiscard]] static QByteArray fromRawData(const char *data, qsizetype size)
440 {
441 return QByteArray(DataPointer::fromRawData(data, size));
442 }
443
444 class FromBase64Result;
445 [[nodiscard]] static FromBase64Result fromBase64Encoding(QByteArray &&base64, Base64Options options = Base64Encoding);
446 [[nodiscard]] static FromBase64Result fromBase64Encoding(const QByteArray &base64, Base64Options options = Base64Encoding);
447 [[nodiscard]] static QByteArray fromBase64(const QByteArray &base64, Base64Options options = Base64Encoding);
448 [[nodiscard]] static QByteArray fromHex(const QByteArray &hexEncoded);
449 [[nodiscard]] static QByteArray fromPercentEncoding(const QByteArray &pctEncoded, char percent = '%');
450 [[nodiscard]] static QByteArray fromPercentEncoding(QByteArray &&pctEncoded, char percent = '%');
451
452#if defined(Q_OS_DARWIN) || defined(Q_QDOC)
453 static QByteArray fromCFData(CFDataRef data);
454 static QByteArray fromRawCFData(CFDataRef data);
455 CFDataRef toCFData() const Q_DECL_CF_RETURNS_RETAINED;
456 CFDataRef toRawCFData() const Q_DECL_CF_RETURNS_RETAINED;
457 static QByteArray fromNSData(const NSData *data);
458 static QByteArray fromRawNSData(const NSData *data);
459 NSData *toNSData() const Q_DECL_NS_RETURNS_AUTORELEASED;
460 NSData *toRawNSData() const Q_DECL_NS_RETURNS_AUTORELEASED;
461#endif
462
463#if defined(Q_OS_WASM) || defined(Q_QDOC)
464 static QByteArray fromEcmaUint8Array(emscripten::val uint8array);
465 emscripten::val toEcmaUint8Array();
466#endif
467
468 typedef char *iterator;
469 typedef const char *const_iterator;
470 typedef iterator Iterator;
471 typedef const_iterator ConstIterator;
472 typedef std::reverse_iterator<iterator> reverse_iterator;
473 typedef std::reverse_iterator<const_iterator> const_reverse_iterator;
474 iterator begin() { return data(); }
475 constexpr
476 const_iterator begin() const noexcept { return d.data(); }
477 constexpr
478 const_iterator cbegin() const noexcept { return begin(); }
479 constexpr
480 const_iterator constBegin() const noexcept { return begin(); }
481 iterator end() { return begin() + size(); }
482 constexpr
483 const_iterator end() const noexcept { return begin() + size(); }
484 constexpr
485 const_iterator cend() const noexcept { return end(); }
486 constexpr
487 const_iterator constEnd() const noexcept { return end(); }
488 reverse_iterator rbegin() { return reverse_iterator(end()); }
489 reverse_iterator rend() { return reverse_iterator(begin()); }
490 constexpr
491 const_reverse_iterator rbegin() const noexcept { return const_reverse_iterator(end()); }
492 constexpr
493 const_reverse_iterator rend() const noexcept { return const_reverse_iterator(begin()); }
494 constexpr
495 const_reverse_iterator crbegin() const noexcept { return rbegin(); }
496 constexpr
497 const_reverse_iterator crend() const noexcept { return rend(); }
498
499 // stl compatibility
500 typedef qsizetype size_type;
501 typedef qptrdiff difference_type;
502 typedef const char & const_reference;
503 typedef char & reference;
504 typedef char *pointer;
505 typedef const char *const_pointer;
506 typedef char value_type;
507 void push_back(char c)
508 { append(c); }
509 void push_back(const char *s)
510 { append(s); }
511 void push_back(const QByteArray &a)
512 { append(a); }
513 void push_back(QByteArrayView a)
514 { append(a); }
515 void push_front(char c)
516 { prepend(c); }
517 void push_front(const char *c)
518 { prepend(c); }
519 void push_front(const QByteArray &a)
520 { prepend(a); }
521 void push_front(QByteArrayView a)
522 { prepend(a); }
523 void shrink_to_fit() { squeeze(); }
524 iterator erase(const_iterator first, const_iterator last);
525 inline iterator erase(const_iterator it) { return erase(it, it + 1); }
526 constexpr qsizetype max_size() const noexcept
527 {
528 return maxSize();
529 }
530
531 static QByteArray fromStdString(const std::string &s);
532 std::string toStdString() const;
533
534 static constexpr qsizetype maxSize() noexcept
535 {
536 // -1 to deal with the NUL terminator
537 return Data::maxSize() - 1;
538 }
539 constexpr qsizetype size() const noexcept
540 {
541 constexpr size_t MaxSize = maxSize();
542 Q_PRESUME(size_t(d.size) <= MaxSize);
543 return d.size;
544 }
545#if QT_DEPRECATED_SINCE(6, 4)
546 QT_DEPRECATED_VERSION_X_6_4("Use size() or length() instead.")
547 constexpr qsizetype count() const noexcept { return size(); }
548#endif
549 constexpr qsizetype length() const noexcept { return size(); }
550 QT_CORE_CONSTEXPR_INLINE_SINCE(6, 4)
551 bool isNull() const noexcept;
552
553 inline const DataPointer &data_ptr() const { return d; }
554 inline DataPointer &data_ptr() { return d; }
555#if QT_VERSION < QT_VERSION_CHECK(7, 0, 0)
556 explicit inline QByteArray(const DataPointer &dd) : d(dd) {}
557#endif
558 explicit Q_DECL_CONSTEXPR_DTOR QByteArray(DataPointer &&dd) : d(std::move(dd)) {}
559
560 [[nodiscard]] QByteArray nullTerminated() const &;
561 [[nodiscard]] QByteArray nullTerminated() &&;
562 QByteArray &nullTerminate();
563
564private:
565 friend bool comparesEqual(const QByteArray &lhs, char rhs) noexcept
566 { return QByteArrayView(lhs) == rhs; }
567 friend bool comparesEqual(const QByteArray &lhs, const QByteArrayView &rhs) noexcept
568 { return QByteArrayView(lhs) == rhs; }
569 friend Qt::strong_ordering
570 compareThreeWay(const QByteArray &lhs, char rhs) noexcept
571 {
572 return compareThreeWay(QByteArrayView(lhs), rhs);
573 }
574 friend Qt::strong_ordering
575 compareThreeWay(const QByteArray &lhs, const QByteArrayView &rhs) noexcept
576 {
577 const int res = QtPrivate::compareMemory(QByteArrayView(lhs), rhs);
578 return Qt::compareThreeWay(res, 0);
579 }
580 Q_DECLARE_STRONGLY_ORDERED(QByteArray)
581 Q_DECLARE_STRONGLY_ORDERED(QByteArray, char)
582 Q_DECLARE_STRONGLY_ORDERED(QByteArray, const char *)
583#if defined(__GLIBCXX__) && defined(__cpp_lib_three_way_comparison)
584 // libstdc++ has a bug [0] when `operator const void *()` is preferred over
585 // `operator<=>()` when calling std::less<> and other similar methods.
586 // Fix it by explicitly providing relational operators in such case.
587 // [0]: https://gcc.gnu.org/bugzilla/show_bug.cgi?id=114153
588 friend bool operator<(const QByteArray &lhs, const QByteArray &rhs) noexcept
589 { return is_lt(compareThreeWay(lhs, rhs)); }
590 friend bool operator<=(const QByteArray &lhs, const QByteArray &rhs) noexcept
591 { return is_lteq(compareThreeWay(lhs, rhs)); }
592 friend bool operator>(const QByteArray &lhs, const QByteArray &rhs) noexcept
593 { return is_gt(compareThreeWay(lhs, rhs)); }
594 friend bool operator>=(const QByteArray &lhs, const QByteArray &rhs) noexcept
595 { return is_gteq(compareThreeWay(lhs, rhs)); }
596#endif // defined(__GLIBCXX__) && defined(__cpp_lib_three_way_comparison)
597
598 // Check isEmpty() instead of isNull() for backwards compatibility.
599 friend bool comparesEqual(const QByteArray &lhs, std::nullptr_t) noexcept
600 { return lhs.isEmpty(); }
601 friend Qt::strong_ordering compareThreeWay(const QByteArray &lhs, std::nullptr_t) noexcept
602 { return lhs.isEmpty() ? Qt::strong_ordering::equivalent : Qt::strong_ordering::greater; }
603 Q_DECLARE_STRONGLY_ORDERED(QByteArray, std::nullptr_t)
604
605 // defined in qstring.cpp
606 friend Q_CORE_EXPORT bool comparesEqual(const QByteArray &lhs, const QChar &rhs) noexcept;
607 friend Q_CORE_EXPORT Qt::strong_ordering
608 compareThreeWay(const QByteArray &lhs, const QChar &rhs) noexcept;
609 friend Q_CORE_EXPORT bool comparesEqual(const QByteArray &lhs, char16_t rhs) noexcept;
610 friend Q_CORE_EXPORT Qt::strong_ordering
611 compareThreeWay(const QByteArray &lhs, char16_t rhs) noexcept;
612#if !defined(QT_NO_CAST_FROM_ASCII) && !defined(QT_RESTRICTED_CAST_FROM_ASCII)
613 Q_DECLARE_STRONGLY_ORDERED(QByteArray, QChar, QT_ASCII_CAST_WARN)
614 Q_DECLARE_STRONGLY_ORDERED(QByteArray, char16_t, QT_ASCII_CAST_WARN)
615#endif // !defined(QT_NO_CAST_FROM_ASCII) && !defined(QT_RESTRICTED_CAST_FROM_ASCII)
616
617
618 void reallocData(qsizetype alloc, QArrayData::AllocationOption option);
619 void reallocGrowData(qsizetype n);
620 void expand(qsizetype i);
621
622 Q_ALWAYS_INLINE constexpr void verify([[maybe_unused]] qsizetype pos = 0,
623 [[maybe_unused]] qsizetype n = 1) const
624 {
625 Q_ASSERT(pos >= 0);
626 Q_ASSERT(pos <= d.size);
627 Q_ASSERT(n >= 0);
628 Q_ASSERT(n <= d.size - pos);
629 }
630
631 static QByteArray sliced_helper(QByteArray &a, qsizetype pos, qsizetype n);
632 static QByteArray toLower_helper(const QByteArray &a);
633 static QByteArray toLower_helper(QByteArray &a);
634 static QByteArray toUpper_helper(const QByteArray &a);
635 static QByteArray toUpper_helper(QByteArray &a);
636 static QByteArray trimmed_helper(const QByteArray &a);
637 static QByteArray trimmed_helper(QByteArray &a);
638 static QByteArray simplified_helper(const QByteArray &a);
639 static QByteArray simplified_helper(QByteArray &a);
640 template <typename Predicate>
641 qsizetype removeIf_helper(Predicate pred)
642 {
643 const qsizetype result = d->eraseIf(pred);
644 if (result > 0)
645 d.data()[d.size] = '\0';
646 return result;
647 }
648
649 friend class QString;
650 friend Q_CORE_EXPORT QByteArray qUncompress(const uchar *data, qsizetype nbytes);
651
652 template <typename T> friend qsizetype erase(QByteArray &ba, const T &t);
653 template <typename Predicate> friend qsizetype erase_if(QByteArray &ba, Predicate pred);
654};
655
656Q_DECLARE_OPERATORS_FOR_FLAGS(QByteArray::Base64Options)
657
658constexpr
659inline char QByteArray::at(qsizetype i) const
660{ verify(i, 1); return d.data()[i]; }
661constexpr
662inline char QByteArray::operator[](qsizetype i) const
663{ verify(i, 1); return d.data()[i]; }
664
665#ifndef QT_NO_CAST_FROM_BYTEARRAY
666inline QByteArray::operator const char *() const
667{ return data(); }
668inline QByteArray::operator const void *() const
669{ return data(); }
670#endif
671inline char *QByteArray::data()
672{
673 detach();
674 Q_ASSERT(d.data());
675 return d.data();
676}
677constexpr
678inline const char *QByteArray::data() const noexcept
679{
680#if QT5_NULL_STRINGS == 1
681 return d.data() ? d.data() : &_empty;
682#else
683 return d.data();
684#endif
685}
686inline void QByteArray::detach()
687{ if (d.needsDetach()) reallocData(size(), QArrayData::KeepSize); }
688inline bool QByteArray::isDetached() const
689{ return !d.isShared(); }
690#if QT_CORE_INLINE_IMPL_SINCE(6, 13)
691QT_CORE_CONSTEXPR_DTOR_INLINE_SINCE(6, 13)
692QByteArray &QByteArray::operator=(const QByteArray &other) noexcept
693{
694 d = other.d;
695 return *this;
696}
697#endif // QT_CORE_INLINE_IMPL_SINCE(6, 13)
698
699inline qsizetype QByteArray::capacity() const { return qsizetype(d.constAllocatedCapacity()); }
700
701inline void QByteArray::reserve(qsizetype asize)
702{
703 if (d.needsDetach() || asize > capacity() - d.freeSpaceAtBegin())
704 reallocData(qMax(size(), asize), QArrayData::KeepSize);
705 if (d.constAllocatedCapacity())
706 d.setFlag(Data::CapacityReserved);
707}
708
709inline void QByteArray::squeeze()
710{
711 if (!d.isMutable())
712 return;
713 if (d.needsDetach() || size() < capacity())
714 reallocData(size(), QArrayData::KeepSize);
715 if (d.constAllocatedCapacity())
716 d.clearFlag(Data::CapacityReserved);
717}
718
719inline char &QByteArray::operator[](qsizetype i)
720{ verify(i, 1); return data()[i]; }
721inline char &QByteArray::front() { return operator[](0); }
722inline char &QByteArray::back() { return operator[](size() - 1); }
723inline QByteArray &QByteArray::append(qsizetype n, char ch)
724{ return insert(size(), n, ch); }
725inline QByteArray &QByteArray::prepend(qsizetype n, char ch)
726{ return insert(0, n, ch); }
727inline bool QByteArray::contains(char c) const
728{ return indexOf(c) != -1; }
729inline bool QByteArray::contains(QByteArrayView bv) const
730{ return indexOf(bv) != -1; }
731inline int QByteArray::compare(QByteArrayView a) const noexcept
732{
733 return QByteArrayView(*this).compare(a);
734}
735inline int QByteArray::compare(QByteArrayView a, Qt::CaseSensitivity cs) const noexcept
736{
737 return QByteArrayView(*this).compare(a, cs);
738}
739#if !defined(QT_USE_QSTRINGBUILDER)
740inline QByteArray operator+(const QByteArray &a1, const QByteArray &a2)
741{ return QByteArray(a1) += a2; }
742inline QByteArray operator+(QByteArray &&lhs, const QByteArray &rhs)
743{ return std::move(lhs += rhs); }
744inline QByteArray operator+(const QByteArray &a1, const char *a2)
745{ return QByteArray(a1) += a2; }
746inline QByteArray operator+(QByteArray &&lhs, const char *rhs)
747{ return std::move(lhs += rhs); }
748inline QByteArray operator+(const QByteArray &a1, char a2)
749{ return QByteArray(a1) += a2; }
750inline QByteArray operator+(QByteArray &&lhs, char rhs)
751{ return std::move(lhs += rhs); }
752inline QByteArray operator+(const char *a1, const QByteArray &a2)
753{ return QByteArray(a1) += a2; }
754inline QByteArray operator+(char a1, const QByteArray &a2)
755{ return QByteArray(&a1, 1) += a2; }
756Q_WEAK_OVERLOAD
757inline QByteArray operator+(const QByteArray &lhs, QByteArrayView rhs)
758{
759 QByteArray tmp{lhs.size() + rhs.size(), Qt::Uninitialized};
760 return tmp.assign(lhs).append(rhs);
761}
762Q_WEAK_OVERLOAD
763inline QByteArray operator+(QByteArrayView lhs, const QByteArray &rhs)
764{
765 QByteArray tmp{lhs.size() + rhs.size(), Qt::Uninitialized};
766 return tmp.assign(lhs).append(rhs);
767}
768#endif // QT_USE_QSTRINGBUILDER
769
770inline QByteArray &QByteArray::setNum(short n, int base)
771{ return setNum(qlonglong(n), base); }
772inline QByteArray &QByteArray::setNum(ushort n, int base)
773{ return setNum(qulonglong(n), base); }
774inline QByteArray &QByteArray::setNum(int n, int base)
775{ return setNum(qlonglong(n), base); }
776inline QByteArray &QByteArray::setNum(uint n, int base)
777{ return setNum(qulonglong(n), base); }
778inline QByteArray &QByteArray::setNum(long n, int base)
779{ return setNum(qlonglong(n), base); }
780inline QByteArray &QByteArray::setNum(ulong n, int base)
781{ return setNum(qulonglong(n), base); }
782inline QByteArray &QByteArray::setNum(float n, char format, int precision)
783{ return setNum(double(n), format, precision); }
784
785#if QT_CORE_INLINE_IMPL_SINCE(6, 4)
786QT_CORE_CONSTEXPR_INLINE_SINCE(6, 4)
787bool QByteArray::isNull() const noexcept
788{
789 return d.isNull();
790}
791#endif
792#if QT_CORE_INLINE_IMPL_SINCE(6, 8)
793qsizetype QByteArray::indexOf(char ch, qsizetype from) const
794{
795 return qToByteArrayViewIgnoringNull(*this).indexOf(ch, from);
796}
797qsizetype QByteArray::lastIndexOf(char ch, qsizetype from) const
798{
799 return qToByteArrayViewIgnoringNull(*this).lastIndexOf(ch, from);
800}
801#endif
802
803#if !defined(QT_NO_DATASTREAM) || defined(QT_BOOTSTRAPPED)
804Q_CORE_EXPORT QDataStream &operator<<(QDataStream &, const QByteArray &);
805Q_CORE_EXPORT QDataStream &operator>>(QDataStream &, QByteArray &);
806#endif
807
808#ifndef QT_NO_COMPRESS
809Q_CORE_EXPORT QByteArray qCompress(const uchar* data, qsizetype nbytes, int compressionLevel = -1);
810Q_CORE_EXPORT QByteArray qUncompress(const uchar* data, qsizetype nbytes);
811inline QByteArray qCompress(const QByteArray& data, int compressionLevel = -1)
812{ return qCompress(reinterpret_cast<const uchar *>(data.constData()), data.size(), compressionLevel); }
813inline QByteArray qUncompress(const QByteArray& data)
814{ return qUncompress(reinterpret_cast<const uchar*>(data.constData()), data.size()); }
815#endif
816
817Q_DECLARE_SHARED(QByteArray)
818
819class QByteArray::FromBase64Result
820{
821public:
822 QByteArray decoded;
823 QByteArray::Base64DecodingStatus decodingStatus;
824
825 void swap(QByteArray::FromBase64Result &other) noexcept
826 {
827 decoded.swap(other.decoded);
828 std::swap(decodingStatus, other.decodingStatus);
829 }
830
831 explicit operator bool() const noexcept { return decodingStatus == QByteArray::Base64DecodingStatus::Ok; }
832
833 QByteArray &operator*() & noexcept { return decoded; }
834 const QByteArray &operator*() const & noexcept { return decoded; }
835 QByteArray &&operator*() && noexcept { return std::move(decoded); }
836 const QByteArray &&operator*() const && noexcept { return std::move(decoded); }
837
838 friend inline bool operator==(const QByteArray::FromBase64Result &lhs, const QByteArray::FromBase64Result &rhs) noexcept
839 {
840 if (lhs.decodingStatus != rhs.decodingStatus)
841 return false;
842
843 if (lhs.decodingStatus == QByteArray::Base64DecodingStatus::Ok && lhs.decoded != rhs.decoded)
844 return false;
845
846 return true;
847 }
848
849 friend inline bool operator!=(const QByteArray::FromBase64Result &lhs, const QByteArray::FromBase64Result &rhs) noexcept
850 {
851 return !(lhs == rhs);
852 }
853};
854
855Q_DECLARE_SHARED(QByteArray::FromBase64Result)
856
857
858Q_CORE_EXPORT Q_DECL_PURE_FUNCTION size_t qHash(const QByteArray::FromBase64Result &key, size_t seed = 0) noexcept;
859
860template <typename T>
861qsizetype erase(QByteArray &ba, const T &t)
862{
863 return ba.removeIf_helper([&t](const auto &e) { return t == e; });
864}
865
866template <typename Predicate>
867qsizetype erase_if(QByteArray &ba, Predicate pred)
868{
869 return ba.removeIf_helper(pred);
870}
871
872//
873// QByteArrayView members that require QByteArray:
874//
875QByteArray QByteArrayView::toByteArray() const
876{
877 return QByteArray(*this);
878}
879
880namespace Qt {
881inline namespace Literals {
882inline namespace StringLiterals {
883
884Q_DECL_CONSTEXPR_DTOR QByteArray operator""_ba(const char *str, size_t size) noexcept
885{
886 return QByteArray(QByteArrayData(nullptr, const_cast<char *>(str), qsizetype(size)));
887}
888
889} // StringLiterals
890} // Literals
891} // Qt
892
893inline namespace QtLiterals {
894#if QT_DEPRECATED_SINCE(6, 8)
895
896QT_DEPRECATED_VERSION_X_6_8("Use _ba from Qt::StringLiterals namespace instead.")
897inline QByteArray operator""_qba(const char *str, size_t size) noexcept
898{
899 return Qt::StringLiterals::operator""_ba(str, size);
900}
901
902#endif // QT_DEPRECATED_SINCE(6, 8)
903} // QtLiterals
904
905QT_END_NAMESPACE
906
907#endif // QBYTEARRAY_H
QByteArray::FromBase64Result::decodingStatus
QByteArray::Base64DecodingStatus decodingStatus
Definition qbytearray.h:823
QByteArray::FromBase64Result::operator==
friend bool operator==(const QByteArray::FromBase64Result &lhs, const QByteArray::FromBase64Result &rhs) noexcept
Returns true if lhs and rhs are equal, otherwise returns false.
Definition qbytearray.h:838
QByteArray::FromBase64Result::operator*
QByteArray & operator*() &noexcept
Definition qbytearray.h:833
QByteArray::FromBase64Result::operator*
const QByteArray & operator*() const &noexcept
Definition qbytearray.h:834
QByteArray::FromBase64Result::swap
void swap(QByteArray::FromBase64Result &other) noexcept
Definition qbytearray.h:825
QByteArray::FromBase64Result::operator bool
operator bool() const noexcept
\variable QByteArray::FromBase64Result::decoded
Definition qbytearray.h:831
QByteArray::FromBase64Result::operator*
QByteArray && operator*() &&noexcept
Definition qbytearray.h:835
QByteArray::FromBase64Result::operator*
const QByteArray && operator*() const &&noexcept
Definition qbytearray.h:836
QByteArray::FromBase64Result::operator!=
friend bool operator!=(const QByteArray::FromBase64Result &lhs, const QByteArray::FromBase64Result &rhs) noexcept
Returns true if lhs and rhs are different, otherwise returns false.
Definition qbytearray.h:849
QByteArray
\inmodule QtCore
Definition qbytearray.h:58
QDataStream
\inmodule QtCore\reentrant
Definition qdatastream.h:50
QInternalMessageLogContext::initFrom
int initFrom(const QMessageLogContext &logContext)
Definition qlogging.cpp:2487
QInternalMessageLogContext::populateBacktrace
void populateBacktrace(int frameCount)
Definition qlogging.cpp:1648
QInternalMessageLogContext::QInternalMessageLogContext
QInternalMessageLogContext(const QMessageLogContext &logContext, const QLoggingCategory &categoryOverride)
Definition qlogging_p.h:67
QInternalMessageLogContext::MaxBacktraceDepth
static constexpr int MaxBacktraceDepth
Definition qlogging_p.h:49
QInternalMessageLogContext::backtrace
std::optional< BacktraceStorage > backtrace
Definition qlogging_p.h:59
QInternalMessageLogContext::DefaultBacktraceDepth
static constexpr int DefaultBacktraceDepth
Definition qlogging_p.h:48
QList
Definition qlist.h:82
QMessageLogContext
\inmodule QtCore
Definition qlogging.h:44
QMessageLogContext::QMessageLogContext
constexpr QMessageLogContext(const char *fileName, int lineNumber, const char *functionName, const char *categoryName) noexcept
Definition qlogging.h:49
QMessageLogContext::category
const char * category
Definition qlogging.h:56
QMessageLogContext::QMessageLogContext
constexpr QMessageLogContext() noexcept=default
QMessageLogContext::function
const char * function
Definition qlogging.h:55
QMessageLogContext::file
const char * file
Definition qlogging.h:54
QMessageLogger
\inmodule QtCore
Definition qlogging.h:74
QMessageLogger::debug
QDebug debug(CategoryFunction catFunc) const
QMessageLogger::debug
QDebug debug(const QLoggingCategory &cat) const
Logs a debug message into category cat using a QDebug stream.
Definition qlogging.cpp:528
QMessageLogger::debug
void void void void Q_DECL_COLD_FUNCTION void Q_DECL_COLD_FUNCTION void Q_DECL_COLD_FUNCTION void Q_DECL_COLD_FUNCTION void QT_MESSAGE_LOGGER_NORETURN Q_DECL_COLD_FUNCTION void QT_MESSAGE_LOGGER_NORETURN Q_DECL_COLD_FUNCTION void QDebug debug() const
Logs a debug message using a QDebug stream.
Definition qlogging.cpp:514
QMessageLogger::info
QDebug info(const QLoggingCategory &cat) const
Logs an informational message into the category cat using a QDebug stream.
Definition qlogging.cpp:617
QMessageLogger::info
QDebug info() const
Logs an informational message using a QDebug stream.
Definition qlogging.cpp:603
QMessageLogger::noDebug
QNoDebug noDebug(...) const noexcept
QMessageLogger::info
QDebug info(CategoryFunction catFunc) const
QString
\macro QT_RESTRICTED_CAST_FROM_ASCII
Definition qstring.h:177
ifCriticalTokenC
static const char ifCriticalTokenC[]
Definition qlogging.cpp:1148
grabMessageHandler
static bool grabMessageHandler()
Definition qlogging.cpp:2171
qt_message_output
void qt_message_output(QtMsgType msgType, const QMessageLogContext &context, const QString &message)
Definition qlogging.cpp:2244
emptyTokenC
static const char emptyTokenC[]
Definition qlogging.cpp:1151
qt_message
static Q_NEVER_INLINE void qt_message(QtMsgType msgType, const QMessageLogContext &context, const char *msg, va_list ap)
Definition qlogging.cpp:411
preformattedMessageHandler
static void preformattedMessageHandler(QtMsgType type, const QMessageLogContext &context, const QString &formattedMessage)
Definition qlogging.cpp:2137
systemHasStderr
static bool systemHasStderr()
Returns true if writing to stderr is supported.
Definition qlogging.cpp:267
endifTokenC
static const char endifTokenC[]
Definition qlogging.cpp:1150
isDefaultCategory
static bool isDefaultCategory(const char *category)
Definition qlogging.cpp:957
messageTokenC
static const char messageTokenC[]
Definition qlogging.cpp:1133
qt_append_thread_name_to
static bool qt_append_thread_name_to(QString &message)
Definition qlogging.cpp:252
systemMessageSink
static constexpr SystemMessageSink systemMessageSink
Definition qlogging.cpp:2115
qt_maybe_message_fatal
static void qt_maybe_message_fatal(QtMsgType, const QMessageLogContext &context, String &&message)
\inmodule QtCore \title Qt Logging Types
Definition qlogging.cpp:2209
HANDLE_IF_TOKEN
#define HANDLE_IF_TOKEN(LEVEL)
Q_DECLARE_TYPEINFO
Q_DECLARE_TYPEINFO(QMessagePattern::BacktraceParams, Q_RELOCATABLE_TYPE)
qDefaultMessageHandler
static void qDefaultMessageHandler(QtMsgType type, const QMessageLogContext &context, const QString &buf)
Definition qlogging.cpp:2154
timeTokenC
static const char timeTokenC[]
Definition qlogging.cpp:1142
isFatalCountDown
static bool isFatalCountDown(const char *varname, QBasicAtomicInt &n)
Definition qlogging.cpp:157
qErrnoWarning
void qErrnoWarning(int code, const char *msg,...)
Definition qlogging.cpp:2267
qthreadptrTokenC
static const char qthreadptrTokenC[]
Definition qlogging.cpp:1141
fileTokenC
static const char fileTokenC[]
Definition qlogging.cpp:1134
ifDebugTokenC
static const char ifDebugTokenC[]
Definition qlogging.cpp:1145
ifFatalTokenC
static const char ifFatalTokenC[]
Definition qlogging.cpp:1149
categoryTokenC
static const char categoryTokenC[]
Definition qlogging.cpp:1131
stderr_message_handler
static void stderr_message_handler(QtMsgType type, const QMessageLogContext &context, const QString &formattedMessage)
Definition qlogging.cpp:2091
lineTokenC
static const char lineTokenC[]
Definition qlogging.cpp:1135
typeTokenC
static const char typeTokenC[]
Definition qlogging.cpp:1132
ungrabMessageHandler
static void ungrabMessageHandler()
Definition qlogging.cpp:2180
copyInternalContext
static void copyInternalContext(QInternalMessageLogContext *self, const QMessageLogContext &logContext) noexcept
Definition qlogging.cpp:2473
ifCategoryTokenC
static const char ifCategoryTokenC[]
Definition qlogging.cpp:1144
checked_var_value
static int checked_var_value(const char *varname)
Definition qlogging.cpp:143
threadnameTokenC
static const char threadnameTokenC[]
Definition qlogging.cpp:1140
pidTokenC
static const char pidTokenC[]
Definition qlogging.cpp:1137
Q_TRACE_POINT
Q_TRACE_POINT(qtcore, qt_message_print, int type, const char *category, const char *function, const char *file, int line, const QString &message)
threadidTokenC
static const char threadidTokenC[]
Definition qlogging.cpp:1139
formatLogMessage
static QString formatLogMessage(QtMsgType type, const QMessageLogContext &context, const QString &str)
Definition qlogging.cpp:1679
msgHandlerGrabbed
static Q_CONSTINIT bool msgHandlerGrabbed
Definition qlogging.cpp:2169
backtraceTokenC
static const char backtraceTokenC[]
Definition qlogging.cpp:1143
qErrnoWarning
void qErrnoWarning(const char *msg,...)
Definition qlogging.cpp:2251
functionTokenC
static const char functionTokenC[]
Definition qlogging.cpp:1136
IF_TOKEN
#define IF_TOKEN(LEVEL)
ifWarningTokenC
static const char ifWarningTokenC[]
Definition qlogging.cpp:1147
appnameTokenC
static const char appnameTokenC[]
Definition qlogging.cpp:1138
isFatal
static bool isFatal(QtMsgType msgType)
Definition qlogging.cpp:191
ifInfoTokenC
static const char ifInfoTokenC[]
Definition qlogging.cpp:1146
qInstallMessageHandler
QtMessageHandler qInstallMessageHandler(QtMessageHandler h)
Definition qlogging.cpp:2456
qt_message_print
static void qt_message_print(QtMsgType, const QMessageLogContext &context, const QString &message)
Definition qlogging.cpp:2185
stderrHasConsoleAttached
static bool stderrHasConsoleAttached()
Returns true if writing to stderr will end up in a console/terminal visible to the user.
Definition qlogging.cpp:296
qSetMessagePattern
void qSetMessagePattern(const QString &pattern)
Definition qlogging.cpp:2465
QT_BEGIN_NAMESPACE
Combined button and popup list for selecting options.
Definition qsequentialanimationgroup.cpp:47
QtPrivate::shouldLogToStderr
bool shouldLogToStderr()
Returns true if logging stderr should be ensured.
Definition qlogging.cpp:343
Qt
Definition qcompare.h:111
operator+
QByteArray operator+(const QByteArray &a1, const char *a2)
Definition qbytearray.h:744
qUncompress
QByteArray qUncompress(const QByteArray &data)
Definition qbytearray.h:813
operator+
QByteArray operator+(char a1, const QByteArray &a2)
Definition qbytearray.h:754
operator+
QByteArray operator+(QByteArray &&lhs, char rhs)
Definition qbytearray.h:750
operator+
QByteArray operator+(const QByteArray &a1, char a2)
Definition qbytearray.h:748
operator+
QByteArray operator+(const char *a1, const QByteArray &a2)
Definition qbytearray.h:752
operator+
QByteArray operator+(QByteArray &&lhs, const QByteArray &rhs)
Definition qbytearray.h:742
erase_if
qsizetype erase_if(QByteArray &ba, Predicate pred)
Definition qbytearray.h:867
operator+
QByteArray operator+(const QByteArray &a1, const QByteArray &a2)
Definition qbytearray.h:740
qCompress
QByteArray qCompress(const QByteArray &data, int compressionLevel=-1)
Definition qbytearray.h:811
QT5_NULL_STRINGS
#define QT5_NULL_STRINGS
Definition qbytearray.h:26
erase
qsizetype erase(QByteArray &ba, const T &t)
Definition qbytearray.h:861
operator+
QByteArray operator+(QByteArray &&lhs, const char *rhs)
Definition qbytearray.h:746
__has_include
#define __has_include(x)
Definition qcompilerdetection.h:459
operator<<
Q_CORE_EXPORT QDebug operator<<(QDebug debug, QDir::Filters filters)
Definition qdir.cpp:2620
QT_MESSAGELOG_FUNC
#define QT_MESSAGELOG_FUNC
Definition qlogging.h:162
QT_MESSAGELOG_FILE
#define QT_MESSAGELOG_FILE
Definition qlogging.h:160
QT_MESSAGE_LOGGER_NORETURN
#define QT_MESSAGE_LOGGER_NORETURN
Definition qlogging.h:70
QT_MESSAGELOG_LINE
#define QT_MESSAGELOG_LINE
Definition qlogging.h:161
qSetMessagePattern
Q_CORE_EXPORT void qSetMessagePattern(const QString &messagePattern)
Definition qlogging.cpp:2465
QT_MESSAGELOGCONTEXT
#define QT_MESSAGELOGCONTEXT
Definition qlogging.h:155
QtMsgType
QtMsgType
Definition qlogging.h:30
QtCriticalMsg
@ QtCriticalMsg
Definition qlogging.h:34
QtFatalMsg
@ QtFatalMsg
Definition qlogging.h:35
QtDebugMsg
@ QtDebugMsg
Definition qlogging.h:31
qt_message_output
Q_CORE_EXPORT void qt_message_output(QtMsgType, const QMessageLogContext &context, const QString &message)
Definition qlogging.cpp:2244
QtMessageHandler
void(* QtMessageHandler)(QtMsgType, const QMessageLogContext &, const QString &)
Definition qlogging.h:197
QBasicMutex
QMutex QBasicMutex
Definition qmutex.h:360
QMessagePattern::setPattern
void setPattern(const QString &pattern)
Definition qlogging.cpp:1231
QMessagePattern::literals
std::unique_ptr< std::unique_ptr< const char[]>[]> literals
Definition qlogging.cpp:1184
QMessagePattern::appStartTime
std::chrono::steady_clock::time_point appStartTime
Definition qlogging.cpp:1187
QMessagePattern::tokens
std::unique_ptr< const char *[]> tokens
Definition qlogging.cpp:1185
QMessagePattern::timeArgs
QList< QString > timeArgs
Definition qlogging.cpp:1186
QMessagePattern::mutex
static QBasicMutex mutex
Definition qlogging.cpp:1199
QMessagePattern::setDefaultPattern
void setDefaultPattern()
Definition qlogging.cpp:1159