Move text-related code out of corelib/tools/ to corelib/text/

This includes byte array, string, char, unicode, locale, collation and
regular expressions.

Change-Id: I8b125fa52c8c513eb57a0f1298b91910e5a0d786
Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>

1 files changed, 0 insertions, 12593 deletions

diff --git a/src/corelib/tools/qstring.cpp b/src/corelib/tools/qstring.cpp
deleted file mode 100644
index 12506afdef..0000000000
--- a/src/corelib/tools/qstring.cpp
+++ /dev/null
@@ -1,12593 +0,0 @@
-/****************************************************************************
-**
-** Copyright (C) 2016 The Qt Company Ltd.
-** Copyright (C) 2018 Intel Corporation.
-** Copyright (C) 2019 Mail.ru Group.
-** 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$
-**
-****************************************************************************/
-
-#include "qstringlist.h"
-#include "qregexp.h"
-#if QT_CONFIG(regularexpression)
-#include "qregularexpression.h"
-#endif
-#include "qunicodetables_p.h"
-#if QT_CONFIG(textcodec)
-#include <qtextcodec.h>
-#endif
-#include <private/qutfcodec_p.h>
-#include <private/qlocale_tools_p.h>
-#include "qsimd_p.h"
-#include <qnumeric.h>
-#include <qdatastream.h>
-#include <qlist.h>
-#include "qlocale.h"
-#include "qlocale_p.h"
-#include "qstringbuilder.h"
-#include "qstringmatcher.h"
-#include "qvarlengtharray.h"
-#include "qtools_p.h"
-#include "qdebug.h"
-#include "qendian.h"
-#include "qcollator.h"
-
-#ifdef Q_OS_MAC
-#include <private/qcore_mac_p.h>
-#endif
-
-#include <private/qfunctions_p.h>
-
-#include <limits.h>
-#include <string.h>
-#include <stdlib.h>
-#include <stdio.h>
-#include <stdarg.h>
-#include <wchar.h>
-
-#include "qchar.cpp"
-#include "qstringmatcher.cpp"
-#include "qstringiterator_p.h"
-#include "qstringalgorithms_p.h"
-#include "qthreadstorage.h"
-
-#ifdef Q_OS_WIN
-#  include <qt_windows.h>
-#endif
-
-#ifdef truncate
-#  undef truncate
-#endif
-
-#ifndef LLONG_MAX
-#define LLONG_MAX qint64_C(9223372036854775807)
-#endif
-#ifndef LLONG_MIN
-#define LLONG_MIN (-LLONG_MAX - qint64_C(1))
-#endif
-#ifndef ULLONG_MAX
-#define ULLONG_MAX quint64_C(18446744073709551615)
-#endif
-
-#define IS_RAW_DATA(d) ((d)->offset != sizeof(QStringData))
-
-QT_BEGIN_NAMESPACE
-
-/*
- * Note on the use of SIMD in qstring.cpp:
- *
- * Several operations with strings are improved with the use of SIMD code,
- * since they are repetitive. For MIPS, we have hand-written assembly code
- * outside of qstring.cpp targeting MIPS DSP and MIPS DSPr2. For ARM and for
- * x86, we can only use intrinsics and therefore everything is contained in
- * qstring.cpp. We need to use intrinsics only for those platforms due to the
- * different compilers and toolchains used, which have different syntax for
- * assembly sources.
- *
- * ** SSE notes: **
- *
- * Whenever multiple alternatives are equivalent or near so, we prefer the one
- * using instructions from SSE2, since SSE2 is guaranteed to be enabled for all
- * 64-bit builds and we enable it for 32-bit builds by default. Use of higher
- * SSE versions should be done when there is a clear performance benefit and
- * requires fallback code to SSE2, if it exists.
- *
- * Performance measurement in the past shows that most strings are short in
- * size and, therefore, do not benefit from alignment prologues. That is,
- * trying to find a 16-byte-aligned boundary to operate on is often more
- * expensive than executing the unaligned operation directly. In addition, note
- * that the QString private data is designed so that the data is stored on
- * 16-byte boundaries if the system malloc() returns 16-byte aligned pointers
- * on its own (64-bit glibc on Linux does; 32-bit glibc on Linux returns them
- * 50% of the time), so skipping the alignment prologue is actually optimizing
- * for the common case.
- */
-
-#if defined(__mips_dsp)
-// From qstring_mips_dsp_asm.S
-extern "C" void qt_fromlatin1_mips_asm_unroll4 (ushort*, const char*, uint);
-extern "C" void qt_fromlatin1_mips_asm_unroll8 (ushort*, const char*, uint);
-extern "C" void qt_toLatin1_mips_dsp_asm(uchar *dst, const ushort *src, int length);
-#endif
-
-// internal
-qsizetype qFindStringBoyerMoore(QStringView haystack, qsizetype from, QStringView needle, Qt::CaseSensitivity cs);
-static inline qsizetype qFindChar(QStringView str, QChar ch, qsizetype from, Qt::CaseSensitivity cs) noexcept;
-template <typename Haystack>
-static inline qsizetype qLastIndexOf(Haystack haystack, QChar needle, qsizetype from, Qt::CaseSensitivity cs) noexcept;
-static inline qsizetype qt_string_count(QStringView haystack, QStringView needle, Qt::CaseSensitivity cs);
-static inline qsizetype qt_string_count(QStringView haystack, QChar needle, Qt::CaseSensitivity cs);
-
-static inline bool qt_starts_with(QStringView haystack, QStringView needle, Qt::CaseSensitivity cs);
-static inline bool qt_starts_with(QStringView haystack, QLatin1String needle, Qt::CaseSensitivity cs);
-static inline bool qt_starts_with(QStringView haystack, QChar needle, Qt::CaseSensitivity cs);
-static inline bool qt_ends_with(QStringView haystack, QStringView needle, Qt::CaseSensitivity cs);
-static inline bool qt_ends_with(QStringView haystack, QLatin1String needle, Qt::CaseSensitivity cs);
-static inline bool qt_ends_with(QStringView haystack, QChar needle, Qt::CaseSensitivity cs);
-
-qsizetype QtPrivate::qustrlen(const ushort *str) noexcept
-{
-    qsizetype result = 0;
-
-#ifdef __SSE2__
-    // find the 16-byte alignment immediately prior or equal to str
-    quintptr misalignment = quintptr(str) & 0xf;
-    Q_ASSERT((misalignment & 1) == 0);
-    const ushort *ptr = str - (misalignment / 2);
-
-    // load 16 bytes and see if we have a null
-    // (aligned loads can never segfault)
-    const __m128i zeroes = _mm_setzero_si128();
-    __m128i data = _mm_load_si128(reinterpret_cast<const __m128i *>(ptr));
-    __m128i comparison = _mm_cmpeq_epi16(data, zeroes);
-    quint32 mask = _mm_movemask_epi8(comparison);
-
-    // ignore the result prior to the beginning of str
-    mask >>= misalignment;
-
-    // Have we found something in the first block? Need to handle it now
-    // because of the left shift above.
-    if (mask)
-        return qCountTrailingZeroBits(quint32(mask)) / 2;
-
-    do {
-        ptr += 8;
-        data = _mm_load_si128(reinterpret_cast<const __m128i *>(ptr));
-
-        comparison = _mm_cmpeq_epi16(data, zeroes);
-        mask = _mm_movemask_epi8(comparison);
-    } while (mask == 0);
-
-    // found a null
-    uint idx = qCountTrailingZeroBits(quint32(mask));
-    return ptr - str + idx / 2;
-#endif
-
-    if (sizeof(wchar_t) == sizeof(ushort))
-        return wcslen(reinterpret_cast<const wchar_t *>(str));
-
-    while (*str++)
-        ++result;
-    return result;
-}
-
-#if !defined(__OPTIMIZE_SIZE__)
-namespace {
-template <uint MaxCount> struct UnrollTailLoop
-{
-    template <typename RetType, typename Functor1, typename Functor2, typename Number>
-    static inline RetType exec(Number count, RetType returnIfExited, Functor1 loopCheck, Functor2 returnIfFailed, Number i = 0)
-    {
-        /* equivalent to:
-         *   while (count--) {
-         *       if (loopCheck(i))
-         *           return returnIfFailed(i);
-         *   }
-         *   return returnIfExited;
-         */
-
-        if (!count)
-            return returnIfExited;
-
-        bool check = loopCheck(i);
-        if (check)
-            return returnIfFailed(i);
-
-        return UnrollTailLoop<MaxCount - 1>::exec(count - 1, returnIfExited, loopCheck, returnIfFailed, i + 1);
-    }
-
-    template <typename Functor, typename Number>
-    static inline void exec(Number count, Functor code)
-    {
-        /* equivalent to:
-         *   for (Number i = 0; i < count; ++i)
-         *       code(i);
-         */
-        exec(count, 0, [=](Number i) -> bool { code(i); return false; }, [](Number) { return 0; });
-    }
-};
-template <> template <typename RetType, typename Functor1, typename Functor2, typename Number>
-inline RetType UnrollTailLoop<0>::exec(Number, RetType returnIfExited, Functor1, Functor2, Number)
-{
-    return returnIfExited;
-}
-}
-#endif
-
-/*!
- * \internal
- *
- * Searches for character \a c in the string \a str and returns a pointer to
- * it. Unlike strchr() and wcschr() (but like glibc's strchrnul()), if the
- * character is not found, this function returns a pointer to the end of the
- * string -- that is, \c{str.end()}.
- */
-const ushort *QtPrivate::qustrchr(QStringView str, ushort c) noexcept
-{
-    const ushort *n = reinterpret_cast<const ushort *>(str.begin());
-    const ushort *e = reinterpret_cast<const ushort *>(str.end());
-
-#ifdef __SSE2__
-    bool loops = true;
-    // Using the PMOVMSKB instruction, we get two bits for each character
-    // we compare.
-#  if defined(__AVX2__) && !defined(__OPTIMIZE_SIZE__)
-    // we're going to read n[0..15] (32 bytes)
-    __m256i mch256 = _mm256_set1_epi32(c | (c << 16));
-    for (const ushort *next = n + 16; next <= e; n = next, next += 16) {
-        __m256i data = _mm256_loadu_si256(reinterpret_cast<const __m256i *>(n));
-        __m256i result = _mm256_cmpeq_epi16(data, mch256);
-        uint mask = uint(_mm256_movemask_epi8(result));
-        if (mask) {
-            uint idx = qCountTrailingZeroBits(mask);
-            return n + idx / 2;
-        }
-    }
-    loops = false;
-    __m128i mch = _mm256_castsi256_si128(mch256);
-#  else
-    __m128i mch = _mm_set1_epi32(c | (c << 16));
-#  endif
-
-    auto hasMatch = [mch, &n](__m128i data, ushort validityMask) {
-        __m128i result = _mm_cmpeq_epi16(data, mch);
-        uint mask = uint(_mm_movemask_epi8(result));
-        if ((mask & validityMask) == 0)
-            return false;
-        uint idx = qCountTrailingZeroBits(mask);
-        n += idx / 2;
-        return true;
-    };
-
-    // we're going to read n[0..7] (16 bytes)
-    for (const ushort *next = n + 8; next <= e; n = next, next += 8) {
-        __m128i data = _mm_loadu_si128(reinterpret_cast<const __m128i *>(n));
-        if (hasMatch(data, 0xffff))
-            return n;
-
-        if (!loops) {
-            n += 8;
-            break;
-        }
-    }
-
-#  if !defined(__OPTIMIZE_SIZE__)
-    // we're going to read n[0..3] (8 bytes)
-    if (e - n > 3) {
-        __m128i data = _mm_loadl_epi64(reinterpret_cast<const __m128i *>(n));
-        if (hasMatch(data, 0xff))
-            return n;
-
-        n += 4;
-    }
-
-    return UnrollTailLoop<3>::exec(e - n, e,
-                                   [=](int i) { return n[i] == c; },
-                                   [=](int i) { return n + i; });
-#  endif
-#elif defined(__ARM_NEON__) && defined(Q_PROCESSOR_ARM_64) // vaddv is only available on Aarch64
-    const uint16x8_t vmask = { 1, 1 << 1, 1 << 2, 1 << 3, 1 << 4, 1 << 5, 1 << 6, 1 << 7 };
-    const uint16x8_t ch_vec = vdupq_n_u16(c);
-    for (const ushort *next = n + 8; next <= e; n = next, next += 8) {
-        uint16x8_t data = vld1q_u16(n);
-        uint mask = vaddvq_u16(vandq_u16(vceqq_u16(data, ch_vec), vmask));
-        if (ushort(mask)) {
-            // found a match
-            return n + qCountTrailingZeroBits(mask);
-        }
-    }
-#endif // aarch64
-
-    --n;
-    while (++n != e)
-        if (*n == c)
-            return n;
-
-    return n;
-}
-
-#ifdef __SSE2__
-// Scans from \a ptr to \a end until \a maskval is non-zero. Returns true if
-// the no non-zero was found. Returns false and updates \a ptr to point to the
-// first 16-bit word that has any bit set (note: if the input is 8-bit, \a ptr
-// may be updated to one byte short).
-static bool simdTestMask(const char *&ptr, const char *end, quint32 maskval)
-{
-    auto updatePtr = [&](uint result) {
-        // found a character matching the mask
-        uint idx = qCountTrailingZeroBits(~result);
-        ptr += idx;
-        return false;
-    };
-
-#  if defined(__SSE4_1__)
-    __m128i mask;
-    auto updatePtrSimd = [&](__m128i data) {
-        __m128i masked = _mm_and_si128(mask, data);
-        __m128i comparison = _mm_cmpeq_epi16(masked, _mm_setzero_si128());
-        uint result = _mm_movemask_epi8(comparison);
-        return updatePtr(result);
-    };
-
-#    if defined(__AVX2__)
-    // AVX2 implementation: test 32 bytes at a time
-    const __m256i mask256 = _mm256_broadcastd_epi32(_mm_cvtsi32_si128(maskval));
-    while (ptr + 32 <= end) {
-        __m256i data = _mm256_loadu_si256(reinterpret_cast<const __m256i *>(ptr));
-        if (!_mm256_testz_si256(mask256, data)) {
-            // found a character matching the mask
-            __m256i masked256 = _mm256_and_si256(mask256, data);
-            __m256i comparison256 = _mm256_cmpeq_epi16(masked256, _mm256_setzero_si256());
-            return updatePtr(_mm256_movemask_epi8(comparison256));
-        }
-        ptr += 32;
-    }
-
-    mask = _mm256_castsi256_si128(mask256);
-#    else
-    // SSE 4.1 implementation: test 32 bytes at a time (two 16-byte
-    // comparisons, unrolled)
-    mask = _mm_set1_epi32(maskval);
-    while (ptr + 32 <= end) {
-        __m128i data1 = _mm_loadu_si128(reinterpret_cast<const __m128i *>(ptr));
-        __m128i data2 = _mm_loadu_si128(reinterpret_cast<const __m128i *>(ptr + 16));
-        if (!_mm_testz_si128(mask, data1))
-            return updatePtrSimd(data1);
-
-        ptr += 16;
-        if (!_mm_testz_si128(mask, data2))
-            return updatePtrSimd(data2);
-        ptr += 16;
-    }
-#    endif
-
-    // AVX2 and SSE4.1: final 16-byte comparison
-    if (ptr + 16 <= end) {
-        __m128i data1 = _mm_loadu_si128(reinterpret_cast<const __m128i *>(ptr));
-        if (!_mm_testz_si128(mask, data1))
-            return updatePtrSimd(data1);
-        ptr += 16;
-    }
-
-    // and final 8-byte comparison
-    if (ptr + 8 <= end) {
-        __m128i data1 = _mm_loadl_epi64(reinterpret_cast<const __m128i *>(ptr));
-        if (!_mm_testz_si128(mask, data1))
-            return updatePtrSimd(data1);
-        ptr += 8;
-    }
-
-#  else
-    // SSE2 implementation: test 16 bytes at a time.
-    const __m128i mask = _mm_set1_epi32(maskval);
-    while (ptr + 16 <= end) {
-        __m128i data = _mm_loadu_si128(reinterpret_cast<const __m128i *>(ptr));
-        __m128i masked = _mm_and_si128(mask, data);
-        __m128i comparison = _mm_cmpeq_epi16(masked, _mm_setzero_si128());
-        quint16 result = _mm_movemask_epi8(comparison);
-        if (result != 0xffff)
-            return updatePtr(result);
-        ptr += 16;
-    }
-
-    // and one 8-byte comparison
-    if (ptr + 8 <= end) {
-        __m128i data = _mm_loadl_epi64(reinterpret_cast<const __m128i *>(ptr));
-        __m128i masked = _mm_and_si128(mask, data);
-        __m128i comparison = _mm_cmpeq_epi16(masked, _mm_setzero_si128());
-        quint8 result = _mm_movemask_epi8(comparison);
-        if (result != 0xff)
-            return updatePtr(result);
-        ptr += 8;
-    }
-#  endif
-
-    return true;
-}
-
-static Q_ALWAYS_INLINE __m128i mm_load8_zero_extend(const void *ptr)
-{
-    const __m128i *dataptr = static_cast<const __m128i *>(ptr);
-#if defined(__SSE4_1__)
-    // use a MOVQ followed by PMOVZXBW
-    // if AVX2 is present, these should combine into a single VPMOVZXBW instruction
-    __m128i data = _mm_loadl_epi64(dataptr);
-    return _mm_cvtepu8_epi16(data);
-#  else
-    // use MOVQ followed by PUNPCKLBW
-    __m128i data = _mm_loadl_epi64(dataptr);
-    return _mm_unpacklo_epi8(data, _mm_setzero_si128());
-#  endif
-}
-#endif
-
-// Note: ptr on output may be off by one and point to a preceding US-ASCII
-// character. Usually harmless.
-bool qt_is_ascii(const char *&ptr, const char *end) noexcept
-{
-#if defined(__SSE2__)
-    // Testing for the high bit can be done efficiently with just PMOVMSKB
-#  if defined(__AVX2__)
-    while (ptr + 32 <= end) {
-        __m256i data = _mm256_loadu_si256(reinterpret_cast<const __m256i *>(ptr));
-        quint32 mask = _mm256_movemask_epi8(data);
-        if (mask) {
-            uint idx = qCountTrailingZeroBits(mask);
-            ptr += idx;
-            return false;
-        }
-        ptr += 32;
-    }
-#  endif
-    while (ptr + 16 <= end) {
-        __m128i data = _mm_loadu_si128(reinterpret_cast<const __m128i *>(ptr));
-        quint32 mask = _mm_movemask_epi8(data);
-        if (mask) {
-            uint idx = qCountTrailingZeroBits(mask);
-            ptr += idx;
-            return false;
-        }
-        ptr += 16;
-    }
-    if (ptr + 8 <= end) {
-        __m128i data = _mm_loadl_epi64(reinterpret_cast<const __m128i *>(ptr));
-        quint8 mask = _mm_movemask_epi8(data);
-        if (mask) {
-            uint idx = qCountTrailingZeroBits(mask);
-            ptr += idx;
-            return false;
-        }
-        ptr += 8;
-    }
-#endif
-
-    while (ptr + 4 <= end) {
-        quint32 data = qFromUnaligned<quint32>(ptr);
-        if (data &= 0x80808080U) {
-#if Q_BYTE_ORDER == Q_BIG_ENDIAN
-            uint idx = qCountLeadingZeroBits(data);
-#else
-            uint idx = qCountTrailingZeroBits(data);
-#endif
-            ptr += idx / 8;
-            return false;
-        }
-        ptr += 4;
-    }
-
-    while (ptr != end) {
-        if (quint8(*ptr) & 0x80)
-            return false;
-        ++ptr;
-    }
-    return true;
-}
-
-bool QtPrivate::isAscii(QLatin1String s) noexcept
-{
-    const char *ptr = s.begin();
-    const char *end = s.end();
-
-    return qt_is_ascii(ptr, end);
-}
-
-static bool isAscii(const QChar *&ptr, const QChar *end)
-{
-#ifdef __SSE2__
-    const char *ptr8 = reinterpret_cast<const char *>(ptr);
-    const char *end8 = reinterpret_cast<const char *>(end);
-    bool ok = simdTestMask(ptr8, end8, 0xff80ff80);
-    ptr = reinterpret_cast<const QChar *>(ptr8);
-    if (!ok)
-        return false;
-#endif
-
-    while (ptr != end) {
-        if (ptr->unicode() & 0xff80)
-            return false;
-        ++ptr;
-    }
-    return true;
-}
-
-bool QtPrivate::isAscii(QStringView s) noexcept
-{
-    const QChar *ptr = s.begin();
-    const QChar *end = s.end();
-
-    return isAscii(ptr, end);
-}
-
-bool QtPrivate::isLatin1(QStringView s) noexcept
-{
-    const QChar *ptr = s.begin();
-    const QChar *end = s.end();
-
-#if defined(__SSE4_1__)
-    const char *ptr8 = reinterpret_cast<const char *>(ptr);
-    const char *end8 = reinterpret_cast<const char *>(end);
-    if (!simdTestMask(ptr8, end8, 0xff00ff00))
-        return false;
-    ptr = reinterpret_cast<const QChar *>(ptr8);
-#elif defined(__SSE2__)
-    // Testing if every other byte is non-zero can be done efficiently by
-    // using PUNPCKHBW (unpack high order bytes) and comparing that to zero.
-    while (ptr + 32 < end) {
-        __m128i data1 = _mm_loadu_si128(reinterpret_cast<const __m128i *>(ptr));
-        __m128i data2 = _mm_loadu_si128(reinterpret_cast<const __m128i *>(ptr + 16));
-        __m128i high = _mm_unpackhi_epi8(data1, data2);
-        __m128i comparison = _mm_cmpeq_epi16(high, _mm_setzero_si128());
-        if (_mm_movemask_epi8(comparison))
-            return false;
-        ptr += 16;
-    }
-    if (ptr + 16 < end) {
-        __m128i data1 = _mm_loadu_si128(reinterpret_cast<const __m128i *>(ptr));
-        __m128i high = _mm_unpackhi_epi8(data1, data1);
-        __m128i comparison = _mm_cmpeq_epi16(high, _mm_setzero_si128());
-        if (_mm_movemask_epi8(comparison))
-            return false;
-    }
-#endif
-
-    while (ptr != end) {
-        if ((*ptr++).unicode() > 0xff)
-            return false;
-    }
-    return true;
-}
-
-// conversion between Latin 1 and UTF-16
-void qt_from_latin1(ushort *dst, const char *str, size_t size) noexcept
-{
-    /* SIMD:
-     * Unpacking with SSE has been shown to improve performance on recent CPUs
-     * The same method gives no improvement with NEON. On Aarch64, clang will do the vectorization
-     * itself in exactly the same way as one would do it with intrinsics.
-     */
-#if defined(__SSE2__)
-    const char *e = str + size;
-    qptrdiff offset = 0;
-
-    // we're going to read str[offset..offset+15] (16 bytes)
-    for ( ; str + offset + 15 < e; offset += 16) {
-        const __m128i chunk = _mm_loadu_si128((const __m128i*)(str + offset)); // load
-#ifdef __AVX2__
-        // zero extend to an YMM register
-        const __m256i extended = _mm256_cvtepu8_epi16(chunk);
-
-        // store
-        _mm256_storeu_si256((__m256i*)(dst + offset), extended);
-#else
-        const __m128i nullMask = _mm_set1_epi32(0);
-
-        // unpack the first 8 bytes, padding with zeros
-        const __m128i firstHalf = _mm_unpacklo_epi8(chunk, nullMask);
-        _mm_storeu_si128((__m128i*)(dst + offset), firstHalf); // store
-
-        // unpack the last 8 bytes, padding with zeros
-        const __m128i secondHalf = _mm_unpackhi_epi8 (chunk, nullMask);
-        _mm_storeu_si128((__m128i*)(dst + offset + 8), secondHalf); // store
-#endif
-    }
-
-    // we're going to read str[offset..offset+7] (8 bytes)
-    if (str + offset + 7 < e) {
-        const __m128i unpacked = mm_load8_zero_extend(str + offset);
-        _mm_storeu_si128(reinterpret_cast<__m128i *>(dst + offset), unpacked);
-        offset += 8;
-    }
-
-    size = size % 8;
-    dst += offset;
-    str += offset;
-#  if !defined(__OPTIMIZE_SIZE__)
-    return UnrollTailLoop<7>::exec(int(size), [=](int i) { dst[i] = (uchar)str[i]; });
-#  endif
-#endif
-#if defined(__mips_dsp)
-    if (size > 20)
-        qt_fromlatin1_mips_asm_unroll8(dst, str, size);
-    else
-        qt_fromlatin1_mips_asm_unroll4(dst, str, size);
-#else
-    while (size--)
-        *dst++ = (uchar)*str++;
-#endif
-}
-
-template <bool Checked>
-static void qt_to_latin1_internal(uchar *dst, const ushort *src, qsizetype length)
-{
-#if defined(__SSE2__)
-    uchar *e = dst + length;
-    qptrdiff offset = 0;
-
-#  ifdef __AVX2__
-    const __m256i questionMark256 = _mm256_broadcastw_epi16(_mm_cvtsi32_si128('?'));
-    const __m256i outOfRange256 = _mm256_broadcastw_epi16(_mm_cvtsi32_si128(0x100));
-    const __m128i questionMark = _mm256_castsi256_si128(questionMark256);
-    const __m128i outOfRange = _mm256_castsi256_si128(outOfRange256);
-#  else
-    const __m128i questionMark = _mm_set1_epi16('?');
-    const __m128i outOfRange = _mm_set1_epi16(0x100);
-#  endif
-
-    auto mergeQuestionMarks = [=](__m128i chunk) {
-        // SSE has no compare instruction for unsigned comparison.
-# ifdef __SSE4_1__
-        // We use an unsigned uc = qMin(uc, 0x100) and then compare for equality.
-        chunk = _mm_min_epu16(chunk, outOfRange);
-        const __m128i offLimitMask = _mm_cmpeq_epi16(chunk, outOfRange);
-        chunk = _mm_blendv_epi8(chunk, questionMark, offLimitMask);
-# else
-        // The variables must be shiffted + 0x8000 to be compared
-        const __m128i signedBitOffset = _mm_set1_epi16(short(0x8000));
-        const __m128i thresholdMask = _mm_set1_epi16(short(0xff + 0x8000));
-
-        const __m128i signedChunk = _mm_add_epi16(chunk, signedBitOffset);
-        const __m128i offLimitMask = _mm_cmpgt_epi16(signedChunk, thresholdMask);
-
-        // offLimitQuestionMark contains '?' for each 16 bits that was off-limit
-        // the 16 bits that were correct contains zeros
-        const __m128i offLimitQuestionMark = _mm_and_si128(offLimitMask, questionMark);
-
-        // correctBytes contains the bytes that were in limit
-        // the 16 bits that were off limits contains zeros
-        const __m128i correctBytes = _mm_andnot_si128(offLimitMask, chunk);
-
-        // merge offLimitQuestionMark and correctBytes to have the result
-        chunk = _mm_or_si128(correctBytes, offLimitQuestionMark);
-
-        Q_UNUSED(outOfRange);
-# endif
-        return chunk;
-    };
-
-    // we're going to write to dst[offset..offset+15] (16 bytes)
-    for ( ; dst + offset + 15 < e; offset += 16) {
-#  if defined(__AVX2__)
-        __m256i chunk = _mm256_loadu_si256(reinterpret_cast<const __m256i *>(src + offset));
-        if (Checked) {
-            // See mergeQuestionMarks lambda above for details
-            chunk = _mm256_min_epu16(chunk, outOfRange256);
-            const __m256i offLimitMask = _mm256_cmpeq_epi16(chunk, outOfRange256);
-            chunk = _mm256_blendv_epi8(chunk, questionMark256, offLimitMask);
-        }
-
-        const __m128i chunk2 = _mm256_extracti128_si256(chunk, 1);
-        const __m128i chunk1 = _mm256_castsi256_si128(chunk);
-#  else
-        __m128i chunk1 = _mm_loadu_si128((const __m128i*)(src + offset)); // load
-        if (Checked)
-            chunk1 = mergeQuestionMarks(chunk1);
-
-        __m128i chunk2 = _mm_loadu_si128((const __m128i*)(src + offset + 8)); // load
-        if (Checked)
-            chunk2 = mergeQuestionMarks(chunk2);
-#  endif
-
-        // pack the two vector to 16 x 8bits elements
-        const __m128i result = _mm_packus_epi16(chunk1, chunk2);
-        _mm_storeu_si128((__m128i*)(dst + offset), result); // store
-    }
-
-#  if !defined(__OPTIMIZE_SIZE__)
-    // we're going to write to dst[offset..offset+7] (8 bytes)
-    if (dst + offset + 7 < e) {
-        __m128i chunk = _mm_loadu_si128(reinterpret_cast<const __m128i *>(src + offset));
-        if (Checked)
-            chunk = mergeQuestionMarks(chunk);
-
-        // pack, where the upper half is ignored
-        const __m128i result = _mm_packus_epi16(chunk, chunk);
-        _mm_storel_epi64(reinterpret_cast<__m128i *>(dst + offset), result);
-        offset += 8;
-    }
-
-    // we're going to write to dst[offset..offset+3] (4 bytes)
-    if (dst + offset + 3 < e) {
-        __m128i chunk = _mm_loadl_epi64(reinterpret_cast<const __m128i *>(src + offset));
-        if (Checked)
-            chunk = mergeQuestionMarks(chunk);
-
-        // pack, we'll the upper three quarters
-        const __m128i result = _mm_packus_epi16(chunk, chunk);
-        qToUnaligned(_mm_cvtsi128_si32(result), dst + offset);
-        offset += 4;
-    }
-
-    length = length % 4;
-#  else
-    length = length % 16;
-#  endif // optimize size
-
-    // advance dst, src for tail processing
-    dst += offset;
-    src += offset;
-
-#  if !defined(__OPTIMIZE_SIZE__)
-    return UnrollTailLoop<3>::exec(length, [=](int i) {
-        if (Checked)
-            dst[i] = (src[i]>0xff) ? '?' : (uchar) src[i];
-        else
-            dst[i] = src[i];
-    });
-#  endif
-#elif defined(__ARM_NEON__)
-    // Refer to the documentation of the SSE2 implementation
-    // this use eactly the same method as for SSE except:
-    // 1) neon has unsigned comparison
-    // 2) packing is done to 64 bits (8 x 8bits component).
-    if (length >= 16) {
-        const int chunkCount = length >> 3; // divided by 8
-        const uint16x8_t questionMark = vdupq_n_u16('?'); // set
-        const uint16x8_t thresholdMask = vdupq_n_u16(0xff); // set
-        for (int i = 0; i < chunkCount; ++i) {
-            uint16x8_t chunk = vld1q_u16((uint16_t *)src); // load
-            src += 8;
-
-            if (Checked) {
-                const uint16x8_t offLimitMask = vcgtq_u16(chunk, thresholdMask); // chunk > thresholdMask
-                const uint16x8_t offLimitQuestionMark = vandq_u16(offLimitMask, questionMark); // offLimitMask & questionMark
-                const uint16x8_t correctBytes = vbicq_u16(chunk, offLimitMask); // !offLimitMask & chunk
-                chunk = vorrq_u16(correctBytes, offLimitQuestionMark); // correctBytes | offLimitQuestionMark
-            }
-            const uint8x8_t result = vmovn_u16(chunk); // narrowing move->packing
-            vst1_u8(dst, result); // store
-            dst += 8;
-        }
-        length = length % 8;
-    }
-#endif
-#if defined(__mips_dsp)
-    qt_toLatin1_mips_dsp_asm(dst, src, length);
-#else
-    while (length--) {
-        if (Checked)
-            *dst++ = (*src>0xff) ? '?' : (uchar) *src;
-        else
-            *dst++ = *src;
-        ++src;
-    }
-#endif
-}
-
-static void qt_to_latin1(uchar *dst, const ushort *src, qsizetype length)
-{
-    qt_to_latin1_internal<true>(dst, src, length);
-}
-
-void qt_to_latin1_unchecked(uchar *dst, const ushort *src, qsizetype length)
-{
-    qt_to_latin1_internal<false>(dst, src, length);
-}
-
-// Unicode case-insensitive comparison
-static int ucstricmp(const QChar *a, const QChar *ae, const QChar *b, const QChar *be)
-{
-    if (a == b)
-        return (ae - be);
-
-    const QChar *e = ae;
-    if (be - b < ae - a)
-        e = a + (be - b);
-
-    uint alast = 0;
-    uint blast = 0;
-    while (a < e) {
-//         qDebug() << Qt::hex << alast << blast;
-//         qDebug() << Qt::hex << "*a=" << *a << "alast=" << alast << "folded=" << foldCase (*a, alast);
-//         qDebug() << Qt::hex << "*b=" << *b << "blast=" << blast << "folded=" << foldCase (*b, blast);
-        int diff = foldCase(a->unicode(), alast) - foldCase(b->unicode(), blast);
-        if ((diff))
-            return diff;
-        ++a;
-        ++b;
-    }
-    if (a == ae) {
-        if (b == be)
-            return 0;
-        return -1;
-    }
-    return 1;
-}
-
-// Case-insensitive comparison between a Unicode string and a QLatin1String
-static int ucstricmp(const QChar *a, const QChar *ae, const char *b, const char *be)
-{
-    auto e = ae;
-    if (be - b < ae - a)
-        e = a + (be - b);
-
-    while (a < e) {
-        int diff = foldCase(a->unicode()) - foldCase(uchar(*b));
-        if ((diff))
-            return diff;
-        ++a;
-        ++b;
-    }
-    if (a == ae) {
-        if (b == be)
-            return 0;
-        return -1;
-    }
-    return 1;
-}
-
-#if defined(__mips_dsp)
-// From qstring_mips_dsp_asm.S
-extern "C" int qt_ucstrncmp_mips_dsp_asm(const ushort *a,
-                                         const ushort *b,
-                                         unsigned len);
-#endif
-
-// Unicode case-sensitive compare two same-sized strings
-static int ucstrncmp(const QChar *a, const QChar *b, size_t l)
-{
-#ifdef __OPTIMIZE_SIZE__
-    const QChar *end = a + l;
-    while (a < end) {
-        if (int diff = (int)a->unicode() - (int)b->unicode())
-            return diff;
-        ++a;
-        ++b;
-    }
-    return 0;
-#else
-#if defined(__mips_dsp)
-    Q_STATIC_ASSERT(sizeof(uint) == sizeof(size_t));
-    if (l >= 8) {
-        return qt_ucstrncmp_mips_dsp_asm(reinterpret_cast<const ushort*>(a),
-                                         reinterpret_cast<const ushort*>(b),
-                                         l);
-    }
-#endif // __mips_dsp
-#ifdef __SSE2__
-    const QChar *end = a + l;
-    qptrdiff offset = 0;
-
-    // Using the PMOVMSKB instruction, we get two bits for each character
-    // we compare.
-    int retval;
-    auto isDifferent = [a, b, &offset, &retval](__m128i a_data, __m128i b_data) {
-        __m128i result = _mm_cmpeq_epi16(a_data, b_data);
-        uint mask = ~uint(_mm_movemask_epi8(result));
-        if (ushort(mask) == 0)
-            return false;
-        uint idx = qCountTrailingZeroBits(mask);
-        retval = a[offset + idx / 2].unicode() - b[offset + idx / 2].unicode();
-        return true;
-    };
-
-    // we're going to read a[0..15] and b[0..15] (32 bytes)
-    for ( ; a + offset + 16 <= end; offset += 16) {
-#ifdef __AVX2__
-        __m256i a_data = _mm256_loadu_si256(reinterpret_cast<const __m256i *>(a + offset));
-        __m256i b_data = _mm256_loadu_si256(reinterpret_cast<const __m256i *>(b + offset));
-        __m256i result = _mm256_cmpeq_epi16(a_data, b_data);
-        uint mask = _mm256_movemask_epi8(result);
-#else
-        __m128i a_data1 = _mm_loadu_si128(reinterpret_cast<const __m128i *>(a + offset));
-        __m128i a_data2 = _mm_loadu_si128(reinterpret_cast<const __m128i *>(a + offset + 8));
-        __m128i b_data1 = _mm_loadu_si128(reinterpret_cast<const __m128i *>(b + offset));
-        __m128i b_data2 = _mm_loadu_si128(reinterpret_cast<const __m128i *>(b + offset + 8));
-        __m128i result1 = _mm_cmpeq_epi16(a_data1, b_data1);
-        __m128i result2 = _mm_cmpeq_epi16(a_data2, b_data2);
-        uint mask = _mm_movemask_epi8(result1) | (_mm_movemask_epi8(result2) << 16);
-#endif
-        mask = ~mask;
-        if (mask) {
-            // found a different character
-            uint idx = qCountTrailingZeroBits(mask);
-            return a[offset + idx / 2].unicode() - b[offset + idx / 2].unicode();
-        }
-    }
-
-    // we're going to read a[0..7] and b[0..7] (16 bytes)
-    if (a + offset + 8 <= end) {
-        __m128i a_data = _mm_loadu_si128(reinterpret_cast<const __m128i *>(a + offset));
-        __m128i b_data = _mm_loadu_si128(reinterpret_cast<const __m128i *>(b + offset));
-        if (isDifferent(a_data, b_data))
-            return retval;
-
-        offset += 8;
-    }
-
-    // we're going to read a[0..3] and b[0..3] (8 bytes)
-    if (a + offset + 4 <= end) {
-        __m128i a_data = _mm_loadl_epi64(reinterpret_cast<const __m128i *>(a + offset));
-        __m128i b_data = _mm_loadl_epi64(reinterpret_cast<const __m128i *>(b + offset));
-        if (isDifferent(a_data, b_data))
-            return retval;
-
-        offset += 4;
-    }
-
-    // reset l
-    l &= 3;
-
-    const auto lambda = [=](size_t i) -> int {
-        return a[offset + i].unicode() - b[offset + i].unicode();
-    };
-    return UnrollTailLoop<3>::exec(l, 0, lambda, lambda);
-#endif
-#if defined(__ARM_NEON__) && defined(Q_PROCESSOR_ARM_64) // vaddv is only available on Aarch64
-    if (l >= 8) {
-        const QChar *end = a + l;
-        const uint16x8_t mask = { 1, 1 << 1, 1 << 2, 1 << 3, 1 << 4, 1 << 5, 1 << 6, 1 << 7 };
-        while (a + 7 < end) {
-            uint16x8_t da = vld1q_u16(reinterpret_cast<const uint16_t *>(a));
-            uint16x8_t db = vld1q_u16(reinterpret_cast<const uint16_t *>(b));
-
-            uint8_t r = ~(uint8_t)vaddvq_u16(vandq_u16(vceqq_u16(da, db), mask));
-            if (r) {
-                // found a different QChar
-                uint idx = qCountTrailingZeroBits(r);
-                return (int)a[idx].unicode() - (int)b[idx].unicode();
-            }
-            a += 8;
-            b += 8;
-        }
-        l &= 7;
-    }
-    const auto lambda = [=](size_t i) -> int {
-        return a[i].unicode() - b[i].unicode();
-    };
-    return UnrollTailLoop<7>::exec(l, 0, lambda, lambda);
-#endif // __ARM_NEON__
-    if (!l)
-        return 0;
-
-    // check alignment
-    if ((reinterpret_cast<quintptr>(a) & 2) == (reinterpret_cast<quintptr>(b) & 2)) {
-        // both addresses have the same alignment
-        if (reinterpret_cast<quintptr>(a) & 2) {
-            // both addresses are not aligned to 4-bytes boundaries
-            // compare the first character
-            if (*a != *b)
-                return a->unicode() - b->unicode();
-            --l;
-            ++a;
-            ++b;
-
-            // now both addresses are 4-bytes aligned
-        }
-
-        // both addresses are 4-bytes aligned
-        // do a fast 32-bit comparison
-        const quint32 *da = reinterpret_cast<const quint32 *>(a);
-        const quint32 *db = reinterpret_cast<const quint32 *>(b);
-        const quint32 *e = da + (l >> 1);
-        for ( ; da != e; ++da, ++db) {
-            if (*da != *db) {
-                a = reinterpret_cast<const QChar *>(da);
-                b = reinterpret_cast<const QChar *>(db);
-                if (*a != *b)
-                    return a->unicode() - b->unicode();
-                return a[1].unicode() - b[1].unicode();
-            }
-        }
-
-        // do we have a tail?
-        a = reinterpret_cast<const QChar *>(da);
-        b = reinterpret_cast<const QChar *>(db);
-        return (l & 1) ? a->unicode() - b->unicode() : 0;
-    } else {
-        // one of the addresses isn't 4-byte aligned but the other is
-        const QChar *e = a + l;
-        for ( ; a != e; ++a, ++b) {
-            if (*a != *b)
-                return a->unicode() - b->unicode();
-        }
-    }
-    return 0;
-#endif
-}
-
-static int ucstrncmp(const QChar *a, const uchar *c, size_t l)
-{
-    const ushort *uc = reinterpret_cast<const ushort *>(a);
-    const ushort *e = uc + l;
-
-#ifdef __SSE2__
-    __m128i nullmask = _mm_setzero_si128();
-    qptrdiff offset = 0;
-
-#  if !defined(__OPTIMIZE_SIZE__)
-    // Using the PMOVMSKB instruction, we get two bits for each character
-    // we compare.
-    int retval;
-    auto isDifferent = [uc, c, &offset, &retval](__m128i a_data, __m128i b_data) {
-        __m128i result = _mm_cmpeq_epi16(a_data, b_data);
-        uint mask = ~uint(_mm_movemask_epi8(result));
-        if (ushort(mask) == 0)
-            return false;
-        uint idx = qCountTrailingZeroBits(mask);
-        retval = uc[offset + idx / 2] - c[offset + idx / 2];
-        return true;
-    };
-#  endif
-
-    // we're going to read uc[offset..offset+15] (32 bytes)
-    // and c[offset..offset+15] (16 bytes)
-    for ( ; uc + offset + 15 < e; offset += 16) {
-        // similar to fromLatin1_helper:
-        // load 16 bytes of Latin 1 data
-        __m128i chunk = _mm_loadu_si128((const __m128i*)(c + offset));
-
-#  ifdef __AVX2__
-        // expand Latin 1 data via zero extension
-        __m256i ldata = _mm256_cvtepu8_epi16(chunk);
-
-        // load UTF-16 data and compare
-        __m256i ucdata = _mm256_loadu_si256((const __m256i*)(uc + offset));
-        __m256i result = _mm256_cmpeq_epi16(ldata, ucdata);
-
-        uint mask = ~_mm256_movemask_epi8(result);
-#  else
-        // expand via unpacking
-        __m128i firstHalf = _mm_unpacklo_epi8(chunk, nullmask);
-        __m128i secondHalf = _mm_unpackhi_epi8(chunk, nullmask);
-
-        // load UTF-16 data and compare
-        __m128i ucdata1 = _mm_loadu_si128((const __m128i*)(uc + offset));
-        __m128i ucdata2 = _mm_loadu_si128((const __m128i*)(uc + offset + 8));
-        __m128i result1 = _mm_cmpeq_epi16(firstHalf, ucdata1);
-        __m128i result2 = _mm_cmpeq_epi16(secondHalf, ucdata2);
-
-        uint mask = ~(_mm_movemask_epi8(result1) | _mm_movemask_epi8(result2) << 16);
-#  endif
-        if (mask) {
-            // found a different character
-            uint idx = qCountTrailingZeroBits(mask);
-            return uc[offset + idx / 2] - c[offset + idx / 2];
-        }
-    }
-
-#  if !defined(__OPTIMIZE_SIZE__)
-    // we'll read uc[offset..offset+7] (16 bytes) and c[offset..offset+7] (8 bytes)
-    if (uc + offset + 7 < e) {
-        // same, but we're using an 8-byte load
-        __m128i secondHalf = mm_load8_zero_extend(c + offset);
-
-        __m128i ucdata = _mm_loadu_si128((const __m128i*)(uc + offset));
-        if (isDifferent(ucdata, secondHalf))
-            return retval;
-
-        // still matched
-        offset += 8;
-    }
-
-    enum { MaxTailLength = 3 };
-    // we'll read uc[offset..offset+3] (8 bytes) and c[offset..offset+3] (4 bytes)
-    if (uc + offset + 3 < e) {
-        __m128i chunk = _mm_cvtsi32_si128(qFromUnaligned<int>(c + offset));
-        __m128i secondHalf = _mm_unpacklo_epi8(chunk, nullmask);
-
-        __m128i ucdata = _mm_loadl_epi64(reinterpret_cast<const __m128i *>(uc + offset));
-        if (isDifferent(ucdata, secondHalf))
-            return retval;
-
-        // still matched
-        offset += 4;
-    }
-#  endif // optimize size
-
-    // reset uc and c
-    uc += offset;
-    c += offset;
-
-#  if !defined(__OPTIMIZE_SIZE__)
-    const auto lambda = [=](size_t i) { return uc[i] - ushort(c[i]); };
-    return UnrollTailLoop<MaxTailLength>::exec(e - uc, 0, lambda, lambda);
-#  endif
-#endif
-
-    while (uc < e) {
-        int diff = *uc - *c;
-        if (diff)
-            return diff;
-        uc++, c++;
-    }
-
-    return 0;
-}
-
-template <typename Number>
-Q_DECL_CONSTEXPR int lencmp(Number lhs, Number rhs) noexcept
-{
-    return lhs == rhs ? 0 :
-           lhs >  rhs ? 1 :
-           /* else */  -1 ;
-}
-
-// Unicode case-sensitive comparison
-static int ucstrcmp(const QChar *a, size_t alen, const QChar *b, size_t blen)
-{
-    if (a == b && alen == blen)
-        return 0;
-    const size_t l = qMin(alen, blen);
-    int cmp = ucstrncmp(a, b, l);
-    return cmp ? cmp : lencmp(alen, blen);
-}
-
-static int ucstrcmp(const QChar *a, size_t alen, const char *b, size_t blen)
-{
-    const size_t l = qMin(alen, blen);
-    const int cmp = ucstrncmp(a, reinterpret_cast<const uchar*>(b), l);
-    return cmp ? cmp : lencmp(alen, blen);
-}
-
-static int qt_compare_strings(QStringView lhs, QStringView rhs, Qt::CaseSensitivity cs) noexcept
-{
-    if (cs == Qt::CaseSensitive)
-        return ucstrcmp(lhs.begin(), lhs.size(), rhs.begin(), rhs.size());
-    else
-        return ucstricmp(lhs.begin(), lhs.end(), rhs.begin(), rhs.end());
-}
-
-static int qt_compare_strings(QStringView lhs, QLatin1String rhs, Qt::CaseSensitivity cs) noexcept
-{
-    if (cs == Qt::CaseSensitive)
-        return ucstrcmp(lhs.begin(), lhs.size(), rhs.begin(), rhs.size());
-    else
-        return ucstricmp(lhs.begin(), lhs.end(), rhs.begin(), rhs.end());
-}
-
-static int qt_compare_strings(QLatin1String lhs, QStringView rhs, Qt::CaseSensitivity cs) noexcept
-{
-    return -qt_compare_strings(rhs, lhs, cs);
-}
-
-static int qt_compare_strings(QLatin1String lhs, QLatin1String rhs, Qt::CaseSensitivity cs) noexcept
-{
-    if (cs == Qt::CaseInsensitive)
-        return qstrnicmp(lhs.data(), lhs.size(), rhs.data(), rhs.size());
-    if (lhs.isEmpty())
-        return lencmp(0, rhs.size());
-    const auto l = std::min(lhs.size(), rhs.size());
-    int r = qstrncmp(lhs.data(), rhs.data(), l);
-    return r ? r : lencmp(lhs.size(), rhs.size());
-}
-
-/*!
-    \relates QStringView
-    \internal
-    \since 5.10
-
-    Returns an integer that compares to 0 as \a lhs compares to \a rhs.
-
-    If \a cs is Qt::CaseSensitive (the default), the comparison is case-sensitive;
-    otherwise the comparison is case-insensitive.
-
-    Case-sensitive comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would expect.
-    Consider sorting user-visible strings with QString::localeAwareCompare().
-*/
-int QtPrivate::compareStrings(QStringView lhs, QStringView rhs, Qt::CaseSensitivity cs) noexcept
-{
-    return qt_compare_strings(lhs, rhs, cs);
-}
-
-/*!
-    \relates QStringView
-    \internal
-    \since 5.10
-    \overload
-
-    Returns an integer that compares to 0 as \a lhs compares to \a rhs.
-
-    If \a cs is Qt::CaseSensitive (the default), the comparison is case-sensitive;
-    otherwise the comparison is case-insensitive.
-
-    Case-sensitive comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would expect.
-    Consider sorting user-visible strings with QString::localeAwareCompare().
-*/
-int QtPrivate::compareStrings(QStringView lhs, QLatin1String rhs, Qt::CaseSensitivity cs) noexcept
-{
-    return qt_compare_strings(lhs, rhs, cs);
-}
-
-/*!
-    \relates QStringView
-    \internal
-    \since 5.10
-    \overload
-
-    Returns an integer that compares to 0 as \a lhs compares to \a rhs.
-
-    If \a cs is Qt::CaseSensitive (the default), the comparison is case-sensitive;
-    otherwise the comparison is case-insensitive.
-
-    Case-sensitive comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would expect.
-    Consider sorting user-visible strings with QString::localeAwareCompare().
-*/
-int QtPrivate::compareStrings(QLatin1String lhs, QStringView rhs, Qt::CaseSensitivity cs) noexcept
-{
-    return qt_compare_strings(lhs, rhs, cs);
-}
-
-/*!
-    \relates QStringView
-    \internal
-    \since 5.10
-    \overload
-
-    Returns an integer that compares to 0 as \a lhs compares to \a rhs.
-
-    If \a cs is Qt::CaseSensitive (the default), the comparison is case-sensitive;
-    otherwise the comparison is case-insensitive.
-
-    Case-sensitive comparison is based exclusively on the numeric Latin-1 values
-    of the characters and is very fast, but is not what a human would expect.
-    Consider sorting user-visible strings with QString::localeAwareCompare().
-*/
-int QtPrivate::compareStrings(QLatin1String lhs, QLatin1String rhs, Qt::CaseSensitivity cs) noexcept
-{
-    return qt_compare_strings(lhs, rhs, cs);
-}
-
-#define REHASH(a) \
-    if (sl_minus_1 < sizeof(std::size_t) * CHAR_BIT)  \
-        hashHaystack -= std::size_t(a) << sl_minus_1; \
-    hashHaystack <<= 1
-
-inline bool qIsUpper(char ch)
-{
-    return ch >= 'A' && ch <= 'Z';
-}
-
-inline bool qIsDigit(char ch)
-{
-    return ch >= '0' && ch <= '9';
-}
-
-inline char qToLower(char ch)
-{
-    if (ch >= 'A' && ch <= 'Z')
-        return ch - 'A' + 'a';
-    else
-        return ch;
-}
-
-
-#if QT_DEPRECATED_SINCE(5, 9)
-const QString::Null QString::null = { };
-#endif
-
-/*!
-  \macro QT_RESTRICTED_CAST_FROM_ASCII
-  \relates QString
-
-  Defining this macro disables most automatic conversions from source
-  literals and 8-bit data to unicode QStrings, but allows the use of
-  the \c{QChar(char)} and \c{QString(const char (&ch)[N]} constructors,
-  and the \c{QString::operator=(const char (&ch)[N])} assignment operator
-  giving most of the type-safety benefits of \c QT_NO_CAST_FROM_ASCII
-  but does not require user code to wrap character and string literals
-  with QLatin1Char, QLatin1String or similar.
-
-  Using this macro together with source strings outside the 7-bit range,
-  non-literals, or literals with embedded NUL characters is undefined.
-
-  \sa QT_NO_CAST_FROM_ASCII, QT_NO_CAST_TO_ASCII
-*/
-
-/*!
-  \macro QT_NO_CAST_FROM_ASCII
-  \relates QString
-
-  Disables automatic conversions from 8-bit strings (char *) to unicode QStrings
-
-  \sa QT_NO_CAST_TO_ASCII, QT_RESTRICTED_CAST_FROM_ASCII, QT_NO_CAST_FROM_BYTEARRAY
-*/
-
-/*!
-  \macro QT_NO_CAST_TO_ASCII
-  \relates QString
-
-  disables automatic conversion from QString to 8-bit strings (char *)
-
-  \sa QT_NO_CAST_FROM_ASCII, QT_RESTRICTED_CAST_FROM_ASCII, QT_NO_CAST_FROM_BYTEARRAY
-*/
-
-/*!
-  \macro QT_ASCII_CAST_WARNINGS
-  \internal
-  \relates QString
-
-  This macro can be defined to force a warning whenever a function is
-  called that automatically converts between unicode and 8-bit encodings.
-
-  Note: This only works for compilers that support warnings for
-  deprecated API.
-
-  \sa QT_NO_CAST_TO_ASCII, QT_NO_CAST_FROM_ASCII, QT_RESTRICTED_CAST_FROM_ASCII
-*/
-
-/*!
-    \class QCharRef
-    \inmodule QtCore
-    \reentrant
-    \brief The QCharRef class is a helper class for QString.
-
-    \internal
-
-    \ingroup string-processing
-
-    When you get an object of type QCharRef, if you can assign to it,
-    the assignment will apply to the character in the string from
-    which you got the reference. That is its whole purpose in life.
-    The QCharRef becomes invalid once modifications are made to the
-    string: if you want to keep the character, copy it into a QChar.
-
-    Most of the QChar member functions also exist in QCharRef.
-    However, they are not explicitly documented here.
-
-    \sa QString::operator[](), QString::at(), QChar
-*/
-
-/*!
-    \class QString
-    \inmodule QtCore
-    \reentrant
-
-    \brief The QString class provides a Unicode character string.
-
-    \ingroup tools
-    \ingroup shared
-    \ingroup string-processing
-
-    QString stores a string of 16-bit \l{QChar}s, where each QChar
-    corresponds to one UTF-16 code unit. (Unicode characters
-    with code values above 65535 are stored using surrogate pairs,
-    i.e., two consecutive \l{QChar}s.)
-
-    \l{Unicode} is an international standard that supports most of the
-    writing systems in use today. It is a superset of US-ASCII (ANSI
-    X3.4-1986) and Latin-1 (ISO 8859-1), and all the US-ASCII/Latin-1
-    characters are available at the same code positions.
-
-    Behind the scenes, QString uses \l{implicit sharing}
-    (copy-on-write) to reduce memory usage and to avoid the needless
-    copying of data. This also helps reduce the inherent overhead of
-    storing 16-bit characters instead of 8-bit characters.
-
-    In addition to QString, Qt also provides the QByteArray class to
-    store raw bytes and traditional 8-bit '\\0'-terminated strings.
-    For most purposes, QString is the class you want to use. It is
-    used throughout the Qt API, and the Unicode support ensures that
-    your applications will be easy to translate if you want to expand
-    your application's market at some point. The two main cases where
-    QByteArray is appropriate are when you need to store raw binary
-    data, and when memory conservation is critical (like in embedded
-    systems).
-
-    \tableofcontents
-
-    \section1 Initializing a String
-
-    One way to initialize a QString is simply to pass a \c{const char
-    *} to its constructor. For example, the following code creates a
-    QString of size 5 containing the data "Hello":
-
-    \snippet qstring/main.cpp 0
-
-    QString converts the \c{const char *} data into Unicode using the
-    fromUtf8() function.
-
-    In all of the QString functions that take \c{const char *}
-    parameters, the \c{const char *} is interpreted as a classic
-    C-style '\\0'-terminated string encoded in UTF-8. It is legal for
-    the \c{const char *} parameter to be \nullptr.
-
-    You can also provide string data as an array of \l{QChar}s:
-
-    \snippet qstring/main.cpp 1
-
-    QString makes a deep copy of the QChar data, so you can modify it
-    later without experiencing side effects. (If for performance
-    reasons you don't want to take a deep copy of the character data,
-    use QString::fromRawData() instead.)
-
-    Another approach is to set the size of the string using resize()
-    and to initialize the data character per character. QString uses
-    0-based indexes, just like C++ arrays. To access the character at
-    a particular index position, you can use \l operator[](). On
-    non-const strings, \l operator[]() returns a reference to a
-    character that can be used on the left side of an assignment. For
-    example:
-
-    \snippet qstring/main.cpp 2
-
-    For read-only access, an alternative syntax is to use the at()
-    function:
-
-    \snippet qstring/main.cpp 3
-
-    The at() function can be faster than \l operator[](), because it
-    never causes a \l{deep copy} to occur. Alternatively, use the
-    left(), right(), or mid() functions to extract several characters
-    at a time.
-
-    A QString can embed '\\0' characters (QChar::Null). The size()
-    function always returns the size of the whole string, including
-    embedded '\\0' characters.
-
-    After a call to the resize() function, newly allocated characters
-    have undefined values. To set all the characters in the string to
-    a particular value, use the fill() function.
-
-    QString provides dozens of overloads designed to simplify string
-    usage. For example, if you want to compare a QString with a string
-    literal, you can write code like this and it will work as expected:
-
-    \snippet qstring/main.cpp 4
-
-    You can also pass string literals to functions that take QStrings
-    as arguments, invoking the QString(const char *)
-    constructor. Similarly, you can pass a QString to a function that
-    takes a \c{const char *} argument using the \l qPrintable() macro
-    which returns the given QString as a \c{const char *}. This is
-    equivalent to calling <QString>.toLocal8Bit().constData().
-
-    \section1 Manipulating String Data
-
-    QString provides the following basic functions for modifying the
-    character data: append(), prepend(), insert(), replace(), and
-    remove(). For example:
-
-    \snippet qstring/main.cpp 5
-
-    If you are building a QString gradually and know in advance
-    approximately how many characters the QString will contain, you
-    can call reserve(), asking QString to preallocate a certain amount
-    of memory. You can also call capacity() to find out how much
-    memory QString actually allocated.
-
-    The replace() and remove() functions' first two arguments are the
-    position from which to start erasing and the number of characters
-    that should be erased.  If you want to replace all occurrences of
-    a particular substring with another, use one of the two-parameter
-    replace() overloads.
-
-    A frequent requirement is to remove whitespace characters from a
-    string ('\\n', '\\t', ' ', etc.). If you want to remove whitespace
-    from both ends of a QString, use the trimmed() function. If you
-    want to remove whitespace from both ends and replace multiple
-    consecutive whitespaces with a single space character within the
-    string, use simplified().
-
-    If you want to find all occurrences of a particular character or
-    substring in a QString, use the indexOf() or lastIndexOf()
-    functions. The former searches forward starting from a given index
-    position, the latter searches backward. Both return the index
-    position of the character or substring if they find it; otherwise,
-    they return -1.  For example, here is a typical loop that finds all
-    occurrences of a particular substring:
-
-    \snippet qstring/main.cpp 6
-
-    QString provides many functions for converting numbers into
-    strings and strings into numbers. See the arg() functions, the
-    setNum() functions, the number() static functions, and the
-    toInt(), toDouble(), and similar functions.
-
-    To get an upper- or lowercase version of a string use toUpper() or
-    toLower().
-
-    Lists of strings are handled by the QStringList class. You can
-    split a string into a list of strings using the split() function,
-    and join a list of strings into a single string with an optional
-    separator using QStringList::join(). You can obtain a list of
-    strings from a string list that contain a particular substring or
-    that match a particular QRegExp using the QStringList::filter()
-    function.
-
-    \section1 Querying String Data
-
-    If you want to see if a QString starts or ends with a particular
-    substring use startsWith() or endsWith(). If you simply want to
-    check whether a QString contains a particular character or
-    substring, use the contains() function. If you want to find out
-    how many times a particular character or substring occurs in the
-    string, use count().
-
-    QStrings can be compared using overloaded operators such as \l
-    operator<(), \l operator<=(), \l operator==(), \l operator>=(),
-    and so on.  Note that the comparison is based exclusively on the
-    numeric Unicode values of the characters. It is very fast, but is
-    not what a human would expect; the QString::localeAwareCompare()
-    function is a better choice for sorting user-interface strings.
-
-    To obtain a pointer to the actual character data, call data() or
-    constData(). These functions return a pointer to the beginning of
-    the QChar data. The pointer is guaranteed to remain valid until a
-    non-const function is called on the QString.
-
-    \section1 Converting Between 8-Bit Strings and Unicode Strings
-
-    QString provides the following three functions that return a
-    \c{const char *} version of the string as QByteArray: toUtf8(),
-    toLatin1(), and toLocal8Bit().
-
-    \list
-    \li toLatin1() returns a Latin-1 (ISO 8859-1) encoded 8-bit string.
-    \li toUtf8() returns a UTF-8 encoded 8-bit string. UTF-8 is a
-       superset of US-ASCII (ANSI X3.4-1986) that supports the entire
-       Unicode character set through multibyte sequences.
-    \li toLocal8Bit() returns an 8-bit string using the system's local
-       encoding.
-    \endlist
-
-    To convert from one of these encodings, QString provides
-    fromLatin1(), fromUtf8(), and fromLocal8Bit(). Other
-    encodings are supported through the QTextCodec class.
-
-    As mentioned above, QString provides a lot of functions and
-    operators that make it easy to interoperate with \c{const char *}
-    strings. But this functionality is a double-edged sword: It makes
-    QString more convenient to use if all strings are US-ASCII or
-    Latin-1, but there is always the risk that an implicit conversion
-    from or to \c{const char *} is done using the wrong 8-bit
-    encoding. To minimize these risks, you can turn off these implicit
-    conversions by defining the following two preprocessor symbols:
-
-    \list
-    \li \c QT_NO_CAST_FROM_ASCII disables automatic conversions from
-       C string literals and pointers to Unicode.
-    \li \c QT_RESTRICTED_CAST_FROM_ASCII allows automatic conversions
-       from C characters and character arrays, but disables automatic
-       conversions from character pointers to Unicode.
-    \li \c QT_NO_CAST_TO_ASCII disables automatic conversion from QString
-       to C strings.
-    \endlist
-
-    One way to define these preprocessor symbols globally for your
-    application is to add the following entry to your \l {Creating Project Files}{qmake project file}:
-
-    \snippet code/src_corelib_tools_qstring.cpp 0
-
-    You then need to explicitly call fromUtf8(), fromLatin1(),
-    or fromLocal8Bit() to construct a QString from an
-    8-bit string, or use the lightweight QLatin1String class, for
-    example:
-
-    \snippet code/src_corelib_tools_qstring.cpp 1
-
-    Similarly, you must call toLatin1(), toUtf8(), or
-    toLocal8Bit() explicitly to convert the QString to an 8-bit
-    string.  (Other encodings are supported through the QTextCodec
-    class.)
-
-    \table 100 %
-    \header
-    \li Note for C Programmers
-
-    \row
-    \li
-    Due to C++'s type system and the fact that QString is
-    \l{implicitly shared}, QStrings may be treated like \c{int}s or
-    other basic types. For example:
-
-    \snippet qstring/main.cpp 7
-
-    The \c result variable, is a normal variable allocated on the
-    stack. When \c return is called, and because we're returning by
-    value, the copy constructor is called and a copy of the string is
-    returned. No actual copying takes place thanks to the implicit
-    sharing.
-
-    \endtable
-
-    \section1 Distinction Between Null and Empty Strings
-
-    For historical reasons, QString distinguishes between a null
-    string and an empty string. A \e null string is a string that is
-    initialized using QString's default constructor or by passing
-    (const char *)0 to the constructor. An \e empty string is any
-    string with size 0. A null string is always empty, but an empty
-    string isn't necessarily null:
-
-    \snippet qstring/main.cpp 8
-
-    All functions except isNull() treat null strings the same as empty
-    strings. For example, toUtf8().constData() returns a valid pointer
-    (\e not nullptr) to a '\\0' character for a null string. We
-    recommend that you always use the isEmpty() function and avoid isNull().
-
-    \section1 Argument Formats
-
-    In member functions where an argument \e format can be specified
-    (e.g., arg(), number()), the argument \e format can be one of the
-    following:
-
-    \table
-    \header \li Format \li Meaning
-    \row \li \c e \li format as [-]9.9e[+|-]999
-    \row \li \c E \li format as [-]9.9E[+|-]999
-    \row \li \c f \li format as [-]9.9
-    \row \li \c g \li use \c e or \c f format, whichever is the most concise
-    \row \li \c G \li use \c E or \c f format, whichever is the most concise
-    \endtable
-
-    A \e precision is also specified with the argument \e format. For
-    the 'e', 'E', and 'f' formats, the \e precision represents the
-    number of digits \e after the decimal point. For the 'g' and 'G'
-    formats, the \e precision represents the maximum number of
-    significant digits (trailing zeroes are omitted).
-
-    \section1 More Efficient String Construction
-
-    Many strings are known at compile time. But the trivial
-    constructor QString("Hello"), will copy the contents of the string,
-    treating the contents as Latin-1. To avoid this one can use the
-    QStringLiteral macro to directly create the required data at compile
-    time. Constructing a QString out of the literal does then not cause
-    any overhead at runtime.
-
-    A slightly less efficient way is to use QLatin1String. This class wraps
-    a C string literal, precalculates it length at compile time and can
-    then be used for faster comparison with QStrings and conversion to
-    QStrings than a regular C string literal.
-
-    Using the QString \c{'+'} operator, it is easy to construct a
-    complex string from multiple substrings. You will often write code
-    like this:
-
-    \snippet qstring/stringbuilder.cpp 0
-
-    There is nothing wrong with either of these string constructions,
-    but there are a few hidden inefficiencies. Beginning with Qt 4.6,
-    you can eliminate them.
-
-    First, multiple uses of the \c{'+'} operator usually means
-    multiple memory allocations. When concatenating \e{n} substrings,
-    where \e{n > 2}, there can be as many as \e{n - 1} calls to the
-    memory allocator.
-
-    In 4.6, an internal template class \c{QStringBuilder} has been
-    added along with a few helper functions. This class is marked
-    internal and does not appear in the documentation, because you
-    aren't meant to instantiate it in your code. Its use will be
-    automatic, as described below. The class is found in
-    \c {src/corelib/tools/qstringbuilder.cpp} if you want to have a
-    look at it.
-
-    \c{QStringBuilder} uses expression templates and reimplements the
-    \c{'%'} operator so that when you use \c{'%'} for string
-    concatenation instead of \c{'+'}, multiple substring
-    concatenations will be postponed until the final result is about
-    to be assigned to a QString. At this point, the amount of memory
-    required for the final result is known. The memory allocator is
-    then called \e{once} to get the required space, and the substrings
-    are copied into it one by one.
-
-    Additional efficiency is gained by inlining and reduced reference
-    counting (the QString created from a \c{QStringBuilder} typically
-    has a ref count of 1, whereas QString::append() needs an extra
-    test).
-
-    There are two ways you can access this improved method of string
-    construction. The straightforward way is to include
-    \c{QStringBuilder} wherever you want to use it, and use the
-    \c{'%'} operator instead of \c{'+'} when concatenating strings:
-
-    \snippet qstring/stringbuilder.cpp 5
-
-    A more global approach which is the most convenient but
-    not entirely source compatible, is to this define in your
-    .pro file:
-
-    \snippet qstring/stringbuilder.cpp 3
-
-    and the \c{'+'} will automatically be performed as the
-    \c{QStringBuilder} \c{'%'} everywhere.
-
-    \section1 Maximum size and out-of-memory conditions
-
-    The current version of QString is limited to just under 2 GB (2^31 bytes)
-    in size. The exact value is architecture-dependent, since it depends on the
-    overhead required for managing the data block, but is no more than 32
-    bytes. Raw data blocks are also limited by the use of \c int type in the
-    current version to 2 GB minus 1 byte. Since QString uses two bytes per
-    character, that translates to just under 2^30 characters in one QString.
-
-    In case memory allocation fails, QString will throw a \c std::bad_alloc
-    exception. Out of memory conditions in the Qt containers are the only case
-    where Qt will throw exceptions.
-
-    Note that the operating system may impose further limits on applications
-    holding a lot of allocated memory, especially large, contiguous blocks.
-    Such considerations, the configuration of such behavior or any mitigation
-    are outside the scope of the Qt API.
-
-    \sa fromRawData(), QChar, QLatin1String, QByteArray, QStringRef
-*/
-
-/*!
-    \enum QString::SplitBehavior
-
-    This enum specifies how the split() function should behave with
-    respect to empty strings.
-
-    \value KeepEmptyParts  If a field is empty, keep it in the result.
-    \value SkipEmptyParts  If a field is empty, don't include it in the result.
-
-    \sa split()
-*/
-
-/*! \typedef QString::ConstIterator
-
-    Qt-style synonym for QString::const_iterator.
-*/
-
-/*! \typedef QString::Iterator
-
-    Qt-style synonym for QString::iterator.
-*/
-
-/*! \typedef QString::const_iterator
-
-    This typedef provides an STL-style const iterator for QString.
-
-    \sa QString::iterator
-*/
-
-/*! \typedef QString::iterator
-
-    The QString::iterator typedef provides an STL-style non-const
-    iterator for QString.
-
-    \sa QString::const_iterator
-*/
-
-/*! \typedef QString::const_reverse_iterator
-    \since 5.6
-
-    This typedef provides an STL-style const reverse iterator for QString.
-
-    \sa QString::reverse_iterator, QString::const_iterator
-*/
-
-/*! \typedef QString::reverse_iterator
-    \since 5.6
-
-    This typedef provides an STL-style non-const reverse iterator for QString.
-
-    \sa QString::const_reverse_iterator, QString::iterator
-*/
-
-/*!
-    \typedef QString::size_type
-
-    The QString::size_type typedef provides an STL-style type for sizes (int).
-*/
-
-/*!
-    \typedef QString::difference_type
-
-    The QString::size_type typedef provides an STL-style type for difference between pointers.
-*/
-
-/*!
-    \typedef QString::const_reference
-
-    This typedef provides an STL-style const reference for a QString element (QChar).
-*/
-/*!
-    \typedef QString::reference
-
-    This typedef provides an STL-style
-    reference for a QString element (QChar).
-*/
-
-/*!
-    \typedef QString::const_pointer
-
-    The QString::const_pointer typedef provides an STL-style
-    const pointer to a QString element (QChar).
-*/
-/*!
-    \typedef QString::pointer
-
-    The QString::const_pointer typedef provides an STL-style
-    pointer to a QString element (QChar).
-*/
-
-/*!
-    \typedef QString::value_type
-
-    This typedef provides an STL-style value type for QString.
-*/
-
-/*! \fn QString::iterator QString::begin()
-
-    Returns an \l{STL-style iterators}{STL-style iterator} pointing to the first character in
-    the string.
-
-    \sa constBegin(), end()
-*/
-
-/*! \fn QString::const_iterator QString::begin() const
-
-    \overload begin()
-*/
-
-/*! \fn QString::const_iterator QString::cbegin() const
-    \since 5.0
-
-    Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the first character
-    in the string.
-
-    \sa begin(), cend()
-*/
-
-/*! \fn QString::const_iterator QString::constBegin() const
-
-    Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the first character
-    in the string.
-
-    \sa begin(), constEnd()
-*/
-
-/*! \fn QString::iterator QString::end()
-
-    Returns an \l{STL-style iterators}{STL-style iterator} pointing to the imaginary character
-    after the last character in the string.
-
-    \sa begin(), constEnd()
-*/
-
-/*! \fn QString::const_iterator QString::end() const
-
-    \overload end()
-*/
-
-/*! \fn QString::const_iterator QString::cend() const
-    \since 5.0
-
-    Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the imaginary
-    character after the last character in the list.
-
-    \sa cbegin(), end()
-*/
-
-/*! \fn QString::const_iterator QString::constEnd() const
-
-    Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the imaginary
-    character after the last character in the list.
-
-    \sa constBegin(), end()
-*/
-
-/*! \fn QString::reverse_iterator QString::rbegin()
-    \since 5.6
-
-    Returns a \l{STL-style iterators}{STL-style} reverse iterator pointing to the first
-    character in the string, in reverse order.
-
-    \sa begin(), crbegin(), rend()
-*/
-
-/*! \fn QString::const_reverse_iterator QString::rbegin() const
-    \since 5.6
-    \overload
-*/
-
-/*! \fn QString::const_reverse_iterator QString::crbegin() const
-    \since 5.6
-
-    Returns a const \l{STL-style iterators}{STL-style} reverse iterator pointing to the first
-    character in the string, in reverse order.
-
-    \sa begin(), rbegin(), rend()
-*/
-
-/*! \fn QString::reverse_iterator QString::rend()
-    \since 5.6
-
-    Returns a \l{STL-style iterators}{STL-style} reverse iterator pointing to one past
-    the last character in the string, in reverse order.
-
-    \sa end(), crend(), rbegin()
-*/
-
-/*! \fn QString::const_reverse_iterator QString::rend() const
-    \since 5.6
-    \overload
-*/
-
-/*! \fn QString::const_reverse_iterator QString::crend() const
-    \since 5.6
-
-    Returns a const \l{STL-style iterators}{STL-style} reverse iterator pointing to one
-    past the last character in the string, in reverse order.
-
-    \sa end(), rend(), rbegin()
-*/
-
-/*!
-    \fn QString::QString()
-
-    Constructs a null string. Null strings are also empty.
-
-    \sa isEmpty()
-*/
-
-/*!
-    \fn QString::QString(QString &&other)
-
-    Move-constructs a QString instance, making it point at the same
-    object that \a other was pointing to.
-
-    \since 5.2
-*/
-
-/*! \fn QString::QString(const char *str)
-
-    Constructs a string initialized with the 8-bit string \a str. The
-    given const char pointer is converted to Unicode using the
-    fromUtf8() function.
-
-    You can disable this constructor by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \note Defining \c QT_RESTRICTED_CAST_FROM_ASCII also disables
-    this constructor, but enables a \c{QString(const char (&ch)[N])}
-    constructor instead. Using non-literal input, or input with
-    embedded NUL characters, or non-7-bit characters is undefined
-    in this case.
-
-    \sa fromLatin1(), fromLocal8Bit(), fromUtf8(), QT_NO_CAST_FROM_ASCII, QT_RESTRICTED_CAST_FROM_ASCII
-*/
-
-/*! \fn QString QString::fromStdString(const std::string &str)
-
-    Returns a copy of the \a str string. The given string is converted
-    to Unicode using the fromUtf8() function.
-
-    \sa fromLatin1(), fromLocal8Bit(), fromUtf8(), QByteArray::fromStdString()
-*/
-
-/*! \fn QString QString::fromStdWString(const std::wstring &str)
-
-    Returns a copy of the \a str string. The given string is assumed
-    to be encoded in utf16 if the size of wchar_t is 2 bytes (e.g. on
-    windows) and ucs4 if the size of wchar_t is 4 bytes (most Unix
-    systems).
-
-    \sa fromUtf16(), fromLatin1(), fromLocal8Bit(), fromUtf8(), fromUcs4(), fromStdU16String(), fromStdU32String()
-*/
-
-/*! \fn QString QString::fromWCharArray(const wchar_t *string, int size)
-    \since 4.2
-
-    Returns a copy of the \a string, where the encoding of \a string depends on
-    the size of wchar. If wchar is 4 bytes, the \a string is interpreted as UCS-4,
-    if wchar is 2 bytes it is interpreted as UTF-16.
-
-    If \a size is -1 (default), the \a string has to be \\0'-terminated.
-
-    \sa fromUtf16(), fromLatin1(), fromLocal8Bit(), fromUtf8(), fromUcs4(), fromStdWString()
-*/
-
-/*! \fn std::wstring QString::toStdWString() const
-
-    Returns a std::wstring object with the data contained in this
-    QString. The std::wstring is encoded in utf16 on platforms where
-    wchar_t is 2 bytes wide (e.g. windows) and in ucs4 on platforms
-    where wchar_t is 4 bytes wide (most Unix systems).
-
-    This method is mostly useful to pass a QString to a function
-    that accepts a std::wstring object.
-
-    \sa utf16(), toLatin1(), toUtf8(), toLocal8Bit(), toStdU16String(), toStdU32String()
-*/
-
-int QString::toUcs4_helper(const ushort *uc, int length, uint *out)
-{
-    int count = 0;
-
-    QStringIterator i(QStringView(uc, length));
-    while (i.hasNext())
-        out[count++] = i.next();
-
-    return count;
-}
-
-/*! \fn int QString::toWCharArray(wchar_t *array) const
-  \since 4.2
-
-  Fills the \a array with the data contained in this QString object.
-  The array is encoded in UTF-16 on platforms where
-  wchar_t is 2 bytes wide (e.g. windows) and in UCS-4 on platforms
-  where wchar_t is 4 bytes wide (most Unix systems).
-
-  \a array has to be allocated by the caller and contain enough space to
-  hold the complete string (allocating the array with the same length as the
-  string is always sufficient).
-
-  This function returns the actual length of the string in \a array.
-
-  \note This function does not append a null character to the array.
-
-  \sa utf16(), toUcs4(), toLatin1(), toUtf8(), toLocal8Bit(), toStdWString(), QStringView::toWCharArray()
-*/
-
-/*! \fn QString::QString(const QString &other)
-
-    Constructs a copy of \a other.
-
-    This operation takes \l{constant time}, because QString is
-    \l{implicitly shared}. This makes returning a QString from a
-    function very fast. If a shared instance is modified, it will be
-    copied (copy-on-write), and that takes \l{linear time}.
-
-    \sa operator=()
-*/
-
-/*!
-    Constructs a string initialized with the first \a size characters
-    of the QChar array \a unicode.
-
-    If \a unicode is 0, a null string is constructed.
-
-    If \a size is negative, \a unicode is assumed to point to a \\0'-terminated
-    array and its length is determined dynamically. The terminating
-    nul-character is not considered part of the string.
-
-    QString makes a deep copy of the string data. The unicode data is copied as
-    is and the Byte Order Mark is preserved if present.
-
-    \sa fromRawData()
-*/
-QString::QString(const QChar *unicode, int size)
-{
-   if (!unicode) {
-        d = Data::sharedNull();
-    } else {
-        if (size < 0) {
-            size = 0;
-            while (!unicode[size].isNull())
-                ++size;
-        }
-        if (!size) {
-            d = Data::allocate(0);
-        } else {
-            d = Data::allocate(size + 1);
-            Q_CHECK_PTR(d);
-            d->size = size;
-            memcpy(d->data(), unicode, size * sizeof(QChar));
-            d->data()[size] = '\0';
-        }
-    }
-}
-
-/*!
-    Constructs a string of the given \a size with every character set
-    to \a ch.
-
-    \sa fill()
-*/
-QString::QString(int size, QChar ch)
-{
-   if (size <= 0) {
-        d = Data::allocate(0);
-    } else {
-        d = Data::allocate(size + 1);
-        Q_CHECK_PTR(d);
-        d->size = size;
-        d->data()[size] = '\0';
-        ushort *i = d->data() + size;
-        ushort *b = d->data();
-        const ushort value = ch.unicode();
-        while (i != b)
-           *--i = value;
-    }
-}
-
-/*! \fn QString::QString(int size, Qt::Initialization)
-  \internal
-
-  Constructs a string of the given \a size without initializing the
-  characters. This is only used in \c QStringBuilder::toString().
-*/
-QString::QString(int size, Qt::Initialization)
-{
-    d = Data::allocate(size + 1);
-    Q_CHECK_PTR(d);
-    d->size = size;
-    d->data()[size] = '\0';
-}
-
-/*! \fn QString::QString(QLatin1String str)
-
-    Constructs a copy of the Latin-1 string \a str.
-
-    \sa fromLatin1()
-*/
-
-/*!
-    Constructs a string of size 1 containing the character \a ch.
-*/
-QString::QString(QChar ch)
-{
-    d = Data::allocate(2);
-    Q_CHECK_PTR(d);
-    d->size = 1;
-    d->data()[0] = ch.unicode();
-    d->data()[1] = '\0';
-}
-
-/*! \fn QString::QString(const QByteArray &ba)
-
-    Constructs a string initialized with the byte array \a ba. The
-    given byte array is converted to Unicode using fromUtf8(). Stops
-    copying at the first 0 character, otherwise copies the entire byte
-    array.
-
-    You can disable this constructor by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa fromLatin1(), fromLocal8Bit(), fromUtf8(), QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn QString::QString(const Null &)
-    \internal
-*/
-
-/*! \fn QString::QString(QStringDataPtr)
-    \internal
-*/
-
-/*! \fn QString &QString::operator=(const QString::Null &)
-    \internal
-*/
-
-/*!
-  \fn QString::~QString()
-
-    Destroys the string.
-*/
-
-
-/*! \fn void QString::swap(QString &other)
-    \since 4.8
-
-    Swaps string \a other with this string. This operation is very fast and
-    never fails.
-*/
-
-/*! \fn void QString::detach()
-
-    \internal
-*/
-
-/*! \fn bool QString::isDetached() const
-
-    \internal
-*/
-
-/*! \fn bool QString::isSharedWith(const QString &other) const
-
-    \internal
-*/
-
-/*!
-    Sets the size of the string to \a size characters.
-
-    If \a size is greater than the current size, the string is
-    extended to make it \a size characters long with the extra
-    characters added to the end. The new characters are uninitialized.
-
-    If \a size is less than the current size, characters are removed
-    from the end.
-
-    Example:
-
-    \snippet qstring/main.cpp 45
-
-    If you want to append a certain number of identical characters to
-    the string, use the \l {QString::}{resize(int, QChar)} overload.
-
-    If you want to expand the string so that it reaches a certain
-    width and fill the new positions with a particular character, use
-    the leftJustified() function:
-
-    If \a size is negative, it is equivalent to passing zero.
-
-    \snippet qstring/main.cpp 47
-
-    \sa truncate(), reserve()
-*/
-
-void QString::resize(int size)
-{
-    if (size < 0)
-        size = 0;
-
-    if (IS_RAW_DATA(d) && !d->ref.isShared() && size < d->size) {
-        d->size = size;
-        return;
-    }
-
-    if (d->ref.isShared() || uint(size) + 1u > d->alloc)
-        reallocData(uint(size) + 1u, true);
-    if (d->alloc) {
-        d->size = size;
-        d->data()[size] = '\0';
-    }
-}
-
-/*!
-    \overload
-    \since 5.7
-
-    Unlike \l {QString::}{resize(int)}, this overload
-    initializes the new characters to \a fillChar:
-
-    \snippet qstring/main.cpp 46
-*/
-
-void QString::resize(int size, QChar fillChar)
-{
-    const int oldSize = length();
-    resize(size);
-    const int difference = length() - oldSize;
-    if (difference > 0)
-        std::fill_n(d->begin() + oldSize, difference, fillChar.unicode());
-}
-
-/*! \fn int QString::capacity() const
-
-    Returns the maximum number of characters that can be stored in
-    the string without forcing a reallocation.
-
-    The sole purpose of this function is to provide a means of fine
-    tuning QString's memory usage. In general, you will rarely ever
-    need to call this function. If you want to know how many
-    characters are in the string, call size().
-
-    \sa reserve(), squeeze()
-*/
-
-/*!
-    \fn void QString::reserve(int size)
-
-    Attempts to allocate memory for at least \a size characters. If
-    you know in advance how large the string will be, you can call
-    this function, and if you resize the string often you are likely
-    to get better performance. If \a size is an underestimate, the
-    worst that will happen is that the QString will be a bit slower.
-
-    The sole purpose of this function is to provide a means of fine
-    tuning QString's memory usage. In general, you will rarely ever
-    need to call this function. If you want to change the size of the
-    string, call resize().
-
-    This function is useful for code that needs to build up a long
-    string and wants to avoid repeated reallocation. In this example,
-    we want to add to the string until some condition is \c true, and
-    we're fairly sure that size is large enough to make a call to
-    reserve() worthwhile:
-
-    \snippet qstring/main.cpp 44
-
-    \sa squeeze(), capacity()
-*/
-
-/*!
-    \fn void QString::squeeze()
-
-    Releases any memory not required to store the character data.
-
-    The sole purpose of this function is to provide a means of fine
-    tuning QString's memory usage. In general, you will rarely ever
-    need to call this function.
-
-    \sa reserve(), capacity()
-*/
-
-void QString::reallocData(uint alloc, bool grow)
-{
-    auto allocOptions = d->detachFlags();
-    if (grow)
-        allocOptions |= QArrayData::Grow;
-
-    if (d->ref.isShared() || IS_RAW_DATA(d)) {
-        Data *x = Data::allocate(alloc, allocOptions);
-        Q_CHECK_PTR(x);
-        x->size = qMin(int(alloc) - 1, d->size);
-        ::memcpy(x->data(), d->data(), x->size * sizeof(QChar));
-        x->data()[x->size] = 0;
-        if (!d->ref.deref())
-            Data::deallocate(d);
-        d = x;
-    } else {
-        Data *p = Data::reallocateUnaligned(d, alloc, allocOptions);
-        Q_CHECK_PTR(p);
-        d = p;
-    }
-}
-
-#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
-void QString::expand(int i)
-{
-    resize(qMax(i + 1, d->size), QLatin1Char(' '));
-}
-#endif
-
-/*! \fn void QString::clear()
-
-    Clears the contents of the string and makes it null.
-
-    \sa resize(), isNull()
-*/
-
-/*! \fn QString &QString::operator=(const QString &other)
-
-    Assigns \a other to this string and returns a reference to this
-    string.
-*/
-
-QString &QString::operator=(const QString &other) noexcept
-{
-    other.d->ref.ref();
-    if (!d->ref.deref())
-        Data::deallocate(d);
-    d = other.d;
-    return *this;
-}
-
-/*!
-    \fn QString &QString::operator=(QString &&other)
-
-    Move-assigns \a other to this QString instance.
-
-    \since 5.2
-*/
-
-/*! \fn QString &QString::operator=(QLatin1String str)
-
-    \overload operator=()
-
-    Assigns the Latin-1 string \a str to this string.
-*/
-QString &QString::operator=(QLatin1String other)
-{
-    if (isDetached() && other.size() <= capacity()) { // assumes d->alloc == 0 -> !isDetached() (sharedNull)
-        d->size = other.size();
-        d->data()[other.size()] = 0;
-        qt_from_latin1(d->data(), other.latin1(), other.size());
-    } else {
-        *this = fromLatin1(other.latin1(), other.size());
-    }
-    return *this;
-}
-
-/*! \fn QString &QString::operator=(const QByteArray &ba)
-
-    \overload operator=()
-
-    Assigns \a ba to this string. The byte array is converted to Unicode
-    using the fromUtf8() function. This function stops conversion at the
-    first NUL character found, or the end of the \a ba byte array.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn QString &QString::operator=(const char *str)
-
-    \overload operator=()
-
-    Assigns \a str to this string. The const char pointer is converted
-    to Unicode using the fromUtf8() function.
-
-    You can disable this operator by defining \c QT_NO_CAST_FROM_ASCII
-    or \c QT_RESTRICTED_CAST_FROM_ASCII when you compile your applications.
-    This can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII, QT_RESTRICTED_CAST_FROM_ASCII
-*/
-
-/*! \fn QString &QString::operator=(char ch)
-
-    \overload operator=()
-
-    Assigns character \a ch to this string. Note that the character is
-    converted to Unicode using the fromLatin1() function, unlike other 8-bit
-    functions that operate on UTF-8 data.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \overload operator=()
-
-    Sets the string to contain the single character \a ch.
-*/
-QString &QString::operator=(QChar ch)
-{
-    if (isDetached() && capacity() >= 1) { // assumes d->alloc == 0 -> !isDetached() (sharedNull)
-        // re-use existing capacity:
-        ushort *dat = d->data();
-        dat[0] = ch.unicode();
-        dat[1] = 0;
-        d->size = 1;
-    } else {
-        operator=(QString(ch));
-    }
-    return *this;
-}
-
-/*!
-     \fn QString& QString::insert(int position, const QString &str)
-
-    Inserts the string \a str at the given index \a position and
-    returns a reference to this string.
-
-    Example:
-
-    \snippet qstring/main.cpp 26
-
-    If the given \a position is greater than size(), the array is
-    first extended using resize().
-
-    \sa append(), prepend(), replace(), remove()
-*/
-
-
-/*!
-    \fn QString& QString::insert(int position, const QStringRef &str)
-    \since 5.5
-    \overload insert()
-
-    Inserts the string reference \a str at the given index \a position and
-    returns a reference to this string.
-
-    If the given \a position is greater than size(), the array is
-    first extended using resize().
-*/
-
-
-/*!
-    \fn QString& QString::insert(int position, const char *str)
-    \since 5.5
-    \overload insert()
-
-    Inserts the C string \a str at the given index \a position and
-    returns a reference to this string.
-
-    If the given \a position is greater than size(), the array is
-    first extended using resize().
-
-    This function is not available when \c QT_NO_CAST_FROM_ASCII is
-    defined.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-
-/*!
-    \fn QString& QString::insert(int position, const QByteArray &str)
-    \since 5.5
-    \overload insert()
-
-    Inserts the byte array \a str at the given index \a position and
-    returns a reference to this string.
-
-    If the given \a position is greater than size(), the array is
-    first extended using resize().
-
-    This function is not available when \c QT_NO_CAST_FROM_ASCII is
-    defined.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-
-/*!
-    \fn QString &QString::insert(int position, QLatin1String str)
-    \overload insert()
-
-    Inserts the Latin-1 string \a str at the given index \a position.
-*/
-QString &QString::insert(int i, QLatin1String str)
-{
-    const char *s = str.latin1();
-    if (i < 0 || !s || !(*s))
-        return *this;
-
-    int len = str.size();
-    if (Q_UNLIKELY(i > d->size))
-        resize(i + len, QLatin1Char(' '));
-    else
-        resize(d->size + len);
-
-    ::memmove(d->data() + i + len, d->data() + i, (d->size - i - len) * sizeof(QChar));
-    qt_from_latin1(d->data() + i, s, uint(len));
-    return *this;
-}
-
-/*!
-    \fn QString& QString::insert(int position, const QChar *unicode, int size)
-    \overload insert()
-
-    Inserts the first \a size characters of the QChar array \a unicode
-    at the given index \a position in the string.
-*/
-QString& QString::insert(int i, const QChar *unicode, int size)
-{
-    if (i < 0 || size <= 0)
-        return *this;
-
-    const ushort *s = (const ushort *)unicode;
-    if (s >= d->data() && s < d->data() + d->alloc) {
-        // Part of me - take a copy
-        ushort *tmp = static_cast<ushort *>(::malloc(size * sizeof(QChar)));
-        Q_CHECK_PTR(tmp);
-        memcpy(tmp, s, size * sizeof(QChar));
-        insert(i, reinterpret_cast<const QChar *>(tmp), size);
-        ::free(tmp);
-        return *this;
-    }
-
-    if (Q_UNLIKELY(i > d->size))
-        resize(i + size, QLatin1Char(' '));
-    else
-        resize(d->size + size);
-
-    ::memmove(d->data() + i + size, d->data() + i, (d->size - i - size) * sizeof(QChar));
-    memcpy(d->data() + i, s, size * sizeof(QChar));
-    return *this;
-}
-
-/*!
-    \fn QString& QString::insert(int position, QChar ch)
-    \overload insert()
-
-    Inserts \a ch at the given index \a position in the string.
-*/
-
-QString& QString::insert(int i, QChar ch)
-{
-    if (i < 0)
-        i += d->size;
-    if (i < 0)
-        return *this;
-    if (Q_UNLIKELY(i > d->size))
-        resize(i + 1, QLatin1Char(' '));
-    else
-        resize(d->size + 1);
-    ::memmove(d->data() + i + 1, d->data() + i, (d->size - i - 1) * sizeof(QChar));
-    d->data()[i] = ch.unicode();
-    return *this;
-}
-
-/*!
-    Appends the string \a str onto the end of this string.
-
-    Example:
-
-    \snippet qstring/main.cpp 9
-
-    This is the same as using the insert() function:
-
-    \snippet qstring/main.cpp 10
-
-    The append() function is typically very fast (\l{constant time}),
-    because QString preallocates extra space at the end of the string
-    data so it can grow without reallocating the entire string each
-    time.
-
-    \sa operator+=(), prepend(), insert()
-*/
-QString &QString::append(const QString &str)
-{
-    if (str.d != Data::sharedNull()) {
-        if (d == Data::sharedNull()) {
-            operator=(str);
-        } else {
-            if (d->ref.isShared() || uint(d->size + str.d->size) + 1u > d->alloc)
-                reallocData(uint(d->size + str.d->size) + 1u, true);
-            memcpy(d->data() + d->size, str.d->data(), str.d->size * sizeof(QChar));
-            d->size += str.d->size;
-            d->data()[d->size] = '\0';
-        }
-    }
-    return *this;
-}
-
-/*!
-  \overload append()
-  \since 5.0
-
-  Appends \a len characters from the QChar array \a str to this string.
-*/
-QString &QString::append(const QChar *str, int len)
-{
-    if (str && len > 0) {
-        if (d->ref.isShared() || uint(d->size + len) + 1u > d->alloc)
-            reallocData(uint(d->size + len) + 1u, true);
-        memcpy(d->data() + d->size, str, len * sizeof(QChar));
-        d->size += len;
-        d->data()[d->size] = '\0';
-    }
-    return *this;
-}
-
-/*!
-  \overload append()
-
-  Appends the Latin-1 string \a str to this string.
-*/
-QString &QString::append(QLatin1String str)
-{
-    const char *s = str.latin1();
-    if (s) {
-        int len = str.size();
-        if (d->ref.isShared() || uint(d->size + len) + 1u > d->alloc)
-            reallocData(uint(d->size + len) + 1u, true);
-        ushort *i = d->data() + d->size;
-        qt_from_latin1(i, s, uint(len));
-        i[len] = '\0';
-        d->size += len;
-    }
-    return *this;
-}
-
-/*! \fn QString &QString::append(const QByteArray &ba)
-
-    \overload append()
-
-    Appends the byte array \a ba to this string. The given byte array
-    is converted to Unicode using the fromUtf8() function.
-
-    You can disable this function by defining \c QT_NO_CAST_FROM_ASCII
-    when you compile your applications. This can be useful if you want
-    to ensure that all user-visible strings go through QObject::tr(),
-    for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn QString &QString::append(const char *str)
-
-    \overload append()
-
-    Appends the string \a str to this string. The given const char
-    pointer is converted to Unicode using the fromUtf8() function.
-
-    You can disable this function by defining \c QT_NO_CAST_FROM_ASCII
-    when you compile your applications. This can be useful if you want
-    to ensure that all user-visible strings go through QObject::tr(),
-    for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \overload append()
-
-    Appends the character \a ch to this string.
-*/
-QString &QString::append(QChar ch)
-{
-    if (d->ref.isShared() || uint(d->size) + 2u > d->alloc)
-        reallocData(uint(d->size) + 2u, true);
-    d->data()[d->size++] = ch.unicode();
-    d->data()[d->size] = '\0';
-    return *this;
-}
-
-/*! \fn QString &QString::prepend(const QString &str)
-
-    Prepends the string \a str to the beginning of this string and
-    returns a reference to this string.
-
-    Example:
-
-    \snippet qstring/main.cpp 36
-
-    \sa append(), insert()
-*/
-
-/*! \fn QString &QString::prepend(QLatin1String str)
-
-    \overload prepend()
-
-    Prepends the Latin-1 string \a str to this string.
-*/
-
-/*! \fn QString &QString::prepend(const QChar *str, int len)
-    \since 5.5
-    \overload prepend()
-
-    Prepends \a len characters from the QChar array \a str to this string and
-    returns a reference to this string.
-*/
-
-/*! \fn QString &QString::prepend(const QStringRef &str)
-    \since 5.5
-    \overload prepend()
-
-    Prepends the string reference \a str to the beginning of this string and
-    returns a reference to this string.
-*/
-
-/*! \fn QString &QString::prepend(const QByteArray &ba)
-
-    \overload prepend()
-
-    Prepends the byte array \a ba to this string. The byte array is
-    converted to Unicode using the fromUtf8() function.
-
-    You can disable this function by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn QString &QString::prepend(const char *str)
-
-    \overload prepend()
-
-    Prepends the string \a str to this string. The const char pointer
-    is converted to Unicode using the fromUtf8() function.
-
-    You can disable this function by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn QString &QString::prepend(QChar ch)
-
-    \overload prepend()
-
-    Prepends the character \a ch to this string.
-*/
-
-/*!
-  \fn QString &QString::remove(int position, int n)
-
-  Removes \a n characters from the string, starting at the given \a
-  position index, and returns a reference to the string.
-
-  If the specified \a position index is within the string, but \a
-  position + \a n is beyond the end of the string, the string is
-  truncated at the specified \a position.
-
-  \snippet qstring/main.cpp 37
-
-  \sa insert(), replace()
-*/
-QString &QString::remove(int pos, int len)
-{
-    if (pos < 0)  // count from end of string
-        pos += d->size;
-    if (uint(pos) >= uint(d->size)) {
-        // range problems
-    } else if (len >= d->size - pos) {
-        resize(pos); // truncate
-    } else if (len > 0) {
-        detach();
-        memmove(d->data() + pos, d->data() + pos + len,
-                (d->size - pos - len + 1) * sizeof(ushort));
-        d->size -= len;
-    }
-    return *this;
-}
-
-template<typename T>
-static void removeStringImpl(QString &s, const T &needle, Qt::CaseSensitivity cs)
-{
-    const int needleSize = needle.size();
-    if (needleSize) {
-        if (needleSize == 1) {
-            s.remove(needle.front(), cs);
-        } else {
-            int i = 0;
-            while ((i = s.indexOf(needle, i, cs)) != -1)
-                s.remove(i, needleSize);
-        }
-    }
-}
-
-/*!
-  Removes every occurrence of the given \a str string in this
-  string, and returns a reference to this string.
-
-  If \a cs is Qt::CaseSensitive (default), the search is
-  case sensitive; otherwise the search is case insensitive.
-
-  This is the same as \c replace(str, "", cs).
-
-  \sa replace()
-*/
-QString &QString::remove(const QString &str, Qt::CaseSensitivity cs)
-{
-    removeStringImpl(*this, str, cs);
-    return *this;
-}
-
-/*!
-  \since 5.11
-  \overload
-
-  Removes every occurrence of the given \a str string in this
-  string, and returns a reference to this string.
-
-  If \a cs is Qt::CaseSensitive (default), the search is
-  case sensitive; otherwise the search is case insensitive.
-
-  This is the same as \c replace(str, "", cs).
-
-  \sa replace()
-*/
-QString &QString::remove(QLatin1String str, Qt::CaseSensitivity cs)
-{
-    removeStringImpl(*this, str, cs);
-    return *this;
-}
-
-/*!
-  Removes every occurrence of the character \a ch in this string, and
-  returns a reference to this string.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  Example:
-
-  \snippet qstring/main.cpp 38
-
-  This is the same as \c replace(ch, "", cs).
-
-  \sa replace()
-*/
-QString &QString::remove(QChar ch, Qt::CaseSensitivity cs)
-{
-    const int idx = indexOf(ch, 0, cs);
-    if (idx != -1) {
-        const auto first = begin(); // implicit detach()
-        auto last = end();
-        if (cs == Qt::CaseSensitive) {
-            last = std::remove(first + idx, last, ch);
-        } else {
-            const QChar c = ch.toCaseFolded();
-            auto caseInsensEqual = [c](QChar x) {
-                return c == x.toCaseFolded();
-            };
-            last = std::remove_if(first + idx, last, caseInsensEqual);
-        }
-        resize(last - first);
-    }
-    return *this;
-}
-
-/*!
-  \fn QString &QString::remove(const QRegExp &rx)
-
-  Removes every occurrence of the regular expression \a rx in the
-  string, and returns a reference to the string. For example:
-
-  \snippet qstring/main.cpp 39
-
-  \sa indexOf(), lastIndexOf(), replace()
-*/
-
-/*!
-  \fn QString &QString::remove(const QRegularExpression &re)
-  \since 5.0
-
-  Removes every occurrence of the regular expression \a re in the
-  string, and returns a reference to the string. For example:
-
-  \snippet qstring/main.cpp 96
-
-  \sa indexOf(), lastIndexOf(), replace()
-*/
-
-/*!
-  \fn QString &QString::replace(int position, int n, const QString &after)
-
-  Replaces \a n characters beginning at index \a position with
-  the string \a after and returns a reference to this string.
-
-  \note If the specified \a position index is within the string,
-  but \a position + \a n goes outside the strings range,
-  then \a n will be adjusted to stop at the end of the string.
-
-  Example:
-
-  \snippet qstring/main.cpp 40
-
-  \sa insert(), remove()
-*/
-QString &QString::replace(int pos, int len, const QString &after)
-{
-    return replace(pos, len, after.constData(), after.length());
-}
-
-/*!
-  \fn QString &QString::replace(int position, int n, const QChar *unicode, int size)
-  \overload replace()
-  Replaces \a n characters beginning at index \a position with the
-  first \a size characters of the QChar array \a unicode and returns a
-  reference to this string.
-*/
-QString &QString::replace(int pos, int len, const QChar *unicode, int size)
-{
-    if (uint(pos) > uint(d->size))
-        return *this;
-    if (len > d->size - pos)
-        len = d->size - pos;
-
-    uint index = pos;
-    replace_helper(&index, 1, len, unicode, size);
-    return *this;
-}
-
-/*!
-  \fn QString &QString::replace(int position, int n, QChar after)
-  \overload replace()
-
-  Replaces \a n characters beginning at index \a position with the
-  character \a after and returns a reference to this string.
-*/
-QString &QString::replace(int pos, int len, QChar after)
-{
-    return replace(pos, len, &after, 1);
-}
-
-/*!
-  \overload replace()
-  Replaces every occurrence of the string \a before with the string \a
-  after and returns a reference to this string.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  Example:
-
-  \snippet qstring/main.cpp 41
-
-  \note The replacement text is not rescanned after it is inserted.
-
-  Example:
-
-  \snippet qstring/main.cpp 86
-*/
-QString &QString::replace(const QString &before, const QString &after, Qt::CaseSensitivity cs)
-{
-    return replace(before.constData(), before.size(), after.constData(), after.size(), cs);
-}
-
-namespace { // helpers for replace and its helper:
-QChar *textCopy(const QChar *start, int len)
-{
-    const size_t size = len * sizeof(QChar);
-    QChar *const copy = static_cast<QChar *>(::malloc(size));
-    Q_CHECK_PTR(copy);
-    ::memcpy(copy, start, size);
-    return copy;
-}
-
-bool pointsIntoRange(const QChar *ptr, const ushort *base, int len)
-{
-    const QChar *const start = reinterpret_cast<const QChar *>(base);
-    return start <= ptr && ptr < start + len;
-}
-} // end namespace
-
-/*!
-  \internal
- */
-void QString::replace_helper(uint *indices, int nIndices, int blen, const QChar *after, int alen)
-{
-    // Copy after if it lies inside our own d->data() area (which we could
-    // possibly invalidate via a realloc or modify by replacement).
-    QChar *afterBuffer = nullptr;
-    if (pointsIntoRange(after, d->data(), d->size)) // Use copy in place of vulnerable original:
-        after = afterBuffer = textCopy(after, alen);
-
-    QT_TRY {
-        if (blen == alen) {
-            // replace in place
-            detach();
-            for (int i = 0; i < nIndices; ++i)
-                memcpy(d->data() + indices[i], after, alen * sizeof(QChar));
-        } else if (alen < blen) {
-            // replace from front
-            detach();
-            uint to = indices[0];
-            if (alen)
-                memcpy(d->data()+to, after, alen*sizeof(QChar));
-            to += alen;
-            uint movestart = indices[0] + blen;
-            for (int i = 1; i < nIndices; ++i) {
-                int msize = indices[i] - movestart;
-                if (msize > 0) {
-                    memmove(d->data() + to, d->data() + movestart, msize * sizeof(QChar));
-                    to += msize;
-                }
-                if (alen) {
-                    memcpy(d->data() + to, after, alen * sizeof(QChar));
-                    to += alen;
-                }
-                movestart = indices[i] + blen;
-            }
-            int msize = d->size - movestart;
-            if (msize > 0)
-                memmove(d->data() + to, d->data() + movestart, msize * sizeof(QChar));
-            resize(d->size - nIndices*(blen-alen));
-        } else {
-            // replace from back
-            int adjust = nIndices*(alen-blen);
-            int newLen = d->size + adjust;
-            int moveend = d->size;
-            resize(newLen);
-
-            while (nIndices) {
-                --nIndices;
-                int movestart = indices[nIndices] + blen;
-                int insertstart = indices[nIndices] + nIndices*(alen-blen);
-                int moveto = insertstart + alen;
-                memmove(d->data() + moveto, d->data() + movestart,
-                        (moveend - movestart)*sizeof(QChar));
-                memcpy(d->data() + insertstart, after, alen * sizeof(QChar));
-                moveend = movestart-blen;
-            }
-        }
-    } QT_CATCH(const std::bad_alloc &) {
-        ::free(afterBuffer);
-        QT_RETHROW;
-    }
-    ::free(afterBuffer);
-}
-
-/*!
-  \since 4.5
-  \overload replace()
-
-  Replaces each occurrence in this string of the first \a blen
-  characters of \a before with the first \a alen characters of \a
-  after and returns a reference to this string.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-*/
-QString &QString::replace(const QChar *before, int blen,
-                          const QChar *after, int alen,
-                          Qt::CaseSensitivity cs)
-{
-    if (d->size == 0) {
-        if (blen)
-            return *this;
-    } else {
-        if (cs == Qt::CaseSensitive && before == after && blen == alen)
-            return *this;
-    }
-    if (alen == 0 && blen == 0)
-        return *this;
-
-    QStringMatcher matcher(before, blen, cs);
-    QChar *beforeBuffer = nullptr, *afterBuffer = nullptr;
-
-    int index = 0;
-    while (1) {
-        uint indices[1024];
-        uint pos = 0;
-        while (pos < 1024) {
-            index = matcher.indexIn(*this, index);
-            if (index == -1)
-                break;
-            indices[pos++] = index;
-            if (blen) // Step over before:
-                index += blen;
-            else // Only count one instance of empty between any two characters:
-                index++;
-        }
-        if (!pos) // Nothing to replace
-            break;
-
-        if (Q_UNLIKELY(index != -1)) {
-            /*
-              We're about to change data, that before and after might point
-              into, and we'll need that data for our next batch of indices.
-            */
-            if (!afterBuffer && pointsIntoRange(after, d->data(), d->size))
-                after = afterBuffer = textCopy(after, alen);
-
-            if (!beforeBuffer && pointsIntoRange(before, d->data(), d->size)) {
-                beforeBuffer = textCopy(before, blen);
-                matcher = QStringMatcher(beforeBuffer, blen, cs);
-            }
-        }
-
-        replace_helper(indices, pos, blen, after, alen);
-
-        if (Q_LIKELY(index == -1)) // Nothing left to replace
-            break;
-        // The call to replace_helper just moved what index points at:
-        index += pos*(alen-blen);
-    }
-    ::free(afterBuffer);
-    ::free(beforeBuffer);
-
-    return *this;
-}
-
-/*!
-  \overload replace()
-  Replaces every occurrence of the character \a ch in the string with
-  \a after and returns a reference to this string.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-*/
-QString& QString::replace(QChar ch, const QString &after, Qt::CaseSensitivity cs)
-{
-    if (after.d->size == 0)
-        return remove(ch, cs);
-
-    if (after.d->size == 1)
-        return replace(ch, after.front(), cs);
-
-    if (d->size == 0)
-        return *this;
-
-    ushort cc = (cs == Qt::CaseSensitive ? ch.unicode() : ch.toCaseFolded().unicode());
-
-    int index = 0;
-    while (1) {
-        uint indices[1024];
-        uint pos = 0;
-        if (cs == Qt::CaseSensitive) {
-            while (pos < 1024 && index < d->size) {
-                if (d->data()[index] == cc)
-                    indices[pos++] = index;
-                index++;
-            }
-        } else {
-            while (pos < 1024 && index < d->size) {
-                if (QChar::toCaseFolded(d->data()[index]) == cc)
-                    indices[pos++] = index;
-                index++;
-            }
-        }
-        if (!pos) // Nothing to replace
-            break;
-
-        replace_helper(indices, pos, 1, after.constData(), after.d->size);
-
-        if (Q_LIKELY(index == -1)) // Nothing left to replace
-            break;
-        // The call to replace_helper just moved what index points at:
-        index += pos*(after.d->size - 1);
-    }
-    return *this;
-}
-
-/*!
-  \overload replace()
-  Replaces every occurrence of the character \a before with the
-  character \a after and returns a reference to this string.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-*/
-QString& QString::replace(QChar before, QChar after, Qt::CaseSensitivity cs)
-{
-    if (d->size) {
-        const int idx = indexOf(before, 0, cs);
-        if (idx != -1) {
-            detach();
-            const ushort a = after.unicode();
-            ushort *i = d->data();
-            const ushort *e = i + d->size;
-            i += idx;
-            *i = a;
-            if (cs == Qt::CaseSensitive) {
-                const ushort b = before.unicode();
-                while (++i != e) {
-                    if (*i == b)
-                        *i = a;
-                }
-            } else {
-                const ushort b = foldCase(before.unicode());
-                while (++i != e) {
-                    if (foldCase(*i) == b)
-                        *i = a;
-                }
-            }
-        }
-    }
-    return *this;
-}
-
-/*!
-  \since 4.5
-  \overload replace()
-
-  Replaces every occurrence of the string \a before with the string \a
-  after and returns a reference to this string.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  \note The text is not rescanned after a replacement.
-*/
-QString &QString::replace(QLatin1String before, QLatin1String after, Qt::CaseSensitivity cs)
-{
-    int alen = after.size();
-    int blen = before.size();
-    QVarLengthArray<ushort> a(alen);
-    QVarLengthArray<ushort> b(blen);
-    qt_from_latin1(a.data(), after.latin1(), alen);
-    qt_from_latin1(b.data(), before.latin1(), blen);
-    return replace((const QChar *)b.data(), blen, (const QChar *)a.data(), alen, cs);
-}
-
-/*!
-  \since 4.5
-  \overload replace()
-
-  Replaces every occurrence of the string \a before with the string \a
-  after and returns a reference to this string.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  \note The text is not rescanned after a replacement.
-*/
-QString &QString::replace(QLatin1String before, const QString &after, Qt::CaseSensitivity cs)
-{
-    int blen = before.size();
-    QVarLengthArray<ushort> b(blen);
-    qt_from_latin1(b.data(), before.latin1(), blen);
-    return replace((const QChar *)b.data(), blen, after.constData(), after.d->size, cs);
-}
-
-/*!
-  \since 4.5
-  \overload replace()
-
-  Replaces every occurrence of the string \a before with the string \a
-  after and returns a reference to this string.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  \note The text is not rescanned after a replacement.
-*/
-QString &QString::replace(const QString &before, QLatin1String after, Qt::CaseSensitivity cs)
-{
-    int alen = after.size();
-    QVarLengthArray<ushort> a(alen);
-    qt_from_latin1(a.data(), after.latin1(), alen);
-    return replace(before.constData(), before.d->size, (const QChar *)a.data(), alen, cs);
-}
-
-/*!
-  \since 4.5
-  \overload replace()
-
-  Replaces every occurrence of the character \a c with the string \a
-  after and returns a reference to this string.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  \note The text is not rescanned after a replacement.
-*/
-QString &QString::replace(QChar c, QLatin1String after, Qt::CaseSensitivity cs)
-{
-    int alen = after.size();
-    QVarLengthArray<ushort> a(alen);
-    qt_from_latin1(a.data(), after.latin1(), alen);
-    return replace(&c, 1, (const QChar *)a.data(), alen, cs);
-}
-
-
-/*!
-  \relates QString
-  Returns \c true if string \a s1 is equal to string \a s2; otherwise
-  returns \c false.
-
-  The comparison is based exclusively on the numeric Unicode values of
-  the characters and is very fast, but is not what a human would
-  expect. Consider sorting user-interface strings with
-  localeAwareCompare().
-*/
-bool operator==(const QString &s1, const QString &s2) noexcept
-{
-    if (s1.d->size != s2.d->size)
-        return false;
-
-    return qt_compare_strings(s1, s2, Qt::CaseSensitive) == 0;
-}
-
-/*!
-    \overload operator==()
-    Returns \c true if this string is equal to \a other; otherwise
-    returns \c false.
-*/
-bool QString::operator==(QLatin1String other) const noexcept
-{
-    if (d->size != other.size())
-        return false;
-
-    return qt_compare_strings(*this, other, Qt::CaseSensitive) == 0;
-}
-
-/*! \fn bool QString::operator==(const QByteArray &other) const
-
-    \overload operator==()
-
-    The \a other byte array is converted to a QString using the
-    fromUtf8() function. This function stops conversion at the
-    first NUL character found, or the end of the byte array.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    Returns \c true if this string is lexically equal to the parameter
-    string \a other. Otherwise returns \c false.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn bool QString::operator==(const char *other) const
-
-    \overload operator==()
-
-    The \a other const char pointer is converted to a QString using
-    the fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-   \relates QString
-    Returns \c true if string \a s1 is lexically less than string
-    \a s2; otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings using the
-    QString::localeAwareCompare() function.
-*/
-bool operator<(const QString &s1, const QString &s2) noexcept
-{
-    return qt_compare_strings(s1, s2, Qt::CaseSensitive) < 0;
-}
-
-/*!
-   \overload operator<()
-
-    Returns \c true if this string is lexically less than the parameter
-    string called \a other; otherwise returns \c false.
-*/
-bool QString::operator<(QLatin1String other) const noexcept
-{
-    return qt_compare_strings(*this, other, Qt::CaseSensitive) < 0;
-}
-
-/*! \fn bool QString::operator<(const QByteArray &other) const
-
-    \overload operator<()
-
-    The \a other byte array is converted to a QString using the
-    fromUtf8() function. If any NUL characters ('\\0') are embedded
-    in the byte array, they will be included in the transformation.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn bool QString::operator<(const char *other) const
-
-    Returns \c true if this string is lexically less than string \a other.
-    Otherwise returns \c false.
-
-    \overload operator<()
-
-    The \a other const char pointer is converted to a QString using
-    the fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn bool operator<=(const QString &s1, const QString &s2)
-
-    \relates QString
-
-    Returns \c true if string \a s1 is lexically less than or equal to
-    string \a s2; otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings with
-    localeAwareCompare().
-*/
-
-/*! \fn bool QString::operator<=(QLatin1String other) const
-
-    Returns \c true if this string is lexically less than or equal to
-    parameter string \a other. Otherwise returns \c false.
-
-    \overload operator<=()
-*/
-
-/*! \fn bool QString::operator<=(const QByteArray &other) const
-
-    \overload operator<=()
-
-    The \a other byte array is converted to a QString using the
-    fromUtf8() function. If any NUL characters ('\\0') are embedded
-    in the byte array, they will be included in the transformation.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn bool QString::operator<=(const char *other) const
-
-    \overload operator<=()
-
-    The \a other const char pointer is converted to a QString using
-    the fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn bool operator>(const QString &s1, const QString &s2)
-    \relates QString
-
-    Returns \c true if string \a s1 is lexically greater than string \a s2;
-    otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings with
-    localeAwareCompare().
-*/
-
-/*!
-   \overload operator>()
-
-    Returns \c true if this string is lexically greater than the parameter
-    string \a other; otherwise returns \c false.
-*/
-bool QString::operator>(QLatin1String other) const noexcept
-{
-    return qt_compare_strings(*this, other, Qt::CaseSensitive) > 0;
-}
-
-/*! \fn bool QString::operator>(const QByteArray &other) const
-
-    \overload operator>()
-
-    The \a other byte array is converted to a QString using the
-    fromUtf8() function. If any NUL characters ('\\0') are embedded
-    in the byte array, they will be included in the transformation.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn bool QString::operator>(const char *other) const
-
-    \overload operator>()
-
-    The \a other const char pointer is converted to a QString using
-    the fromUtf8() function.
-
-    You can disable this operator by defining \c QT_NO_CAST_FROM_ASCII
-    when you compile your applications. This can be useful if you want
-    to ensure that all user-visible strings go through QObject::tr(),
-    for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn bool operator>=(const QString &s1, const QString &s2)
-    \relates QString
-
-    Returns \c true if string \a s1 is lexically greater than or equal to
-    string \a s2; otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings with
-    localeAwareCompare().
-*/
-
-/*! \fn bool QString::operator>=(QLatin1String other) const
-
-    Returns \c true if this string is lexically greater than or equal to parameter
-    string \a other. Otherwise returns \c false.
-
-    \overload operator>=()
-*/
-
-/*! \fn bool QString::operator>=(const QByteArray &other) const
-
-    \overload operator>=()
-
-    The \a other byte array is converted to a QString using the
-    fromUtf8() function. If any NUL characters ('\\0') are embedded in
-    the byte array, they will be included in the transformation.
-
-    You can disable this operator by defining \c QT_NO_CAST_FROM_ASCII
-    when you compile your applications. This can be useful if you want
-    to ensure that all user-visible strings go through QObject::tr(),
-    for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn bool QString::operator>=(const char *other) const
-
-    \overload operator>=()
-
-    The \a other const char pointer is converted to a QString using
-    the fromUtf8() function.
-
-    You can disable this operator by defining \c QT_NO_CAST_FROM_ASCII
-    when you compile your applications. This can be useful if you want
-    to ensure that all user-visible strings go through QObject::tr(),
-    for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn bool operator!=(const QString &s1, const QString &s2)
-    \relates QString
-
-    Returns \c true if string \a s1 is not equal to string \a s2;
-    otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings with
-    localeAwareCompare().
-*/
-
-/*! \fn bool QString::operator!=(QLatin1String other) const
-
-    Returns \c true if this string is not equal to parameter string \a other.
-    Otherwise returns \c false.
-
-    \overload operator!=()
-*/
-
-/*! \fn bool QString::operator!=(const QByteArray &other) const
-
-    \overload operator!=()
-
-    The \a other byte array is converted to a QString using the
-    fromUtf8() function. If any NUL characters ('\\0') are embedded
-    in the byte array, they will be included in the transformation.
-
-    You can disable this operator by defining \c QT_NO_CAST_FROM_ASCII
-    when you compile your applications. This can be useful if you want
-    to ensure that all user-visible strings go through QObject::tr(),
-    for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn bool QString::operator!=(const char *other) const
-
-    \overload operator!=()
-
-    The \a other const char pointer is converted to a QString using
-    the fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*!
-  Returns the index position of the first occurrence of the string \a
-  str in this string, searching forward from index position \a
-  from. Returns -1 if \a str is not found.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  Example:
-
-  \snippet qstring/main.cpp 24
-
-  If \a from is -1, the search starts at the last character; if it is
-  -2, at the next to last character and so on.
-
-  \sa lastIndexOf(), contains(), count()
-*/
-int QString::indexOf(const QString &str, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(QtPrivate::findString(QStringView(unicode(), length()), from, QStringView(str.unicode(), str.length()), cs));
-}
-#endif  // QT_STRINGVIEW_LEVEL < 2
-
-/*!
-    \fn int QString::indexOf(QStringView str, int from, Qt::CaseSensitivity cs) const
-    \since 5.14
-    \overload indexOf()
-
-    Returns the index position of the first occurrence of the string view \a str
-    in this string, searching forward from index position \a from.
-    Returns -1 if \a str is not found.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case
-    sensitive; otherwise the search is case insensitive.
-
-    If \a from is -1, the search starts at the last character; if it is
-    -2, at the next to last character and so on.
-
-    \sa QStringView::indexOf(), lastIndexOf(), contains(), count()
-*/
-
-/*!
-  \since 4.5
-  Returns the index position of the first occurrence of the string \a
-  str in this string, searching forward from index position \a
-  from. Returns -1 if \a str is not found.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  Example:
-
-  \snippet qstring/main.cpp 24
-
-  If \a from is -1, the search starts at the last character; if it is
-  -2, at the next to last character and so on.
-
-  \sa lastIndexOf(), contains(), count()
-*/
-
-int QString::indexOf(QLatin1String str, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(QtPrivate::findString(QStringView(unicode(), size()), from, str, cs));
-}
-
-/*!
-    \overload indexOf()
-
-    Returns the index position of the first occurrence of the
-    character \a ch in the string, searching forward from index
-    position \a from. Returns -1 if \a ch could not be found.
-*/
-int QString::indexOf(QChar ch, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(qFindChar(QStringView(unicode(), length()), ch, from, cs));
-}
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*!
-    \since 4.8
-
-    \overload indexOf()
-
-    Returns the index position of the first occurrence of the string
-    reference \a str in this string, searching forward from index
-    position \a from. Returns -1 if \a str is not found.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case
-    sensitive; otherwise the search is case insensitive.
-*/
-int QString::indexOf(const QStringRef &str, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(QtPrivate::findString(QStringView(unicode(), length()), from, QStringView(str.unicode(), str.length()), cs));
-}
-
-/*!
-  Returns the index position of the last occurrence of the string \a
-  str in this string, searching backward from index position \a
-  from. If \a from is -1 (default), the search starts at the last
-  character; if \a from is -2, at the next to last character and so
-  on. Returns -1 if \a str is not found.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  Example:
-
-  \snippet qstring/main.cpp 29
-
-  \sa indexOf(), contains(), count()
-*/
-int QString::lastIndexOf(const QString &str, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(QtPrivate::lastIndexOf(*this, from, str, cs));
-}
-
-#endif // QT_STRINGVIEW_LEVEL < 2
-
-/*!
-  \since 4.5
-  \overload lastIndexOf()
-
-  Returns the index position of the last occurrence of the string \a
-  str in this string, searching backward from index position \a
-  from. If \a from is -1 (default), the search starts at the last
-  character; if \a from is -2, at the next to last character and so
-  on. Returns -1 if \a str is not found.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  Example:
-
-  \snippet qstring/main.cpp 29
-
-  \sa indexOf(), contains(), count()
-*/
-int QString::lastIndexOf(QLatin1String str, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(QtPrivate::lastIndexOf(*this, from, str, cs));
-}
-
-/*!
-  \overload lastIndexOf()
-
-  Returns the index position of the last occurrence of the character
-  \a ch, searching backward from position \a from.
-*/
-int QString::lastIndexOf(QChar ch, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(qLastIndexOf(*this, ch, from, cs));
-}
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*!
-  \since 4.8
-  \overload lastIndexOf()
-
-  Returns the index position of the last occurrence of the string
-  reference \a str in this string, searching backward from index
-  position \a from. If \a from is -1 (default), the search starts at
-  the last character; if \a from is -2, at the next to last character
-  and so on. Returns -1 if \a str is not found.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  \sa indexOf(), contains(), count()
-*/
-int QString::lastIndexOf(const QStringRef &str, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(QtPrivate::lastIndexOf(*this, from, str, cs));
-}
-#endif // QT_STRINGVIEW_LEVEL < 2
-
-/*!
-  \fn int QString::lastIndexOf(QStringView str, int from, Qt::CaseSensitivity cs) const
-  \since 5.14
-  \overload lastIndexOf()
-
-  Returns the index position of the last occurrence of the string view \a
-  str in this string, searching backward from index position \a
-  from. If \a from is -1 (default), the search starts at the last
-  character; if \a from is -2, at the next to last character and so
-  on. Returns -1 if \a str is not found.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  \sa indexOf(), contains(), count()
-*/
-
-
-#if !(defined(QT_NO_REGEXP) && !QT_CONFIG(regularexpression))
-struct QStringCapture
-{
-    int pos;
-    int len;
-    int no;
-};
-Q_DECLARE_TYPEINFO(QStringCapture, Q_PRIMITIVE_TYPE);
-#endif
-
-#ifndef QT_NO_REGEXP
-
-/*!
-  \overload replace()
-
-  Replaces every occurrence of the regular expression \a rx in the
-  string with \a after. Returns a reference to the string. For
-  example:
-
-  \snippet qstring/main.cpp 42
-
-  For regular expressions containing \l{capturing parentheses},
-  occurrences of \b{\\1}, \b{\\2}, ..., in \a after are replaced
-  with \a{rx}.cap(1), cap(2), ...
-
-  \snippet qstring/main.cpp 43
-
-  \sa indexOf(), lastIndexOf(), remove(), QRegExp::cap()
-*/
-QString& QString::replace(const QRegExp &rx, const QString &after)
-{
-    QRegExp rx2(rx);
-
-    if (isEmpty() && rx2.indexIn(*this) == -1)
-        return *this;
-
-    reallocData(uint(d->size) + 1u);
-
-    int index = 0;
-    int numCaptures = rx2.captureCount();
-    int al = after.length();
-    QRegExp::CaretMode caretMode = QRegExp::CaretAtZero;
-
-    if (numCaptures > 0) {
-        const QChar *uc = after.unicode();
-        int numBackRefs = 0;
-
-        for (int i = 0; i < al - 1; i++) {
-            if (uc[i] == QLatin1Char('\\')) {
-                int no = uc[i + 1].digitValue();
-                if (no > 0 && no <= numCaptures)
-                    numBackRefs++;
-            }
-        }
-
-        /*
-            This is the harder case where we have back-references.
-        */
-        if (numBackRefs > 0) {
-            QVarLengthArray<QStringCapture, 16> captures(numBackRefs);
-            int j = 0;
-
-            for (int i = 0; i < al - 1; i++) {
-                if (uc[i] == QLatin1Char('\\')) {
-                    int no = uc[i + 1].digitValue();
-                    if (no > 0 && no <= numCaptures) {
-                        QStringCapture capture;
-                        capture.pos = i;
-                        capture.len = 2;
-
-                        if (i < al - 2) {
-                            int secondDigit = uc[i + 2].digitValue();
-                            if (secondDigit != -1 && ((no * 10) + secondDigit) <= numCaptures) {
-                                no = (no * 10) + secondDigit;
-                                ++capture.len;
-                            }
-                        }
-
-                        capture.no = no;
-                        captures[j++] = capture;
-                    }
-                }
-            }
-
-            while (index <= length()) {
-                index = rx2.indexIn(*this, index, caretMode);
-                if (index == -1)
-                    break;
-
-                QString after2(after);
-                for (j = numBackRefs - 1; j >= 0; j--) {
-                    const QStringCapture &capture = captures[j];
-                    after2.replace(capture.pos, capture.len, rx2.cap(capture.no));
-                }
-
-                replace(index, rx2.matchedLength(), after2);
-                index += after2.length();
-
-                // avoid infinite loop on 0-length matches (e.g., QRegExp("[a-z]*"))
-                if (rx2.matchedLength() == 0)
-                    ++index;
-
-                caretMode = QRegExp::CaretWontMatch;
-            }
-            return *this;
-        }
-    }
-
-    /*
-        This is the simple and optimized case where we don't have
-        back-references.
-    */
-    while (index != -1) {
-        struct {
-            int pos;
-            int length;
-        } replacements[2048];
-
-        int pos = 0;
-        int adjust = 0;
-        while (pos < 2047) {
-            index = rx2.indexIn(*this, index, caretMode);
-            if (index == -1)
-                break;
-            int ml = rx2.matchedLength();
-            replacements[pos].pos = index;
-            replacements[pos++].length = ml;
-            index += ml;
-            adjust += al - ml;
-            // avoid infinite loop
-            if (!ml)
-                index++;
-        }
-        if (!pos)
-            break;
-        replacements[pos].pos = d->size;
-        int newlen = d->size + adjust;
-
-        // to continue searching at the right position after we did
-        // the first round of replacements
-        if (index != -1)
-            index += adjust;
-        QString newstring;
-        newstring.reserve(newlen + 1);
-        QChar *newuc = newstring.data();
-        QChar *uc = newuc;
-        int copystart = 0;
-        int i = 0;
-        while (i < pos) {
-            int copyend = replacements[i].pos;
-            int size = copyend - copystart;
-            memcpy(static_cast<void*>(uc), static_cast<const void *>(d->data() + copystart), size * sizeof(QChar));
-            uc += size;
-            memcpy(static_cast<void *>(uc), static_cast<const void *>(after.d->data()), al * sizeof(QChar));
-            uc += al;
-            copystart = copyend + replacements[i].length;
-            i++;
-        }
-        memcpy(static_cast<void *>(uc), static_cast<const void *>(d->data() + copystart), (d->size - copystart) * sizeof(QChar));
-        newstring.resize(newlen);
-        *this = newstring;
-        caretMode = QRegExp::CaretWontMatch;
-    }
-    return *this;
-}
-#endif
-
-#if QT_CONFIG(regularexpression)
-/*!
-  \overload replace()
-  \since 5.0
-
-  Replaces every occurrence of the regular expression \a re in the
-  string with \a after. Returns a reference to the string. For
-  example:
-
-  \snippet qstring/main.cpp 87
-
-  For regular expressions containing capturing groups,
-  occurrences of \b{\\1}, \b{\\2}, ..., in \a after are replaced
-  with the string captured by the corresponding capturing group.
-
-  \snippet qstring/main.cpp 88
-
-  \sa indexOf(), lastIndexOf(), remove(), QRegularExpression, QRegularExpressionMatch
-*/
-QString &QString::replace(const QRegularExpression &re, const QString &after)
-{
-    if (!re.isValid()) {
-        qWarning("QString::replace: invalid QRegularExpression object");
-        return *this;
-    }
-
-    const QString copy(*this);
-    QRegularExpressionMatchIterator iterator = re.globalMatch(copy);
-    if (!iterator.hasNext()) // no matches at all
-        return *this;
-
-    reallocData(uint(d->size) + 1u);
-
-    int numCaptures = re.captureCount();
-
-    // 1. build the backreferences vector, holding where the backreferences
-    // are in the replacement string
-    QVector<QStringCapture> backReferences;
-    const int al = after.length();
-    const QChar *ac = after.unicode();
-
-    for (int i = 0; i < al - 1; i++) {
-        if (ac[i] == QLatin1Char('\\')) {
-            int no = ac[i + 1].digitValue();
-            if (no > 0 && no <= numCaptures) {
-                QStringCapture backReference;
-                backReference.pos = i;
-                backReference.len = 2;
-
-                if (i < al - 2) {
-                    int secondDigit = ac[i + 2].digitValue();
-                    if (secondDigit != -1 && ((no * 10) + secondDigit) <= numCaptures) {
-                        no = (no * 10) + secondDigit;
-                        ++backReference.len;
-                    }
-                }
-
-                backReference.no = no;
-                backReferences.append(backReference);
-            }
-        }
-    }
-
-    // 2. iterate on the matches. For every match, copy in chunks
-    // - the part before the match
-    // - the after string, with the proper replacements for the backreferences
-
-    int newLength = 0; // length of the new string, with all the replacements
-    int lastEnd = 0;
-    QVector<QStringRef> chunks;
-    while (iterator.hasNext()) {
-        QRegularExpressionMatch match = iterator.next();
-        int len;
-        // add the part before the match
-        len = match.capturedStart() - lastEnd;
-        if (len > 0) {
-            chunks << copy.midRef(lastEnd, len);
-            newLength += len;
-        }
-
-        lastEnd = 0;
-        // add the after string, with replacements for the backreferences
-        for (const QStringCapture &backReference : qAsConst(backReferences)) {
-            // part of "after" before the backreference
-            len = backReference.pos - lastEnd;
-            if (len > 0) {
-                chunks << after.midRef(lastEnd, len);
-                newLength += len;
-            }
-
-            // backreference itself
-            len = match.capturedLength(backReference.no);
-            if (len > 0) {
-                chunks << copy.midRef(match.capturedStart(backReference.no), len);
-                newLength += len;
-            }
-
-            lastEnd = backReference.pos + backReference.len;
-        }
-
-        // add the last part of the after string
-        len = after.length() - lastEnd;
-        if (len > 0) {
-            chunks << after.midRef(lastEnd, len);
-            newLength += len;
-        }
-
-        lastEnd = match.capturedEnd();
-    }
-
-    // 3. trailing string after the last match
-    if (copy.length() > lastEnd) {
-        chunks << copy.midRef(lastEnd);
-        newLength += copy.length() - lastEnd;
-    }
-
-    // 4. assemble the chunks together
-    resize(newLength);
-    int i = 0;
-    QChar *uc = data();
-    for (const QStringRef &chunk : qAsConst(chunks)) {
-        int len = chunk.length();
-        memcpy(uc + i, chunk.unicode(), len * sizeof(QChar));
-        i += len;
-    }
-
-    return *this;
-}
-#endif // QT_CONFIG(regularexpression)
-
-/*!
-    Returns the number of (potentially overlapping) occurrences of
-    the string \a str in this string.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \sa contains(), indexOf()
-*/
-
-int QString::count(const QString &str, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(qt_string_count(QStringView(unicode(), size()), QStringView(str.unicode(), str.size()), cs));
-}
-
-/*!
-    \overload count()
-
-    Returns the number of occurrences of character \a ch in the string.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \sa contains(), indexOf()
-*/
-
-int QString::count(QChar ch, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(qt_string_count(QStringView(unicode(), size()), ch, cs));
-}
-
-/*!
-    \since 4.8
-    \overload count()
-    Returns the number of (potentially overlapping) occurrences of the
-    string reference \a str in this string.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \sa contains(), indexOf()
-*/
-int QString::count(const QStringRef &str, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(qt_string_count(QStringView(unicode(), size()), QStringView(str.unicode(), str.size()), cs));
-}
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*! \fn bool QString::contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-
-    Returns \c true if this string contains an occurrence of the string
-    \a str; otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    Example:
-    \snippet qstring/main.cpp 17
-
-    \sa indexOf(), count()
-*/
-#endif // QT_STRINGVIEW_LEVEL < 2
-
-/*! \fn bool QString::contains(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \since 5.3
-
-    \overload contains()
-
-    Returns \c true if this string contains an occurrence of the latin-1 string
-    \a str; otherwise returns \c false.
-*/
-
-/*! \fn bool QString::contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-
-    \overload contains()
-
-    Returns \c true if this string contains an occurrence of the
-    character \a ch; otherwise returns \c false.
-*/
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*! \fn bool QString::contains(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \since 4.8
-
-    Returns \c true if this string contains an occurrence of the string
-    reference \a str; otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \sa indexOf(), count()
-*/
-#endif // QT_STRINGVIEW_LEVEL < 2
-
-/*! \fn bool QString::contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \since 5.14
-    \overload contains()
-
-    Returns \c true if this string contains an occurrence of the string view
-    \a str; otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \sa indexOf(), count()
-*/
-
-/*! \fn bool QString::contains(const QRegExp &rx) const
-
-    \overload contains()
-
-    Returns \c true if the regular expression \a rx matches somewhere in
-    this string; otherwise returns \c false.
-*/
-
-/*! \fn bool QString::contains(QRegExp &rx) const
-    \overload contains()
-    \since 4.5
-
-    Returns \c true if the regular expression \a rx matches somewhere in
-    this string; otherwise returns \c false.
-
-    If there is a match, the \a rx regular expression will contain the
-    matched captures (see QRegExp::matchedLength, QRegExp::cap).
-*/
-
-#ifndef QT_NO_REGEXP
-/*!
-    \overload indexOf()
-
-    Returns the index position of the first match of the regular
-    expression \a rx in the string, searching forward from index
-    position \a from. Returns -1 if \a rx didn't match anywhere.
-
-    Example:
-
-    \snippet qstring/main.cpp 25
-*/
-int QString::indexOf(const QRegExp& rx, int from) const
-{
-    QRegExp rx2(rx);
-    return rx2.indexIn(*this, from);
-}
-
-/*!
-    \overload indexOf()
-    \since 4.5
-
-    Returns the index position of the first match of the regular
-    expression \a rx in the string, searching forward from index
-    position \a from. Returns -1 if \a rx didn't match anywhere.
-
-    If there is a match, the \a rx regular expression will contain the
-    matched captures (see QRegExp::matchedLength, QRegExp::cap).
-
-    Example:
-
-    \snippet qstring/main.cpp 25
-*/
-int QString::indexOf(QRegExp& rx, int from) const
-{
-    return rx.indexIn(*this, from);
-}
-
-/*!
-    \overload lastIndexOf()
-
-    Returns the index position of the last match of the regular
-    expression \a rx in the string, searching backward from index
-    position \a from. Returns -1 if \a rx didn't match anywhere.
-
-    Example:
-
-    \snippet qstring/main.cpp 30
-*/
-int QString::lastIndexOf(const QRegExp& rx, int from) const
-{
-    QRegExp rx2(rx);
-    return rx2.lastIndexIn(*this, from);
-}
-
-/*!
-    \overload lastIndexOf()
-    \since 4.5
-
-    Returns the index position of the last match of the regular
-    expression \a rx in the string, searching backward from index
-    position \a from. Returns -1 if \a rx didn't match anywhere.
-
-    If there is a match, the \a rx regular expression will contain the
-    matched captures (see QRegExp::matchedLength, QRegExp::cap).
-
-    Example:
-
-    \snippet qstring/main.cpp 30
-*/
-int QString::lastIndexOf(QRegExp& rx, int from) const
-{
-    return rx.lastIndexIn(*this, from);
-}
-
-/*!
-    \overload count()
-
-    Returns the number of times the regular expression \a rx matches
-    in the string.
-
-    This function counts overlapping matches, so in the example
-    below, there are four instances of "ana" or "ama":
-
-    \snippet qstring/main.cpp 18
-
-*/
-int QString::count(const QRegExp& rx) const
-{
-    QRegExp rx2(rx);
-    int count = 0;
-    int index = -1;
-    int len = length();
-    while (index < len - 1) {                 // count overlapping matches
-        index = rx2.indexIn(*this, index + 1);
-        if (index == -1)
-            break;
-        count++;
-    }
-    return count;
-}
-#endif // QT_NO_REGEXP
-
-#if QT_CONFIG(regularexpression)
-/*!
-    \overload indexOf()
-    \since 5.0
-
-    Returns the index position of the first match of the regular
-    expression \a re in the string, searching forward from index
-    position \a from. Returns -1 if \a re didn't match anywhere.
-
-    Example:
-
-    \snippet qstring/main.cpp 93
-*/
-int QString::indexOf(const QRegularExpression& re, int from) const
-{
-    return indexOf(re, from, nullptr);
-}
-
-/*!
-    \overload
-    \since 5.5
-
-    Returns the index position of the first match of the regular
-    expression \a re in the string, searching forward from index
-    position \a from. Returns -1 if \a re didn't match anywhere.
-
-    If the match is successful and \a rmatch is not \nullptr, it also
-    writes the results of the match into the QRegularExpressionMatch object
-    pointed to by \a rmatch.
-
-    Example:
-
-    \snippet qstring/main.cpp 99
-*/
-int QString::indexOf(const QRegularExpression &re, int from, QRegularExpressionMatch *rmatch) const
-{
-    if (!re.isValid()) {
-        qWarning("QString::indexOf: invalid QRegularExpression object");
-        return -1;
-    }
-
-    QRegularExpressionMatch match = re.match(*this, from);
-    if (match.hasMatch()) {
-        const int ret = match.capturedStart();
-        if (rmatch)
-            *rmatch = std::move(match);
-        return ret;
-    }
-
-    return -1;
-}
-
-/*!
-    \overload lastIndexOf()
-    \since 5.0
-
-    Returns the index position of the last match of the regular
-    expression \a re in the string, which starts before the index
-    position \a from. Returns -1 if \a re didn't match anywhere.
-
-    Example:
-
-    \snippet qstring/main.cpp 94
-*/
-int QString::lastIndexOf(const QRegularExpression &re, int from) const
-{
-    return lastIndexOf(re, from, nullptr);
-}
-
-/*!
-    \overload
-    \since 5.5
-
-    Returns the index position of the last match of the regular
-    expression \a re in the string, which starts before the index
-    position \a from. Returns -1 if \a re didn't match anywhere.
-
-    If the match is successful and \a rmatch is not \nullptr, it also
-    writes the results of the match into the QRegularExpressionMatch object
-    pointed to by \a rmatch.
-
-    Example:
-
-    \snippet qstring/main.cpp 100
-*/
-int QString::lastIndexOf(const QRegularExpression &re, int from, QRegularExpressionMatch *rmatch) const
-{
-    if (!re.isValid()) {
-        qWarning("QString::lastIndexOf: invalid QRegularExpression object");
-        return -1;
-    }
-
-    int endpos = (from < 0) ? (size() + from + 1) : (from + 1);
-    QRegularExpressionMatchIterator iterator = re.globalMatch(*this);
-    int lastIndex = -1;
-    while (iterator.hasNext()) {
-        QRegularExpressionMatch match = iterator.next();
-        int start = match.capturedStart();
-        if (start < endpos) {
-            lastIndex = start;
-            if (rmatch)
-                *rmatch = std::move(match);
-        } else {
-            break;
-        }
-    }
-
-    return lastIndex;
-}
-
-/*! \overload contains()
-    \since 5.0
-
-    Returns \c true if the regular expression \a re matches somewhere in
-    this string; otherwise returns \c false.
-*/
-bool QString::contains(const QRegularExpression &re) const
-{
-    return contains(re, nullptr);
-}
-
-/*!
-    \overload contains()
-    \since 5.1
-
-    Returns \c true if the regular expression \a re matches somewhere in this
-    string; otherwise returns \c false.
-
-    If the match is successful and \a rmatch is not \nullptr, it also
-    writes the results of the match into the QRegularExpressionMatch object
-    pointed to by \a rmatch.
-
-    \sa QRegularExpression::match()
-*/
-
-bool QString::contains(const QRegularExpression &re, QRegularExpressionMatch *rmatch) const
-{
-    if (!re.isValid()) {
-        qWarning("QString::contains: invalid QRegularExpression object");
-        return false;
-    }
-    QRegularExpressionMatch m = re.match(*this);
-    bool hasMatch = m.hasMatch();
-    if (hasMatch && rmatch)
-        *rmatch = std::move(m);
-    return hasMatch;
-}
-
-/*!
-    \overload count()
-    \since 5.0
-
-    Returns the number of times the regular expression \a re matches
-    in the string.
-
-    This function counts overlapping matches, so in the example
-    below, there are four instances of "ana" or "ama":
-
-    \snippet qstring/main.cpp 95
-*/
-int QString::count(const QRegularExpression &re) const
-{
-    if (!re.isValid()) {
-        qWarning("QString::count: invalid QRegularExpression object");
-        return 0;
-    }
-    int count = 0;
-    int index = -1;
-    int len = length();
-    while (index < len - 1) {
-        QRegularExpressionMatch match = re.match(*this, index + 1);
-        if (!match.hasMatch())
-            break;
-        index = match.capturedStart();
-        count++;
-    }
-    return count;
-}
-#endif // QT_CONFIG(regularexpression)
-
-/*! \fn int QString::count() const
-
-    \overload count()
-
-    Same as size().
-*/
-
-
-/*!
-    \enum QString::SectionFlag
-
-    This enum specifies flags that can be used to affect various
-    aspects of the section() function's behavior with respect to
-    separators and empty fields.
-
-    \value SectionDefault Empty fields are counted, leading and
-    trailing separators are not included, and the separator is
-    compared case sensitively.
-
-    \value SectionSkipEmpty Treat empty fields as if they don't exist,
-    i.e. they are not considered as far as \e start and \e end are
-    concerned.
-
-    \value SectionIncludeLeadingSep Include the leading separator (if
-    any) in the result string.
-
-    \value SectionIncludeTrailingSep Include the trailing separator
-    (if any) in the result string.
-
-    \value SectionCaseInsensitiveSeps Compare the separator
-    case-insensitively.
-
-    \sa section()
-*/
-
-/*!
-    \fn QString QString::section(QChar sep, int start, int end = -1, SectionFlags flags) const
-
-    This function returns a section of the string.
-
-    This string is treated as a sequence of fields separated by the
-    character, \a sep. The returned string consists of the fields from
-    position \a start to position \a end inclusive. If \a end is not
-    specified, all fields from position \a start to the end of the
-    string are included. Fields are numbered 0, 1, 2, etc., counting
-    from the left, and -1, -2, etc., counting from right to left.
-
-    The \a flags argument can be used to affect some aspects of the
-    function's behavior, e.g. whether to be case sensitive, whether
-    to skip empty fields and how to deal with leading and trailing
-    separators; see \l{SectionFlags}.
-
-    \snippet qstring/main.cpp 52
-
-    If \a start or \a end is negative, we count fields from the right
-    of the string, the right-most field being -1, the one from
-    right-most field being -2, and so on.
-
-    \snippet qstring/main.cpp 53
-
-    \sa split()
-*/
-
-/*!
-    \overload section()
-
-    \snippet qstring/main.cpp 51
-    \snippet qstring/main.cpp 54
-
-    \sa split()
-*/
-
-QString QString::section(const QString &sep, int start, int end, SectionFlags flags) const
-{
-    const QVector<QStringRef> sections = splitRef(sep, KeepEmptyParts,
-                                                  (flags & SectionCaseInsensitiveSeps) ? Qt::CaseInsensitive : Qt::CaseSensitive);
-    const int sectionsSize = sections.size();
-    if (!(flags & SectionSkipEmpty)) {
-        if (start < 0)
-            start += sectionsSize;
-        if (end < 0)
-            end += sectionsSize;
-    } else {
-        int skip = 0;
-        for (int k = 0; k < sectionsSize; ++k) {
-            if (sections.at(k).isEmpty())
-                skip++;
-        }
-        if (start < 0)
-            start += sectionsSize - skip;
-        if (end < 0)
-            end += sectionsSize - skip;
-    }
-    if (start >= sectionsSize || end < 0 || start > end)
-        return QString();
-
-    QString ret;
-    int first_i = start, last_i = end;
-    for (int x = 0, i = 0; x <= end && i < sectionsSize; ++i) {
-        const QStringRef &section = sections.at(i);
-        const bool empty = section.isEmpty();
-        if (x >= start) {
-            if(x == start)
-                first_i = i;
-            if(x == end)
-                last_i = i;
-            if (x > start && i > 0)
-                ret += sep;
-            ret += section;
-        }
-        if (!empty || !(flags & SectionSkipEmpty))
-            x++;
-    }
-    if ((flags & SectionIncludeLeadingSep) && first_i > 0)
-        ret.prepend(sep);
-    if ((flags & SectionIncludeTrailingSep) && last_i < sectionsSize - 1)
-        ret += sep;
-    return ret;
-}
-
-#if !(defined(QT_NO_REGEXP) && !QT_CONFIG(regularexpression))
-class qt_section_chunk {
-public:
-    qt_section_chunk() {}
-    qt_section_chunk(int l, QStringRef s) : length(l), string(std::move(s)) {}
-    int length;
-    QStringRef string;
-};
-Q_DECLARE_TYPEINFO(qt_section_chunk, Q_MOVABLE_TYPE);
-
-static QString extractSections(const QVector<qt_section_chunk> &sections,
-                               int start,
-                               int end,
-                               QString::SectionFlags flags)
-{
-    const int sectionsSize = sections.size();
-
-    if (!(flags & QString::SectionSkipEmpty)) {
-        if (start < 0)
-            start += sectionsSize;
-        if (end < 0)
-            end += sectionsSize;
-    } else {
-        int skip = 0;
-        for (int k = 0; k < sectionsSize; ++k) {
-            const qt_section_chunk &section = sections.at(k);
-            if (section.length == section.string.length())
-                skip++;
-        }
-        if (start < 0)
-            start += sectionsSize - skip;
-        if (end < 0)
-            end += sectionsSize - skip;
-    }
-    if (start >= sectionsSize || end < 0 || start > end)
-        return QString();
-
-    QString ret;
-    int x = 0;
-    int first_i = start, last_i = end;
-    for (int i = 0; x <= end && i < sectionsSize; ++i) {
-        const qt_section_chunk &section = sections.at(i);
-        const bool empty = (section.length == section.string.length());
-        if (x >= start) {
-            if (x == start)
-                first_i = i;
-            if (x == end)
-                last_i = i;
-            if (x != start)
-                ret += section.string;
-            else
-                ret += section.string.mid(section.length);
-        }
-        if (!empty || !(flags & QString::SectionSkipEmpty))
-            x++;
-    }
-
-    if ((flags & QString::SectionIncludeLeadingSep) && first_i >= 0) {
-        const qt_section_chunk &section = sections.at(first_i);
-        ret.prepend(section.string.left(section.length));
-    }
-
-    if ((flags & QString::SectionIncludeTrailingSep)
-        && last_i < sectionsSize - 1) {
-        const qt_section_chunk &section = sections.at(last_i+1);
-        ret += section.string.left(section.length);
-    }
-
-    return ret;
-}
-#endif
-
-#ifndef QT_NO_REGEXP
-/*!
-    \overload section()
-
-    This string is treated as a sequence of fields separated by the
-    regular expression, \a reg.
-
-    \snippet qstring/main.cpp 55
-
-    \warning Using this QRegExp version is much more expensive than
-    the overloaded string and character versions.
-
-    \sa split(), simplified()
-*/
-QString QString::section(const QRegExp &reg, int start, int end, SectionFlags flags) const
-{
-    const QChar *uc = unicode();
-    if(!uc)
-        return QString();
-
-    QRegExp sep(reg);
-    sep.setCaseSensitivity((flags & SectionCaseInsensitiveSeps) ? Qt::CaseInsensitive
-                                                                : Qt::CaseSensitive);
-
-    QVector<qt_section_chunk> sections;
-    int n = length(), m = 0, last_m = 0, last_len = 0;
-    while ((m = sep.indexIn(*this, m)) != -1) {
-        sections.append(qt_section_chunk(last_len, QStringRef(this, last_m, m - last_m)));
-        last_m = m;
-        last_len = sep.matchedLength();
-        m += qMax(sep.matchedLength(), 1);
-    }
-    sections.append(qt_section_chunk(last_len, QStringRef(this, last_m, n - last_m)));
-
-    return extractSections(sections, start, end, flags);
-}
-#endif
-
-#if QT_CONFIG(regularexpression)
-/*!
-    \overload section()
-    \since 5.0
-
-    This string is treated as a sequence of fields separated by the
-    regular expression, \a re.
-
-    \snippet qstring/main.cpp 89
-
-    \warning Using this QRegularExpression version is much more expensive than
-    the overloaded string and character versions.
-
-    \sa split(), simplified()
-*/
-QString QString::section(const QRegularExpression &re, int start, int end, SectionFlags flags) const
-{
-    if (!re.isValid()) {
-        qWarning("QString::section: invalid QRegularExpression object");
-        return QString();
-    }
-
-    const QChar *uc = unicode();
-    if (!uc)
-        return QString();
-
-    QRegularExpression sep(re);
-    if (flags & SectionCaseInsensitiveSeps)
-        sep.setPatternOptions(sep.patternOptions() | QRegularExpression::CaseInsensitiveOption);
-
-    QVector<qt_section_chunk> sections;
-    int n = length(), m = 0, last_m = 0, last_len = 0;
-    QRegularExpressionMatchIterator iterator = sep.globalMatch(*this);
-    while (iterator.hasNext()) {
-        QRegularExpressionMatch match = iterator.next();
-        m = match.capturedStart();
-        sections.append(qt_section_chunk(last_len, QStringRef(this, last_m, m - last_m)));
-        last_m = m;
-        last_len = match.capturedLength();
-    }
-    sections.append(qt_section_chunk(last_len, QStringRef(this, last_m, n - last_m)));
-
-    return extractSections(sections, start, end, flags);
-}
-#endif // QT_CONFIG(regularexpression)
-
-/*!
-    Returns a substring that contains the \a n leftmost characters
-    of the string.
-
-    The entire string is returned if \a n is greater than or equal
-    to size(), or less than zero.
-
-    \snippet qstring/main.cpp 31
-
-    \sa right(), mid(), startsWith(), chopped(), chop(), truncate()
-*/
-QString QString::left(int n)  const
-{
-    if (uint(n) >= uint(d->size))
-        return *this;
-    return QString((const QChar*) d->data(), n);
-}
-
-/*!
-    Returns a substring that contains the \a n rightmost characters
-    of the string.
-
-    The entire string is returned if \a n is greater than or equal
-    to size(), or less than zero.
-
-    \snippet qstring/main.cpp 48
-
-    \sa left(), mid(), endsWith(), chopped(), chop(), truncate()
-*/
-QString QString::right(int n) const
-{
-    if (uint(n) >= uint(d->size))
-        return *this;
-    return QString((const QChar*) d->data() + d->size - n, n);
-}
-
-/*!
-    Returns a string that contains \a n characters of this string,
-    starting at the specified \a position index.
-
-    Returns a null string if the \a position index exceeds the
-    length of the string. If there are less than \a n characters
-    available in the string starting at the given \a position, or if
-    \a n is -1 (default), the function returns all characters that
-    are available from the specified \a position.
-
-    Example:
-
-    \snippet qstring/main.cpp 34
-
-    \sa left(), right(), chopped(), chop(), truncate()
-*/
-
-QString QString::mid(int position, int n) const
-{
-    using namespace QtPrivate;
-    switch (QContainerImplHelper::mid(d->size, &position, &n)) {
-    case QContainerImplHelper::Null:
-        return QString();
-    case QContainerImplHelper::Empty:
-    {
-        QStringDataPtr empty = { Data::allocate(0) };
-        return QString(empty);
-    }
-    case QContainerImplHelper::Full:
-        return *this;
-    case QContainerImplHelper::Subset:
-        return QString((const QChar*)d->data() + position, n);
-    }
-    Q_UNREACHABLE();
-    return QString();
-}
-
-/*!
-    \fn QString QString::chopped(int len) const
-    \since 5.10
-
-    Returns a substring that contains the size() - \a len leftmost characters
-    of this string.
-
-    \note The behavior is undefined if \a len is negative or greater than size().
-
-    \sa endsWith(), left(), right(), mid(), chop(), truncate()
-*/
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*!
-    Returns \c true if the string starts with \a s; otherwise returns
-    \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \snippet qstring/main.cpp 65
-
-    \sa endsWith()
-*/
-bool QString::startsWith(const QString& s, Qt::CaseSensitivity cs) const
-{
-    return qt_starts_with(*this, s, cs);
-}
-#endif
-
-/*!
-  \overload startsWith()
- */
-bool QString::startsWith(QLatin1String s, Qt::CaseSensitivity cs) const
-{
-    return qt_starts_with(*this, s, cs);
-}
-
-/*!
-  \overload startsWith()
-
-  Returns \c true if the string starts with \a c; otherwise returns
-  \c false.
-*/
-bool QString::startsWith(QChar c, Qt::CaseSensitivity cs) const
-{
-    return qt_starts_with(*this, c, cs);
-}
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*!
-    \since 4.8
-    \overload
-    Returns \c true if the string starts with the string reference \a s;
-    otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case
-    sensitive; otherwise the search is case insensitive.
-
-    \sa endsWith()
-*/
-bool QString::startsWith(const QStringRef &s, Qt::CaseSensitivity cs) const
-{
-    return qt_starts_with(*this, s, cs);
-}
-#endif
-
-/*!
-    \fn bool QString::startsWith(QStringView str, Qt::CaseSensitivity cs) const
-    \since 5.10
-    \overload
-
-    Returns \c true if the string starts with the string-view \a str;
-    otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case-sensitive;
-    otherwise the search is case insensitive.
-
-    \sa endsWith()
-*/
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*!
-    Returns \c true if the string ends with \a s; otherwise returns
-    \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case
-    sensitive; otherwise the search is case insensitive.
-
-    \snippet qstring/main.cpp 20
-
-    \sa startsWith()
-*/
-bool QString::endsWith(const QString &s, Qt::CaseSensitivity cs) const
-{
-    return qt_ends_with(*this, s, cs);
-}
-
-/*!
-    \since 4.8
-    \overload endsWith()
-    Returns \c true if the string ends with the string reference \a s;
-    otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case
-    sensitive; otherwise the search is case insensitive.
-
-    \sa startsWith()
-*/
-bool QString::endsWith(const QStringRef &s, Qt::CaseSensitivity cs) const
-{
-    return qt_ends_with(*this, s, cs);
-}
-#endif // QT_STRINGVIEW_LEVEL < 2
-
-/*!
-    \fn bool QString::endsWith(QStringView str, Qt::CaseSensitivity cs) const
-    \since 5.10
-    \overload endsWith()
-    Returns \c true if the string ends with the string view \a str;
-    otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case
-    sensitive; otherwise the search is case insensitive.
-
-    \sa startsWith()
-*/
-
-/*!
-    \overload endsWith()
-*/
-bool QString::endsWith(QLatin1String s, Qt::CaseSensitivity cs) const
-{
-    return qt_ends_with(*this, s, cs);
-}
-
-/*!
-  Returns \c true if the string ends with \a c; otherwise returns
-  \c false.
-
-  \overload endsWith()
- */
-bool QString::endsWith(QChar c, Qt::CaseSensitivity cs) const
-{
-    return qt_ends_with(*this, c, cs);
-}
-
-/*!
-    Returns \c true if the string only contains uppercase letters,
-    otherwise returns \c false.
-    \since 5.12
-
-    \sa QChar::isUpper(), isLower()
-*/
-bool QString::isUpper() const
-{
-    if (isEmpty())
-        return false;
-
-    const QChar *d = data();
-
-    for (int i = 0, max = size(); i < max; ++i) {
-        if (!d[i].isUpper())
-            return false;
-    }
-
-    return true;
-}
-
-/*!
-    Returns \c true if the string only contains lowercase letters,
-    otherwise returns \c false.
-    \since 5.12
-
-    \sa QChar::isLower(), isUpper()
- */
-bool QString::isLower() const
-{
-    if (isEmpty())
-        return false;
-
-    const QChar *d = data();
-
-    for (int i = 0, max = size(); i < max; ++i) {
-        if (!d[i].isLower())
-            return false;
-    }
-
-    return true;
-}
-
-static QByteArray qt_convert_to_latin1(QStringView string);
-
-QByteArray QString::toLatin1_helper(const QString &string)
-{
-    return qt_convert_to_latin1(string);
-}
-
-/*!
-    \since 5.10
-    \internal
-    \relates QStringView
-
-    Returns a Latin-1 representation of \a string as a QByteArray.
-
-    The behavior is undefined if \a string contains non-Latin1 characters.
-
-    \sa QString::toLatin1(), QStringView::toLatin1(), QtPrivate::convertToUtf8(),
-    QtPrivate::convertToLocal8Bit(), QtPrivate::convertToUcs4()
-*/
-QByteArray QtPrivate::convertToLatin1(QStringView string)
-{
-    return qt_convert_to_latin1(string);
-}
-
-static QByteArray qt_convert_to_latin1(QStringView string)
-{
-    if (Q_UNLIKELY(string.isNull()))
-        return QByteArray();
-
-    QByteArray ba(string.length(), Qt::Uninitialized);
-
-    // since we own the only copy, we're going to const_cast the constData;
-    // that avoids an unnecessary call to detach() and expansion code that will never get used
-    qt_to_latin1(reinterpret_cast<uchar *>(const_cast<char *>(ba.constData())),
-                 reinterpret_cast<const ushort *>(string.data()), string.length());
-    return ba;
-}
-
-QByteArray QString::toLatin1_helper_inplace(QString &s)
-{
-    if (!s.isDetached())
-        return qt_convert_to_latin1(s);
-
-    // We can return our own buffer to the caller.
-    // Conversion to Latin-1 always shrinks the buffer by half.
-    const ushort *data = reinterpret_cast<const ushort *>(s.constData());
-    uint length = s.size();
-
-    // Swap the d pointers.
-    // Kids, avert your eyes. Don't try this at home.
-    QArrayData *ba_d = s.d;
-
-    // multiply the allocated capacity by sizeof(ushort)
-    ba_d->alloc *= sizeof(ushort);
-
-    // reset ourselves to QString()
-    s.d = QString().d;
-
-    // do the in-place conversion
-    uchar *dst = reinterpret_cast<uchar *>(ba_d->data());
-    qt_to_latin1(dst, data, length);
-    dst[length] = '\0';
-
-    QByteArrayDataPtr badptr = { ba_d };
-    return QByteArray(badptr);
-}
-
-
-/*!
-    \fn QByteArray QString::toLatin1() const
-
-    Returns a Latin-1 representation of the string as a QByteArray.
-
-    The returned byte array is undefined if the string contains non-Latin1
-    characters. Those characters may be suppressed or replaced with a
-    question mark.
-
-    \sa fromLatin1(), toUtf8(), toLocal8Bit(), QTextCodec
-*/
-
-/*!
-    \fn QByteArray QString::toAscii() const
-    \deprecated
-    Returns an 8-bit representation of the string as a QByteArray.
-
-    This function does the same as toLatin1().
-
-    Note that, despite the name, this function does not necessarily return an US-ASCII
-    (ANSI X3.4-1986) string and its result may not be US-ASCII compatible.
-
-    \sa fromAscii(), toLatin1(), toUtf8(), toLocal8Bit(), QTextCodec
-*/
-
-static QByteArray qt_convert_to_local_8bit(QStringView string);
-
-/*!
-    \fn QByteArray QString::toLocal8Bit() const
-
-    Returns the local 8-bit representation of the string as a
-    QByteArray. The returned byte array is undefined if the string
-    contains characters not supported by the local 8-bit encoding.
-
-    QTextCodec::codecForLocale() is used to perform the conversion from
-    Unicode. If the locale encoding could not be determined, this function
-    does the same as toLatin1().
-
-    If this string contains any characters that cannot be encoded in the
-    locale, the returned byte array is undefined. Those characters may be
-    suppressed or replaced by another.
-
-    \sa fromLocal8Bit(), toLatin1(), toUtf8(), QTextCodec
-*/
-
-QByteArray QString::toLocal8Bit_helper(const QChar *data, int size)
-{
-    return qt_convert_to_local_8bit(QStringView(data, size));
-}
-
-static QByteArray qt_convert_to_local_8bit(QStringView string)
-{
-    if (string.isNull())
-        return QByteArray();
-#if QT_CONFIG(textcodec)
-    QTextCodec *localeCodec = QTextCodec::codecForLocale();
-    if (localeCodec)
-        return localeCodec->fromUnicode(string);
-#endif // textcodec
-    return qt_convert_to_latin1(string);
-}
-
-/*!
-    \since 5.10
-    \internal
-    \relates QStringView
-
-    Returns a local 8-bit representation of \a string as a QByteArray.
-
-    QTextCodec::codecForLocale() is used to perform the conversion from
-    Unicode.
-
-    The behavior is undefined if \a string contains characters not
-    supported by the locale's 8-bit encoding.
-
-    \sa QString::toLocal8Bit(), QStringView::toLocal8Bit()
-*/
-QByteArray QtPrivate::convertToLocal8Bit(QStringView string)
-{
-    return qt_convert_to_local_8bit(string);
-}
-
-static QByteArray qt_convert_to_utf8(QStringView str);
-
-/*!
-    \fn QByteArray QString::toUtf8() const
-
-    Returns a UTF-8 representation of the string as a QByteArray.
-
-    UTF-8 is a Unicode codec and can represent all characters in a Unicode
-    string like QString.
-
-    \sa fromUtf8(), toLatin1(), toLocal8Bit(), QTextCodec
-*/
-
-QByteArray QString::toUtf8_helper(const QString &str)
-{
-    return qt_convert_to_utf8(str);
-}
-
-static QByteArray qt_convert_to_utf8(QStringView str)
-{
-    if (str.isNull())
-        return QByteArray();
-
-    return QUtf8::convertFromUnicode(str.data(), str.length());
-}
-
-/*!
-    \since 5.10
-    \internal
-    \relates QStringView
-
-    Returns a UTF-8 representation of \a string as a QByteArray.
-
-    UTF-8 is a Unicode codec and can represent all characters in a Unicode
-    string like QStringView.
-
-    \sa QString::toUtf8(), QStringView::toUtf8()
-*/
-QByteArray QtPrivate::convertToUtf8(QStringView string)
-{
-    return qt_convert_to_utf8(string);
-}
-
-static QVector<uint> qt_convert_to_ucs4(QStringView string);
-
-/*!
-    \since 4.2
-
-    Returns a UCS-4/UTF-32 representation of the string as a QVector<uint>.
-
-    UCS-4 is a Unicode codec and therefore it is lossless. All characters from
-    this string will be encoded in UCS-4. Any invalid sequence of code units in
-    this string is replaced by the Unicode's replacement character
-    (QChar::ReplacementCharacter, which corresponds to \c{U+FFFD}).
-
-    The returned vector is not \\0'-terminated.
-
-    \sa fromUtf8(), toUtf8(), toLatin1(), toLocal8Bit(), QTextCodec, fromUcs4(), toWCharArray()
-*/
-QVector<uint> QString::toUcs4() const
-{
-    return qt_convert_to_ucs4(*this);
-}
-
-static QVector<uint> qt_convert_to_ucs4(QStringView string)
-{
-    QVector<uint> v(string.length());
-    uint *a = const_cast<uint*>(v.constData());
-    QStringIterator it(string);
-    while (it.hasNext())
-        *a++ = it.next();
-    v.resize(a - v.constData());
-    return v;
-}
-
-/*!
-    \since 5.10
-    \internal
-    \relates QStringView
-
-    Returns a UCS-4/UTF-32 representation of \a string as a QVector<uint>.
-
-    UCS-4 is a Unicode codec and therefore it is lossless. All characters from
-    this string will be encoded in UCS-4. Any invalid sequence of code units in
-    this string is replaced by the Unicode's replacement character
-    (QChar::ReplacementCharacter, which corresponds to \c{U+FFFD}).
-
-    The returned vector is not \\0'-terminated.
-
-    \sa QString::toUcs4(), QStringView::toUcs4(), QtPrivate::convertToLatin1(),
-    QtPrivate::convertToLocal8Bit(), QtPrivate::convertToUtf8()
-*/
-QVector<uint> QtPrivate::convertToUcs4(QStringView string)
-{
-    return qt_convert_to_ucs4(string);
-}
-
-QString::Data *QString::fromLatin1_helper(const char *str, int size)
-{
-    Data *d;
-    if (!str) {
-        d = Data::sharedNull();
-    } else if (size == 0 || (!*str && size < 0)) {
-        d = Data::allocate(0);
-    } else {
-        if (size < 0)
-            size = qstrlen(str);
-        d = Data::allocate(size + 1);
-        Q_CHECK_PTR(d);
-        d->size = size;
-        d->data()[size] = '\0';
-        ushort *dst = d->data();
-
-        qt_from_latin1(dst, str, uint(size));
-    }
-    return d;
-}
-
-QString::Data *QString::fromAscii_helper(const char *str, int size)
-{
-    QString s = fromUtf8(str, size);
-    s.d->ref.ref();
-    return s.d;
-}
-
-/*! \fn QString QString::fromLatin1(const char *str, int size)
-    Returns a QString initialized with the first \a size characters
-    of the Latin-1 string \a str.
-
-    If \a size is -1 (default), it is taken to be strlen(\a
-    str).
-
-    \sa toLatin1(), fromUtf8(), fromLocal8Bit()
-*/
-
-/*!
-    \fn QString QString::fromLatin1(const QByteArray &str)
-    \overload
-    \since 5.0
-
-    Returns a QString initialized with the Latin-1 string \a str.
-*/
-
-/*! \fn QString QString::fromLocal8Bit(const char *str, int size)
-    Returns a QString initialized with the first \a size characters
-    of the 8-bit string \a str.
-
-    If \a size is -1 (default), it is taken to be strlen(\a
-    str).
-
-    QTextCodec::codecForLocale() is used to perform the conversion.
-
-    \sa toLocal8Bit(), fromLatin1(), fromUtf8()
-*/
-
-/*!
-    \fn QString QString::fromLocal8Bit(const QByteArray &str)
-    \overload
-    \since 5.0
-
-    Returns a QString initialized with the 8-bit string \a str.
-*/
-QString QString::fromLocal8Bit_helper(const char *str, int size)
-{
-    if (!str)
-        return QString();
-    if (size == 0 || (!*str && size < 0)) {
-        QStringDataPtr empty = { Data::allocate(0) };
-        return QString(empty);
-    }
-#if QT_CONFIG(textcodec)
-    if (size < 0)
-        size = qstrlen(str);
-    QTextCodec *codec = QTextCodec::codecForLocale();
-    if (codec)
-        return codec->toUnicode(str, size);
-#endif // textcodec
-    return fromLatin1(str, size);
-}
-
-/*! \fn QString QString::fromAscii(const char *, int size);
-    \deprecated
-
-    Returns a QString initialized with the first \a size characters
-    from the string \a str.
-
-    If \a size is -1 (default), it is taken to be strlen(\a
-    str).
-
-    This function does the same as fromLatin1().
-
-    \sa toAscii(), fromLatin1(), fromUtf8(), fromLocal8Bit()
-*/
-
-/*!
-    \fn QString QString::fromAscii(const QByteArray &str)
-    \deprecated
-    \overload
-    \since 5.0
-
-    Returns a QString initialized with the string \a str.
-*/
-
-/*! \fn QString QString::fromUtf8(const char *str, int size)
-    Returns a QString initialized with the first \a size bytes
-    of the UTF-8 string \a str.
-
-    If \a size is -1 (default), it is taken to be strlen(\a
-    str).
-
-    UTF-8 is a Unicode codec and can represent all characters in a Unicode
-    string like QString. However, invalid sequences are possible with UTF-8
-    and, if any such are found, they will be replaced with one or more
-    "replacement characters", or suppressed. These include non-Unicode
-    sequences, non-characters, overlong sequences or surrogate codepoints
-    encoded into UTF-8.
-
-    This function can be used to process incoming data incrementally as long as
-    all UTF-8 characters are terminated within the incoming data. Any
-    unterminated characters at the end of the string will be replaced or
-    suppressed. In order to do stateful decoding, please use \l QTextDecoder.
-
-    \sa toUtf8(), fromLatin1(), fromLocal8Bit()
-*/
-
-/*!
-    \fn QString QString::fromUtf8(const QByteArray &str)
-    \overload
-    \since 5.0
-
-    Returns a QString initialized with the UTF-8 string \a str.
-*/
-QString QString::fromUtf8_helper(const char *str, int size)
-{
-    if (!str)
-        return QString();
-
-    Q_ASSERT(size != -1);
-    return QUtf8::convertToUnicode(str, size);
-}
-
-/*!
-    Returns a QString initialized with the first \a size characters
-    of the Unicode string \a unicode (ISO-10646-UTF-16 encoded).
-
-    If \a size is -1 (default), \a unicode must be \\0'-terminated.
-
-    This function checks for a Byte Order Mark (BOM). If it is missing,
-    host byte order is assumed.
-
-    This function is slow compared to the other Unicode conversions.
-    Use QString(const QChar *, int) or QString(const QChar *) if possible.
-
-    QString makes a deep copy of the Unicode data.
-
-    \sa utf16(), setUtf16(), fromStdU16String()
-*/
-QString QString::fromUtf16(const ushort *unicode, int size)
-{
-    if (!unicode)
-        return QString();
-    if (size < 0) {
-        size = 0;
-        while (unicode[size] != 0)
-            ++size;
-    }
-    return QUtf16::convertToUnicode((const char *)unicode, size*2, nullptr);
-}
-
-/*!
-   \fn QString QString::fromUtf16(const char16_t *str, int size)
-   \since 5.3
-
-    Returns a QString initialized with the first \a size characters
-    of the Unicode string \a str (ISO-10646-UTF-16 encoded).
-
-    If \a size is -1 (default), \a str must be \\0'-terminated.
-
-    This function checks for a Byte Order Mark (BOM). If it is missing,
-    host byte order is assumed.
-
-    This function is slow compared to the other Unicode conversions.
-    Use QString(const QChar *, int) or QString(const QChar *) if possible.
-
-    QString makes a deep copy of the Unicode data.
-
-    \sa utf16(), setUtf16(), fromStdU16String()
-*/
-
-/*!
-    \fn QString QString::fromUcs4(const char32_t *str, int size)
-    \since 5.3
-
-    Returns a QString initialized with the first \a size characters
-    of the Unicode string \a str (ISO-10646-UCS-4 encoded).
-
-    If \a size is -1 (default), \a str must be \\0'-terminated.
-
-    \sa toUcs4(), fromUtf16(), utf16(), setUtf16(), fromWCharArray(), fromStdU32String()
-*/
-
-/*!
-    \since 4.2
-
-    Returns a QString initialized with the first \a size characters
-    of the Unicode string \a unicode (ISO-10646-UCS-4 encoded).
-
-    If \a size is -1 (default), \a unicode must be \\0'-terminated.
-
-    \sa toUcs4(), fromUtf16(), utf16(), setUtf16(), fromWCharArray(), fromStdU32String()
-*/
-QString QString::fromUcs4(const uint *unicode, int size)
-{
-    if (!unicode)
-        return QString();
-    if (size < 0) {
-        size = 0;
-        while (unicode[size] != 0)
-            ++size;
-    }
-    return QUtf32::convertToUnicode((const char *)unicode, size*4, nullptr);
-}
-
-
-/*!
-    Resizes the string to \a size characters and copies \a unicode
-    into the string.
-
-    If \a unicode is 0, nothing is copied, but the string is still
-    resized to \a size.
-
-    \sa unicode(), setUtf16()
-*/
-QString& QString::setUnicode(const QChar *unicode, int size)
-{
-     resize(size);
-     if (unicode && size)
-         memcpy(d->data(), unicode, size * sizeof(QChar));
-     return *this;
-}
-
-/*!
-    \fn QString &QString::setUtf16(const ushort *unicode, int size)
-
-    Resizes the string to \a size characters and copies \a unicode
-    into the string.
-
-    If \a unicode is 0, nothing is copied, but the string is still
-    resized to \a size.
-
-    Note that unlike fromUtf16(), this function does not consider BOMs and
-    possibly differing byte ordering.
-
-    \sa utf16(), setUnicode()
-*/
-
-/*!
-    \fn QString QString::simplified() const
-
-    Returns a string that has whitespace removed from the start
-    and the end, and that has each sequence of internal whitespace
-    replaced with a single space.
-
-    Whitespace means any character for which QChar::isSpace() returns
-    \c true. This includes the ASCII characters '\\t', '\\n', '\\v',
-    '\\f', '\\r', and ' '.
-
-    Example:
-
-    \snippet qstring/main.cpp 57
-
-    \sa trimmed()
-*/
-QString QString::simplified_helper(const QString &str)
-{
-    return QStringAlgorithms<const QString>::simplified_helper(str);
-}
-
-QString QString::simplified_helper(QString &str)
-{
-    return QStringAlgorithms<QString>::simplified_helper(str);
-}
-
-namespace {
-    template <typename StringView>
-    StringView qt_trimmed(StringView s) noexcept
-    {
-        auto begin = s.begin();
-        auto end = s.end();
-        QStringAlgorithms<const StringView>::trimmed_helper_positions(begin, end);
-        return StringView{begin, end};
-    }
-}
-
-/*!
-    \fn QStringView QtPrivate::trimmed(QStringView s)
-    \fn QLatin1String QtPrivate::trimmed(QLatin1String s)
-    \internal
-    \relates QStringView
-    \since 5.10
-
-    Returns \a s with whitespace removed from the start and the end.
-
-    Whitespace means any character for which QChar::isSpace() returns
-    \c true. This includes the ASCII characters '\\t', '\\n', '\\v',
-    '\\f', '\\r', and ' '.
-
-    \sa QString::trimmed(), QStringView::trimmed(), QLatin1String::trimmed()
-*/
-QStringView QtPrivate::trimmed(QStringView s) noexcept
-{
-    return qt_trimmed(s);
-}
-
-QLatin1String QtPrivate::trimmed(QLatin1String s) noexcept
-{
-    return qt_trimmed(s);
-}
-
-/*!
-    \fn QString QString::trimmed() const
-
-    Returns a string that has whitespace removed from the start and
-    the end.
-
-    Whitespace means any character for which QChar::isSpace() returns
-    \c true. This includes the ASCII characters '\\t', '\\n', '\\v',
-    '\\f', '\\r', and ' '.
-
-    Example:
-
-    \snippet qstring/main.cpp 82
-
-    Unlike simplified(), trimmed() leaves internal whitespace alone.
-
-    \sa simplified()
-*/
-QString QString::trimmed_helper(const QString &str)
-{
-    return QStringAlgorithms<const QString>::trimmed_helper(str);
-}
-
-QString QString::trimmed_helper(QString &str)
-{
-    return QStringAlgorithms<QString>::trimmed_helper(str);
-}
-
-/*! \fn const QChar QString::at(int position) const
-
-    Returns the character at the given index \a position in the
-    string.
-
-    The \a position must be a valid index position in the string
-    (i.e., 0 <= \a position < size()).
-
-    \sa operator[]()
-*/
-
-/*!
-    \fn QCharRef QString::operator[](int position)
-
-    Returns the character at the specified \a position in the string as a
-    modifiable reference.
-
-    Example:
-
-    \snippet qstring/main.cpp 85
-
-    The return value is of type QCharRef, a helper class for QString.
-    When you get an object of type QCharRef, you can use it as if it
-    were a QChar &. If you assign to it, the assignment will apply to
-    the character in the QString from which you got the reference.
-
-    \note Before Qt 5.14 it was possible to use this operator to access
-    a character at an out-of-bounds position in the string, and
-    then assign to such a position, causing the string to be
-    automatically resized. Furthermore, assigning a value to the
-    returned QCharRef would cause a detach of the string, even if the
-    string has been copied in the meanwhile (and the QCharRef kept
-    alive while the copy was taken). These behaviors are deprecated,
-    and will be changed in a future version of Qt.
-
-    \sa at()
-*/
-
-/*!
-    \fn const QChar QString::operator[](int position) const
-
-    \overload operator[]()
-*/
-
-/*! \fn QCharRef QString::operator[](uint position)
-
-\overload operator[]()
-
-Returns the character at the specified \a position in the string as a
-modifiable reference.
-*/
-
-/*! \fn const QChar QString::operator[](uint position) const
-    Equivalent to \c at(position).
-\overload operator[]()
-*/
-
-/*!
-    \fn QChar QString::front() const
-    \since 5.10
-
-    Returns the first character in the string.
-    Same as \c{at(0)}.
-
-    This function is provided for STL compatibility.
-
-    \warning Calling this function on an empty string constitutes
-    undefined behavior.
-
-    \sa back(), at(), operator[]()
-*/
-
-/*!
-    \fn QChar QString::back() const
-    \since 5.10
-
-    Returns the last character in the string.
-    Same as \c{at(size() - 1)}.
-
-    This function is provided for STL compatibility.
-
-    \warning Calling this function on an empty string constitutes
-    undefined behavior.
-
-    \sa front(), at(), operator[]()
-*/
-
-/*!
-    \fn QCharRef QString::front()
-    \since 5.10
-
-    Returns a reference to the first character in the string.
-    Same as \c{operator[](0)}.
-
-    This function is provided for STL compatibility.
-
-    \warning Calling this function on an empty string constitutes
-    undefined behavior.
-
-    \sa back(), at(), operator[]()
-*/
-
-/*!
-    \fn QCharRef QString::back()
-    \since 5.10
-
-    Returns a reference to the last character in the string.
-    Same as \c{operator[](size() - 1)}.
-
-    This function is provided for STL compatibility.
-
-    \warning Calling this function on an empty string constitutes
-    undefined behavior.
-
-    \sa front(), at(), operator[]()
-*/
-
-/*!
-    \fn void QString::truncate(int position)
-
-    Truncates the string at the given \a position index.
-
-    If the specified \a position index is beyond the end of the
-    string, nothing happens.
-
-    Example:
-
-    \snippet qstring/main.cpp 83
-
-    If \a position is negative, it is equivalent to passing zero.
-
-    \sa chop(), resize(), left(), QStringRef::truncate()
-*/
-
-void QString::truncate(int pos)
-{
-    if (pos < d->size)
-        resize(pos);
-}
-
-
-/*!
-    Removes \a n characters from the end of the string.
-
-    If \a n is greater than or equal to size(), the result is an
-    empty string; if \a n is negative, it is equivalent to passing zero.
-
-    Example:
-    \snippet qstring/main.cpp 15
-
-    If you want to remove characters from the \e beginning of the
-    string, use remove() instead.
-
-    \sa truncate(), resize(), remove(), QStringRef::chop()
-*/
-void QString::chop(int n)
-{
-    if (n > 0)
-        resize(d->size - n);
-}
-
-/*!
-    Sets every character in the string to character \a ch. If \a size
-    is different from -1 (default), the string is resized to \a
-    size beforehand.
-
-    Example:
-
-    \snippet qstring/main.cpp 21
-
-    \sa resize()
-*/
-
-QString& QString::fill(QChar ch, int size)
-{
-    resize(size < 0 ? d->size : size);
-    if (d->size) {
-        QChar *i = (QChar*)d->data() + d->size;
-        QChar *b = (QChar*)d->data();
-        while (i != b)
-           *--i = ch;
-    }
-    return *this;
-}
-
-/*!
-    \fn int QString::length() const
-
-    Returns the number of characters in this string.  Equivalent to
-    size().
-
-    \sa resize()
-*/
-
-/*!
-    \fn int QString::size() const
-
-    Returns the number of characters in this string.
-
-    The last character in the string is at position size() - 1.
-
-    Example:
-    \snippet qstring/main.cpp 58
-
-    \sa isEmpty(), resize()
-*/
-
-/*! \fn bool QString::isNull() const
-
-    Returns \c true if this string is null; otherwise returns \c false.
-
-    Example:
-
-    \snippet qstring/main.cpp 28
-
-    Qt makes a distinction between null strings and empty strings for
-    historical reasons. For most applications, what matters is
-    whether or not a string contains any data, and this can be
-    determined using the isEmpty() function.
-
-    \sa isEmpty()
-*/
-
-/*! \fn bool QString::isEmpty() const
-
-    Returns \c true if the string has no characters; otherwise returns
-    \c false.
-
-    Example:
-
-    \snippet qstring/main.cpp 27
-
-    \sa size()
-*/
-
-/*! \fn QString &QString::operator+=(const QString &other)
-
-    Appends the string \a other onto the end of this string and
-    returns a reference to this string.
-
-    Example:
-
-    \snippet qstring/main.cpp 84
-
-    This operation is typically very fast (\l{constant time}),
-    because QString preallocates extra space at the end of the string
-    data so it can grow without reallocating the entire string each
-    time.
-
-    \sa append(), prepend()
-*/
-
-/*! \fn QString &QString::operator+=(QLatin1String str)
-
-    \overload operator+=()
-
-    Appends the Latin-1 string \a str to this string.
-*/
-
-/*! \fn QString &QString::operator+=(const QByteArray &ba)
-
-    \overload operator+=()
-
-    Appends the byte array \a ba to this string. The byte array is converted
-    to Unicode using the fromUtf8() function. If any NUL characters ('\\0')
-    are embedded in the \a ba byte array, they will be included in the
-    transformation.
-
-    You can disable this function by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn QString &QString::operator+=(const char *str)
-
-    \overload operator+=()
-
-    Appends the string \a str to this string. The const char pointer
-    is converted to Unicode using the fromUtf8() function.
-
-    You can disable this function by defining \c QT_NO_CAST_FROM_ASCII
-    when you compile your applications. This can be useful if you want
-    to ensure that all user-visible strings go through QObject::tr(),
-    for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn QString &QString::operator+=(const QStringRef &str)
-
-    \overload operator+=()
-
-    Appends the string section referenced by \a str to this string.
-*/
-
-/*! \fn QString &QString::operator+=(char ch)
-
-    \overload operator+=()
-
-    Appends the character \a ch to this string. Note that the character is
-    converted to Unicode using the fromLatin1() function, unlike other 8-bit
-    functions that operate on UTF-8 data.
-
-    You can disable this function by defining \c QT_NO_CAST_FROM_ASCII
-    when you compile your applications. This can be useful if you want
-    to ensure that all user-visible strings go through QObject::tr(),
-    for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn QString &QString::operator+=(QChar ch)
-
-    \overload operator+=()
-
-    Appends the character \a ch to the string.
-*/
-
-/*! \fn QString &QString::operator+=(QChar::SpecialCharacter c)
-
-    \overload operator+=()
-
-    \internal
-*/
-
-/*!
-    \fn bool operator==(const char *s1, const QString &s2)
-
-    \overload  operator==()
-    \relates QString
-
-    Returns \c true if \a s1 is equal to \a s2; otherwise returns \c false.
-    Note that no string is equal to \a s1 being 0.
-
-    Equivalent to \c {s1 != 0 && compare(s1, s2) == 0}.
-*/
-
-/*!
-    \fn bool operator!=(const char *s1, const QString &s2)
-    \relates QString
-
-    Returns \c true if \a s1 is not equal to \a s2; otherwise returns
-    \c false.
-
-    For \a s1 != 0, this is equivalent to \c {compare(} \a s1, \a s2
-    \c {) != 0}. Note that no string is equal to \a s1 being 0.
-*/
-
-/*!
-    \fn bool operator<(const char *s1, const QString &s2)
-    \relates QString
-
-    Returns \c true if \a s1 is lexically less than \a s2; otherwise
-    returns \c false.  For \a s1 != 0, this is equivalent to \c
-    {compare(s1, s2) < 0}.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings using the
-    QString::localeAwareCompare() function.
-*/
-
-/*!
-    \fn bool operator<=(const char *s1, const QString &s2)
-    \relates QString
-
-    Returns \c true if \a s1 is lexically less than or equal to \a s2;
-    otherwise returns \c false.  For \a s1 != 0, this is equivalent to \c
-    {compare(s1, s2) <= 0}.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings with
-    QString::localeAwareCompare().
-*/
-
-/*!
-    \fn bool operator>(const char *s1, const QString &s2)
-    \relates QString
-
-    Returns \c true if \a s1 is lexically greater than \a s2; otherwise
-    returns \c false.  Equivalent to \c {compare(s1, s2) > 0}.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings using the
-    QString::localeAwareCompare() function.
-*/
-
-/*!
-    \fn bool operator>=(const char *s1, const QString &s2)
-    \relates QString
-
-    Returns \c true if \a s1 is lexically greater than or equal to \a s2;
-    otherwise returns \c false.  For \a s1 != 0, this is equivalent to \c
-    {compare(s1, s2) >= 0}.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings using the
-    QString::localeAwareCompare() function.
-*/
-
-/*!
-    \fn const QString operator+(const QString &s1, const QString &s2)
-    \relates QString
-
-    Returns a string which is the result of concatenating \a s1 and \a
-    s2.
-*/
-
-/*!
-    \fn const QString operator+(const QString &s1, const char *s2)
-    \relates QString
-
-    Returns a string which is the result of concatenating \a s1 and \a
-    s2 (\a s2 is converted to Unicode using the QString::fromUtf8()
-    function).
-
-    \sa QString::fromUtf8()
-*/
-
-/*!
-    \fn const QString operator+(const char *s1, const QString &s2)
-    \relates QString
-
-    Returns a string which is the result of concatenating \a s1 and \a
-    s2 (\a s1 is converted to Unicode using the QString::fromUtf8()
-    function).
-
-    \sa QString::fromUtf8()
-*/
-
-/*!
-    \fn const QString operator+(const QString &s, char ch)
-    \relates QString
-
-    Returns a string which is the result of concatenating the string
-    \a s and the character \a ch.
-*/
-
-/*!
-    \fn const QString operator+(char ch, const QString &s)
-    \relates QString
-
-    Returns a string which is the result of concatenating the
-    character \a ch and the string \a s.
-*/
-
-/*!
-    \fn int QString::compare(const QString &s1, const QString &s2, Qt::CaseSensitivity cs)
-    \since 4.2
-
-    Compares \a s1 with \a s2 and returns an integer less than, equal
-    to, or greater than zero if \a s1 is less than, equal to, or
-    greater than \a s2.
-
-    If \a cs is Qt::CaseSensitive, the comparison is case sensitive;
-    otherwise the comparison is case insensitive.
-
-    Case sensitive comparison is based exclusively on the numeric
-    Unicode values of the characters and is very fast, but is not what
-    a human would expect.  Consider sorting user-visible strings with
-    localeAwareCompare().
-
-    \snippet qstring/main.cpp 16
-
-    \sa operator==(), operator<(), operator>()
-*/
-
-/*!
-    \fn int QString::compare(const QString &s1, QLatin1String s2, Qt::CaseSensitivity cs)
-    \since 4.2
-    \overload compare()
-
-    Performs a comparison of \a s1 and \a s2, using the case
-    sensitivity setting \a cs.
-*/
-
-/*!
-    \fn int QString::compare(QLatin1String s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
-
-    \since 4.2
-    \overload compare()
-
-    Performs a comparison of \a s1 and \a s2, using the case
-    sensitivity setting \a cs.
-*/
-
-/*!
-    \fn int QString::compare(QStringView s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-
-    \since 5.12
-    \overload compare()
-
-    Performs a comparison of this with \a s, using the case
-    sensitivity setting \a cs.
-*/
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*!
-    \overload compare()
-    \since 4.2
-
-    Lexically compares this string with the \a other string and
-    returns an integer less than, equal to, or greater than zero if
-    this string is less than, equal to, or greater than the other
-    string.
-
-    Same as compare(*this, \a other, \a cs).
-*/
-int QString::compare(const QString &other, Qt::CaseSensitivity cs) const noexcept
-{
-    return qt_compare_strings(*this, other, cs);
-}
-#endif
-
-/*!
-    \internal
-    \since 4.5
-*/
-int QString::compare_helper(const QChar *data1, int length1, const QChar *data2, int length2,
-                            Qt::CaseSensitivity cs) noexcept
-{
-    Q_ASSERT(length1 >= 0);
-    Q_ASSERT(length2 >= 0);
-    Q_ASSERT(data1 || length1 == 0);
-    Q_ASSERT(data2 || length2 == 0);
-    return qt_compare_strings(QStringView(data1, length1), QStringView(data2, length2), cs);
-}
-
-/*!
-    \overload compare()
-    \since 4.2
-
-    Same as compare(*this, \a other, \a cs).
-*/
-int QString::compare(QLatin1String other, Qt::CaseSensitivity cs) const noexcept
-{
-    return qt_compare_strings(*this, other, cs);
-}
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*!
-  \fn int QString::compare(const QStringRef &ref, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-  \overload compare()
-
-  Compares the string reference, \a ref, with the string and returns
-  an integer less than, equal to, or greater than zero if the string
-  is less than, equal to, or greater than \a ref.
-*/
-#endif
-
-/*!
-    \internal
-    \since 5.0
-*/
-int QString::compare_helper(const QChar *data1, int length1, const char *data2, int length2,
-                            Qt::CaseSensitivity cs)
-{
-    Q_ASSERT(length1 >= 0);
-    Q_ASSERT(data1 || length1 == 0);
-    if (!data2)
-        return length1;
-    if (Q_UNLIKELY(length2 < 0))
-        length2 = int(strlen(data2));
-    // ### make me nothrow in all cases
-    QVarLengthArray<ushort> s2(length2);
-    const auto beg = reinterpret_cast<QChar *>(s2.data());
-    const auto end = QUtf8::convertToUnicode(beg, data2, length2);
-    return qt_compare_strings(QStringView(data1, length1), QStringView(beg, end - beg), cs);
-}
-
-/*!
-  \fn int QString::compare(const QString &s1, const QStringRef &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
-  \overload compare()
-*/
-
-/*!
-    \internal
-    \since 4.5
-*/
-int QString::compare_helper(const QChar *data1, int length1, QLatin1String s2,
-                            Qt::CaseSensitivity cs) noexcept
-{
-    Q_ASSERT(length1 >= 0);
-    Q_ASSERT(data1 || length1 == 0);
-    return qt_compare_strings(QStringView(data1, length1), s2, cs);
-}
-
-/*!
-    \fn int QString::localeAwareCompare(const QString & s1, const QString & s2)
-
-    Compares \a s1 with \a s2 and returns an integer less than, equal
-    to, or greater than zero if \a s1 is less than, equal to, or
-    greater than \a s2.
-
-    The comparison is performed in a locale- and also
-    platform-dependent manner. Use this function to present sorted
-    lists of strings to the user.
-
-    On \macos and iOS this function compares according the
-    "Order for sorted lists" setting in the International preferences panel.
-
-    \sa compare(), QLocale
-*/
-
-/*!
-    \fn int QString::localeAwareCompare(const QStringRef &other) const
-    \since 4.5
-    \overload localeAwareCompare()
-
-    Compares this string with the \a other string and returns an
-    integer less than, equal to, or greater than zero if this string
-    is less than, equal to, or greater than the \a other string.
-
-    The comparison is performed in a locale- and also
-    platform-dependent manner. Use this function to present sorted
-    lists of strings to the user.
-
-    Same as \c {localeAwareCompare(*this, other)}.
-*/
-
-/*!
-    \fn int QString::localeAwareCompare(const QString &s1, const QStringRef &s2)
-    \since 4.5
-    \overload localeAwareCompare()
-
-    Compares \a s1 with \a s2 and returns an integer less than, equal
-    to, or greater than zero if \a s1 is less than, equal to, or
-    greater than \a s2.
-
-    The comparison is performed in a locale- and also
-    platform-dependent manner. Use this function to present sorted
-    lists of strings to the user.
-*/
-
-
-#if !defined(CSTR_LESS_THAN)
-#define CSTR_LESS_THAN    1
-#define CSTR_EQUAL        2
-#define CSTR_GREATER_THAN 3
-#endif
-
-/*!
-    \overload localeAwareCompare()
-
-    Compares this string with the \a other string and returns an
-    integer less than, equal to, or greater than zero if this string
-    is less than, equal to, or greater than the \a other string.
-
-    The comparison is performed in a locale- and also
-    platform-dependent manner. Use this function to present sorted
-    lists of strings to the user.
-
-    Same as \c {localeAwareCompare(*this, other)}.
-*/
-int QString::localeAwareCompare(const QString &other) const
-{
-    return localeAwareCompare_helper(constData(), length(), other.constData(), other.length());
-}
-
-#if QT_CONFIG(icu)
-Q_GLOBAL_STATIC(QThreadStorage<QCollator>, defaultCollator)
-#endif
-
-/*!
-    \internal
-    \since 4.5
-*/
-int QString::localeAwareCompare_helper(const QChar *data1, int length1,
-                                       const QChar *data2, int length2)
-{
-    Q_ASSERT(length1 >= 0);
-    Q_ASSERT(data1 || length1 == 0);
-    Q_ASSERT(length2 >= 0);
-    Q_ASSERT(data2 || length2 == 0);
-
-    // do the right thing for null and empty
-    if (length1 == 0 || length2 == 0)
-        return qt_compare_strings(QStringView(data1, length1), QStringView(data2, length2),
-                               Qt::CaseSensitive);
-
-#if QT_CONFIG(icu)
-    if (!defaultCollator()->hasLocalData())
-        defaultCollator()->setLocalData(QCollator());
-    return defaultCollator()->localData().compare(data1, length1, data2, length2);
-#else
-    const QString lhs = QString::fromRawData(data1, length1).normalized(QString::NormalizationForm_C);
-    const QString rhs = QString::fromRawData(data2, length2).normalized(QString::NormalizationForm_C);
-#  if defined(Q_OS_WIN)
-    int res = CompareStringEx(LOCALE_NAME_USER_DEFAULT, 0, (LPWSTR)lhs.constData(), lhs.length(), (LPWSTR)rhs.constData(), rhs.length(), NULL, NULL, 0);
-
-    switch (res) {
-    case CSTR_LESS_THAN:
-        return -1;
-    case CSTR_GREATER_THAN:
-        return 1;
-    default:
-        return 0;
-    }
-#  elif defined (Q_OS_DARWIN)
-    // Use CFStringCompare for comparing strings on Mac. This makes Qt order
-    // strings the same way as native applications do, and also respects
-    // the "Order for sorted lists" setting in the International preferences
-    // panel.
-    const CFStringRef thisString =
-        CFStringCreateWithCharactersNoCopy(kCFAllocatorDefault,
-            reinterpret_cast<const UniChar *>(lhs.constData()), lhs.length(), kCFAllocatorNull);
-    const CFStringRef otherString =
-        CFStringCreateWithCharactersNoCopy(kCFAllocatorDefault,
-            reinterpret_cast<const UniChar *>(rhs.constData()), rhs.length(), kCFAllocatorNull);
-
-    const int result = CFStringCompare(thisString, otherString, kCFCompareLocalized);
-    CFRelease(thisString);
-    CFRelease(otherString);
-    return result;
-#  elif defined(Q_OS_UNIX)
-    // declared in <string.h>
-    int delta = strcoll(lhs.toLocal8Bit().constData(), rhs.toLocal8Bit().constData());
-    if (delta == 0)
-        delta = qt_compare_strings(lhs, rhs, Qt::CaseSensitive);
-    return delta;
-#  else
-#     error "This case shouldn't happen"
-    return qt_compare_strings(lhs, rhs, Qt::CaseSensitive);
-#  endif
-#endif // !QT_CONFIG(icu)
-}
-
-
-/*!
-    \fn const QChar *QString::unicode() const
-
-    Returns a Unicode representation of the string.
-    The result remains valid until the string is modified.
-
-    \note The returned string may not be '\\0'-terminated.
-    Use size() to determine the length of the array.
-
-    \sa utf16(), fromRawData()
-*/
-
-/*!
-    \fn const ushort *QString::utf16() const
-
-    Returns the QString as a '\\0\'-terminated array of unsigned
-    shorts. The result remains valid until the string is modified.
-
-    The returned string is in host byte order.
-
-    \sa unicode()
-*/
-
-const ushort *QString::utf16() const
-{
-    if (IS_RAW_DATA(d)) {
-        // ensure '\0'-termination for ::fromRawData strings
-        const_cast<QString*>(this)->reallocData(uint(d->size) + 1u);
-    }
-    return d->data();
-}
-
-/*!
-    Returns a string of size \a width that contains this string
-    padded by the \a fill character.
-
-    If \a truncate is \c false and the size() of the string is more than
-    \a width, then the returned string is a copy of the string.
-
-    \snippet qstring/main.cpp 32
-
-    If \a truncate is \c true and the size() of the string is more than
-    \a width, then any characters in a copy of the string after
-    position \a width are removed, and the copy is returned.
-
-    \snippet qstring/main.cpp 33
-
-    \sa rightJustified()
-*/
-
-QString QString::leftJustified(int width, QChar fill, bool truncate) const
-{
-    QString result;
-    int len = length();
-    int padlen = width - len;
-    if (padlen > 0) {
-        result.resize(len+padlen);
-        if (len)
-            memcpy(result.d->data(), d->data(), sizeof(QChar)*len);
-        QChar *uc = (QChar*)result.d->data() + len;
-        while (padlen--)
-           * uc++ = fill;
-    } else {
-        if (truncate)
-            result = left(width);
-        else
-            result = *this;
-    }
-    return result;
-}
-
-/*!
-    Returns a string of size() \a width that contains the \a fill
-    character followed by the string. For example:
-
-    \snippet qstring/main.cpp 49
-
-    If \a truncate is \c false and the size() of the string is more than
-    \a width, then the returned string is a copy of the string.
-
-    If \a truncate is true and the size() of the string is more than
-    \a width, then the resulting string is truncated at position \a
-    width.
-
-    \snippet qstring/main.cpp 50
-
-    \sa leftJustified()
-*/
-
-QString QString::rightJustified(int width, QChar fill, bool truncate) const
-{
-    QString result;
-    int len = length();
-    int padlen = width - len;
-    if (padlen > 0) {
-        result.resize(len+padlen);
-        QChar *uc = (QChar*)result.d->data();
-        while (padlen--)
-           * uc++ = fill;
-        if (len)
-          memcpy(static_cast<void *>(uc), static_cast<const void *>(d->data()), sizeof(QChar)*len);
-    } else {
-        if (truncate)
-            result = left(width);
-        else
-            result = *this;
-    }
-    return result;
-}
-
-/*!
-    \fn QString QString::toLower() const
-
-    Returns a lowercase copy of the string.
-
-    \snippet qstring/main.cpp 75
-
-    The case conversion will always happen in the 'C' locale. For locale dependent
-    case folding use QLocale::toLower()
-
-    \sa toUpper(), QLocale::toLower()
-*/
-
-namespace QUnicodeTables {
-/*
-    \internal
-    Converts the \a str string starting from the position pointed to by the \a
-    it iterator, using the Unicode case traits \c Traits, and returns the
-    result. The input string must not be empty (the convertCase function below
-    guarantees that).
-
-    The string type \c{T} is also a template and is either \c{const QString} or
-    \c{QString}. This function can do both copy-conversion and in-place
-    conversion depending on the state of the \a str parameter:
-    \list
-       \li \c{T} is \c{const QString}: copy-convert
-       \li \c{T} is \c{QString} and its refcount != 1: copy-convert
-       \li \c{T} is \c{QString} and its refcount == 1: in-place convert
-    \endlist
-
-    In copy-convert mode, the local variable \c{s} is detached from the input
-    \a str. In the in-place convert mode, \a str is in moved-from state (which
-    this function requires to be a valid, empty string) and \c{s} contains the
-    only copy of the string, without reallocation (thus, \a it is still valid).
-
-    There is one pathological case left: when the in-place conversion needs to
-    reallocate memory to grow the buffer. In that case, we need to adjust the \a
-    it pointer.
- */
-template <typename Traits, typename T>
-Q_NEVER_INLINE
-static QString detachAndConvertCase(T &str, QStringIterator it)
-{
-    Q_ASSERT(!str.isEmpty());
-    QString s = std::move(str);             // will copy if T is const QString
-    QChar *pp = s.begin() + it.index(); // will detach if necessary
-
-    do {
-        uint uc = it.nextUnchecked();
-
-        const QUnicodeTables::Properties *prop = qGetProp(uc);
-        signed short caseDiff = Traits::caseDiff(prop);
-
-        if (Q_UNLIKELY(Traits::caseSpecial(prop))) {
-            const ushort *specialCase = specialCaseMap + caseDiff;
-            ushort length = *specialCase++;
-
-            if (Q_LIKELY(length == 1)) {
-                *pp++ = QChar(*specialCase);
-            } else {
-                // slow path: the string is growing
-                int inpos = it.index() - 1;
-                int outpos = pp - s.constBegin();
-
-                s.replace(outpos, 1, reinterpret_cast<const QChar *>(specialCase), length);
-                pp = const_cast<QChar *>(s.constBegin()) + outpos + length;
-
-                // do we need to adjust the input iterator too?
-                // if it is pointing to s's data, str is empty
-                if (str.isEmpty())
-                    it = QStringIterator(s.constBegin(), inpos + length, s.constEnd());
-            }
-        } else if (Q_UNLIKELY(QChar::requiresSurrogates(uc))) {
-            // so far, case convertion never changes planes (guaranteed by the qunicodetables generator)
-            pp++;
-            *pp++ = QChar(QChar::lowSurrogate(uc + caseDiff));
-        } else {
-            *pp++ = QChar(uc + caseDiff);
-        }
-    } while (it.hasNext());
-
-    return s;
-}
-
-template <typename Traits, typename T>
-static QString convertCase(T &str)
-{
-    const QChar *p = str.constBegin();
-    const QChar *e = p + str.size();
-
-    // this avoids out of bounds check in the loop
-    while (e != p && e[-1].isHighSurrogate())
-        --e;
-
-    QStringIterator it(p, e);
-    while (it.hasNext()) {
-        uint uc = it.nextUnchecked();
-        if (Traits::caseDiff(qGetProp(uc))) {
-            it.recedeUnchecked();
-            return detachAndConvertCase<Traits>(str, it);
-        }
-    }
-    return std::move(str);
-}
-} // namespace QUnicodeTables
-
-QString QString::toLower_helper(const QString &str)
-{
-    return QUnicodeTables::convertCase<QUnicodeTables::LowercaseTraits>(str);
-}
-
-QString QString::toLower_helper(QString &str)
-{
-    return QUnicodeTables::convertCase<QUnicodeTables::LowercaseTraits>(str);
-}
-
-/*!
-    \fn QString QString::toCaseFolded() const
-
-    Returns the case folded equivalent of the string. For most Unicode
-    characters this is the same as toLower().
-*/
-
-QString QString::toCaseFolded_helper(const QString &str)
-{
-    return QUnicodeTables::convertCase<QUnicodeTables::CasefoldTraits>(str);
-}
-
-QString QString::toCaseFolded_helper(QString &str)
-{
-    return QUnicodeTables::convertCase<QUnicodeTables::CasefoldTraits>(str);
-}
-
-/*!
-    \fn QString QString::toUpper() const
-
-    Returns an uppercase copy of the string.
-
-    \snippet qstring/main.cpp 81
-
-    The case conversion will always happen in the 'C' locale. For locale dependent
-    case folding use QLocale::toUpper()
-
-    \sa toLower(), QLocale::toLower()
-*/
-
-QString QString::toUpper_helper(const QString &str)
-{
-    return QUnicodeTables::convertCase<QUnicodeTables::UppercaseTraits>(str);
-}
-
-QString QString::toUpper_helper(QString &str)
-{
-    return QUnicodeTables::convertCase<QUnicodeTables::UppercaseTraits>(str);
-}
-
-#if QT_DEPRECATED_SINCE(5, 14)
-/*!
-    \obsolete
-
-    Use asprintf(), arg() or QTextStream instead.
-*/
-QString &QString::sprintf(const char *cformat, ...)
-{
-    va_list ap;
-    va_start(ap, cformat);
-    *this = vasprintf(cformat, ap);
-    va_end(ap);
-    return *this;
-}
-#endif
-
-// ### Qt 6: Consider whether this function shouldn't be removed See task 202871.
-/*!
-    \since 5.5
-
-    Safely builds a formatted string from the format string \a cformat
-    and an arbitrary list of arguments.
-
-    The format string supports the conversion specifiers, length modifiers,
-    and flags provided by printf() in the standard C++ library. The \a cformat
-    string and \c{%s} arguments must be UTF-8 encoded.
-
-    \note The \c{%lc} escape sequence expects a unicode character of type
-    \c char16_t, or \c ushort (as returned by QChar::unicode()).
-    The \c{%ls} escape sequence expects a pointer to a zero-terminated array
-    of unicode characters of type \c char16_t, or ushort (as returned by
-    QString::utf16()). This is at odds with the printf() in the standard C++
-    library, which defines \c {%lc} to print a wchar_t and \c{%ls} to print
-    a \c{wchar_t*}, and might also produce compiler warnings on platforms
-    where the size of \c {wchar_t} is not 16 bits.
-
-    \warning We do not recommend using QString::asprintf() in new Qt
-    code. Instead, consider using QTextStream or arg(), both of
-    which support Unicode strings seamlessly and are type-safe.
-    Here is an example that uses QTextStream:
-
-    \snippet qstring/main.cpp 64
-
-    For \l {QObject::tr()}{translations}, especially if the strings
-    contains more than one escape sequence, you should consider using
-    the arg() function instead. This allows the order of the
-    replacements to be controlled by the translator.
-
-    \sa arg()
-*/
-
-QString QString::asprintf(const char *cformat, ...)
-{
-    va_list ap;
-    va_start(ap, cformat);
-    const QString s = vasprintf(cformat, ap);
-    va_end(ap);
-    return s;
-}
-
-#if QT_DEPRECATED_SINCE(5, 14)
-/*!
-    \obsolete
-
-    Use vasprintf(), arg() or QTextStream instead.
-*/
-QString &QString::vsprintf(const char *cformat, va_list ap)
-{
-    return *this = vasprintf(cformat, ap);
-}
-#endif
-
-static void append_utf8(QString &qs, const char *cs, int len)
-{
-    const int oldSize = qs.size();
-    qs.resize(oldSize + len);
-    const QChar *newEnd = QUtf8::convertToUnicode(qs.data() + oldSize, cs, len);
-    qs.resize(newEnd - qs.constData());
-}
-
-static uint parse_flag_characters(const char * &c) noexcept
-{
-    uint flags = QLocaleData::ZeroPadExponent;
-    while (true) {
-        switch (*c) {
-        case '#':
-            flags |= QLocaleData::ShowBase | QLocaleData::AddTrailingZeroes
-                    | QLocaleData::ForcePoint;
-            break;
-        case '0': flags |= QLocaleData::ZeroPadded; break;
-        case '-': flags |= QLocaleData::LeftAdjusted; break;
-        case ' ': flags |= QLocaleData::BlankBeforePositive; break;
-        case '+': flags |= QLocaleData::AlwaysShowSign; break;
-        case '\'': flags |= QLocaleData::ThousandsGroup; break;
-        default: return flags;
-        }
-        ++c;
-    }
-}
-
-static int parse_field_width(const char * &c)
-{
-    Q_ASSERT(qIsDigit(*c));
-
-    // can't be negative - started with a digit
-    // contains at least one digit
-    const char *endp;
-    bool ok;
-    const qulonglong result = qstrtoull(c, &endp, 10, &ok);
-    c = endp;
-    while (qIsDigit(*c)) // preserve Qt 5.5 behavior of consuming all digits, no matter how many
-        ++c;
-    return ok && result < qulonglong(std::numeric_limits<int>::max()) ? int(result) : 0;
-}
-
-enum LengthMod { lm_none, lm_hh, lm_h, lm_l, lm_ll, lm_L, lm_j, lm_z, lm_t };
-
-static inline bool can_consume(const char * &c, char ch) noexcept
-{
-    if (*c == ch) {
-        ++c;
-        return true;
-    }
-    return false;
-}
-
-static LengthMod parse_length_modifier(const char * &c) noexcept
-{
-    switch (*c++) {
-    case 'h': return can_consume(c, 'h') ? lm_hh : lm_h;
-    case 'l': return can_consume(c, 'l') ? lm_ll : lm_l;
-    case 'L': return lm_L;
-    case 'j': return lm_j;
-    case 'z':
-    case 'Z': return lm_z;
-    case 't': return lm_t;
-    }
-    --c; // don't consume *c - it wasn't a flag
-    return lm_none;
-}
-
-/*!
-    \fn QString QString::vasprintf(const char *cformat, va_list ap)
-    \since 5.5
-
-    Equivalent method to asprintf(), but takes a va_list \a ap
-    instead a list of variable arguments. See the asprintf()
-    documentation for an explanation of \a cformat.
-
-    This method does not call the va_end macro, the caller
-    is responsible to call va_end on \a ap.
-
-    \sa asprintf()
-*/
-
-QString QString::vasprintf(const char *cformat, va_list ap)
-{
-    if (!cformat || !*cformat) {
-        // Qt 1.x compat
-        return fromLatin1("");
-    }
-
-    // Parse cformat
-
-    QString result;
-    const char *c = cformat;
-    for (;;) {
-        // Copy non-escape chars to result
-        const char *cb = c;
-        while (*c != '\0' && *c != '%')
-            c++;
-        append_utf8(result, cb, int(c - cb));
-
-        if (*c == '\0')
-            break;
-
-        // Found '%'
-        const char *escape_start = c;
-        ++c;
-
-        if (*c == '\0') {
-            result.append(QLatin1Char('%')); // a % at the end of the string - treat as non-escape text
-            break;
-        }
-        if (*c == '%') {
-            result.append(QLatin1Char('%')); // %%
-            ++c;
-            continue;
-        }
-
-        uint flags = parse_flag_characters(c);
-
-        if (*c == '\0') {
-            result.append(QLatin1String(escape_start)); // incomplete escape, treat as non-escape text
-            break;
-        }
-
-        // Parse field width
-        int width = -1; // -1 means unspecified
-        if (qIsDigit(*c)) {
-            width = parse_field_width(c);
-        } else if (*c == '*') { // can't parse this in another function, not portably, at least
-            width = va_arg(ap, int);
-            if (width < 0)
-                width = -1; // treat all negative numbers as unspecified
-            ++c;
-        }
-
-        if (*c == '\0') {
-            result.append(QLatin1String(escape_start)); // incomplete escape, treat as non-escape text
-            break;
-        }
-
-        // Parse precision
-        int precision = -1; // -1 means unspecified
-        if (*c == '.') {
-            ++c;
-            if (qIsDigit(*c)) {
-                precision = parse_field_width(c);
-            } else if (*c == '*') { // can't parse this in another function, not portably, at least
-                precision = va_arg(ap, int);
-                if (precision < 0)
-                    precision = -1; // treat all negative numbers as unspecified
-                ++c;
-            }
-        }
-
-        if (*c == '\0') {
-            result.append(QLatin1String(escape_start)); // incomplete escape, treat as non-escape text
-            break;
-        }
-
-        const LengthMod length_mod = parse_length_modifier(c);
-
-        if (*c == '\0') {
-            result.append(QLatin1String(escape_start)); // incomplete escape, treat as non-escape text
-            break;
-        }
-
-        // Parse the conversion specifier and do the conversion
-        QString subst;
-        switch (*c) {
-            case 'd':
-            case 'i': {
-                qint64 i;
-                switch (length_mod) {
-                    case lm_none: i = va_arg(ap, int); break;
-                    case lm_hh: i = va_arg(ap, int); break;
-                    case lm_h: i = va_arg(ap, int); break;
-                    case lm_l: i = va_arg(ap, long int); break;
-                    case lm_ll: i = va_arg(ap, qint64); break;
-                    case lm_j: i = va_arg(ap, long int); break;
-                    case lm_z: i = va_arg(ap, size_t); break;
-                    case lm_t: i = va_arg(ap, int); break;
-                    default: i = 0; break;
-                }
-                subst = QLocaleData::c()->longLongToString(i, precision, 10, width, flags);
-                ++c;
-                break;
-            }
-            case 'o':
-            case 'u':
-            case 'x':
-            case 'X': {
-                quint64 u;
-                switch (length_mod) {
-                    case lm_none: u = va_arg(ap, uint); break;
-                    case lm_hh: u = va_arg(ap, uint); break;
-                    case lm_h: u = va_arg(ap, uint); break;
-                    case lm_l: u = va_arg(ap, ulong); break;
-                    case lm_ll: u = va_arg(ap, quint64); break;
-                    case lm_z: u = va_arg(ap, size_t); break;
-                    default: u = 0; break;
-                }
-
-                if (qIsUpper(*c))
-                    flags |= QLocaleData::CapitalEorX;
-
-                int base = 10;
-                switch (qToLower(*c)) {
-                    case 'o':
-                        base = 8; break;
-                    case 'u':
-                        base = 10; break;
-                    case 'x':
-                        base = 16; break;
-                    default: break;
-                }
-                subst = QLocaleData::c()->unsLongLongToString(u, precision, base, width, flags);
-                ++c;
-                break;
-            }
-            case 'E':
-            case 'e':
-            case 'F':
-            case 'f':
-            case 'G':
-            case 'g':
-            case 'A':
-            case 'a': {
-                double d;
-                if (length_mod == lm_L)
-                    d = va_arg(ap, long double); // not supported - converted to a double
-                else
-                    d = va_arg(ap, double);
-
-                if (qIsUpper(*c))
-                    flags |= QLocaleData::CapitalEorX;
-
-                QLocaleData::DoubleForm form = QLocaleData::DFDecimal;
-                switch (qToLower(*c)) {
-                    case 'e': form = QLocaleData::DFExponent; break;
-                    case 'a':                             // not supported - decimal form used instead
-                    case 'f': form = QLocaleData::DFDecimal; break;
-                    case 'g': form = QLocaleData::DFSignificantDigits; break;
-                    default: break;
-                }
-                subst = QLocaleData::c()->doubleToString(d, precision, form, width, flags);
-                ++c;
-                break;
-            }
-            case 'c': {
-                if (length_mod == lm_l)
-                    subst = QChar((ushort) va_arg(ap, int));
-                else
-                    subst = QLatin1Char((uchar) va_arg(ap, int));
-                ++c;
-                break;
-            }
-            case 's': {
-                if (length_mod == lm_l) {
-                    const ushort *buff = va_arg(ap, const ushort*);
-                    const ushort *ch = buff;
-                    while (*ch != 0)
-                        ++ch;
-                    subst.setUtf16(buff, ch - buff);
-                } else
-                    subst = QString::fromUtf8(va_arg(ap, const char*));
-                if (precision != -1)
-                    subst.truncate(precision);
-                ++c;
-                break;
-            }
-            case 'p': {
-                void *arg = va_arg(ap, void*);
-                const quint64 i = reinterpret_cast<quintptr>(arg);
-                flags |= QLocaleData::ShowBase;
-                subst = QLocaleData::c()->unsLongLongToString(i, precision, 16, width, flags);
-                ++c;
-                break;
-            }
-            case 'n':
-                switch (length_mod) {
-                    case lm_hh: {
-                        signed char *n = va_arg(ap, signed char*);
-                        *n = result.length();
-                        break;
-                    }
-                    case lm_h: {
-                        short int *n = va_arg(ap, short int*);
-                        *n = result.length();
-                            break;
-                    }
-                    case lm_l: {
-                        long int *n = va_arg(ap, long int*);
-                        *n = result.length();
-                        break;
-                    }
-                    case lm_ll: {
-                        qint64 *n = va_arg(ap, qint64*);
-                        *n = result.length();
-                        break;
-                    }
-                    default: {
-                        int *n = va_arg(ap, int*);
-                        *n = result.length();
-                        break;
-                    }
-                }
-                ++c;
-                break;
-
-            default: // bad escape, treat as non-escape text
-                for (const char *cc = escape_start; cc != c; ++cc)
-                    result.append(QLatin1Char(*cc));
-                continue;
-        }
-
-        if (flags & QLocaleData::LeftAdjusted)
-            result.append(subst.leftJustified(width));
-        else
-            result.append(subst.rightJustified(width));
-    }
-
-    return result;
-}
-
-/*!
-    Returns the string converted to a \c{long long} using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toLongLong()
-
-    Example:
-
-    \snippet qstring/main.cpp 74
-
-    This function ignores leading and trailing whitespace.
-
-    \sa number(), toULongLong(), toInt(), QLocale::toLongLong()
-*/
-
-qint64 QString::toLongLong(bool *ok, int base) const
-{
-    return toIntegral_helper<qlonglong>(constData(), size(), ok, base);
-}
-
-qlonglong QString::toIntegral_helper(const QChar *data, int len, bool *ok, int base)
-{
-#if defined(QT_CHECK_RANGE)
-    if (base != 0 && (base < 2 || base > 36)) {
-        qWarning("QString::toULongLong: Invalid base (%d)", base);
-        base = 10;
-    }
-#endif
-
-    return QLocaleData::c()->stringToLongLong(QStringView(data, len), base, ok, QLocale::RejectGroupSeparator);
-}
-
-
-/*!
-    Returns the string converted to an \c{unsigned long long} using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toULongLong()
-
-    Example:
-
-    \snippet qstring/main.cpp 79
-
-    This function ignores leading and trailing whitespace.
-
-    \sa number(), toLongLong(), QLocale::toULongLong()
-*/
-
-quint64 QString::toULongLong(bool *ok, int base) const
-{
-    return toIntegral_helper<qulonglong>(constData(), size(), ok, base);
-}
-
-qulonglong QString::toIntegral_helper(const QChar *data, uint len, bool *ok, int base)
-{
-#if defined(QT_CHECK_RANGE)
-    if (base != 0 && (base < 2 || base > 36)) {
-        qWarning("QString::toULongLong: Invalid base (%d)", base);
-        base = 10;
-    }
-#endif
-
-    return QLocaleData::c()->stringToUnsLongLong(QStringView(data, len), base, ok,
-                                                 QLocale::RejectGroupSeparator);
-}
-
-/*!
-    \fn long QString::toLong(bool *ok, int base) const
-
-    Returns the string converted to a \c long using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toLongLong()
-
-    Example:
-
-    \snippet qstring/main.cpp 73
-
-    This function ignores leading and trailing whitespace.
-
-    \sa number(), toULong(), toInt(), QLocale::toInt()
-*/
-
-long QString::toLong(bool *ok, int base) const
-{
-    return toIntegral_helper<long>(constData(), size(), ok, base);
-}
-
-/*!
-    \fn ulong QString::toULong(bool *ok, int base) const
-
-    Returns the string converted to an \c{unsigned long} using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toULongLong()
-
-    Example:
-
-    \snippet qstring/main.cpp 78
-
-    This function ignores leading and trailing whitespace.
-
-    \sa number(), QLocale::toUInt()
-*/
-
-ulong QString::toULong(bool *ok, int base) const
-{
-    return toIntegral_helper<ulong>(constData(), size(), ok, base);
-}
-
-
-/*!
-    Returns the string converted to an \c int using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toInt()
-
-    Example:
-
-    \snippet qstring/main.cpp 72
-
-    This function ignores leading and trailing whitespace.
-
-    \sa number(), toUInt(), toDouble(), QLocale::toInt()
-*/
-
-int QString::toInt(bool *ok, int base) const
-{
-    return toIntegral_helper<int>(constData(), size(), ok, base);
-}
-
-/*!
-    Returns the string converted to an \c{unsigned int} using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toUInt()
-
-    Example:
-
-    \snippet qstring/main.cpp 77
-
-    This function ignores leading and trailing whitespace.
-
-    \sa number(), toInt(), QLocale::toUInt()
-*/
-
-uint QString::toUInt(bool *ok, int base) const
-{
-    return toIntegral_helper<uint>(constData(), size(), ok, base);
-}
-
-/*!
-    Returns the string converted to a \c short using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toShort()
-
-    Example:
-
-    \snippet qstring/main.cpp 76
-
-    This function ignores leading and trailing whitespace.
-
-    \sa number(), toUShort(), toInt(), QLocale::toShort()
-*/
-
-short QString::toShort(bool *ok, int base) const
-{
-    return toIntegral_helper<short>(constData(), size(), ok, base);
-}
-
-/*!
-    Returns the string converted to an \c{unsigned short} using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toUShort()
-
-    Example:
-
-    \snippet qstring/main.cpp 80
-
-    This function ignores leading and trailing whitespace.
-
-    \sa number(), toShort(), QLocale::toUShort()
-*/
-
-ushort QString::toUShort(bool *ok, int base) const
-{
-    return toIntegral_helper<ushort>(constData(), size(), ok, base);
-}
-
-
-/*!
-    Returns the string converted to a \c double value.
-
-    Returns an infinity if the conversion overflows or 0.0 if the
-    conversion fails for other reasons (e.g. underflow).
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    \snippet qstring/main.cpp 66
-
-    \warning The QString content may only contain valid numerical characters
-    which includes the plus/minus sign, the character e used in scientific
-    notation, and the decimal point. Including the unit or additional characters
-    leads to a conversion error.
-
-    \snippet qstring/main.cpp 67
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toDouble()
-
-    \snippet qstring/main.cpp 68
-
-    For historical reasons, this function does not handle
-    thousands group separators. If you need to convert such numbers,
-    use QLocale::toDouble().
-
-    \snippet qstring/main.cpp 69
-
-    This function ignores leading and trailing whitespace.
-
-    \sa number(), QLocale::setDefault(), QLocale::toDouble(), trimmed()
-*/
-
-double QString::toDouble(bool *ok) const
-{
-    return QLocaleData::c()->stringToDouble(*this, ok, QLocale::RejectGroupSeparator);
-}
-
-/*!
-    Returns the string converted to a \c float value.
-
-    Returns an infinity if the conversion overflows or 0.0 if the
-    conversion fails for other reasons (e.g. underflow).
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    \warning The QString content may only contain valid numerical characters
-    which includes the plus/minus sign, the character e used in scientific
-    notation, and the decimal point. Including the unit or additional characters
-    leads to a conversion error.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toFloat()
-
-    For historical reasons, this function does not handle
-    thousands group separators. If you need to convert such numbers,
-    use QLocale::toFloat().
-
-    Example:
-
-    \snippet qstring/main.cpp 71
-
-    This function ignores leading and trailing whitespace.
-
-    \sa number(), toDouble(), toInt(), QLocale::toFloat(), trimmed()
-*/
-
-float QString::toFloat(bool *ok) const
-{
-    return QLocaleData::convertDoubleToFloat(toDouble(ok), ok);
-}
-
-/*! \fn QString &QString::setNum(int n, int base)
-
-    Sets the string to the printed value of \a n in the specified \a
-    base, and returns a reference to the string.
-
-    The base is 10 by default and must be between 2 and 36. For bases
-    other than 10, \a n is treated as an unsigned integer.
-
-    \snippet qstring/main.cpp 56
-
-   The formatting always uses QLocale::C, i.e., English/UnitedStates.
-   To get a localized string representation of a number, use
-   QLocale::toString() with the appropriate locale.
-*/
-
-/*! \fn QString &QString::setNum(uint n, int base)
-
-    \overload
-*/
-
-/*! \fn QString &QString::setNum(long n, int base)
-
-    \overload
-*/
-
-/*! \fn QString &QString::setNum(ulong n, int base)
-
-    \overload
-*/
-
-/*!
-    \overload
-*/
-QString &QString::setNum(qlonglong n, int base)
-{
-    return *this = number(n, base);
-}
-
-/*!
-    \overload
-*/
-QString &QString::setNum(qulonglong n, int base)
-{
-    return *this = number(n, base);
-}
-
-/*! \fn QString &QString::setNum(short n, int base)
-
-    \overload
-*/
-
-/*! \fn QString &QString::setNum(ushort n, int base)
-
-    \overload
-*/
-
-/*!
-    \fn QString &QString::setNum(double n, char format, int precision)
-    \overload
-
-    Sets the string to the printed value of \a n, formatted according
-    to the given \a format and \a precision, and returns a reference
-    to the string.
-
-    The \a format can be 'e', 'E', 'f', 'g' or 'G' (see
-    \l{Argument Formats} for an explanation of the formats).
-
-    The formatting always uses QLocale::C, i.e., English/UnitedStates.
-    To get a localized string representation of a number, use
-    QLocale::toString() with the appropriate locale.
-*/
-
-QString &QString::setNum(double n, char f, int prec)
-{
-    return *this = number(n, f, prec);
-}
-
-/*!
-    \fn QString &QString::setNum(float n, char format, int precision)
-    \overload
-
-    Sets the string to the printed value of \a n, formatted according
-    to the given \a format and \a precision, and returns a reference
-    to the string.
-
-    The formatting always uses QLocale::C, i.e., English/UnitedStates.
-    To get a localized string representation of a number, use
-    QLocale::toString() with the appropriate locale.
-*/
-
-
-/*!
-    \fn QString QString::number(long n, int base)
-
-    Returns a string equivalent of the number \a n according to the
-    specified \a base.
-
-    The base is 10 by default and must be between 2
-    and 36. For bases other than 10, \a n is treated as an
-    unsigned integer.
-
-    The formatting always uses QLocale::C, i.e., English/UnitedStates.
-    To get a localized string representation of a number, use
-    QLocale::toString() with the appropriate locale.
-
-    \snippet qstring/main.cpp 35
-
-    \sa setNum()
-*/
-
-QString QString::number(long n, int base)
-{
-    return number(qlonglong(n), base);
-}
-
-/*!
-  \fn QString QString::number(ulong n, int base)
-
-    \overload
-*/
-QString QString::number(ulong n, int base)
-{
-    return number(qulonglong(n), base);
-}
-
-/*!
-    \overload
-*/
-QString QString::number(int n, int base)
-{
-    return number(qlonglong(n), base);
-}
-
-/*!
-    \overload
-*/
-QString QString::number(uint n, int base)
-{
-    return number(qulonglong(n), base);
-}
-
-/*!
-    \overload
-*/
-QString QString::number(qlonglong n, int base)
-{
-#if defined(QT_CHECK_RANGE)
-    if (base < 2 || base > 36) {
-        qWarning("QString::setNum: Invalid base (%d)", base);
-        base = 10;
-    }
-#endif
-    return QLocaleData::c()->longLongToString(n, -1, base);
-}
-
-/*!
-    \overload
-*/
-QString QString::number(qulonglong n, int base)
-{
-#if defined(QT_CHECK_RANGE)
-    if (base < 2 || base > 36) {
-        qWarning("QString::setNum: Invalid base (%d)", base);
-        base = 10;
-    }
-#endif
-    return QLocaleData::c()->unsLongLongToString(n, -1, base);
-}
-
-
-/*!
-    \fn QString QString::number(double n, char format, int precision)
-
-    Returns a string equivalent of the number \a n, formatted
-    according to the specified \a format and \a precision. See
-    \l{Argument Formats} for details.
-
-    Unlike QLocale::toString(), this function does not honor the
-    user's locale settings.
-
-    \sa setNum(), QLocale::toString()
-*/
-QString QString::number(double n, char f, int prec)
-{
-    QLocaleData::DoubleForm form = QLocaleData::DFDecimal;
-    uint flags = QLocaleData::ZeroPadExponent;
-
-    if (qIsUpper(f))
-        flags |= QLocaleData::CapitalEorX;
-
-    switch (qToLower(f)) {
-        case 'f':
-            form = QLocaleData::DFDecimal;
-            break;
-        case 'e':
-            form = QLocaleData::DFExponent;
-            break;
-        case 'g':
-            form = QLocaleData::DFSignificantDigits;
-            break;
-        default:
-#if defined(QT_CHECK_RANGE)
-            qWarning("QString::setNum: Invalid format char '%c'", f);
-#endif
-            break;
-    }
-
-    return QLocaleData::c()->doubleToString(n, prec, form, -1, flags);
-}
-
-namespace {
-template<class ResultList, class StringSource>
-static ResultList splitString(const StringSource &source, const QChar *sep,
-                              QString::SplitBehavior behavior, Qt::CaseSensitivity cs, const int separatorSize)
-{
-    ResultList list;
-    typename StringSource::size_type start = 0;
-    typename StringSource::size_type end;
-    typename StringSource::size_type extra = 0;
-    while ((end = QtPrivate::findString(QStringView(source.constData(), source.size()), start + extra, QStringView(sep, separatorSize), cs)) != -1) {
-        if (start != end || behavior == QString::KeepEmptyParts)
-            list.append(source.mid(start, end - start));
-        start = end + separatorSize;
-        extra = (separatorSize == 0 ? 1 : 0);
-    }
-    if (start != source.size() || behavior == QString::KeepEmptyParts)
-        list.append(source.mid(start, -1));
-    return list;
-}
-
-} // namespace
-
-/*!
-    Splits the string into substrings wherever \a sep occurs, and
-    returns the list of those strings. If \a sep does not match
-    anywhere in the string, split() returns a single-element list
-    containing this string.
-
-    \a cs specifies whether \a sep should be matched case
-    sensitively or case insensitively.
-
-    If \a behavior is QString::SkipEmptyParts, empty entries don't
-    appear in the result. By default, empty entries are kept.
-
-    Example:
-
-    \snippet qstring/main.cpp 62
-
-    If \a sep is empty, split() returns an empty string, followed
-    by each of the string's characters, followed by another empty string:
-
-    \snippet qstring/main.cpp 62-empty
-
-    To understand this behavior, recall that the empty string matches
-    everywhere, so the above is qualitatively the same as:
-
-    \snippet qstring/main.cpp 62-slashes
-
-    \sa QStringList::join(), section()
-*/
-QStringList QString::split(const QString &sep, SplitBehavior behavior, Qt::CaseSensitivity cs) const
-{
-    return splitString<QStringList>(*this, sep.constData(), behavior, cs, sep.size());
-}
-
-/*!
-    Splits the string into substring references wherever \a sep occurs, and
-    returns the list of those strings.
-
-    See QString::split() for how \a sep, \a behavior and \a cs interact to form
-    the result.
-
-    \note All references are valid as long this string is alive. Destroying this
-    string will cause all references to be dangling pointers.
-
-    \since 5.4
-    \sa QStringRef split()
-*/
-QVector<QStringRef> QString::splitRef(const QString &sep, SplitBehavior behavior, Qt::CaseSensitivity cs) const
-{
-    return splitString<QVector<QStringRef> >(QStringRef(this), sep.constData(), behavior, cs, sep.size());
-}
-/*!
-    \overload
-*/
-QStringList QString::split(QChar sep, SplitBehavior behavior, Qt::CaseSensitivity cs) const
-{
-    return splitString<QStringList>(*this, &sep, behavior, cs, 1);
-}
-
-/*!
-    \overload
-    \since 5.4
-*/
-QVector<QStringRef> QString::splitRef(QChar sep, SplitBehavior behavior, Qt::CaseSensitivity cs) const
-{
-    return splitString<QVector<QStringRef> >(QStringRef(this), &sep, behavior, cs, 1);
-}
-
-/*!
-    Splits the string into substrings references wherever \a sep occurs, and
-    returns the list of those strings.
-
-    See QString::split() for how \a sep, \a behavior and \a cs interact to form
-    the result.
-
-    \note All references are valid as long this string is alive. Destroying this
-    string will cause all references to be dangling pointers.
-
-    \since 5.4
-*/
-QVector<QStringRef> QStringRef::split(const QString &sep, QString::SplitBehavior behavior, Qt::CaseSensitivity cs) const
-{
-    return splitString<QVector<QStringRef> >(*this, sep.constData(), behavior, cs, sep.size());
-}
-
-/*!
-    \overload
-    \since 5.4
-*/
-QVector<QStringRef> QStringRef::split(QChar sep, QString::SplitBehavior behavior, Qt::CaseSensitivity cs) const
-{
-    return splitString<QVector<QStringRef> >(*this, &sep, behavior, cs, 1);
-}
-
-#ifndef QT_NO_REGEXP
-namespace {
-template<class ResultList, typename MidMethod>
-static ResultList splitString(const QString &source, MidMethod mid, const QRegExp &rx, QString::SplitBehavior behavior)
-{
-    QRegExp rx2(rx);
-    ResultList list;
-    int start = 0;
-    int extra = 0;
-    int end;
-    while ((end = rx2.indexIn(source, start + extra)) != -1) {
-        int matchedLen = rx2.matchedLength();
-        if (start != end || behavior == QString::KeepEmptyParts)
-            list.append((source.*mid)(start, end - start));
-        start = end + matchedLen;
-        extra = (matchedLen == 0) ? 1 : 0;
-    }
-    if (start != source.size() || behavior == QString::KeepEmptyParts)
-        list.append((source.*mid)(start, -1));
-    return list;
-}
-} // namespace
-
-/*!
-    \overload
-
-    Splits the string into substrings wherever the regular expression
-    \a rx matches, and returns the list of those strings. If \a rx
-    does not match anywhere in the string, split() returns a
-    single-element list containing this string.
-
-    Here is an example where we extract the words in a sentence
-    using one or more whitespace characters as the separator:
-
-    \snippet qstring/main.cpp 59
-
-    Here is a similar example, but this time we use any sequence of
-    non-word characters as the separator:
-
-    \snippet qstring/main.cpp 60
-
-    Here is a third example where we use a zero-length assertion,
-    \b{\\b} (word boundary), to split the string into an
-    alternating sequence of non-word and word tokens:
-
-    \snippet qstring/main.cpp 61
-
-    \sa QStringList::join(), section()
-*/
-QStringList QString::split(const QRegExp &rx, SplitBehavior behavior) const
-{
-    return splitString<QStringList>(*this, &QString::mid, rx, behavior);
-}
-
-/*!
-    \overload
-    \since 5.4
-
-    Splits the string into substring references wherever the regular expression
-    \a rx matches, and returns the list of those strings. If \a rx
-    does not match anywhere in the string, splitRef() returns a
-    single-element vector containing this string reference.
-
-    \note All references are valid as long this string is alive. Destroying this
-    string will cause all references to be dangling pointers.
-
-    \sa QStringRef split()
-*/
-QVector<QStringRef> QString::splitRef(const QRegExp &rx, SplitBehavior behavior) const
-{
-    return splitString<QVector<QStringRef> >(*this, &QString::midRef, rx, behavior);
-}
-#endif
-
-#if QT_CONFIG(regularexpression)
-namespace {
-template<class ResultList, typename MidMethod>
-static ResultList splitString(const QString &source, MidMethod mid, const QRegularExpression &re,
-                              QString::SplitBehavior behavior)
-{
-    ResultList list;
-    if (!re.isValid()) {
-        qWarning("QString::split: invalid QRegularExpression object");
-        return list;
-    }
-
-    int start = 0;
-    int end = 0;
-    QRegularExpressionMatchIterator iterator = re.globalMatch(source);
-    while (iterator.hasNext()) {
-        QRegularExpressionMatch match = iterator.next();
-        end = match.capturedStart();
-        if (start != end || behavior == QString::KeepEmptyParts)
-            list.append((source.*mid)(start, end - start));
-        start = match.capturedEnd();
-    }
-
-    if (start != source.size() || behavior == QString::KeepEmptyParts)
-        list.append((source.*mid)(start, -1));
-
-    return list;
-}
-} // namespace
-
-/*!
-    \overload
-    \since 5.0
-
-    Splits the string into substrings wherever the regular expression
-    \a re matches, and returns the list of those strings. If \a re
-    does not match anywhere in the string, split() returns a
-    single-element list containing this string.
-
-    Here is an example where we extract the words in a sentence
-    using one or more whitespace characters as the separator:
-
-    \snippet qstring/main.cpp 90
-
-    Here is a similar example, but this time we use any sequence of
-    non-word characters as the separator:
-
-    \snippet qstring/main.cpp 91
-
-    Here is a third example where we use a zero-length assertion,
-    \b{\\b} (word boundary), to split the string into an
-    alternating sequence of non-word and word tokens:
-
-    \snippet qstring/main.cpp 92
-
-    \sa QStringList::join(), section()
-*/
-QStringList QString::split(const QRegularExpression &re, SplitBehavior behavior) const
-{
-    return splitString<QStringList>(*this, &QString::mid, re, behavior);
-}
-
-/*!
-    \overload
-    \since 5.4
-
-    Splits the string into substring references wherever the regular expression
-    \a re matches, and returns the list of those strings. If \a re
-    does not match anywhere in the string, splitRef() returns a
-    single-element vector containing this string reference.
-
-    \note All references are valid as long this string is alive. Destroying this
-    string will cause all references to be dangling pointers.
-
-    \sa split() QStringRef
-*/
-QVector<QStringRef> QString::splitRef(const QRegularExpression &re, SplitBehavior behavior) const
-{
-    return splitString<QVector<QStringRef> >(*this, &QString::midRef, re, behavior);
-}
-#endif // QT_CONFIG(regularexpression)
-
-/*!
-    \enum QString::NormalizationForm
-
-    This enum describes the various normalized forms of Unicode text.
-
-    \value NormalizationForm_D  Canonical Decomposition
-    \value NormalizationForm_C  Canonical Decomposition followed by Canonical Composition
-    \value NormalizationForm_KD  Compatibility Decomposition
-    \value NormalizationForm_KC  Compatibility Decomposition followed by Canonical Composition
-
-    \sa normalized(),
-        {http://www.unicode.org/reports/tr15/}{Unicode Standard Annex #15}
-*/
-
-/*!
-    \since 4.5
-
-    Returns a copy of this string repeated the specified number of \a times.
-
-    If \a times is less than 1, an empty string is returned.
-
-    Example:
-
-    \snippet code/src_corelib_tools_qstring.cpp 8
-*/
-QString QString::repeated(int times) const
-{
-    if (d->size == 0)
-        return *this;
-
-    if (times <= 1) {
-        if (times == 1)
-            return *this;
-        return QString();
-    }
-
-    const int resultSize = times * d->size;
-
-    QString result;
-    result.reserve(resultSize);
-    if (result.d->alloc != uint(resultSize) + 1u)
-        return QString(); // not enough memory
-
-    memcpy(result.d->data(), d->data(), d->size * sizeof(ushort));
-
-    int sizeSoFar = d->size;
-    ushort *end = result.d->data() + sizeSoFar;
-
-    const int halfResultSize = resultSize >> 1;
-    while (sizeSoFar <= halfResultSize) {
-        memcpy(end, result.d->data(), sizeSoFar * sizeof(ushort));
-        end += sizeSoFar;
-        sizeSoFar <<= 1;
-    }
-    memcpy(end, result.d->data(), (resultSize - sizeSoFar) * sizeof(ushort));
-    result.d->data()[resultSize] = '\0';
-    result.d->size = resultSize;
-    return result;
-}
-
-void qt_string_normalize(QString *data, QString::NormalizationForm mode, QChar::UnicodeVersion version, int from)
-{
-    const QChar *p = data->constData() + from;
-    if (isAscii(p, p + data->length() - from))
-        return;
-    if (p > data->constData() + from)
-        from = p - data->constData() - 1;   // need one before the non-ASCII to perform NFC
-
-    if (version == QChar::Unicode_Unassigned) {
-        version = QChar::currentUnicodeVersion();
-    } else if (int(version) <= NormalizationCorrectionsVersionMax) {
-        const QString &s = *data;
-        QChar *d = nullptr;
-        for (int i = 0; i < NumNormalizationCorrections; ++i) {
-            const NormalizationCorrection &n = uc_normalization_corrections[i];
-            if (n.version > version) {
-                int pos = from;
-                if (QChar::requiresSurrogates(n.ucs4)) {
-                    ushort ucs4High = QChar::highSurrogate(n.ucs4);
-                    ushort ucs4Low = QChar::lowSurrogate(n.ucs4);
-                    ushort oldHigh = QChar::highSurrogate(n.old_mapping);
-                    ushort oldLow = QChar::lowSurrogate(n.old_mapping);
-                    while (pos < s.length() - 1) {
-                        if (s.at(pos).unicode() == ucs4High && s.at(pos + 1).unicode() == ucs4Low) {
-                            if (!d)
-                                d = data->data();
-                            d[pos] = QChar(oldHigh);
-                            d[++pos] = QChar(oldLow);
-                        }
-                        ++pos;
-                    }
-                } else {
-                    while (pos < s.length()) {
-                        if (s.at(pos).unicode() == n.ucs4) {
-                            if (!d)
-                                d = data->data();
-                            d[pos] = QChar(n.old_mapping);
-                        }
-                        ++pos;
-                    }
-                }
-            }
-        }
-    }
-
-    if (normalizationQuickCheckHelper(data, mode, from, &from))
-        return;
-
-    decomposeHelper(data, mode < QString::NormalizationForm_KD, version, from);
-
-    canonicalOrderHelper(data, version, from);
-
-    if (mode == QString::NormalizationForm_D || mode == QString::NormalizationForm_KD)
-        return;
-
-    composeHelper(data, version, from);
-}
-
-/*!
-    Returns the string in the given Unicode normalization \a mode,
-    according to the given \a version of the Unicode standard.
-*/
-QString QString::normalized(QString::NormalizationForm mode, QChar::UnicodeVersion version) const
-{
-    QString copy = *this;
-    qt_string_normalize(&copy, mode, version, 0);
-    return copy;
-}
-
-
-struct ArgEscapeData
-{
-    int min_escape;            // lowest escape sequence number
-    int occurrences;           // number of occurrences of the lowest escape sequence number
-    int locale_occurrences;    // number of occurrences of the lowest escape sequence number that
-                               // contain 'L'
-    int escape_len;            // total length of escape sequences which will be replaced
-};
-
-static ArgEscapeData findArgEscapes(QStringView s)
-{
-    const QChar *uc_begin = s.begin();
-    const QChar *uc_end = s.end();
-
-    ArgEscapeData d;
-
-    d.min_escape = INT_MAX;
-    d.occurrences = 0;
-    d.escape_len = 0;
-    d.locale_occurrences = 0;
-
-    const QChar *c = uc_begin;
-    while (c != uc_end) {
-        while (c != uc_end && c->unicode() != '%')
-            ++c;
-
-        if (c == uc_end)
-            break;
-        const QChar *escape_start = c;
-        if (++c == uc_end)
-            break;
-
-        bool locale_arg = false;
-        if (c->unicode() == 'L') {
-            locale_arg = true;
-            if (++c == uc_end)
-                break;
-        }
-
-        int escape = c->digitValue();
-        if (escape == -1)
-            continue;
-
-        ++c;
-
-        if (c != uc_end) {
-            int next_escape = c->digitValue();
-            if (next_escape != -1) {
-                escape = (10 * escape) + next_escape;
-                ++c;
-            }
-        }
-
-        if (escape > d.min_escape)
-            continue;
-
-        if (escape < d.min_escape) {
-            d.min_escape = escape;
-            d.occurrences = 0;
-            d.escape_len = 0;
-            d.locale_occurrences = 0;
-        }
-
-        ++d.occurrences;
-        if (locale_arg)
-            ++d.locale_occurrences;
-        d.escape_len += c - escape_start;
-    }
-    return d;
-}
-
-static QString replaceArgEscapes(QStringView s, const ArgEscapeData &d, int field_width,
-                                 QStringView arg, QStringView larg, QChar fillChar)
-{
-    const QChar *uc_begin = s.begin();
-    const QChar *uc_end = s.end();
-
-    int abs_field_width = qAbs(field_width);
-    int result_len = s.length()
-                     - d.escape_len
-                     + (d.occurrences - d.locale_occurrences)
-                     *qMax(abs_field_width, arg.length())
-                     + d.locale_occurrences
-                     *qMax(abs_field_width, larg.length());
-
-    QString result(result_len, Qt::Uninitialized);
-    QChar *result_buff = (QChar*) result.unicode();
-
-    QChar *rc = result_buff;
-    const QChar *c = uc_begin;
-    int repl_cnt = 0;
-    while (c != uc_end) {
-        /* We don't have to check if we run off the end of the string with c,
-           because as long as d.occurrences > 0 we KNOW there are valid escape
-           sequences. */
-
-        const QChar *text_start = c;
-
-        while (c->unicode() != '%')
-            ++c;
-
-        const QChar *escape_start = c++;
-
-        bool locale_arg = false;
-        if (c->unicode() == 'L') {
-            locale_arg = true;
-            ++c;
-        }
-
-        int escape = c->digitValue();
-        if (escape != -1) {
-            if (c + 1 != uc_end && (c + 1)->digitValue() != -1) {
-                escape = (10 * escape) + (c + 1)->digitValue();
-                ++c;
-            }
-        }
-
-        if (escape != d.min_escape) {
-            memcpy(rc, text_start, (c - text_start)*sizeof(QChar));
-            rc += c - text_start;
-        }
-        else {
-            ++c;
-
-            memcpy(rc, text_start, (escape_start - text_start)*sizeof(QChar));
-            rc += escape_start - text_start;
-
-            uint pad_chars;
-            if (locale_arg)
-                pad_chars = qMax(abs_field_width, larg.length()) - larg.length();
-            else
-                pad_chars = qMax(abs_field_width, arg.length()) - arg.length();
-
-            if (field_width > 0) { // left padded
-                for (uint i = 0; i < pad_chars; ++i)
-                    (rc++)->unicode() = fillChar.unicode();
-            }
-
-            if (locale_arg) {
-                memcpy(rc, larg.data(), larg.length()*sizeof(QChar));
-                rc += larg.length();
-            }
-            else {
-                memcpy(rc, arg.data(), arg.length()*sizeof(QChar));
-                rc += arg.length();
-            }
-
-            if (field_width < 0) { // right padded
-                for (uint i = 0; i < pad_chars; ++i)
-                    (rc++)->unicode() = fillChar.unicode();
-            }
-
-            if (++repl_cnt == d.occurrences) {
-                memcpy(rc, c, (uc_end - c)*sizeof(QChar));
-                rc += uc_end - c;
-                Q_ASSERT(rc - result_buff == result_len);
-                c = uc_end;
-            }
-        }
-    }
-    Q_ASSERT(rc == result_buff + result_len);
-
-    return result;
-}
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*!
-  Returns a copy of this string with the lowest numbered place marker
-  replaced by string \a a, i.e., \c %1, \c %2, ..., \c %99.
-
-  \a fieldWidth specifies the minimum amount of space that argument \a
-  a shall occupy. If \a a requires less space than \a fieldWidth, it
-  is padded to \a fieldWidth with character \a fillChar.  A positive
-  \a fieldWidth produces right-aligned text. A negative \a fieldWidth
-  produces left-aligned text.
-
-  This example shows how we might create a \c status string for
-  reporting progress while processing a list of files:
-
-  \snippet qstring/main.cpp 11
-
-  First, \c arg(i) replaces \c %1. Then \c arg(total) replaces \c
-  %2. Finally, \c arg(fileName) replaces \c %3.
-
-  One advantage of using arg() over asprintf() is that the order of the
-  numbered place markers can change, if the application's strings are
-  translated into other languages, but each arg() will still replace
-  the lowest numbered unreplaced place marker, no matter where it
-  appears. Also, if place marker \c %i appears more than once in the
-  string, the arg() replaces all of them.
-
-  If there is no unreplaced place marker remaining, a warning message
-  is output and the result is undefined. Place marker numbers must be
-  in the range 1 to 99.
-*/
-QString QString::arg(const QString &a, int fieldWidth, QChar fillChar) const
-{
-    return arg(qToStringViewIgnoringNull(a), fieldWidth, fillChar);
-}
-#endif // QT_STRINGVIEW_LEVEL < 2
-
-/*!
-    \overload
-    \since 5.10
-
-    Returns a copy of this string with the lowest-numbered place-marker
-    replaced by string \a a, i.e., \c %1, \c %2, ..., \c %99.
-
-    \a fieldWidth specifies the minimum amount of space that \a a
-    shall occupy. If \a a requires less space than \a fieldWidth, it
-    is padded to \a fieldWidth with character \a fillChar.  A positive
-    \a fieldWidth produces right-aligned text. A negative \a fieldWidth
-    produces left-aligned text.
-
-    This example shows how we might create a \c status string for
-    reporting progress while processing a list of files:
-
-    \snippet qstring/main.cpp 11-qstringview
-
-    First, \c arg(i) replaces \c %1. Then \c arg(total) replaces \c
-    %2. Finally, \c arg(fileName) replaces \c %3.
-
-    One advantage of using arg() over asprintf() is that the order of the
-    numbered place markers can change, if the application's strings are
-    translated into other languages, but each arg() will still replace
-    the lowest-numbered unreplaced place-marker, no matter where it
-    appears. Also, if place-marker \c %i appears more than once in the
-    string, arg() replaces all of them.
-
-    If there is no unreplaced place-marker remaining, a warning message
-    is printed and the result is undefined. Place-marker numbers must be
-    in the range 1 to 99.
-*/
-QString QString::arg(QStringView a, int fieldWidth, QChar fillChar) const
-{
-    ArgEscapeData d = findArgEscapes(*this);
-
-    if (Q_UNLIKELY(d.occurrences == 0)) {
-        qWarning("QString::arg: Argument missing: %ls, %ls", qUtf16Printable(*this),
-                  qUtf16Printable(a.toString()));
-        return *this;
-    }
-    return replaceArgEscapes(*this, d, fieldWidth, a, a, fillChar);
-}
-
-/*!
-    \overload
-    \since 5.10
-
-    Returns a copy of this string with the lowest-numbered place-marker
-    replaced by string \a a, i.e., \c %1, \c %2, ..., \c %99.
-
-    \a fieldWidth specifies the minimum amount of space that \a a
-    shall occupy. If \a a requires less space than \a fieldWidth, it
-    is padded to \a fieldWidth with character \a fillChar.  A positive
-    \a fieldWidth produces right-aligned text. A negative \a fieldWidth
-    produces left-aligned text.
-
-    One advantage of using arg() over asprintf() is that the order of the
-    numbered place markers can change, if the application's strings are
-    translated into other languages, but each arg() will still replace
-    the lowest-numbered unreplaced place-marker, no matter where it
-    appears. Also, if place-marker \c %i appears more than once in the
-    string, arg() replaces all of them.
-
-    If there is no unreplaced place-marker remaining, a warning message
-    is printed and the result is undefined. Place-marker numbers must be
-    in the range 1 to 99.
-*/
-QString QString::arg(QLatin1String a, int fieldWidth, QChar fillChar) const
-{
-    QVarLengthArray<ushort> utf16(a.size());
-    qt_from_latin1(utf16.data(), a.data(), a.size());
-    return arg(QStringView(utf16.data(), utf16.size()), fieldWidth, fillChar);
-}
-
-/*!
-  \fn QString QString::arg(const QString& a1, const QString& a2) const
-  \overload arg()
-
-  This is the same as \c {str.arg(a1).arg(a2)}, except that the
-  strings \a a1 and \a a2 are replaced in one pass. This can make a
-  difference if \a a1 contains e.g. \c{%1}:
-
-  \snippet qstring/main.cpp 13
-
-  A similar problem occurs when the numbered place markers are not
-  white space separated:
-
-  \snippet qstring/main.cpp 12
-  \snippet qstring/main.cpp 97
-
-  Let's look at the substitutions:
-  \list
-  \li First, \c Hello replaces \c {%1} so the string becomes \c {"Hello%3%2"}.
-  \li Then, \c 20 replaces \c {%2} so the string becomes \c {"Hello%320"}.
-  \li Since the maximum numbered place marker value is 99, \c 50 replaces \c {%32}.
-  \endlist
-  Thus the string finally becomes \c {"Hello500"}.
-
-  In such cases, the following yields the expected results:
-
-  \snippet qstring/main.cpp 12
-  \snippet qstring/main.cpp 98
-*/
-
-/*!
-  \fn QString QString::arg(const QString& a1, const QString& a2, const QString& a3) const
-  \overload arg()
-
-  This is the same as calling \c str.arg(a1).arg(a2).arg(a3), except
-  that the strings \a a1, \a a2 and \a a3 are replaced in one pass.
-*/
-
-/*!
-  \fn QString QString::arg(const QString& a1, const QString& a2, const QString& a3, const QString& a4) const
-  \overload arg()
-
-  This is the same as calling \c
-  {str.arg(a1).arg(a2).arg(a3).arg(a4)}, except that the strings \a
-  a1, \a a2, \a a3 and \a a4 are replaced in one pass.
-*/
-
-/*!
-  \fn QString QString::arg(const QString& a1, const QString& a2, const QString& a3, const QString& a4, const QString& a5) const
-  \overload arg()
-
-  This is the same as calling \c
-  {str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5)}, except that the strings
-  \a a1, \a a2, \a a3, \a a4, and \a a5 are replaced in one pass.
-*/
-
-/*!
-  \fn QString QString::arg(const QString& a1, const QString& a2, const QString& a3, const QString& a4, const QString& a5, const QString& a6) const
-  \overload arg()
-
-  This is the same as calling \c
-  {str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5).arg(a6))}, except that
-  the strings \a a1, \a a2, \a a3, \a a4, \a a5, and \a a6 are
-  replaced in one pass.
-*/
-
-/*!
-  \fn QString QString::arg(const QString& a1, const QString& a2, const QString& a3, const QString& a4, const QString& a5, const QString& a6, const QString& a7) const
-  \overload arg()
-
-  This is the same as calling \c
-  {str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5).arg(a6).arg(a7)},
-  except that the strings \a a1, \a a2, \a a3, \a a4, \a a5, \a a6,
-  and \a a7 are replaced in one pass.
-*/
-
-/*!
-  \fn QString QString::arg(const QString& a1, const QString& a2, const QString& a3, const QString& a4, const QString& a5, const QString& a6, const QString& a7, const QString& a8) const
-  \overload arg()
-
-  This is the same as calling \c
-  {str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5).arg(a6).arg(a7).arg(a8)},
-  except that the strings \a a1, \a a2, \a a3, \a a4, \a a5, \a a6, \a
-  a7, and \a a8 are replaced in one pass.
-*/
-
-/*!
-  \fn QString QString::arg(const QString& a1, const QString& a2, const QString& a3, const QString& a4, const QString& a5, const QString& a6, const QString& a7, const QString& a8, const QString& a9) const
-  \overload arg()
-
-  This is the same as calling \c
-  {str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5).arg(a6).arg(a7).arg(a8).arg(a9)},
-  except that the strings \a a1, \a a2, \a a3, \a a4, \a a5, \a a6, \a
-  a7, \a a8, and \a a9 are replaced in one pass.
-*/
-
-/*! \fn QString QString::arg(int a, int fieldWidth, int base, QChar fillChar) const
-  \overload arg()
-
-  The \a a argument is expressed in base \a base, which is 10 by
-  default and must be between 2 and 36. For bases other than 10, \a a
-  is treated as an unsigned integer.
-
-  \a fieldWidth specifies the minimum amount of space that \a a is
-  padded to and filled with the character \a fillChar. A positive
-  value produces right-aligned text; a negative value produces
-  left-aligned text.
-
-  The '%' can be followed by an 'L', in which case the sequence is
-  replaced with a localized representation of \a a. The conversion
-  uses the default locale, set by QLocale::setDefault(). If no default
-  locale was specified, the "C" locale is used. The 'L' flag is
-  ignored if \a base is not 10.
-
-  \snippet qstring/main.cpp 12
-  \snippet qstring/main.cpp 14
-
-  If \a fillChar is '0' (the number 0, ASCII 48), the locale's zero is
-  used. For negative numbers, zero padding might appear before the
-  minus sign.
-*/
-
-/*! \fn QString QString::arg(uint a, int fieldWidth, int base, QChar fillChar) const
-  \overload arg()
-
-  The \a base argument specifies the base to use when converting the
-  integer \a a into a string. The base must be between 2 and 36.
-
-  If \a fillChar is '0' (the number 0, ASCII 48), the locale's zero is
-  used. For negative numbers, zero padding might appear before the
-  minus sign.
-*/
-
-/*! \fn QString QString::arg(long a, int fieldWidth, int base, QChar fillChar) const
-  \overload arg()
-
-  \a fieldWidth specifies the minimum amount of space that \a a is
-  padded to and filled with the character \a fillChar. A positive
-  value produces right-aligned text; a negative value produces
-  left-aligned text.
-
-  The \a a argument is expressed in the given \a base, which is 10 by
-  default and must be between 2 and 36.
-
-  The '%' can be followed by an 'L', in which case the sequence is
-  replaced with a localized representation of \a a. The conversion
-  uses the default locale. The default locale is determined from the
-  system's locale settings at application startup. It can be changed
-  using QLocale::setDefault(). The 'L' flag is ignored if \a base is
-  not 10.
-
-  \snippet qstring/main.cpp 12
-  \snippet qstring/main.cpp 14
-
-  If \a fillChar is '0' (the number 0, ASCII 48), the locale's zero is
-  used. For negative numbers, zero padding might appear before the
-  minus sign.
-*/
-
-/*! \fn QString QString::arg(ulong a, int fieldWidth, int base, QChar fillChar) const
-  \overload arg()
-
-  \a fieldWidth specifies the minimum amount of space that \a a is
-  padded to and filled with the character \a fillChar. A positive
-  value produces right-aligned text; a negative value produces
-  left-aligned text.
-
-  The \a base argument specifies the base to use when converting the
-  integer \a a to a string. The base must be between 2 and 36, with 8
-  giving octal, 10 decimal, and 16 hexadecimal numbers.
-
-  If \a fillChar is '0' (the number 0, ASCII 48), the locale's zero is
-  used. For negative numbers, zero padding might appear before the
-  minus sign.
-*/
-
-/*!
-  \overload arg()
-
-  \a fieldWidth specifies the minimum amount of space that \a a is
-  padded to and filled with the character \a fillChar. A positive
-  value produces right-aligned text; a negative value produces
-  left-aligned text.
-
-  The \a base argument specifies the base to use when converting the
-  integer \a a into a string. The base must be between 2 and 36, with
-  8 giving octal, 10 decimal, and 16 hexadecimal numbers.
-
-  If \a fillChar is '0' (the number 0, ASCII 48), the locale's zero is
-  used. For negative numbers, zero padding might appear before the
-  minus sign.
-*/
-QString QString::arg(qlonglong a, int fieldWidth, int base, QChar fillChar) const
-{
-    ArgEscapeData d = findArgEscapes(*this);
-
-    if (d.occurrences == 0) {
-        qWarning() << "QString::arg: Argument missing:" << *this << ',' << a;
-        return *this;
-    }
-
-    unsigned flags = QLocaleData::NoFlags;
-    if (fillChar == QLatin1Char('0'))
-        flags = QLocaleData::ZeroPadded;
-
-    QString arg;
-    if (d.occurrences > d.locale_occurrences)
-        arg = QLocaleData::c()->longLongToString(a, -1, base, fieldWidth, flags);
-
-    QString locale_arg;
-    if (d.locale_occurrences > 0) {
-        QLocale locale;
-        if (!(locale.numberOptions() & QLocale::OmitGroupSeparator))
-            flags |= QLocaleData::ThousandsGroup;
-        locale_arg = locale.d->m_data->longLongToString(a, -1, base, fieldWidth, flags);
-    }
-
-    return replaceArgEscapes(*this, d, fieldWidth, arg, locale_arg, fillChar);
-}
-
-/*!
-  \overload arg()
-
-  \a fieldWidth specifies the minimum amount of space that \a a is
-  padded to and filled with the character \a fillChar. A positive
-  value produces right-aligned text; a negative value produces
-  left-aligned text.
-
-  The \a base argument specifies the base to use when converting the
-  integer \a a into a string. \a base must be between 2 and 36, with 8
-  giving octal, 10 decimal, and 16 hexadecimal numbers.
-
-  If \a fillChar is '0' (the number 0, ASCII 48), the locale's zero is
-  used. For negative numbers, zero padding might appear before the
-  minus sign.
-*/
-QString QString::arg(qulonglong a, int fieldWidth, int base, QChar fillChar) const
-{
-    ArgEscapeData d = findArgEscapes(*this);
-
-    if (d.occurrences == 0) {
-        qWarning() << "QString::arg: Argument missing:" << *this << ',' << a;
-        return *this;
-    }
-
-    unsigned flags = QLocaleData::NoFlags;
-    if (fillChar == QLatin1Char('0'))
-        flags = QLocaleData::ZeroPadded;
-
-    QString arg;
-    if (d.occurrences > d.locale_occurrences)
-        arg = QLocaleData::c()->unsLongLongToString(a, -1, base, fieldWidth, flags);
-
-    QString locale_arg;
-    if (d.locale_occurrences > 0) {
-        QLocale locale;
-        if (!(locale.numberOptions() & QLocale::OmitGroupSeparator))
-            flags |= QLocaleData::ThousandsGroup;
-        locale_arg = locale.d->m_data->unsLongLongToString(a, -1, base, fieldWidth, flags);
-    }
-
-    return replaceArgEscapes(*this, d, fieldWidth, arg, locale_arg, fillChar);
-}
-
-/*!
-  \overload arg()
-
-  \fn QString QString::arg(short a, int fieldWidth, int base, QChar fillChar) const
-
-  \a fieldWidth specifies the minimum amount of space that \a a is
-  padded to and filled with the character \a fillChar. A positive
-  value produces right-aligned text; a negative value produces
-  left-aligned text.
-
-  The \a base argument specifies the base to use when converting the
-  integer \a a into a string. The base must be between 2 and 36, with
-  8 giving octal, 10 decimal, and 16 hexadecimal numbers.
-
-  If \a fillChar is '0' (the number 0, ASCII 48), the locale's zero is
-  used. For negative numbers, zero padding might appear before the
-  minus sign.
-*/
-
-/*!
-  \fn QString QString::arg(ushort a, int fieldWidth, int base, QChar fillChar) const
-  \overload arg()
-
-  \a fieldWidth specifies the minimum amount of space that \a a is
-  padded to and filled with the character \a fillChar. A positive
-  value produces right-aligned text; a negative value produces
-  left-aligned text.
-
-  The \a base argument specifies the base to use when converting the
-  integer \a a into a string. The base must be between 2 and 36, with
-  8 giving octal, 10 decimal, and 16 hexadecimal numbers.
-
-  If \a fillChar is '0' (the number 0, ASCII 48), the locale's zero is
-  used. For negative numbers, zero padding might appear before the
-  minus sign.
-*/
-
-/*!
-    \overload arg()
-*/
-QString QString::arg(QChar a, int fieldWidth, QChar fillChar) const
-{
-    QString c;
-    c += a;
-    return arg(c, fieldWidth, fillChar);
-}
-
-/*!
-  \overload arg()
-
-  The \a a argument is interpreted as a Latin-1 character.
-*/
-QString QString::arg(char a, int fieldWidth, QChar fillChar) const
-{
-    QString c;
-    c += QLatin1Char(a);
-    return arg(c, fieldWidth, fillChar);
-}
-
-/*!
-  \fn QString QString::arg(double a, int fieldWidth, char format, int precision, QChar fillChar) const
-  \overload arg()
-
-  Argument \a a is formatted according to the specified \a format and
-  \a precision. See \l{Argument Formats} for details.
-
-  \a fieldWidth specifies the minimum amount of space that \a a is
-  padded to and filled with the character \a fillChar.  A positive
-  value produces right-aligned text; a negative value produces
-  left-aligned text.
-
-  \snippet code/src_corelib_tools_qstring.cpp 2
-
-  The '%' can be followed by an 'L', in which case the sequence is
-  replaced with a localized representation of \a a. The conversion
-  uses the default locale, set by QLocale::setDefault(). If no
-  default locale was specified, the "C" locale is used.
-
-  If \a fillChar is '0' (the number 0, ASCII 48), this function will
-  use the locale's zero to pad. For negative numbers, the zero padding
-  will probably appear before the minus sign.
-
-  \sa QLocale::toString()
-*/
-QString QString::arg(double a, int fieldWidth, char fmt, int prec, QChar fillChar) const
-{
-    ArgEscapeData d = findArgEscapes(*this);
-
-    if (d.occurrences == 0) {
-        qWarning("QString::arg: Argument missing: %s, %g", toLocal8Bit().data(), a);
-        return *this;
-    }
-
-    unsigned flags = QLocaleData::NoFlags;
-    if (fillChar == QLatin1Char('0'))
-        flags |= QLocaleData::ZeroPadded;
-
-    if (qIsUpper(fmt))
-        flags |= QLocaleData::CapitalEorX;
-
-    QLocaleData::DoubleForm form = QLocaleData::DFDecimal;
-    switch (qToLower(fmt)) {
-    case 'f':
-        form = QLocaleData::DFDecimal;
-        break;
-    case 'e':
-        form = QLocaleData::DFExponent;
-        break;
-    case 'g':
-        form = QLocaleData::DFSignificantDigits;
-        break;
-    default:
-#if defined(QT_CHECK_RANGE)
-        qWarning("QString::arg: Invalid format char '%c'", fmt);
-#endif
-        break;
-    }
-
-    QString arg;
-    if (d.occurrences > d.locale_occurrences)
-        arg = QLocaleData::c()->doubleToString(a, prec, form, fieldWidth, flags | QLocaleData::ZeroPadExponent);
-
-    QString locale_arg;
-    if (d.locale_occurrences > 0) {
-        QLocale locale;
-
-        const QLocale::NumberOptions numberOptions = locale.numberOptions();
-        if (!(numberOptions & QLocale::OmitGroupSeparator))
-            flags |= QLocaleData::ThousandsGroup;
-        if (!(numberOptions & QLocale::OmitLeadingZeroInExponent))
-            flags |= QLocaleData::ZeroPadExponent;
-        if (numberOptions & QLocale::IncludeTrailingZeroesAfterDot)
-            flags |= QLocaleData::AddTrailingZeroes;
-        locale_arg = locale.d->m_data->doubleToString(a, prec, form, fieldWidth, flags);
-    }
-
-    return replaceArgEscapes(*this, d, fieldWidth, arg, locale_arg, fillChar);
-}
-
-static inline ushort to_unicode(const QChar c) { return c.unicode(); }
-static inline ushort to_unicode(const char c) { return QLatin1Char{c}.unicode(); }
-
-template <typename Char>
-static int getEscape(const Char *uc, qsizetype *pos, qsizetype len, int maxNumber = 999)
-{
-    int i = *pos;
-    ++i;
-    if (i < len && uc[i] == QLatin1Char('L'))
-        ++i;
-    if (i < len) {
-        int escape = to_unicode(uc[i]) - '0';
-        if (uint(escape) >= 10U)
-            return -1;
-        ++i;
-        while (i < len) {
-            int digit = to_unicode(uc[i]) - '0';
-            if (uint(digit) >= 10U)
-                break;
-            escape = (escape * 10) + digit;
-            ++i;
-        }
-        if (escape <= maxNumber) {
-            *pos = i;
-            return escape;
-        }
-    }
-    return -1;
-}
-
-/*
-    Algorithm for multiArg:
-
-    1. Parse the string as a sequence of verbatim text and placeholders (%L?\d{,3}).
-       The L is parsed and accepted for compatibility with non-multi-arg, but since
-       multiArg only accepts strings as replacements, the localization request can
-       be safely ignored.
-    2. The result of step (1) is a list of (string-ref,int)-tuples. The string-ref
-       either points at text to be copied verbatim (in which case the int is -1),
-       or, initially, at the textual representation of the placeholder. In that case,
-       the int contains the numerical number as parsed from the placeholder.
-    3. Next, collect all the non-negative ints found, sort them in ascending order and
-       remove duplicates.
-       3a. If the result has more entires than multiArg() was given replacement strings,
-           we have found placeholders we can't satisfy with replacement strings. That is
-           fine (there could be another .arg() call coming after this one), so just
-           truncate the result to the number of actual multiArg() replacement strings.
-       3b. If the result has less entries than multiArg() was given replacement strings,
-           the string is missing placeholders. This is an error that the user should be
-           warned about.
-    4. The result of step (3) is a mapping from the index of any replacement string to
-       placeholder number. This is the wrong way around, but since placeholder
-       numbers could get as large as 999, while we typically don't have more than 9
-       replacement strings, we trade 4K of sparsely-used memory for doing a reverse lookup
-       each time we need to map a placeholder number to a replacement string index
-       (that's a linear search; but still *much* faster than using an associative container).
-    5. Next, for each of the tuples found in step (1), do the following:
-       5a. If the int is negative, do nothing.
-       5b. Otherwise, if the int is found in the result of step (3) at index I, replace
-           the string-ref with a string-ref for the (complete) I'th replacement string.
-       5c. Otherwise, do nothing.
-    6. Concatenate all string refs into a single result string.
-*/
-
-namespace {
-struct Part
-{
-    Part() = default; // for QVarLengthArray; do not use
-    Q_DECL_CONSTEXPR Part(QStringView s, int num = -1)
-        : tag{QtPrivate::ArgBase::U16}, number{num}, data{s.utf16()}, size{s.size()} {}
-    Q_DECL_CONSTEXPR Part(QLatin1String s, int num = -1)
-        : tag{QtPrivate::ArgBase::L1}, number{num}, data{s.data()}, size{s.size()} {}
-
-    void reset(QStringView s) noexcept { *this = {s, number}; }
-    void reset(QLatin1String s) noexcept { *this = {s, number}; }
-
-    QtPrivate::ArgBase::Tag tag;
-    int number;
-    const void *data;
-    qsizetype size;
-};
-} // unnamed namespace
-
-Q_DECLARE_TYPEINFO(Part, Q_PRIMITIVE_TYPE);
-
-namespace {
-
-enum { ExpectedParts = 32 };
-
-typedef QVarLengthArray<Part, ExpectedParts> ParseResult;
-typedef QVarLengthArray<int, ExpectedParts/2> ArgIndexToPlaceholderMap;
-
-template <typename StringView>
-static ParseResult parseMultiArgFormatString(StringView s)
-{
-    ParseResult result;
-
-    const auto uc = s.data();
-    const auto len = s.size();
-    const auto end = len - 1;
-    qsizetype i = 0;
-    qsizetype last = 0;
-
-    while (i < end) {
-        if (uc[i] == QLatin1Char('%')) {
-            qsizetype percent = i;
-            int number = getEscape(uc, &i, len);
-            if (number != -1) {
-                if (last != percent)
-                    result.push_back(Part{s.mid(last, percent - last)}); // literal text (incl. failed placeholders)
-                result.push_back(Part{s.mid(percent, i - percent), number});  // parsed placeholder
-                last = i;
-                continue;
-            }
-        }
-        ++i;
-    }
-
-    if (last < len)
-        result.push_back(Part{s.mid(last, len - last)}); // trailing literal text
-
-    return result;
-}
-
-static ArgIndexToPlaceholderMap makeArgIndexToPlaceholderMap(const ParseResult &parts)
-{
-    ArgIndexToPlaceholderMap result;
-
-    for (Part part : parts) {
-        if (part.number >= 0)
-            result.push_back(part.number);
-    }
-
-    std::sort(result.begin(), result.end());
-    result.erase(std::unique(result.begin(), result.end()),
-                 result.end());
-
-    return result;
-}
-
-static qsizetype resolveStringRefsAndReturnTotalSize(ParseResult &parts, const ArgIndexToPlaceholderMap &argIndexToPlaceholderMap, const QtPrivate::ArgBase *args[])
-{
-    using namespace QtPrivate;
-    qsizetype totalSize = 0;
-    for (Part &part : parts) {
-        if (part.number != -1) {
-            const auto it = std::find(argIndexToPlaceholderMap.begin(), argIndexToPlaceholderMap.end(), part.number);
-            if (it != argIndexToPlaceholderMap.end()) {
-                const auto &arg = *args[it - argIndexToPlaceholderMap.begin()];
-                switch (arg.tag) {
-                case ArgBase::L1:
-                    part.reset(static_cast<const QLatin1StringArg&>(arg).string);
-                    break;
-                case ArgBase::U8:
-                    Q_UNREACHABLE(); // waiting for QUtf8String...
-                    break;
-                case ArgBase::U16:
-                    part.reset(static_cast<const QStringViewArg&>(arg).string);
-                    break;
-                }
-            }
-        }
-        totalSize += part.size;
-    }
-    return totalSize;
-}
-
-} // unnamed namespace
-
-#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
-QString QString::multiArg(int numArgs, const QString **args) const
-{
-    QVarLengthArray<QtPrivate::QStringViewArg, 9> sva;
-    sva.reserve(numArgs);
-    QVarLengthArray<const QtPrivate::ArgBase *, 9> pointers;
-    pointers.reserve(numArgs);
-    for (int i = 0; i < numArgs; ++i) {
-        sva.push_back(QtPrivate::qStringLikeToArg(*args[i]));
-        pointers.push_back(&sva.back());
-    }
-    return QtPrivate::argToQString(qToStringViewIgnoringNull(*this), static_cast<size_t>(numArgs), pointers.data());
-}
-#endif
-
-Q_ALWAYS_INLINE QString to_string(QLatin1String s) noexcept { return s; }
-Q_ALWAYS_INLINE QString to_string(QStringView s) noexcept { return s.toString(); }
-
-template <typename StringView>
-static QString argToQStringImpl(StringView pattern, size_t numArgs, const QtPrivate::ArgBase **args)
-{
-    // Step 1-2 above
-    ParseResult parts = parseMultiArgFormatString(pattern);
-
-    // 3-4
-    ArgIndexToPlaceholderMap argIndexToPlaceholderMap = makeArgIndexToPlaceholderMap(parts);
-
-    if (static_cast<size_t>(argIndexToPlaceholderMap.size()) > numArgs) // 3a
-        argIndexToPlaceholderMap.resize(int(numArgs));
-    else if (Q_UNLIKELY(static_cast<size_t>(argIndexToPlaceholderMap.size()) < numArgs)) // 3b
-        qWarning("QString::arg: %d argument(s) missing in %ls",
-                 int(numArgs - argIndexToPlaceholderMap.size()), qUtf16Printable(to_string(pattern)));
-
-    // 5
-    const qsizetype totalSize = resolveStringRefsAndReturnTotalSize(parts, argIndexToPlaceholderMap, args);
-
-    // 6:
-    QString result(totalSize, Qt::Uninitialized);
-    auto out = const_cast<QChar*>(result.constData());
-
-    for (Part part : parts) {
-        switch (part.tag) {
-        case QtPrivate::ArgBase::L1:
-            if (part.size) {
-                qt_from_latin1(reinterpret_cast<ushort*>(out),
-                               reinterpret_cast<const char*>(part.data), part.size);
-            }
-            break;
-        case QtPrivate::ArgBase::U8:
-            Q_UNREACHABLE(); // waiting for QUtf8String
-            break;
-        case QtPrivate::ArgBase::U16:
-            if (part.size)
-                memcpy(out, part.data, part.size * sizeof(QChar));
-            break;
-        }
-        out += part.size;
-    }
-
-    return result;
-}
-
-QString QtPrivate::argToQString(QStringView pattern, size_t n, const ArgBase **args)
-{
-    return argToQStringImpl(pattern, n, args);
-}
-
-QString QtPrivate::argToQString(QLatin1String pattern, size_t n, const ArgBase **args)
-{
-    return argToQStringImpl(pattern, n, args);
-}
-
-/*! \fn bool QString::isSimpleText() const
-
-    \internal
-*/
-bool QString::isSimpleText() const
-{
-    const ushort *p = d->data();
-    const ushort * const end = p + d->size;
-    while (p < end) {
-        ushort uc = *p;
-        // sort out regions of complex text formatting
-        if (uc > 0x058f && (uc < 0x1100 || uc > 0xfb0f)) {
-            return false;
-        }
-        p++;
-    }
-
-    return true;
-}
-
-/*! \fn bool QString::isRightToLeft() const
-
-    Returns \c true if the string is read right to left.
-
-    \sa QStringRef::isRightToLeft()
-*/
-bool QString::isRightToLeft() const
-{
-    return QtPrivate::isRightToLeft(QStringView(*this));
-}
-
-/*! \fn QChar *QString::data()
-
-    Returns a pointer to the data stored in the QString. The pointer
-    can be used to access and modify the characters that compose the
-    string.
-
-    Unlike constData() and unicode(), the returned data is always
-    '\\0'-terminated.
-
-    Example:
-
-    \snippet qstring/main.cpp 19
-
-    Note that the pointer remains valid only as long as the string is
-    not modified by other means. For read-only access, constData() is
-    faster because it never causes a \l{deep copy} to occur.
-
-    \sa constData(), operator[]()
-*/
-
-/*! \fn const QChar *QString::data() const
-
-    \overload
-
-    \note The returned string may not be '\\0'-terminated.
-    Use size() to determine the length of the array.
-
-    \sa fromRawData()
-*/
-
-/*! \fn const QChar *QString::constData() const
-
-    Returns a pointer to the data stored in the QString. The pointer
-    can be used to access the characters that compose the string.
-
-    Note that the pointer remains valid only as long as the string is
-    not modified.
-
-    \note The returned string may not be '\\0'-terminated.
-    Use size() to determine the length of the array.
-
-    \sa data(), operator[](), fromRawData()
-*/
-
-/*! \fn void QString::push_front(const QString &other)
-
-    This function is provided for STL compatibility, prepending the
-    given \a other string to the beginning of this string. It is
-    equivalent to \c prepend(other).
-
-    \sa prepend()
-*/
-
-/*! \fn void QString::push_front(QChar ch)
-
-    \overload
-
-    Prepends the given \a ch character to the beginning of this string.
-*/
-
-/*! \fn void QString::push_back(const QString &other)
-
-    This function is provided for STL compatibility, appending the
-    given \a other string onto the end of this string. It is
-    equivalent to \c append(other).
-
-    \sa append()
-*/
-
-/*! \fn void QString::push_back(QChar ch)
-
-    \overload
-
-    Appends the given \a ch character onto the end of this string.
-*/
-
-/*! \fn void QString::shrink_to_fit()
-    \since 5.10
-
-    This function is provided for STL compatibility. It is
-    equivalent to squeeze().
-
-    \sa squeeze()
-*/
-
-/*!
-    \fn std::string QString::toStdString() const
-
-    Returns a std::string object with the data contained in this
-    QString. The Unicode data is converted into 8-bit characters using
-    the toUtf8() function.
-
-    This method is mostly useful to pass a QString to a function
-    that accepts a std::string object.
-
-    \sa toLatin1(), toUtf8(), toLocal8Bit(), QByteArray::toStdString()
-*/
-
-/*!
-    Constructs a QString that uses the first \a size Unicode characters
-    in the array \a unicode. The data in \a unicode is \e not
-    copied. The caller must be able to guarantee that \a unicode will
-    not be deleted or modified as long as the QString (or an
-    unmodified copy of it) exists.
-
-    Any attempts to modify the QString or copies of it will cause it
-    to create a deep copy of the data, ensuring that the raw data
-    isn't modified.
-
-    Here is an example of how we can use a QRegularExpression on raw data in
-    memory without requiring to copy the data into a QString:
-
-    \snippet qstring/main.cpp 22
-    \snippet qstring/main.cpp 23
-
-    \warning A string created with fromRawData() is \e not
-    '\\0'-terminated, unless the raw data contains a '\\0' character
-    at position \a size. This means unicode() will \e not return a
-    '\\0'-terminated string (although utf16() does, at the cost of
-    copying the raw data).
-
-    \sa fromUtf16(), setRawData()
-*/
-QString QString::fromRawData(const QChar *unicode, int size)
-{
-    Data *x;
-    if (!unicode) {
-        x = Data::sharedNull();
-    } else if (!size) {
-        x = Data::allocate(0);
-    } else {
-        x = Data::fromRawData(reinterpret_cast<const ushort *>(unicode), size);
-        Q_CHECK_PTR(x);
-    }
-    QStringDataPtr dataPtr = { x };
-    return QString(dataPtr);
-}
-
-/*!
-    \since 4.7
-
-    Resets the QString to use the first \a size Unicode characters
-    in the array \a unicode. The data in \a unicode is \e not
-    copied. The caller must be able to guarantee that \a unicode will
-    not be deleted or modified as long as the QString (or an
-    unmodified copy of it) exists.
-
-    This function can be used instead of fromRawData() to re-use
-    existings QString objects to save memory re-allocations.
-
-    \sa fromRawData()
-*/
-QString &QString::setRawData(const QChar *unicode, int size)
-{
-    if (d->ref.isShared() || d->alloc) {
-        *this = fromRawData(unicode, size);
-    } else {
-        if (unicode) {
-            d->size = size;
-            d->offset = reinterpret_cast<const char *>(unicode) - reinterpret_cast<char *>(d);
-        } else {
-            d->offset = sizeof(QStringData);
-            d->size = 0;
-        }
-    }
-    return *this;
-}
-
-/*! \fn QString QString::fromStdU16String(const std::u16string &str)
-    \since 5.5
-
-    Returns a copy of the \a str string. The given string is assumed
-    to be encoded in UTF-16.
-
-    \sa fromUtf16(), fromStdWString(), fromStdU32String()
-*/
-
-/*!
-    \fn std::u16string QString::toStdU16String() const
-    \since 5.5
-
-    Returns a std::u16string object with the data contained in this
-    QString. The Unicode data is the same as returned by the utf16()
-    method.
-
-    \sa utf16(), toStdWString(), toStdU32String()
-*/
-
-/*! \fn QString QString::fromStdU32String(const std::u32string &str)
-    \since 5.5
-
-    Returns a copy of the \a str string. The given string is assumed
-    to be encoded in UCS-4.
-
-    \sa fromUcs4(), fromStdWString(), fromStdU16String()
-*/
-
-/*!
-    \fn std::u32string QString::toStdU32String() const
-    \since 5.5
-
-    Returns a std::u32string object with the data contained in this
-    QString. The Unicode data is the same as returned by the toUcs4()
-    method.
-
-    \sa toUcs4(), toStdWString(), toStdU16String()
-*/
-
-/*! \class QLatin1String
-    \inmodule QtCore
-    \brief The QLatin1String class provides a thin wrapper around an US-ASCII/Latin-1 encoded string literal.
-
-    \ingroup string-processing
-    \reentrant
-
-    Many of QString's member functions are overloaded to accept
-    \c{const char *} instead of QString. This includes the copy
-    constructor, the assignment operator, the comparison operators,
-    and various other functions such as \l{QString::insert()}{insert()}, \l{QString::replace()}{replace()},
-    and \l{QString::indexOf()}{indexOf()}. These functions
-    are usually optimized to avoid constructing a QString object for
-    the \c{const char *} data. For example, assuming \c str is a
-    QString,
-
-    \snippet code/src_corelib_tools_qstring.cpp 3
-
-    is much faster than
-
-    \snippet code/src_corelib_tools_qstring.cpp 4
-
-    because it doesn't construct four temporary QString objects and
-    make a deep copy of the character data.
-
-    Applications that define \c QT_NO_CAST_FROM_ASCII (as explained
-    in the QString documentation) don't have access to QString's
-    \c{const char *} API. To provide an efficient way of specifying
-    constant Latin-1 strings, Qt provides the QLatin1String, which is
-    just a very thin wrapper around a \c{const char *}. Using
-    QLatin1String, the example code above becomes
-
-    \snippet code/src_corelib_tools_qstring.cpp 5
-
-    This is a bit longer to type, but it provides exactly the same
-    benefits as the first version of the code, and is faster than
-    converting the Latin-1 strings using QString::fromLatin1().
-
-    Thanks to the QString(QLatin1String) constructor,
-    QLatin1String can be used everywhere a QString is expected. For
-    example:
-
-    \snippet code/src_corelib_tools_qstring.cpp 6
-
-    \note If the function you're calling with a QLatin1String
-    argument isn't actually overloaded to take QLatin1String, the
-    implicit conversion to QString will trigger a memory allocation,
-    which is usually what you want to avoid by using QLatin1String
-    in the first place. In those cases, using QStringLiteral may be
-    the better option.
-
-    \sa QString, QLatin1Char, {QStringLiteral()}{QStringLiteral}, QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \typedef QLatin1String::value_type
-    \since 5.10
-
-    Alias for \c{const char}. Provided for compatibility with the STL.
-*/
-
-/*!
-    \typedef QLatin1String::difference_type
-    \since 5.10
-
-    Alias for \c{int}. Provided for compatibility with the STL.
-*/
-
-/*!
-    \typedef QLatin1String::size_type
-    \since 5.10
-
-    Alias for \c{int}. Provided for compatibility with the STL.
-*/
-
-/*!
-    \typedef QLatin1String::reference
-    \since 5.10
-
-    Alias for \c{value_type &}. Provided for compatibility with the STL.
-*/
-
-/*!
-    \typedef QLatin1String::const_reference
-    \since 5.11
-
-    Alias for \c{reference}. Provided for compatibility with the STL.
-*/
-
-/*!
-    \typedef QLatin1String::iterator
-    \since 5.10
-
-    This typedef provides an STL-style const iterator for QLatin1String.
-
-    QLatin1String does not support mutable iterators, so this is the same
-    as const_iterator.
-
-    \sa const_iterator, reverse_iterator
-*/
-
-/*!
-    \typedef QLatin1String::const_iterator
-    \since 5.10
-
-    This typedef provides an STL-style const iterator for QLatin1String.
-
-    \sa iterator, const_reverse_iterator
-*/
-
-/*!
-    \typedef QLatin1String::reverse_iterator
-    \since 5.10
-
-    This typedef provides an STL-style const reverse iterator for QLatin1String.
-
-    QLatin1String does not support mutable reverse iterators, so this is the
-    same as const_reverse_iterator.
-
-    \sa const_reverse_iterator, iterator
-*/
-
-/*!
-    \typedef QLatin1String::const_reverse_iterator
-    \since 5.10
-
-    This typedef provides an STL-style const reverse iterator for QLatin1String.
-
-    \sa reverse_iterator, const_iterator
-*/
-
-/*! \fn QLatin1String::QLatin1String()
-    \since 5.6
-
-    Constructs a QLatin1String object that stores a nullptr.
-*/
-
-/*! \fn QLatin1String::QLatin1String(const char *str)
-
-    Constructs a QLatin1String object that stores \a str.
-
-    The string data is \e not copied. The caller must be able to
-    guarantee that \a str will not be deleted or modified as long as
-    the QLatin1String object exists.
-
-    \sa latin1()
-*/
-
-/*! \fn QLatin1String::QLatin1String(const char *str, int size)
-
-    Constructs a QLatin1String object that stores \a str with \a size.
-
-    The string data is \e not copied. The caller must be able to
-    guarantee that \a str will not be deleted or modified as long as
-    the QLatin1String object exists.
-
-    \sa latin1()
-*/
-
-/*!
-    \fn QLatin1String::QLatin1String(const char *first, const char *last)
-    \since 5.10
-
-    Constructs a QLatin1String object that stores \a first with length
-    (\a last - \a first).
-
-    The range \c{[first,last)} must remain valid for the lifetime of
-    this Latin-1 string object.
-
-    Passing \nullptr as \a first is safe if \a last is \nullptr,
-    too, and results in a null Latin-1 string.
-
-    The behavior is undefined if \a last precedes \a first, \a first
-    is \nullptr and \a last is not, or if \c{last - first >
-    INT_MAX}.
-*/
-
-/*! \fn QLatin1String::QLatin1String(const QByteArray &str)
-
-    Constructs a QLatin1String object that stores \a str.
-
-    The string data is \e not copied. The caller must be able to
-    guarantee that \a str will not be deleted or modified as long as
-    the QLatin1String object exists.
-
-    \sa latin1()
-*/
-
-/*! \fn const char *QLatin1String::latin1() const
-
-    Returns the Latin-1 string stored in this object.
-*/
-
-/*! \fn const char *QLatin1String::data() const
-
-    Returns the Latin-1 string stored in this object.
-*/
-
-/*! \fn int QLatin1String::size() const
-
-    Returns the size of the Latin-1 string stored in this object.
-*/
-
-/*! \fn bool QLatin1String::isNull() const
-    \since 5.10
-
-    Returns whether the Latin-1 string stored in this object is null
-    (\c{data() == nullptr}) or not.
-
-    \sa isEmpty(), data()
-*/
-
-/*! \fn bool QLatin1String::isEmpty() const
-    \since 5.10
-
-    Returns whether the Latin-1 string stored in this object is empty
-    (\c{size() == 0}) or not.
-
-    \sa isNull(), size()
-*/
-
-/*! \fn QLatin1Char QLatin1String::at(int pos) const
-    \since 5.8
-
-    Returns the character at position \a pos in this object.
-
-    \note This function performs no error checking.
-    The behavior is undefined when \a pos < 0 or \a pos >= size().
-
-    \sa operator[]()
-*/
-
-/*! \fn QLatin1Char QLatin1String::operator[](int pos) const
-    \since 5.8
-
-    Returns the character at position \a pos in this object.
-
-    \note This function performs no error checking.
-    The behavior is undefined when \a pos < 0 or \a pos >= size().
-
-    \sa at()
-*/
-
-/*!
-    \fn QLatin1Char QLatin1String::front() const
-    \since 5.10
-
-    Returns the first character in the string.
-    Same as \c{at(0)}.
-
-    This function is provided for STL compatibility.
-
-    \warning Calling this function on an empty string constitutes
-    undefined behavior.
-
-    \sa back(), at(), operator[]()
-*/
-
-/*!
-    \fn QLatin1Char QLatin1String::back() const
-    \since 5.10
-
-    Returns the last character in the string.
-    Same as \c{at(size() - 1)}.
-
-    This function is provided for STL compatibility.
-
-    \warning Calling this function on an empty string constitutes
-    undefined behavior.
-
-    \sa front(), at(), operator[]()
-*/
-
-/*!
-    \fn bool QLatin1String::startsWith(QStringView str, Qt::CaseSensitivity cs) const
-    \since 5.10
-    \fn bool QLatin1String::startsWith(QLatin1String l1, Qt::CaseSensitivity cs) const
-    \since 5.10
-    \fn bool QLatin1String::startsWith(QChar ch) const
-    \since 5.10
-    \fn bool QLatin1String::startsWith(QChar ch, Qt::CaseSensitivity cs) const
-    \since 5.10
-
-    Returns \c true if this Latin-1 string starts with string-view \a str,
-    Latin-1 string \a l1, or character \a ch, respectively;
-    otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (the default), the search is case-sensitive;
-    otherwise the search is case-insensitive.
-
-    \sa endsWith()
-*/
-
-/*!
-    \fn bool QLatin1String::endsWith(QStringView str, Qt::CaseSensitivity cs) const
-    \since 5.10
-    \fn bool QLatin1String::endsWith(QLatin1String l1, Qt::CaseSensitivity cs) const
-    \since 5.10
-    \fn bool QLatin1String::endsWith(QChar ch) const
-    \since 5.10
-    \fn bool QLatin1String::endsWith(QChar ch, Qt::CaseSensitivity cs) const
-    \since 5.10
-
-    Returns \c true if this Latin-1 string ends with string-view \a str,
-    Latin-1 string \a l1, or character \a ch, respectively;
-    otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (the default), the search is case-sensitive;
-    otherwise the search is case-insensitive.
-
-    \sa startsWith()
-*/
-
-/*!
-    \fn int QLatin1String::indexOf(QStringView str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \fn int QLatin1String::indexOf(QLatin1String l1, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \fn int QLatin1String::indexOf(QChar c, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \since 5.14
-
-    Returns the index position of the first occurrence of the string-view \a str,
-    Latin-1 string \a l1, or character \a ch, respectively, in this Latin-1 string,
-    searching forward from index position \a from. Returns -1 if \a str is not found.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case
-    sensitive; otherwise the search is case insensitive.
-
-    If \a from is -1, the search starts at the last character; if it is
-    -2, at the next to last character and so on.
-
-    \sa QString::indexOf()
-*/
-
-/*!
-    \fn bool QLatin1String::contains(QStringView str, Qt::CaseSensitivity cs) const
-    \fn bool QLatin1String::contains(QLatin1String l1, Qt::CaseSensitivity cs) const
-    \fn bool QLatin1String::contains(QChar c, Qt::CaseSensitivity cs) const
-    \since 5.14
-
-    Returns \c true if this Latin-1 string contains an occurrence of the string-view
-    \a str, Latin-1 string \a l1, or character \a ch; otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (the default), the search is
-    case-sensitive; otherwise the search is case-insensitive.
-
-    \sa indexOf(), QStringView::contains(), QStringView::indexOf(), QString::indexOf()
-*/
-
-/*!
-    \fn int QLatin1String::lastIndexOf(QStringView str, int from, Qt::CaseSensitivity cs) const
-    \fn int QLatin1String::lastIndexOf(QLatin1String l1, int from, Qt::CaseSensitivity cs) const
-    \fn int QLatin1String::lastIndexOf(QChar c, int from, Qt::CaseSensitivity cs) const
-    \since 5.14
-
-    Returns the index position of the last occurrence of the string-view \a str,
-    Latin-1 string \a l1, or character \a ch, respectively, in this Latin-1 string,
-    searching backward from index position \a from. If \a from is -1 (default),
-    the search starts at the last character; if \a from is -2, at the next to last
-    character and so on. Returns -1 if \a str is not found.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case
-    sensitive; otherwise the search is case insensitive.
-
-    \sa indexOf(), QStringView::lastIndexOf(), QStringView::indexOf(), QString::indexOf()
-*/
-
-/*!
-    \fn QLatin1String::const_iterator QLatin1String::begin() const
-    \since 5.10
-
-    Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the first character in
-    the string.
-
-    This function is provided for STL compatibility.
-
-    \sa end(), cbegin(), rbegin(), data()
-*/
-
-/*!
-    \fn QLatin1String::const_iterator QLatin1String::cbegin() const
-    \since 5.10
-
-    Same as begin().
-
-    This function is provided for STL compatibility.
-
-    \sa cend(), begin(), crbegin(), data()
-*/
-
-/*!
-    \fn QLatin1String::const_iterator QLatin1String::end() const
-    \since 5.10
-
-    Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the imaginary
-    character after the last character in the list.
-
-    This function is provided for STL compatibility.
-
-    \sa begin(), cend(), rend()
-*/
-
-/*! \fn QLatin1String::const_iterator QLatin1String::cend() const
-    \since 5.10
-
-    Same as end().
-
-    This function is provided for STL compatibility.
-
-    \sa cbegin(), end(), crend()
-*/
-
-/*!
-    \fn QLatin1String::const_reverse_iterator QLatin1String::rbegin() const
-    \since 5.10
-
-    Returns a const \l{STL-style iterators}{STL-style} reverse iterator pointing to the first
-    character in the string, in reverse order.
-
-    This function is provided for STL compatibility.
-
-    \sa rend(), crbegin(), begin()
-*/
-
-/*!
-    \fn QLatin1String::const_reverse_iterator QLatin1String::crbegin() const
-    \since 5.10
-
-    Same as rbegin().
-
-    This function is provided for STL compatibility.
-
-    \sa crend(), rbegin(), cbegin()
-*/
-
-/*!
-    \fn QLatin1String::const_reverse_iterator QLatin1String::rend() const
-    \since 5.10
-
-    Returns a \l{STL-style iterators}{STL-style} reverse iterator pointing to one past
-    the last character in the string, in reverse order.
-
-    This function is provided for STL compatibility.
-
-    \sa rbegin(), crend(), end()
-*/
-
-/*!
-    \fn QLatin1String::const_reverse_iterator QLatin1String::crend() const
-    \since 5.10
-
-    Same as rend().
-
-    This function is provided for STL compatibility.
-
-    \sa crbegin(), rend(), cend()
-*/
-
-/*! \fn QLatin1String QLatin1String::mid(int start) const
-    \since 5.8
-
-    Returns the substring starting at position \a start in this object,
-    and extending to the end of the string.
-
-    \note This function performs no error checking.
-    The behavior is undefined when \a start < 0 or \a start > size().
-
-    \sa left(), right(), chopped(), chop(), truncate()
-*/
-
-/*! \fn QLatin1String QLatin1String::mid(int start, int length) const
-    \since 5.8
-    \overload
-
-    Returns the substring of length \a length starting at position
-    \a start in this object.
-
-    \note This function performs no error checking.
-    The behavior is undefined when \a start < 0, \a length < 0,
-    or \a start + \a length > size().
-
-    \sa left(), right(), chopped(), chop(), truncate()
-*/
-
-/*! \fn QLatin1String QLatin1String::left(int length) const
-    \since 5.8
-
-    Returns the substring of length \a length starting at position
-    0 in this object.
-
-    \note This function performs no error checking.
-    The behavior is undefined when \a length < 0 or \a length > size().
-
-    \sa mid(), right(), chopped(), chop(), truncate()
-*/
-
-/*! \fn QLatin1String QLatin1String::right(int length) const
-    \since 5.8
-
-    Returns the substring of length \a length starting at position
-    size() - \a length in this object.
-
-    \note This function performs no error checking.
-    The behavior is undefined when \a length < 0 or \a length > size().
-
-    \sa mid(), left(), chopped(), chop(), truncate()
-*/
-
-/*!
-    \fn QLatin1String QLatin1String::chopped(int length) const
-    \since 5.10
-
-    Returns the substring of length size() - \a length starting at the
-    beginning of this object.
-
-    Same as \c{left(size() - length)}.
-
-    \note The behavior is undefined when \a length < 0 or \a length > size().
-
-    \sa mid(), left(), right(), chop(), truncate()
-*/
-
-/*!
-    \fn void QLatin1String::truncate(int length)
-    \since 5.10
-
-    Truncates this string to length \a length.
-
-    Same as \c{*this = left(length)}.
-
-    \note The behavior is undefined when \a length < 0 or \a length > size().
-
-    \sa mid(), left(), right(), chopped(), chop()
-*/
-
-/*!
-    \fn void QLatin1String::chop(int length)
-    \since 5.10
-
-    Truncates this string by \a length characters.
-
-    Same as \c{*this = left(size() - length)}.
-
-    \note The behavior is undefined when \a length < 0 or \a length > size().
-
-    \sa mid(), left(), right(), chopped(), truncate()
-*/
-
-/*!
-    \fn QLatin1String QLatin1String::trimmed() const
-    \since 5.10
-
-    Strips leading and trailing whitespace and returns the result.
-
-    Whitespace means any character for which QChar::isSpace() returns
-    \c true. This includes the ASCII characters '\\t', '\\n', '\\v',
-    '\\f', '\\r', and ' '.
-*/
-
-/*! \fn bool QLatin1String::operator==(const QString &other) const
-
-    Returns \c true if this string is equal to string \a other;
-    otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings with
-    QString::localeAwareCompare().
-*/
-
-/*!
-    \fn bool QLatin1String::operator==(const char *other) const
-    \since 4.3
-    \overload
-
-    The \a other const char pointer is converted to a QString using
-    the QString::fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QLatin1String::operator==(const QByteArray &other) const
-    \since 5.0
-    \overload
-
-    The \a other byte array is converted to a QString using
-    the QString::fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn bool QLatin1String::operator!=(const QString &other) const
-
-    Returns \c true if this string is not equal to string \a other;
-    otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings with
-    QString::localeAwareCompare().
-*/
-
-/*!
-    \fn bool QLatin1String::operator!=(const char *other) const
-    \since 4.3
-    \overload operator!=()
-
-    The \a other const char pointer is converted to a QString using
-    the QString::fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QLatin1String::operator!=(const QByteArray &other) const
-    \since 5.0
-    \overload operator!=()
-
-    The \a other byte array is converted to a QString using
-    the QString::fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QLatin1String::operator>(const QString &other) const
-
-    Returns \c true if this string is lexically greater than string \a
-    other; otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings with
-    QString::localeAwareCompare().
-*/
-
-/*!
-    \fn bool QLatin1String::operator>(const char *other) const
-    \since 4.3
-    \overload
-
-    The \a other const char pointer is converted to a QString using
-    the QString::fromUtf8() function.
-
-    You can disable this operator by defining \c QT_NO_CAST_FROM_ASCII
-    when you compile your applications. This can be useful if you want
-    to ensure that all user-visible strings go through QObject::tr(),
-    for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QLatin1String::operator>(const QByteArray &other) const
-    \since 5.0
-    \overload
-
-    The \a other const char pointer is converted to a QString using
-    the QString::fromUtf8() function.
-
-    You can disable this operator by defining \c QT_NO_CAST_FROM_ASCII
-    when you compile your applications. This can be useful if you want
-    to ensure that all user-visible strings go through QObject::tr(),
-    for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QLatin1String::operator<(const QString &other) const
-
-    Returns \c true if this string is lexically less than the \a other
-    string; otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings using the
-    QString::localeAwareCompare() function.
-*/
-
-/*!
-    \fn bool QLatin1String::operator<(const char *other) const
-    \since 4.3
-    \overload
-
-    The \a other const char pointer is converted to a QString using
-    the QString::fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QLatin1String::operator<(const QByteArray &other) const
-    \since 5.0
-    \overload
-
-    The \a other const char pointer is converted to a QString using
-    the QString::fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QLatin1String::operator>=(const QString &other) const
-
-    Returns \c true if this string is lexically greater than or equal
-    to string \a other; otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings with
-    QString::localeAwareCompare().
-*/
-
-/*!
-    \fn bool QLatin1String::operator>=(const char *other) const
-    \since 4.3
-    \overload
-
-    The \a other const char pointer is converted to a QString using
-    the QString::fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QLatin1String::operator>=(const QByteArray &other) const
-    \since 5.0
-    \overload
-
-    The \a other array is converted to a QString using
-    the QString::fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*! \fn bool QLatin1String::operator<=(const QString &other) const
-
-    Returns \c true if this string is lexically less than or equal
-    to string \a other; otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings with
-    QString::localeAwareCompare().
-*/
-
-/*!
-    \fn bool QLatin1String::operator<=(const char *other) const
-    \since 4.3
-    \overload
-
-    The \a other const char pointer is converted to a QString using
-    the QString::fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QLatin1String::operator<=(const QByteArray &other) const
-    \since 5.0
-    \overload
-
-    The \a other array is converted to a QString using
-    the QString::fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-
-/*! \fn bool operator==(QLatin1String s1, QLatin1String s2)
-   \relates QLatin1String
-
-   Returns \c true if string \a s1 is lexically equal to string \a s2; otherwise
-   returns \c false.
-*/
-/*! \fn bool operator!=(QLatin1String s1, QLatin1String s2)
-   \relates QLatin1String
-
-   Returns \c true if string \a s1 is lexically unequal to string \a s2; otherwise
-   returns \c false.
-*/
-/*! \fn bool operator<(QLatin1String s1, QLatin1String s2)
-   \relates QLatin1String
-
-   Returns \c true if string \a s1 is lexically smaller than string \a s2; otherwise
-   returns \c false.
-*/
-/*! \fn bool operator<=(QLatin1String s1, QLatin1String s2)
-   \relates QLatin1String
-
-   Returns \c true if string \a s1 is lexically smaller than or equal to string \a s2; otherwise
-   returns \c false.
-*/
-/*! \fn bool operator>(QLatin1String s1, QLatin1String s2)
-   \relates QLatin1String
-
-   Returns \c true if string \a s1 is lexically greater than string \a s2; otherwise
-   returns \c false.
-*/
-/*! \fn bool operator>=(QLatin1String s1, QLatin1String s2)
-   \relates QLatin1String
-
-   Returns \c true if string \a s1 is lexically greater than or equal to
-   string \a s2; otherwise returns \c false.
-*/
-
-
-#if !defined(QT_NO_DATASTREAM) || (defined(QT_BOOTSTRAPPED) && !defined(QT_BUILD_QMAKE))
-/*!
-    \fn QDataStream &operator<<(QDataStream &stream, const QString &string)
-    \relates QString
-
-    Writes the given \a string to the specified \a stream.
-
-    \sa {Serializing Qt Data Types}
-*/
-
-QDataStream &operator<<(QDataStream &out, const QString &str)
-{
-    if (out.version() == 1) {
-        out << str.toLatin1();
-    } else {
-        if (!str.isNull() || out.version() < 3) {
-            if ((out.byteOrder() == QDataStream::BigEndian) == (QSysInfo::ByteOrder == QSysInfo::BigEndian)) {
-                out.writeBytes(reinterpret_cast<const char *>(str.unicode()), sizeof(QChar) * str.length());
-            } else {
-                QVarLengthArray<ushort> buffer(str.length());
-                qbswap<sizeof(ushort)>(str.constData(), str.length(), buffer.data());
-                out.writeBytes(reinterpret_cast<const char *>(buffer.data()), sizeof(ushort) * buffer.size());
-            }
-        } else {
-            // write null marker
-            out << (quint32)0xffffffff;
-        }
-    }
-    return out;
-}
-
-/*!
-    \fn QDataStream &operator>>(QDataStream &stream, QString &string)
-    \relates QString
-
-    Reads a string from the specified \a stream into the given \a string.
-
-    \sa {Serializing Qt Data Types}
-*/
-
-QDataStream &operator>>(QDataStream &in, QString &str)
-{
-    if (in.version() == 1) {
-        QByteArray l;
-        in >> l;
-        str = QString::fromLatin1(l);
-    } else {
-        quint32 bytes = 0;
-        in >> bytes;                                  // read size of string
-        if (bytes == 0xffffffff) {                    // null string
-            str.clear();
-        } else if (bytes > 0) {                       // not empty
-            if (bytes & 0x1) {
-                str.clear();
-                in.setStatus(QDataStream::ReadCorruptData);
-                return in;
-            }
-
-            const quint32 Step = 1024 * 1024;
-            quint32 len = bytes / 2;
-            quint32 allocated = 0;
-
-            while (allocated < len) {
-                int blockSize = qMin(Step, len - allocated);
-                str.resize(allocated + blockSize);
-                if (in.readRawData(reinterpret_cast<char *>(str.data()) + allocated * 2,
-                                   blockSize * 2) != blockSize * 2) {
-                    str.clear();
-                    in.setStatus(QDataStream::ReadPastEnd);
-                    return in;
-                }
-                allocated += blockSize;
-            }
-
-            if ((in.byteOrder() == QDataStream::BigEndian)
-                    != (QSysInfo::ByteOrder == QSysInfo::BigEndian)) {
-                ushort *data = reinterpret_cast<ushort *>(str.data());
-                qbswap<sizeof(*data)>(data, len, data);
-            }
-        } else {
-            str = QString(QLatin1String(""));
-        }
-    }
-    return in;
-}
-#endif // QT_NO_DATASTREAM
-
-
-
-
-/*!
-    \class QStringRef
-    \inmodule QtCore
-    \since 4.3
-    \brief The QStringRef class provides a thin wrapper around QString substrings.
-    \reentrant
-    \ingroup tools
-    \ingroup string-processing
-
-    QStringRef provides a read-only subset of the QString API.
-
-    A string reference explicitly references a portion of a string()
-    with a given size(), starting at a specific position(). Calling
-    toString() returns a copy of the data as a real QString instance.
-
-    This class is designed to improve the performance of substring
-    handling when manipulating substrings obtained from existing QString
-    instances. QStringRef avoids the memory allocation and reference
-    counting overhead of a standard QString by simply referencing a
-    part of the original string. This can prove to be advantageous in
-    low level code, such as that used in a parser, at the expense of
-    potentially more complex code.
-
-    For most users, there are no semantic benefits to using QStringRef
-    instead of QString since QStringRef requires attention to be paid
-    to memory management issues, potentially making code more complex
-    to write and maintain.
-
-    \warning A QStringRef is only valid as long as the referenced
-    string exists. If the original string is deleted, the string
-    reference points to an invalid memory location.
-
-    We suggest that you only use this class in stable code where profiling
-    has clearly identified that performance improvements can be made by
-    replacing standard string operations with the optimized substring
-    handling provided by this class.
-
-    \sa {Implicitly Shared Classes}
-*/
-
-/*!
-    \typedef QStringRef::size_type
-    \internal
-*/
-
-/*!
-    \typedef QStringRef::value_type
-    \internal
-*/
-
-/*!
-    \typedef QStringRef::const_pointer
-    \internal
-*/
-
-/*!
-    \typedef QStringRef::const_reference
-    \internal
-*/
-
-/*!
-    \typedef QStringRef::const_iterator
-    \since 5.4
-
-    This typedef provides an STL-style const iterator for QStringRef.
-
-    \sa QStringRef::const_reverse_iterator
-*/
-
-/*!
-    \typedef QStringRef::const_reverse_iterator
-    \since 5.7
-
-    This typedef provides an STL-style const reverse iterator for QStringRef.
-
-    \sa QStringRef::const_iterator
-*/
-
-/*!
- \fn QStringRef::QStringRef()
-
- Constructs an empty string reference.
-*/
-
-/*! \fn QStringRef::QStringRef(const QString *string, int position, int length)
-
-Constructs a string reference to the range of characters in the given
-\a string specified by the starting \a position and \a length in characters.
-
-\warning This function exists to improve performance as much as possible,
-and performs no bounds checking. For program correctness, \a position and
-\a length must describe a valid substring of \a string.
-
-This means that the starting \a position must be positive or 0 and smaller
-than \a string's length, and \a length must be positive or 0 but smaller than
-the string's length minus the starting \a position;
-i.e, 0 <= position < string->length() and
-0 <= length <= string->length() - position must both be satisfied.
-*/
-
-/*! \fn QStringRef::QStringRef(const QString *string)
-
-Constructs a string reference to the given \a string.
-*/
-
-/*! \fn QStringRef::QStringRef(const QStringRef &other)
-
-Constructs a copy of the \a other string reference.
- */
-/*!
-\fn QStringRef::~QStringRef()
-
-Destroys the string reference.
-
-Since this class is only used to refer to string data, and does not take
-ownership of it, no memory is freed when instances are destroyed.
-*/
-
-/*!
-    \fn int QStringRef::position() const
-
-    Returns the starting position in the referenced string that is referred to
-    by the string reference.
-
-    \sa size(), string()
-*/
-
-/*!
-    \fn int QStringRef::size() const
-
-    Returns the number of characters referred to by the string reference.
-    Equivalent to length() and count().
-
-    \sa position(), string()
-*/
-/*!
-    \fn int QStringRef::count() const
-    Returns the number of characters referred to by the string reference.
-    Equivalent to size() and length().
-
-    \sa position(), string()
-*/
-/*!
-    \fn int QStringRef::length() const
-    Returns the number of characters referred to by the string reference.
-    Equivalent to size() and count().
-
-    \sa position(), string()
-*/
-
-
-/*!
-    \fn bool QStringRef::isEmpty() const
-
-    Returns \c true if the string reference has no characters; otherwise returns
-    \c false.
-
-    A string reference is empty if its size is zero.
-
-    \sa size()
-*/
-
-/*!
-    \fn bool QStringRef::isNull() const
-
-    Returns \c true if this string reference does not reference a string or if
-    the string it references is null (i.e. QString::isNull() is true).
-
-    \sa size()
-*/
-
-/*!
-    \fn const QString *QStringRef::string() const
-
-    Returns a pointer to the string referred to by the string reference, or
-    0 if it does not reference a string.
-
-    \sa unicode()
-*/
-
-
-/*!
-    \fn const QChar *QStringRef::unicode() const
-
-    Returns a Unicode representation of the string reference. Since
-    the data stems directly from the referenced string, it is not
-    \\0'-terminated unless the string reference includes the string's
-    null terminator.
-
-    \sa string()
-*/
-
-/*!
-    \fn const QChar *QStringRef::data() const
-
-    Same as unicode().
-*/
-
-/*!
-    \fn const QChar *QStringRef::constData() const
-
-    Same as unicode().
-*/
-
-/*!
-    \fn QStringRef::const_iterator QStringRef::begin() const
-    \since 5.4
-
-    Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the first character in
-    the string.
-
-    \sa cbegin(), constBegin(), end(), constEnd(), rbegin(), rend()
-*/
-
-/*!
-    \fn QStringRef::const_iterator QStringRef::cbegin() const
-    \since 5.4
-
-    Same as begin().
-
-    \sa begin(), constBegin(), cend(), constEnd(), rbegin(), rend()
-*/
-
-/*!
-    \fn QStringRef::const_iterator QStringRef::constBegin() const
-    \since 5.9
-
-    Same as begin().
-
-    \sa begin(), cend(), constEnd(), rbegin(), rend()
-*/
-
-/*!
-    \fn QStringRef::const_iterator QStringRef::end() const
-    \since 5.4
-
-    Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the imaginary
-    character after the last character in the list.
-
-    \sa cbegin(), constBegin(), end(), constEnd(), rbegin(), rend()
-*/
-
-/*! \fn QStringRef::const_iterator QStringRef::cend() const
-    \since 5.4
-
-    Same as end().
-
-    \sa end(), constEnd(), cbegin(), constBegin(), rbegin(), rend()
-*/
-
-/*! \fn QStringRef::const_iterator QStringRef::constEnd() const
-    \since 5.9
-
-    Same as end().
-
-    \sa end(), cend(), cbegin(), constBegin(), rbegin(), rend()
-*/
-
-/*!
-    \fn QStringRef::const_reverse_iterator QStringRef::rbegin() const
-    \since 5.7
-
-    Returns a const \l{STL-style iterators}{STL-style} reverse iterator pointing to the first
-    character in the string, in reverse order.
-
-    \sa begin(), crbegin(), rend()
-*/
-
-/*!
-    \fn QStringRef::const_reverse_iterator QStringRef::crbegin() const
-    \since 5.7
-
-    Same as rbegin().
-
-    \sa begin(), rbegin(), rend()
-*/
-
-/*!
-    \fn QStringRef::const_reverse_iterator QStringRef::rend() const
-    \since 5.7
-
-    Returns a \l{STL-style iterators}{STL-style} reverse iterator pointing to one past
-    the last character in the string, in reverse order.
-
-    \sa end(), crend(), rbegin()
-*/
-
-
-/*!
-    \fn QStringRef::const_reverse_iterator QStringRef::crend() const
-    \since 5.7
-
-    Same as rend().
-
-    \sa end(), rend(), rbegin()
-*/
-
-/*!
-    Returns a copy of the string reference as a QString object.
-
-    If the string reference is not a complete reference of the string
-    (meaning that position() is 0 and size() equals string()->size()),
-    this function will allocate a new string to return.
-
-    \sa string()
-*/
-
-QString QStringRef::toString() const {
-    if (!m_string)
-        return QString();
-    if (m_size && m_position == 0 && m_size == m_string->size())
-        return *m_string;
-    return QString(m_string->unicode() + m_position, m_size);
-}
-
-
-/*! \relates QStringRef
-
-   Returns \c true if string reference \a s1 is lexically equal to string reference \a s2; otherwise
-   returns \c false.
-*/
-bool operator==(const QStringRef &s1,const QStringRef &s2) noexcept
-{
-    return s1.size() == s2.size() && qt_compare_strings(s1, s2, Qt::CaseSensitive) == 0;
-}
-
-/*! \relates QStringRef
-
-   Returns \c true if string \a s1 is lexically equal to string reference \a s2; otherwise
-   returns \c false.
-*/
-bool operator==(const QString &s1,const QStringRef &s2) noexcept
-{
-    return s1.size() == s2.size() && qt_compare_strings(s1, s2, Qt::CaseSensitive) == 0;
-}
-
-/*! \relates QStringRef
-
-   Returns \c true if string  \a s1 is lexically equal to string reference \a s2; otherwise
-   returns \c false.
-*/
-bool operator==(QLatin1String s1, const QStringRef &s2) noexcept
-{
-    if (s1.size() != s2.size())
-        return false;
-
-    return qt_compare_strings(s2, s1, Qt::CaseSensitive) == 0;
-}
-
-/*!
-   \relates QStringRef
-
-    Returns \c true if string reference \a s1 is lexically less than
-    string reference \a s2; otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings using the
-    QString::localeAwareCompare() function.
-*/
-bool operator<(const QStringRef &s1,const QStringRef &s2) noexcept
-{
-    return qt_compare_strings(s1, s2, Qt::CaseSensitive) < 0;
-}
-
-/*!\fn bool operator<=(const QStringRef &s1,const QStringRef &s2)
-
-   \relates QStringRef
-
-    Returns \c true if string reference \a s1 is lexically less than
-    or equal to string reference \a s2; otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings using the
-    QString::localeAwareCompare() function.
-*/
-
-/*!\fn bool operator>=(const QStringRef &s1,const QStringRef &s2)
-
-   \relates QStringRef
-
-    Returns \c true if string reference \a s1 is lexically greater than
-    or equal to string reference \a s2; otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings using the
-    QString::localeAwareCompare() function.
-*/
-
-/*!\fn bool operator>(const QStringRef &s1,const QStringRef &s2)
-
-   \relates QStringRef
-
-    Returns \c true if string reference \a s1 is lexically greater than
-    string reference \a s2; otherwise returns \c false.
-
-    The comparison is based exclusively on the numeric Unicode values
-    of the characters and is very fast, but is not what a human would
-    expect. Consider sorting user-interface strings using the
-    QString::localeAwareCompare() function.
-*/
-
-
-/*!
-    \fn const QChar QStringRef::at(int position) const
-
-    Returns the character at the given index \a position in the
-    string reference.
-
-    The \a position must be a valid index position in the string
-    (i.e., 0 <= \a position < size()).
-*/
-
-/*!
-    \fn QChar QStringRef::operator[](int position) const
-    \since 5.7
-
-    Returns the character at the given index \a position in the
-    string reference.
-
-    The \a position must be a valid index position in the string
-    reference (i.e., 0 <= \a position < size()).
-
-    \sa at()
-*/
-
-/*!
-    \fn QChar QStringRef::front() const
-    \since 5.10
-
-    Returns the first character in the string.
-    Same as \c{at(0)}.
-
-    This function is provided for STL compatibility.
-
-    \warning Calling this function on an empty string constitutes
-    undefined behavior.
-
-    \sa back(), at(), operator[]()
-*/
-
-/*!
-    \fn QChar QStringRef::back() const
-    \since 5.10
-
-    Returns the last character in the string.
-    Same as \c{at(size() - 1)}.
-
-    This function is provided for STL compatibility.
-
-    \warning Calling this function on an empty string constitutes
-    undefined behavior.
-
-    \sa front(), at(), operator[]()
-*/
-
-/*!
-    \fn void QStringRef::clear()
-
-    Clears the contents of the string reference by making it null and empty.
-
-    \sa isEmpty(), isNull()
-*/
-
-/*!
-    \fn QStringRef &QStringRef::operator=(const QStringRef &other)
-
-    Assigns the \a other string reference to this string reference, and
-    returns the result.
-*/
-
-/*!
-    \fn QStringRef &QStringRef::operator=(const QString *string)
-
-    Constructs a string reference to the given \a string and assigns it to
-    this string reference, returning the result.
-*/
-
-/*!
-    \fn bool QStringRef::operator==(const char * s) const
-
-    \overload operator==()
-
-    The \a s byte array is converted to a QStringRef using the
-    fromUtf8() function. This function stops conversion at the
-    first NUL character found, or the end of the byte array.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    Returns \c true if this string is lexically equal to the parameter
-    string \a s. Otherwise returns \c false.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QStringRef::operator!=(const char * s) const
-
-    \overload operator!=()
-
-    The \a s const char pointer is converted to a QStringRef using
-    the fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    Returns \c true if this string is not lexically equal to the parameter
-    string \a s. Otherwise returns \c false.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QStringRef::operator<(const char * s) const
-
-    \overload operator<()
-
-    The \a s const char pointer is converted to a QStringRef using
-    the fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    Returns \c true if this string is lexically smaller than the parameter
-    string \a s. Otherwise returns \c false.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QStringRef::operator<=(const char * s) const
-
-    \overload operator<=()
-
-    The \a s const char pointer is converted to a QStringRef using
-    the fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    Returns \c true if this string is lexically smaller than or equal to the parameter
-    string \a s. Otherwise returns \c false.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QStringRef::operator>(const char * s) const
-
-
-    \overload operator>()
-
-    The \a s const char pointer is converted to a QStringRef using
-    the fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    Returns \c true if this string is lexically greater than the parameter
-    string \a s. Otherwise returns \c false.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-
-/*!
-    \fn bool QStringRef::operator>= (const char * s) const
-
-    \overload operator>=()
-
-    The \a s const char pointer is converted to a QStringRef using
-    the fromUtf8() function.
-
-    You can disable this operator by defining \c
-    QT_NO_CAST_FROM_ASCII when you compile your applications. This
-    can be useful if you want to ensure that all user-visible strings
-    go through QObject::tr(), for example.
-
-    Returns \c true if this string is lexically greater than or equal to the
-    parameter string \a s. Otherwise returns \c false.
-
-    \sa QT_NO_CAST_FROM_ASCII
-*/
-/*!
-    \typedef QString::Data
-    \internal
-*/
-
-/*!
-    \typedef QString::DataPtr
-    \internal
-*/
-
-/*!
-    \fn DataPtr & QString::data_ptr()
-    \internal
-*/
-
-
-
-/*!  Appends the string reference to \a string, and returns a new
-reference to the combined string data.
- */
-QStringRef QStringRef::appendTo(QString *string) const
-{
-    if (!string)
-        return QStringRef();
-    int pos = string->size();
-    string->insert(pos, unicode(), size());
-    return QStringRef(string, pos, size());
-}
-
-/*!
-    \fn int QStringRef::compare(const QStringRef &s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
-    \since 4.5
-
-    Compares the string \a s1 with the string \a s2 and returns an
-    integer less than, equal to, or greater than zero if \a s1
-    is less than, equal to, or greater than \a s2.
-
-    If \a cs is Qt::CaseSensitive, the comparison is case sensitive;
-    otherwise the comparison is case insensitive.
-*/
-
-/*!
-    \fn int QStringRef::compare(const QStringRef &s1, const QStringRef &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
-    \since 4.5
-    \overload
-
-    Compares the string \a s1 with the string \a s2 and returns an
-    integer less than, equal to, or greater than zero if \a s1
-    is less than, equal to, or greater than \a s2.
-
-    If \a cs is Qt::CaseSensitive, the comparison is case sensitive;
-    otherwise the comparison is case insensitive.
-*/
-
-/*!
-    \fn int QStringRef::compare(const QStringRef &s1, QLatin1String s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
-    \since 4.5
-    \overload
-
-    Compares the string \a s1 with the string \a s2 and returns an
-    integer less than, equal to, or greater than zero if \a s1
-    is less than, equal to, or greater than \a s2.
-
-    If \a cs is Qt::CaseSensitive, the comparison is case sensitive;
-    otherwise the comparison is case insensitive.
-*/
-
-/*!
-    \overload
-    \fn int QStringRef::compare(const QString &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \since 4.5
-
-    Compares this string with the \a other string and returns an
-    integer less than, equal to, or greater than zero if this string
-    is less than, equal to, or greater than the \a other string.
-
-    If \a cs is Qt::CaseSensitive, the comparison is case sensitive;
-    otherwise the comparison is case insensitive.
-
-    Equivalent to \c {compare(*this, other, cs)}.
-*/
-
-/*!
-    \overload
-    \fn int QStringRef::compare(const QStringRef &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \since 4.5
-
-    Compares this string with the \a other string and returns an
-    integer less than, equal to, or greater than zero if this string
-    is less than, equal to, or greater than the \a other string.
-
-    If \a cs is Qt::CaseSensitive, the comparison is case sensitive;
-    otherwise the comparison is case insensitive.
-
-    Equivalent to \c {compare(*this, other, cs)}.
-*/
-
-/*!
-    \overload
-    \fn int QStringRef::compare(QLatin1String other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \since 4.5
-
-    Compares this string with the \a other string and returns an
-    integer less than, equal to, or greater than zero if this string
-    is less than, equal to, or greater than the \a other string.
-
-    If \a cs is Qt::CaseSensitive, the comparison is case sensitive;
-    otherwise the comparison is case insensitive.
-
-    Equivalent to \c {compare(*this, other, cs)}.
-*/
-
-/*!
-    \overload
-    \fn int QStringRef::compare(const QByteArray &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \since 5.8
-
-    Compares this string with \a other and returns an
-    integer less than, equal to, or greater than zero if this string
-    is less than, equal to, or greater than the \a other byte array,
-    interpreted as a UTF-8 sequence.
-
-    If \a cs is Qt::CaseSensitive, the comparison is case sensitive;
-    otherwise the comparison is case insensitive.
-
-    Equivalent to \c {compare(*this, other, cs)}.
-*/
-
-/*!
-    \fn int QStringRef::localeAwareCompare(const QStringRef &s1, const QString & s2)
-    \since 4.5
-
-    Compares \a s1 with \a s2 and returns an integer less than, equal
-    to, or greater than zero if \a s1 is less than, equal to, or
-    greater than \a s2.
-
-    The comparison is performed in a locale- and also
-    platform-dependent manner. Use this function to present sorted
-    lists of strings to the user.
-
-    On \macos and iOS, this function compares according the
-    "Order for sorted lists" setting in the International prefereces panel.
-
-    \sa compare(), QLocale
-*/
-
-/*!
-    \fn int QStringRef::localeAwareCompare(const QStringRef &s1, const QStringRef & s2)
-    \since 4.5
-    \overload
-
-    Compares \a s1 with \a s2 and returns an integer less than, equal
-    to, or greater than zero if \a s1 is less than, equal to, or
-    greater than \a s2.
-
-    The comparison is performed in a locale- and also
-    platform-dependent manner. Use this function to present sorted
-    lists of strings to the user.
-
-*/
-
-/*!
-    \fn int QStringRef::localeAwareCompare(const QString &other) const
-    \since 4.5
-    \overload
-
-    Compares this string with the \a other string and returns an
-    integer less than, equal to, or greater than zero if this string
-    is less than, equal to, or greater than the \a other string.
-
-    The comparison is performed in a locale- and also
-    platform-dependent manner. Use this function to present sorted
-    lists of strings to the user.
-*/
-
-/*!
-    \fn int QStringRef::localeAwareCompare(const QStringRef &other) const
-    \since 4.5
-    \overload
-
-    Compares this string with the \a other string and returns an
-    integer less than, equal to, or greater than zero if this string
-    is less than, equal to, or greater than the \a other string.
-
-    The comparison is performed in a locale- and also
-    platform-dependent manner. Use this function to present sorted
-    lists of strings to the user.
-*/
-
-/*!
-    \fn QString &QString::append(const QStringRef &reference)
-    \since 4.4
-
-    Appends the given string \a reference to this string and returns the result.
- */
-QString &QString::append(const QStringRef &str)
-{
-    if (str.string() == this) {
-        str.appendTo(this);
-    } else if (!str.isNull()) {
-        int oldSize = size();
-        resize(oldSize + str.size());
-        memcpy(data() + oldSize, str.unicode(), str.size() * sizeof(QChar));
-    }
-    return *this;
-}
-
-/*!
-    \fn QStringRef::left(int n) const
-    \since 5.2
-
-    Returns a substring reference to the \a n leftmost characters
-    of the string.
-
-    If \a n is greater than or equal to size(), or less than zero,
-    a reference to the entire string is returned.
-
-    \sa right(), mid(), startsWith(), chopped(), chop(), truncate()
-*/
-QStringRef QStringRef::left(int n) const
-{
-    if (uint(n) >= uint(m_size))
-        return *this;
-    return QStringRef(m_string, m_position, n);
-}
-
-/*!
-    \since 4.4
-
-    Returns a substring reference to the \a n leftmost characters
-    of the string.
-
-    If \a n is greater than or equal to size(), or less than zero,
-    a reference to the entire string is returned.
-
-    \snippet qstring/main.cpp leftRef
-
-    \sa left(), rightRef(), midRef(), startsWith()
-*/
-QStringRef QString::leftRef(int n)  const
-{
-    return QStringRef(this).left(n);
-}
-
-/*!
-    \fn QStringRef::right(int n) const
-    \since 5.2
-
-    Returns a substring reference to the \a n rightmost characters
-    of the string.
-
-    If \a n is greater than or equal to size(), or less than zero,
-    a reference to the entire string is returned.
-
-    \sa left(), mid(), endsWith(), chopped(), chop(), truncate()
-*/
-QStringRef QStringRef::right(int n) const
-{
-    if (uint(n) >= uint(m_size))
-        return *this;
-    return QStringRef(m_string, m_size - n + m_position, n);
-}
-
-/*!
-    \since 4.4
-
-    Returns a substring reference to the \a n rightmost characters
-    of the string.
-
-    If \a n is greater than or equal to size(), or less than zero,
-    a reference to the entire string is returned.
-
-    \snippet qstring/main.cpp rightRef
-
-    \sa right(), leftRef(), midRef(), endsWith()
-*/
-QStringRef QString::rightRef(int n) const
-{
-    return QStringRef(this).right(n);
-}
-
-/*!
-    \fn QStringRef QStringRef::mid(int position, int n = -1) const
-    \since 5.2
-
-    Returns a substring reference to \a n characters of this string,
-    starting at the specified \a position.
-
-    If the \a position exceeds the length of the string, a null
-    reference is returned.
-
-    If there are less than \a n characters available in the string,
-    starting at the given \a position, or if \a n is -1 (default), the
-    function returns all characters from the specified \a position
-    onwards.
-
-    \sa left(), right(), chopped(), chop(), truncate()
-*/
-QStringRef QStringRef::mid(int pos, int n) const
-{
-    using namespace QtPrivate;
-    switch (QContainerImplHelper::mid(m_size, &pos, &n)) {
-    case QContainerImplHelper::Null:
-        return QStringRef();
-    case QContainerImplHelper::Empty:
-        return QStringRef(m_string, 0, 0);
-    case QContainerImplHelper::Full:
-        return *this;
-    case QContainerImplHelper::Subset:
-        return QStringRef(m_string, pos + m_position, n);
-    }
-    Q_UNREACHABLE();
-    return QStringRef();
-}
-
-/*!
-    \fn QStringRef QStringRef::chopped(int len) const
-    \since 5.10
-
-    Returns a substring reference to the size() - \a len leftmost characters
-    of this string.
-
-    \note The behavior is undefined if \a len is negative or greater than size().
-
-    \sa endsWith(), left(), right(), mid(), chop(), truncate()
-*/
-
-/*!
-    \since 4.4
-
-    Returns a substring reference to \a n characters of this string,
-    starting at the specified \a position.
-
-    If the \a position exceeds the length of the string, a null
-    reference is returned.
-
-    If there are less than \a n characters available in the string,
-    starting at the given \a position, or if \a n is -1 (default), the
-    function returns all characters from the specified \a position
-    onwards.
-
-    Example:
-
-    \snippet qstring/main.cpp midRef
-
-    \sa mid(), leftRef(), rightRef()
-*/
-QStringRef QString::midRef(int position, int n) const
-{
-    return QStringRef(this).mid(position, n);
-}
-
-/*!
-    \fn void QStringRef::truncate(int position)
-    \since 5.6
-
-    Truncates the string at the given \a position index.
-
-    If the specified \a position index is beyond the end of the
-    string, nothing happens.
-
-    If \a position is negative, it is equivalent to passing zero.
-
-    \sa QString::truncate()
-*/
-
-/*!
-    \fn void QStringRef::chop(int n)
-    \since 5.8
-
-    Removes \a n characters from the end of the string.
-
-    If \a n is greater than or equal to size(), the result is an
-    empty string; if \a n is negative, it is equivalent to passing zero.
-
-    \sa QString::chop(), truncate()
-*/
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*!
-  \since 4.8
-
-  Returns the index position of the first occurrence of the string \a
-  str in this string reference, searching forward from index position
-  \a from. Returns -1 if \a str is not found.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  If \a from is -1, the search starts at the last character; if it is
-  -2, at the next to last character and so on.
-
-  \sa QString::indexOf(), lastIndexOf(), contains(), count()
-*/
-int QStringRef::indexOf(const QString &str, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(QtPrivate::findString(QStringView(unicode(), length()), from, QStringView(str.unicode(), str.length()), cs));
-}
-#endif // QT_STRINGVIEW_LEVEL < 2
-
-/*!
-    \fn int QStringRef::indexOf(QStringView str, int from, Qt::CaseSensitivity cs) const
-    \since 5.14
-    \overload indexOf()
-
-    Returns the index position of the first occurrence of the string view \a str
-    in this string reference, searching forward from index position \a from.
-    Returns -1 if \a str is not found.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case
-    sensitive; otherwise the search is case insensitive.
-
-    If \a from is -1, the search starts at the last character; if it is
-    -2, at the next to last character and so on.
-
-    \sa QString::indexOf(), QStringView::indexOf(), lastIndexOf(), contains(), count()
-*/
-
-/*!
-    \since 4.8
-    \overload indexOf()
-
-    Returns the index position of the first occurrence of the
-    character \a ch in the string reference, searching forward from
-    index position \a from. Returns -1 if \a ch could not be found.
-
-    \sa QString::indexOf(), lastIndexOf(), contains(), count()
-*/
-int QStringRef::indexOf(QChar ch, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(qFindChar(QStringView(unicode(), length()), ch, from, cs));
-}
-
-/*!
-  \since 4.8
-
-  Returns the index position of the first occurrence of the string \a
-  str in this string reference, searching forward from index position
-  \a from. Returns -1 if \a str is not found.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  If \a from is -1, the search starts at the last character; if it is
-  -2, at the next to last character and so on.
-
-  \sa QString::indexOf(), lastIndexOf(), contains(), count()
-*/
-int QStringRef::indexOf(QLatin1String str, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(QtPrivate::findString(QStringView(unicode(), size()), from, str, cs));
-}
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*!
-    \since 4.8
-
-    \overload indexOf()
-
-    Returns the index position of the first occurrence of the string
-    reference \a str in this string reference, searching forward from
-    index position \a from. Returns -1 if \a str is not found.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case
-    sensitive; otherwise the search is case insensitive.
-
-    \sa QString::indexOf(), lastIndexOf(), contains(), count()
-*/
-int QStringRef::indexOf(const QStringRef &str, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(QtPrivate::findString(QStringView(unicode(), size()), from, QStringView(str.unicode(), str.size()), cs));
-}
-#endif // QT_STRINGVIEW_LEVEL < 2
-
-/*!
-  \since 4.8
-
-  Returns the index position of the last occurrence of the string \a
-  str in this string reference, searching backward from index position
-  \a from. If \a from is -1 (default), the search starts at the last
-  character; if \a from is -2, at the next to last character and so
-  on. Returns -1 if \a str is not found.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  \sa QString::lastIndexOf(), indexOf(), contains(), count()
-*/
-int QStringRef::lastIndexOf(const QString &str, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(QtPrivate::lastIndexOf(*this, from, str, cs));
-}
-
-/*!
-  \since 4.8
-  \overload lastIndexOf()
-
-  Returns the index position of the last occurrence of the character
-  \a ch, searching backward from position \a from.
-
-  \sa QString::lastIndexOf(), indexOf(), contains(), count()
-*/
-int QStringRef::lastIndexOf(QChar ch, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(qLastIndexOf(*this, ch, from, cs));
-}
-
-/*!
-  \since 4.8
-  \overload lastIndexOf()
-
-  Returns the index position of the last occurrence of the string \a
-  str in this string reference, searching backward from index position
-  \a from. If \a from is -1 (default), the search starts at the last
-  character; if \a from is -2, at the next to last character and so
-  on. Returns -1 if \a str is not found.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  \sa QString::lastIndexOf(), indexOf(), contains(), count()
-*/
-int QStringRef::lastIndexOf(QLatin1String str, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(QtPrivate::lastIndexOf(*this, from, str, cs));
-}
-
-/*!
-  \since 4.8
-  \overload lastIndexOf()
-
-  Returns the index position of the last occurrence of the string
-  reference \a str in this string reference, searching backward from
-  index position \a from. If \a from is -1 (default), the search
-  starts at the last character; if \a from is -2, at the next to last
-  character and so on. Returns -1 if \a str is not found.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  \sa QString::lastIndexOf(), indexOf(), contains(), count()
-*/
-int QStringRef::lastIndexOf(const QStringRef &str, int from, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(QtPrivate::lastIndexOf(*this, from, str, cs));
-}
-
-/*!
-  \fn int QStringRef::lastIndexOf(QStringView str, int from, Qt::CaseSensitivity cs) const
-  \since 5.14
-  \overload lastIndexOf()
-
-  Returns the index position of the last occurrence of the string view \a
-  str in this string, searching backward from index position \a
-  from. If \a from is -1 (default), the search starts at the last
-  character; if \a from is -2, at the next to last character and so
-  on. Returns -1 if \a str is not found.
-
-  If \a cs is Qt::CaseSensitive (default), the search is case
-  sensitive; otherwise the search is case insensitive.
-
-  \sa indexOf(), contains(), count()
-*/
-
-/*!
-    \since 4.8
-    Returns the number of (potentially overlapping) occurrences of
-    the string \a str in this string reference.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \sa QString::count(), contains(), indexOf()
-*/
-int QStringRef::count(const QString &str, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(qt_string_count(QStringView(unicode(), size()), QStringView(str.unicode(), str.size()), cs));
-}
-
-/*!
-    \since 4.8
-    \overload count()
-
-    Returns the number of occurrences of the character \a ch in the
-    string reference.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \sa QString::count(), contains(), indexOf()
-*/
-int QStringRef::count(QChar ch, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(qt_string_count(QStringView(unicode(), size()), ch, cs));
-}
-
-/*!
-    \since 4.8
-    \overload count()
-
-    Returns the number of (potentially overlapping) occurrences of the
-    string reference \a str in this string reference.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \sa QString::count(), contains(), indexOf()
-*/
-int QStringRef::count(const QStringRef &str, Qt::CaseSensitivity cs) const
-{
-    // ### Qt6: qsizetype
-    return int(qt_string_count(QStringView(unicode(), size()), QStringView(str.unicode(), str.size()), cs));
-}
-
-/*!
-    \since 5.9
-
-    Returns \c true if the string is read right to left.
-
-    \sa QString::isRightToLeft()
-*/
-bool QStringRef::isRightToLeft() const
-{
-    return QtPrivate::isRightToLeft(QStringView(unicode(), size()));
-}
-
-/*!
-    \since 5.11
-    \internal
-    \relates QStringView
-
-    Returns \c true if the string is read right to left.
-
-    \sa QString::isRightToLeft()
-*/
-bool QtPrivate::isRightToLeft(QStringView string)
-{
-    const ushort *p = reinterpret_cast<const ushort*>(string.data());
-    const ushort * const end = p + string.size();
-    int isolateLevel = 0;
-    while (p < end) {
-        uint ucs4 = *p;
-        if (QChar::isHighSurrogate(ucs4) && p < end - 1) {
-            ushort low = p[1];
-            if (QChar::isLowSurrogate(low)) {
-                ucs4 = QChar::surrogateToUcs4(ucs4, low);
-                ++p;
-            }
-        }
-        switch (QChar::direction(ucs4))
-        {
-        case QChar::DirRLI:
-        case QChar::DirLRI:
-        case QChar::DirFSI:
-            ++isolateLevel;
-            break;
-        case QChar::DirPDI:
-            if (isolateLevel)
-                --isolateLevel;
-            break;
-        case QChar::DirL:
-            if (isolateLevel)
-                break;
-            return false;
-        case QChar::DirR:
-        case QChar::DirAL:
-            if (isolateLevel)
-                break;
-            return true;
-        default:
-            break;
-        }
-        ++p;
-    }
-    return false;
-}
-
-/*!
-    \since 4.8
-
-    Returns \c true if the string reference starts with \a str; otherwise
-    returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \sa QString::startsWith(), endsWith()
-*/
-bool QStringRef::startsWith(const QString &str, Qt::CaseSensitivity cs) const
-{
-    return qt_starts_with(*this, str, cs);
-}
-
-/*!
-    \since 4.8
-    \overload startsWith()
-    \sa QString::startsWith(), endsWith()
-*/
-bool QStringRef::startsWith(QLatin1String str, Qt::CaseSensitivity cs) const
-{
-    return qt_starts_with(*this, str, cs);
-}
-
-/*!
-    \fn bool QStringRef::startsWith(QStringView str, Qt::CaseSensitivity cs) const
-    \since 5.10
-    \overload startsWith()
-    \sa QString::startsWith(), endsWith()
-*/
-
-/*!
-    \since 4.8
-    \overload startsWith()
-    \sa QString::startsWith(), endsWith()
-*/
-bool QStringRef::startsWith(const QStringRef &str, Qt::CaseSensitivity cs) const
-{
-    return qt_starts_with(*this, str, cs);
-}
-
-/*!
-    \since 4.8
-    \overload startsWith()
-
-    Returns \c true if the string reference starts with \a ch; otherwise
-    returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case
-    sensitive; otherwise the search is case insensitive.
-
-    \sa QString::startsWith(), endsWith()
-*/
-bool QStringRef::startsWith(QChar ch, Qt::CaseSensitivity cs) const
-{
-    return qt_starts_with(*this, ch, cs);
-}
-
-/*!
-    \since 4.8
-    Returns \c true if the string reference ends with \a str; otherwise
-    returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case
-    sensitive; otherwise the search is case insensitive.
-
-    \sa QString::endsWith(), startsWith()
-*/
-bool QStringRef::endsWith(const QString &str, Qt::CaseSensitivity cs) const
-{
-    return qt_ends_with(*this, str, cs);
-}
-
-/*!
-    \since 4.8
-    \overload endsWith()
-
-    Returns \c true if the string reference ends with \a ch; otherwise
-    returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is case
-    sensitive; otherwise the search is case insensitive.
-
-    \sa QString::endsWith(), endsWith()
-*/
-bool QStringRef::endsWith(QChar ch, Qt::CaseSensitivity cs) const
-{
-    return qt_ends_with(*this, ch, cs);
-}
-
-/*!
-    \since 4.8
-    \overload endsWith()
-    \sa QString::endsWith(), endsWith()
-*/
-bool QStringRef::endsWith(QLatin1String str, Qt::CaseSensitivity cs) const
-{
-    return qt_ends_with(*this, str, cs);
-}
-
-/*!
-    \fn bool QStringRef::endsWith(QStringView str, Qt::CaseSensitivity cs) const
-    \since 5.10
-    \overload endsWith()
-    \sa QString::endsWith(), startsWith()
-*/
-
-/*!
-    \since 4.8
-    \overload endsWith()
-    \sa QString::endsWith(), endsWith()
-*/
-bool QStringRef::endsWith(const QStringRef &str, Qt::CaseSensitivity cs) const
-{
-    return qt_ends_with(*this, str, cs);
-}
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*! \fn bool QStringRef::contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-
-    \since 4.8
-    Returns \c true if this string reference contains an occurrence of
-    the string \a str; otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \sa indexOf(), count()
-*/
-#endif // QT_STRINGVIEW_LEVEL < 2
-
-/*! \fn bool QStringRef::contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-
-    \overload contains()
-    \since 4.8
-
-    Returns \c true if this string contains an occurrence of the
-    character \a ch; otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-*/
-
-#if QT_STRINGVIEW_LEVEL < 2
-/*! \fn bool QStringRef::contains(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \overload contains()
-    \since 4.8
-
-    Returns \c true if this string reference contains an occurrence of
-    the string reference \a str; otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \sa indexOf(), count()
-*/
-#endif // QT_STRINGVIEW_LEVEL < 2
-
-/*! \fn bool QStringRef::contains(QLatin1String str, Qt::CaseSensitivity cs) const
-    \since 4.8
-    \overload contains()
-
-    Returns \c true if this string reference contains an occurrence of
-    the string \a str; otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \sa indexOf(), count()
-*/
-
-/*! \fn bool QStringRef::contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
-    \since 5.14
-    \overload contains()
-
-    Returns \c true if this string reference contains an occurrence of
-    the string view \a str; otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (default), the search is
-    case sensitive; otherwise the search is case insensitive.
-
-    \sa indexOf(), count()
-*/
-
-static inline qsizetype qt_string_count(QStringView haystack, QStringView needle, Qt::CaseSensitivity cs)
-{
-    qsizetype num = 0;
-    qsizetype i = -1;
-    if (haystack.size() > 500 && needle.size() > 5) {
-        QStringMatcher matcher(needle, cs);
-        while ((i = matcher.indexIn(haystack, i + 1)) != -1)
-            ++num;
-    } else {
-        while ((i = QtPrivate::findString(haystack, i + 1, needle, cs)) != -1)
-            ++num;
-    }
-    return num;
-}
-
-static inline qsizetype qt_string_count(QStringView haystack, QChar ch,
-                                  Qt::CaseSensitivity cs)
-{
-    ushort c = ch.unicode();
-    qsizetype num = 0;
-    const ushort *b = reinterpret_cast<const ushort*>(haystack.data());
-    const ushort *i = b + haystack.size();
-    if (cs == Qt::CaseSensitive) {
-        while (i != b)
-            if (*--i == c)
-                ++num;
-    } else {
-        c = foldCase(c);
-        while (i != b)
-            if (foldCase(*(--i)) == c)
-                ++num;
-    }
-    return num;
-}
-
-template <typename Haystack, typename Needle>
-bool qt_starts_with_impl(Haystack haystack, Needle needle, Qt::CaseSensitivity cs) noexcept
-{
-    if (haystack.isNull())
-        return needle.isNull(); // historical behavior, consider changing in ### Qt 6.
-    const auto haystackLen = haystack.size();
-    const auto needleLen = needle.size();
-    if (haystackLen == 0)
-        return needleLen == 0;
-    if (needleLen > haystackLen)
-        return false;
-
-    return qt_compare_strings(haystack.left(needleLen), needle, cs) == 0;
-}
-
-static inline bool qt_starts_with(QStringView haystack, QStringView needle, Qt::CaseSensitivity cs)
-{
-    return qt_starts_with_impl(haystack, needle, cs);
-}
-
-static inline bool qt_starts_with(QStringView haystack, QLatin1String needle, Qt::CaseSensitivity cs)
-{
-    return qt_starts_with_impl(haystack, needle, cs);
-}
-
-static inline bool qt_starts_with(QStringView haystack, QChar needle, Qt::CaseSensitivity cs)
-{
-    return haystack.size()
-           && (cs == Qt::CaseSensitive ? haystack.front() == needle
-                                       : foldCase(haystack.front()) == foldCase(needle));
-}
-
-/*!
-    \fn bool QtPrivate::startsWith(QStringView haystack, QStringView needle, Qt::CaseSensitivity cs)
-    \since 5.10
-    \fn bool QtPrivate::startsWith(QStringView haystack, QLatin1String needle, Qt::CaseSensitivity cs)
-    \since 5.10
-    \fn bool QtPrivate::startsWith(QLatin1String haystack, QStringView needle, Qt::CaseSensitivity cs)
-    \since 5.10
-    \fn bool QtPrivate::startsWith(QLatin1String haystack, QLatin1String needle, Qt::CaseSensitivity cs)
-    \since 5.10
-    \internal
-    \relates QStringView
-
-    Returns \c true if \a haystack starts with \a needle,
-    otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (the default), the search is case-sensitive;
-    otherwise the search is case-insensitive.
-
-    \sa QtPrivate::endsWith(), QString::endsWith(), QStringView::endsWith(), QLatin1String::endsWith()
-*/
-
-bool QtPrivate::startsWith(QStringView haystack, QStringView needle, Qt::CaseSensitivity cs) noexcept
-{
-    return qt_starts_with_impl(haystack, needle, cs);
-}
-
-bool QtPrivate::startsWith(QStringView haystack, QLatin1String needle, Qt::CaseSensitivity cs) noexcept
-{
-    return qt_starts_with_impl(haystack, needle, cs);
-}
-
-bool QtPrivate::startsWith(QLatin1String haystack, QStringView needle, Qt::CaseSensitivity cs) noexcept
-{
-    return qt_starts_with_impl(haystack, needle, cs);
-}
-
-bool QtPrivate::startsWith(QLatin1String haystack, QLatin1String needle, Qt::CaseSensitivity cs) noexcept
-{
-    return qt_starts_with_impl(haystack, needle, cs);
-}
-
-template <typename Haystack, typename Needle>
-bool qt_ends_with_impl(Haystack haystack, Needle needle, Qt::CaseSensitivity cs) noexcept
-{
-    if (haystack.isNull())
-        return needle.isNull(); // historical behavior, consider changing in ### Qt 6.
-    const auto haystackLen = haystack.size();
-    const auto needleLen = needle.size();
-    if (haystackLen == 0)
-        return needleLen == 0;
-    if (haystackLen < needleLen)
-        return false;
-
-    return qt_compare_strings(haystack.right(needleLen), needle, cs) == 0;
-}
-
-static inline bool qt_ends_with(QStringView haystack, QStringView needle, Qt::CaseSensitivity cs)
-{
-    return qt_ends_with_impl(haystack, needle, cs);
-}
-
-static inline bool qt_ends_with(QStringView haystack, QLatin1String needle, Qt::CaseSensitivity cs)
-{
-    return qt_ends_with_impl(haystack, needle, cs);
-}
-
-static inline bool qt_ends_with(QStringView haystack, QChar needle, Qt::CaseSensitivity cs)
-{
-    return haystack.size()
-           && (cs == Qt::CaseSensitive ? haystack.back() == needle
-                                       : foldCase(haystack.back()) == foldCase(needle));
-}
-
-/*!
-    \fn bool QtPrivate::endsWith(QStringView haystack, QStringView needle, Qt::CaseSensitivity cs)
-    \since 5.10
-    \fn bool QtPrivate::endsWith(QStringView haystack, QLatin1String needle, Qt::CaseSensitivity cs)
-    \since 5.10
-    \fn bool QtPrivate::endsWith(QLatin1String haystack, QStringView needle, Qt::CaseSensitivity cs)
-    \since 5.10
-    \fn bool QtPrivate::endsWith(QLatin1String haystack, QLatin1String needle, Qt::CaseSensitivity cs)
-    \since 5.10
-    \internal
-    \relates QStringView
-
-    Returns \c true if \a haystack ends with \a needle,
-    otherwise returns \c false.
-
-    If \a cs is Qt::CaseSensitive (the default), the search is case-sensitive;
-    otherwise the search is case-insensitive.
-
-    \sa QtPrivate::startsWith(), QString::endsWith(), QStringView::endsWith(), QLatin1String::endsWith()
-*/
-
-bool QtPrivate::endsWith(QStringView haystack, QStringView needle, Qt::CaseSensitivity cs) noexcept
-{
-    return qt_ends_with_impl(haystack, needle, cs);
-}
-
-bool QtPrivate::endsWith(QStringView haystack, QLatin1String needle, Qt::CaseSensitivity cs) noexcept
-{
-    return qt_ends_with_impl(haystack, needle, cs);
-}
-
-bool QtPrivate::endsWith(QLatin1String haystack, QStringView needle, Qt::CaseSensitivity cs) noexcept
-{
-    return qt_ends_with_impl(haystack, needle, cs);
-}
-
-bool QtPrivate::endsWith(QLatin1String haystack, QLatin1String needle, Qt::CaseSensitivity cs) noexcept
-{
-    return qt_ends_with_impl(haystack, needle, cs);
-}
-
-namespace {
-template <typename Pointer>
-uint foldCaseHelper(Pointer ch, Pointer start) = delete;
-
-template <>
-uint foldCaseHelper<const QChar*>(const QChar* ch, const QChar* start)
-{
-    return foldCase(reinterpret_cast<const ushort*>(ch), reinterpret_cast<const ushort*>(start));
-}
-
-template <>
-uint foldCaseHelper<const char*>(const char* ch, const char*)
-{
-    return foldCase(ushort(uchar(*ch)));
-}
-
-template <typename T>
-ushort valueTypeToUtf16(T t) = delete;
-
-template <>
-ushort valueTypeToUtf16<QChar>(QChar t)
-{
-    return t.unicode();
-}
-
-template <>
-ushort valueTypeToUtf16<char>(char t)
-{
-    return ushort(uchar(t));
-}
-}
-
-/*!
-    \internal
-
-    Returns the index position of the first occurrence of the
-    character \a ch in the string given by \a str and \a len,
-    searching forward from index
-    position \a from. Returns -1 if \a ch could not be found.
-*/
-
-static inline qsizetype qFindChar(QStringView str, QChar ch, qsizetype from, Qt::CaseSensitivity cs) noexcept
-{
-    if (from < 0)
-        from = qMax(from + str.size(), qsizetype(0));
-    if (from < str.size()) {
-        const ushort *s = (const ushort *)str.data();
-        ushort c = ch.unicode();
-        const ushort *n = s + from;
-        const ushort *e = s + str.size();
-        if (cs == Qt::CaseSensitive) {
-            n = QtPrivate::qustrchr(QStringView(n, e), c);
-            if (n != e)
-                return n - s;
-        } else {
-            c = foldCase(c);
-            --n;
-            while (++n != e)
-                if (foldCase(*n) == c)
-                    return n - s;
-        }
-    }
-    return -1;
-}
-
-qsizetype QtPrivate::findString(QStringView haystack0, qsizetype from, QStringView needle0, Qt::CaseSensitivity cs) noexcept
-{
-    const qsizetype l = haystack0.size();
-    const qsizetype sl = needle0.size();
-    if (from < 0)
-        from += l;
-    if (std::size_t(sl + from) > std::size_t(l))
-        return -1;
-    if (!sl)
-        return from;
-    if (!l)
-        return -1;
-
-    if (sl == 1)
-        return qFindChar(haystack0, needle0[0], from, cs);
-
-    /*
-        We use the Boyer-Moore algorithm in cases where the overhead
-        for the skip table should pay off, otherwise we use a simple
-        hash function.
-    */
-    if (l > 500 && sl > 5)
-        return qFindStringBoyerMoore(haystack0, from, needle0, cs);
-
-    auto sv = [sl](const ushort *v) { return QStringView(v, sl); };
-    /*
-        We use some hashing for efficiency's sake. Instead of
-        comparing strings, we compare the hash value of str with that
-        of a part of this QString. Only if that matches, we call
-        qt_string_compare().
-    */
-    const ushort *needle = (const ushort *)needle0.data();
-    const ushort *haystack = (const ushort *)(haystack0.data()) + from;
-    const ushort *end = (const ushort *)(haystack0.data()) + (l - sl);
-    const std::size_t sl_minus_1 = sl - 1;
-    std::size_t hashNeedle = 0, hashHaystack = 0;
-    qsizetype idx;
-
-    if (cs == Qt::CaseSensitive) {
-        for (idx = 0; idx < sl; ++idx) {
-            hashNeedle = ((hashNeedle<<1) + needle[idx]);
-            hashHaystack = ((hashHaystack<<1) + haystack[idx]);
-        }
-        hashHaystack -= haystack[sl_minus_1];
-
-        while (haystack <= end) {
-            hashHaystack += haystack[sl_minus_1];
-            if (hashHaystack == hashNeedle
-                 && qt_compare_strings(needle0, sv(haystack), Qt::CaseSensitive) == 0)
-                return haystack - (const ushort *)haystack0.data();
-
-            REHASH(*haystack);
-            ++haystack;
-        }
-    } else {
-        const ushort *haystack_start = (const ushort *)haystack0.data();
-        for (idx = 0; idx < sl; ++idx) {
-            hashNeedle = (hashNeedle<<1) + foldCase(needle + idx, needle);
-            hashHaystack = (hashHaystack<<1) + foldCase(haystack + idx, haystack_start);
-        }
-        hashHaystack -= foldCase(haystack + sl_minus_1, haystack_start);
-
-        while (haystack <= end) {
-            hashHaystack += foldCase(haystack + sl_minus_1, haystack_start);
-            if (hashHaystack == hashNeedle
-                 && qt_compare_strings(needle0, sv(haystack), Qt::CaseInsensitive) == 0)
-                return haystack - (const ushort *)haystack0.data();
-
-            REHASH(foldCase(haystack, haystack_start));
-            ++haystack;
-        }
-    }
-    return -1;
-}
-
-template <typename Haystack>
-static inline qsizetype qLastIndexOf(Haystack haystack, QChar needle,
-                                     qsizetype from, Qt::CaseSensitivity cs) noexcept
-{
-    if (from < 0)
-        from += haystack.size();
-    if (std::size_t(from) >= std::size_t(haystack.size()))
-        return -1;
-    if (from >= 0) {
-        ushort c = needle.unicode();
-        const auto b = haystack.data();
-        auto n = b + from;
-        if (cs == Qt::CaseSensitive) {
-            for (; n >= b; --n)
-                if (valueTypeToUtf16(*n) == c)
-                    return n - b;
-        } else {
-            c = foldCase(c);
-            for (; n >= b; --n)
-                if (foldCase(valueTypeToUtf16(*n)) == c)
-                    return n - b;
-        }
-    }
-    return -1;
-}
-
-template<typename Haystack, typename Needle>
-static qsizetype qLastIndexOf(Haystack haystack0, qsizetype from,
-                              Needle needle0, Qt::CaseSensitivity cs) noexcept
-{
-    const qsizetype sl = needle0.size();
-    if (sl == 1)
-        return qLastIndexOf(haystack0, needle0.front(), from, cs);
-
-    const qsizetype l = haystack0.size();
-    if (from < 0)
-        from += l;
-    if (from == l && sl == 0)
-        return from;
-    const qsizetype delta = l - sl;
-    if (std::size_t(from) >= std::size_t(l) || delta < 0)
-        return -1;
-    if (from > delta)
-        from = delta;
-
-    auto sv = [sl](const typename Haystack::value_type *v) { return Haystack(v, sl); };
-
-    auto haystack = haystack0.data();
-    const auto needle = needle0.data();
-    const auto *end = haystack;
-    haystack += from;
-    const std::size_t sl_minus_1 = sl - 1;
-    const auto *n = needle + sl_minus_1;
-    const auto *h = haystack + sl_minus_1;
-    std::size_t hashNeedle = 0, hashHaystack = 0;
-    qsizetype idx;
-
-    if (cs == Qt::CaseSensitive) {
-        for (idx = 0; idx < sl; ++idx) {
-            hashNeedle = (hashNeedle << 1) + valueTypeToUtf16(*(n - idx));
-            hashHaystack = (hashHaystack << 1) + valueTypeToUtf16(*(h - idx));
-        }
-        hashHaystack -= valueTypeToUtf16(*haystack);
-
-        while (haystack >= end) {
-            hashHaystack += valueTypeToUtf16(*haystack);
-            if (hashHaystack == hashNeedle
-                 && qt_compare_strings(needle0, sv(haystack), Qt::CaseSensitive) == 0)
-                return haystack - end;
-            --haystack;
-            REHASH(valueTypeToUtf16(haystack[sl]));
-        }
-    } else {
-        for (idx = 0; idx < sl; ++idx) {
-            hashNeedle = (hashNeedle << 1) + foldCaseHelper(n - idx, needle);
-            hashHaystack = (hashHaystack << 1) + foldCaseHelper(h - idx, end);
-        }
-        hashHaystack -= foldCaseHelper(haystack, end);
-
-        while (haystack >= end) {
-            hashHaystack += foldCaseHelper(haystack, end);
-            if (hashHaystack == hashNeedle
-                 && qt_compare_strings(sv(haystack), needle0, Qt::CaseInsensitive) == 0)
-                return haystack - end;
-            --haystack;
-            REHASH(foldCaseHelper(haystack + sl, end));
-        }
-    }
-    return -1;
-}
-
-qsizetype QtPrivate::findString(QStringView haystack, qsizetype from, QLatin1String needle, Qt::CaseSensitivity cs) noexcept
-{
-    if (haystack.size() < needle.size())
-        return -1;
-
-    QVarLengthArray<ushort> s(needle.size());
-    qt_from_latin1(s.data(), needle.latin1(), needle.size());
-    return QtPrivate::findString(haystack, from, QStringView(reinterpret_cast<const QChar*>(s.constData()), s.size()), cs);
-}
-
-qsizetype QtPrivate::findString(QLatin1String haystack, qsizetype from, QStringView needle, Qt::CaseSensitivity cs) noexcept
-{
-    if (haystack.size() < needle.size())
-        return -1;
-
-    QVarLengthArray<ushort> s(haystack.size());
-    qt_from_latin1(s.data(), haystack.latin1(), haystack.size());
-    return QtPrivate::findString(QStringView(reinterpret_cast<const QChar*>(s.constData()), s.size()), from, needle, cs);
-}
-
-qsizetype QtPrivate::findString(QLatin1String haystack, qsizetype from, QLatin1String needle, Qt::CaseSensitivity cs) noexcept
-{
-    if (haystack.size() < needle.size())
-        return -1;
-
-    QVarLengthArray<ushort> h(haystack.size());
-    qt_from_latin1(h.data(), haystack.latin1(), haystack.size());
-    QVarLengthArray<ushort> n(needle.size());
-    qt_from_latin1(n.data(), needle.latin1(), needle.size());
-    return QtPrivate::findString(QStringView(reinterpret_cast<const QChar*>(h.constData()), h.size()), from,
-                                 QStringView(reinterpret_cast<const QChar*>(n.constData()), n.size()), cs);
-}
-
-qsizetype QtPrivate::lastIndexOf(QStringView haystack, qsizetype from, QStringView needle, Qt::CaseSensitivity cs) noexcept
-{
-    return qLastIndexOf(haystack, from, needle, cs);
-}
-
-qsizetype QtPrivate::lastIndexOf(QStringView haystack, qsizetype from, QLatin1String needle, Qt::CaseSensitivity cs) noexcept
-{
-    return qLastIndexOf(haystack, from, needle, cs);
-}
-
-qsizetype QtPrivate::lastIndexOf(QLatin1String haystack, qsizetype from, QStringView needle, Qt::CaseSensitivity cs) noexcept
-{
-    return qLastIndexOf(haystack, from, needle, cs);
-}
-
-qsizetype QtPrivate::lastIndexOf(QLatin1String haystack, qsizetype from, QLatin1String needle, Qt::CaseSensitivity cs) noexcept
-{
-    return qLastIndexOf(haystack, from, needle, cs);
-}
-
-/*!
-    \since 4.8
-
-    Returns a Latin-1 representation of the string as a QByteArray.
-
-    The returned byte array is undefined if the string contains non-Latin1
-    characters. Those characters may be suppressed or replaced with a
-    question mark.
-
-    \sa toUtf8(), toLocal8Bit(), QTextCodec
-*/
-QByteArray QStringRef::toLatin1() const
-{
-    return qt_convert_to_latin1(*this);
-}
-
-/*!
-    \fn QByteArray QStringRef::toAscii() const
-    \since 4.8
-    \deprecated
-
-    Returns an 8-bit representation of the string as a QByteArray.
-
-    This function does the same as toLatin1().
-
-    Note that, despite the name, this function does not necessarily return an US-ASCII
-    (ANSI X3.4-1986) string and its result may not be US-ASCII compatible.
-
-    \sa toLatin1(), toUtf8(), toLocal8Bit(), QTextCodec
-*/
-
-/*!
-    \since 4.8
-
-    Returns the local 8-bit representation of the string as a
-    QByteArray. The returned byte array is undefined if the string
-    contains characters not supported by the local 8-bit encoding.
-
-    QTextCodec::codecForLocale() is used to perform the conversion from
-    Unicode. If the locale encoding could not be determined, this function
-    does the same as toLatin1().
-
-    If this string contains any characters that cannot be encoded in the
-    locale, the returned byte array is undefined. Those characters may be
-    suppressed or replaced by another.
-
-    \sa toLatin1(), toUtf8(), QTextCodec
-*/
-QByteArray QStringRef::toLocal8Bit() const
-{
-    return qt_convert_to_local_8bit(*this);
-}
-
-/*!
-    \since 4.8
-
-    Returns a UTF-8 representation of the string as a QByteArray.
-
-    UTF-8 is a Unicode codec and can represent all characters in a Unicode
-    string like QString.
-
-    \sa toLatin1(), toLocal8Bit(), QTextCodec
-*/
-QByteArray QStringRef::toUtf8() const
-{
-    return qt_convert_to_utf8(*this);
-}
-
-/*!
-    \since 4.8
-
-    Returns a UCS-4/UTF-32 representation of the string as a QVector<uint>.
-
-    UCS-4 is a Unicode codec and therefore it is lossless. All characters from
-    this string will be encoded in UCS-4. Any invalid sequence of code units in
-    this string is replaced by the Unicode's replacement character
-    (QChar::ReplacementCharacter, which corresponds to \c{U+FFFD}).
-
-    The returned vector is not \\0'-terminated.
-
-    \sa toUtf8(), toLatin1(), toLocal8Bit(), QTextCodec
-*/
-QVector<uint> QStringRef::toUcs4() const
-{
-    return qt_convert_to_ucs4(*this);
-}
-
-/*!
-    Returns a string that has whitespace removed from the start and
-    the end.
-
-    Whitespace means any character for which QChar::isSpace() returns
-    \c true. This includes the ASCII characters '\\t', '\\n', '\\v',
-    '\\f', '\\r', and ' '.
-
-    Unlike QString::simplified(), trimmed() leaves internal whitespace alone.
-
-    \since 5.1
-
-    \sa QString::trimmed()
-*/
-QStringRef QStringRef::trimmed() const
-{
-    const QChar *begin = cbegin();
-    const QChar *end = cend();
-    QStringAlgorithms<const QStringRef>::trimmed_helper_positions(begin, end);
-    if (begin == cbegin() && end == cend())
-        return *this;
-    int position = m_position + (begin - cbegin());
-    return QStringRef(m_string, position, end - begin);
-}
-
-/*!
-    Returns the string converted to a \c{long long} using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toLongLong()
-
-    \sa QString::toLongLong()
-
-    \since 5.1
-*/
-
-qint64 QStringRef::toLongLong(bool *ok, int base) const
-{
-    return QString::toIntegral_helper<qint64>(constData(), size(), ok, base);
-}
-
-/*!
-    Returns the string converted to an \c{unsigned long long} using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toULongLong()
-
-    \sa QString::toULongLong()
-
-    \since 5.1
-*/
-
-quint64 QStringRef::toULongLong(bool *ok, int base) const
-{
-    return QString::toIntegral_helper<quint64>(constData(), size(), ok, base);
-}
-
-/*!
-    \fn long QStringRef::toLong(bool *ok, int base) const
-
-    Returns the string converted to a \c long using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toLong()
-
-    \sa QString::toLong()
-
-    \since 5.1
-*/
-
-long QStringRef::toLong(bool *ok, int base) const
-{
-    return QString::toIntegral_helper<long>(constData(), size(), ok, base);
-}
-
-/*!
-    \fn ulong QStringRef::toULong(bool *ok, int base) const
-
-    Returns the string converted to an \c{unsigned long} using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toULongLong()
-
-    \sa QString::toULong()
-
-    \since 5.1
-*/
-
-ulong QStringRef::toULong(bool *ok, int base) const
-{
-    return QString::toIntegral_helper<ulong>(constData(), size(), ok, base);
-}
-
-
-/*!
-    Returns the string converted to an \c int using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toInt()
-
-    \sa QString::toInt()
-
-    \since 5.1
-*/
-
-int QStringRef::toInt(bool *ok, int base) const
-{
-    return QString::toIntegral_helper<int>(constData(), size(), ok, base);
-}
-
-/*!
-    Returns the string converted to an \c{unsigned int} using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toUInt()
-
-    \sa QString::toUInt()
-
-    \since 5.1
-*/
-
-uint QStringRef::toUInt(bool *ok, int base) const
-{
-    return QString::toIntegral_helper<uint>(constData(), size(), ok, base);
-}
-
-/*!
-    Returns the string converted to a \c short using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toShort()
-
-    \sa QString::toShort()
-
-    \since 5.1
-*/
-
-short QStringRef::toShort(bool *ok, int base) const
-{
-    return QString::toIntegral_helper<short>(constData(), size(), ok, base);
-}
-
-/*!
-    Returns the string converted to an \c{unsigned short} using base \a
-    base, which is 10 by default and must be between 2 and 36, or 0.
-    Returns 0 if the conversion fails.
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    If \a base is 0, the C language convention is used: If the string
-    begins with "0x", base 16 is used; if the string begins with "0",
-    base 8 is used; otherwise, base 10 is used.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toUShort()
-
-    \sa QString::toUShort()
-
-    \since 5.1
-*/
-
-ushort QStringRef::toUShort(bool *ok, int base) const
-{
-    return QString::toIntegral_helper<ushort>(constData(), size(), ok, base);
-}
-
-
-/*!
-    Returns the string converted to a \c double value.
-
-    Returns an infinity if the conversion overflows or 0.0 if the
-    conversion fails for other reasons (e.g. underflow).
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toDouble()
-
-    For historic reasons, this function does not handle
-    thousands group separators. If you need to convert such numbers,
-    use QLocale::toDouble().
-
-    \sa QString::toDouble()
-
-    \since 5.1
-*/
-
-double QStringRef::toDouble(bool *ok) const
-{
-    return QLocaleData::c()->stringToDouble(*this, ok, QLocale::RejectGroupSeparator);
-}
-
-/*!
-    Returns the string converted to a \c float value.
-
-    Returns an infinity if the conversion overflows or 0.0 if the
-    conversion fails for other reasons (e.g. underflow).
-
-    If \a ok is not \nullptr, failure is reported by setting *\a{ok}
-    to \c false, and success by setting *\a{ok} to \c true.
-
-    The string conversion will always happen in the 'C' locale. For locale
-    dependent conversion use QLocale::toFloat()
-
-    \sa QString::toFloat()
-
-    \since 5.1
-*/
-
-float QStringRef::toFloat(bool *ok) const
-{
-    return QLocaleData::convertDoubleToFloat(toDouble(ok), ok);
-}
-
-/*!
-    \obsolete
-    \fn QString Qt::escape(const QString &plain)
-
-    Use QString::toHtmlEscaped() instead.
-*/
-
-/*!
-    \since 5.0
-
-    Converts a plain text string to an HTML string with
-    HTML metacharacters \c{<}, \c{>}, \c{&}, and \c{"} replaced by HTML
-    entities.
-
-    Example:
-
-    \snippet code/src_corelib_tools_qstring.cpp 7
-*/
-QString QString::toHtmlEscaped() const
-{
-    QString rich;
-    const int len = length();
-    rich.reserve(int(len * 1.1));
-    for (int i = 0; i < len; ++i) {
-        if (at(i) == QLatin1Char('<'))
-            rich += QLatin1String("&lt;");
-        else if (at(i) == QLatin1Char('>'))
-            rich += QLatin1String("&gt;");
-        else if (at(i) == QLatin1Char('&'))
-            rich += QLatin1String("&amp;");
-        else if (at(i) == QLatin1Char('"'))
-            rich += QLatin1String("&quot;");
-        else
-            rich += at(i);
-    }
-    rich.squeeze();
-    return rich;
-}
-
-/*!
-  \macro QStringLiteral(str)
-  \relates QString
-
-  The macro generates the data for a QString out of the string literal \a str
-  at compile time. Creating a QString from it is free in this case, and the
-  generated string data is stored in the read-only segment of the compiled
-  object file.
-
-  If you have code that looks like this:
-
-  \snippet code/src_corelib_tools_qstring.cpp 9
-
-  then a temporary QString will be created to be passed as the \c{hasAttribute}
-  function parameter. This can be quite expensive, as it involves a memory
-  allocation and the copy/conversion of the data into QString's internal
-  encoding.
-
-  This cost can be avoided by using QStringLiteral instead:
-
-  \snippet code/src_corelib_tools_qstring.cpp 10
-
-  In this case, QString's internal data will be generated at compile time; no
-  conversion or allocation will occur at runtime.
-
-  Using QStringLiteral instead of a double quoted plain C++ string literal can
-  significantly speed up creation of QString instances from data known at
-  compile time.
-
-  \note QLatin1String can still be more efficient than QStringLiteral
-  when the string is passed to a function that has an overload taking
-  QLatin1String and this overload avoids conversion to QString.  For
-  instance, QString::operator==() can compare to a QLatin1String
-  directly:
-
-  \snippet code/src_corelib_tools_qstring.cpp 11
-
-  \note Some compilers have bugs encoding strings containing characters outside
-  the US-ASCII character set. Make sure you prefix your string with \c{u} in
-  those cases. It is optional otherwise.
-
-  \sa QByteArrayLiteral
-*/
-
-/*!
-    \internal
- */
-void QAbstractConcatenable::appendLatin1To(const char *a, int len, QChar *out) noexcept
-{
-    qt_from_latin1(reinterpret_cast<ushort *>(out), a, uint(len));
-}
-
-QT_END_NAMESPACE