Класс QStringRef

Класс QStringRef предоставляет тонкий обертывающий слой над подстроками QString. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются повторно входящими.

Открытые типы

Открытые функции

Статические публичные члены

Связанные нечлены

Подробное описание

QStringRef предоставляет чтение-только подмножество API QString.

Ссылка на строку явно ссылается на часть строки string() с заданным размером size(), начиная с определённой позиции position(). Вызов toString() возвращает копию данных в виде реального экземпляра QString.

Этот класс разработан для повышения производительности обработки подстрок при манипулировании подстроками, полученными из существующих экземпляров QString. QStringRef избегает выделения памяти и учёта ссылок стандартного QString, просто ссылаясь на часть исходной строки. Это может быть выгодно в коде низкого уровня, таком как тот, который используется в анализаторе, за счёт потенциально более сложного кода.

Для большинства пользователей нет смысла использовать QStringRef вместо QString, поскольку QStringRef требует внимания к проблемам управления памятью, что потенциально усложняет написание и поддержку кода.

Предупреждение: QStringRef действителен только до тех пор, пока существует ссылка на строку. Если исходная строка удалена, ссылка на строку указывает на недопустимый адрес памяти.

Мы рекомендуем использовать этот класс только в стабильном коде, где профилирование ясно показало, что можно улучшить производительность, заменив стандартные операции со строками оптимизированной обработкой подстрок, предоставляемой этим классом.

См. также Неявное совместное использование.

Документация типов членов

[since 5.4] QStringRef::const_iterator

Этот typedef был введён в Qt 5.4.

См. также QStringRef::const_reverse_iterator.

[since 5.7] QStringRef::const_reverse_iterator

Этот typedef был введён в Qt 5.7.

См. также QStringRef::const_iterator.

Документация по функциям-членам

[default] QStringRef::QStringRef(const QStringRef &other)

Создаёт копию ссылки на другую строку.

QStringRef::QStringRef(const QString *string)

Создаёт ссылку на строку на заданный string.

QStringRef::QStringRef(const QString *string, int position, int length)

Создаёт ссылку на строку на диапазон символов в заданном string, определяемый начальной position и длиной length в символах.

Предупреждение: Эта функция существует для максимального повышения производительности и не выполняет проверку границ. Для корректности программы position и length должны описывать допустимую подстроку string.

Это означает, что начальная position должна быть положительной или 0 и меньше длины string, а length должна быть положительной или 0, но меньше длины строки минус начальная position; т.е. должны быть выполнены оба условия: 0 <= position < string->length() и 0 <= length <= string->length() - position.

QStringRef::QStringRef()

Создаёт пустую ссылку на строку.

[default] QStringRef &QStringRef::operator=(const QStringRef &other)

Присваивает other ссылку на строку этой строке и возвращает результат.

[default] QStringRef::~QStringRef()

Уничтожает ссылку на строку.

Поскольку этот класс используется только для ссылки на данные строки и не берёт на себя их владение, память не освобождается при уничтожении экземпляров.

QStringRef QStringRef::appendTo(QString *string) const

Добавляет ссылку на строку в string и возвращает новую ссылку на объединённые данные строки.

const QChar QStringRef::at(int position) const

Возвращает символ в заданной позиции position в ссылке на строку.

position должен быть допустимой позицией индекса в строке (т. е., 0 <= position < size()).

[since 5.10] QChar QStringRef::back() const

Возвращает последний символ в строке. То же, что и at(size() - 1).

Эта функция предоставляется для совместимости со STL.

Предупреждение: Вызов этой функции для пустой строки является неопределённым поведением.

Эта функция была введена в Qt 5.10.

См. также front(), at() и operator[]().

[since 5.4] QStringRef::const_iterator QStringRef::begin() const

Возвращает константный итератор STL, указывающий на первый символ в строке.

Эта функция была введена в Qt 5.4.

См. также cbegin(), constBegin(), end(), constEnd(), rbegin() и rend().

[since 5.4] QStringRef::const_iterator QStringRef::cbegin() const

То же, что и begin().

Эта функция была введена в Qt 5.4.

См. также begin(), constBegin(), cend(), constEnd(), rbegin() и rend().

[since 5.4] QStringRef::const_iterator QStringRef::cend() const

То же, что и end().

Эта функция была введена в Qt 5.4.

См. также end(), constEnd(), cbegin(), constBegin(), rbegin() и rend().

[since 5.8] void QStringRef::chop(int n)

Удаляет n символов с конца строки.

Если n больше или равно size(), результат — пустая строка; если n отрицательное, это эквивалентно передаче нуля.

Эта функция была введена в Qt 5.8.

См. также QString::chop() и truncate().

[since 5.10] QStringRef QStringRef::chopped(int len) const

Возвращает ссылку на подстроку, содержащую size() - len левых символов этой строки.

Примечание: Поведение неопределённо, если len отрицательное или больше size().

Эта функция была введена в Qt 5.10.

См. также endsWith(), left(), right(), mid(), chop() и truncate().

void QStringRef::clear()

Очищает содержимое ссылки на строку, делая её пустой и нулевой.

См. также isEmpty() и isNull().

[static] int QStringRef::compare(const QStringRef &s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Сравнивает строку s1 со строкой s2 и возвращает целое число, меньшее, равное или больше нуля, если s1 меньше, равна или больше s2.

Если cs имеет значение Qt::CaseSensitive, сравнение выполняется с учётом регистра; в противном случае сравнение выполняется без учёта регистра.

int QStringRef::compare(const QString &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Это перегруженная функция.

Сравнивает эту строку с другой строкой other и возвращает целое число, меньшее, равное или большее нуля, если эта строка меньше, равна или больше другой строки.

Если cs имеет значение Qt::CaseSensitive, сравнение выполняется с учётом регистра; в противном случае сравнение выполняется без учёта регистра.

Эквивалентно compare(*this, other, cs).

int QStringRef::compare(const QStringRef &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Это перегруженная функция.

Сравнивает эту строку с другой строкой other и возвращает целое число, меньшее, равное или большее нуля, если эта строка меньше, равна или больше другой строки.

Если cs имеет значение Qt::CaseSensitive, сравнение выполняется с учётом регистра; в противном случае сравнение выполняется без учёта регистра.

Эквивалентно compare(*this, other, cs).

[since 5.14] int QStringRef::compare(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Это перегруженная функция.

Сравнивает эту строку с символом ch и возвращает целое число, меньшее, равное или большее нуля, если эта строка меньше, равна или больше символа ch, интерпретированного как строка длиной один.

Если cs имеет значение Qt::CaseSensitive, сравнение выполняется с учётом регистра; в противном случае сравнение выполняется без учёта регистра.

Функция была добавлена в Qt 5.14.

int QStringRef::compare(QLatin1String other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Это перегруженная функция.

Сравнивает эту строку с другой строкой other и возвращает целое число, меньшее, равное или большее нуля, если эта строка меньше, равна или больше другой строки.

Если cs имеет значение Qt::CaseSensitive, сравнение выполняется с учётом регистра; в противном случае сравнение выполняется без учёта регистра.

Эквивалентно compare(*this, other, cs).

[since 5.8] int QStringRef::compare(const QByteArray &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Это перегруженная функция.

Сравнивает эту строку с other и возвращает целое число, меньшее, равное или большее нуля, если эта строка меньше, равна или больше массива байтов other, интерпретированного как последовательность UTF-8.

Если cs имеет значение Qt::CaseSensitive, сравнение выполняется с учётом регистра; в противном случае сравнение выполняется без учёта регистра.

Эквивалентно compare(*this, other, cs).

Функция была добавлена в Qt 5.8.

[static] int QStringRef::compare(const QStringRef &s1, const QStringRef &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Это перегруженная функция.

Сравнивает строку s1 со строкой s2 и возвращает целое число, меньшее, равное или большее нуля, если s1 меньше, равна или больше s2.

Если cs имеет значение Qt::CaseSensitive, сравнение выполняется с учётом регистра; в противном случае сравнение выполняется без учёта регистра.

[static] int QStringRef::compare(const QStringRef &s1, QLatin1String s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Это перегруженная функция.

Сравнивает строку s1 со строкой s2 и возвращает целое число, меньшее, равное или большее нуля, если s1 меньше, равна или больше s2.

Если cs имеет значение Qt::CaseSensitive, сравнение выполняется с учётом регистра; в противном случае сравнение выполняется без учёта регистра.

[since 5.9] QStringRef::const_iterator QStringRef::constBegin() const

То же, что и begin().

Функция была добавлена в Qt 5.9.

См. также begin(), cend(), constEnd(), rbegin(), и rend().

const QChar *QStringRef::constData() const

То же, что и unicode().

[since 5.9] QStringRef::const_iterator QStringRef::constEnd() const

То же, что и end().

Функция была добавлена в Qt 5.9.

См. также end(), cend(), cbegin(), constBegin(), rbegin(), и rend().

bool QStringRef::contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Возвращает true если эта строка содержит вхождение строки str; в противном случае возвращает false.

Если cs имеет значение Qt::CaseSensitive (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

См. также indexOf() и count().

bool QStringRef::contains(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает contains().

Возвращает true если эта строка содержит вхождение ссылки на строку str; в противном случае возвращает false.

Если cs имеет значение Qt::CaseSensitive (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

См. также indexOf() и count().

bool QStringRef::contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает contains().

Возвращает true если эта строка содержит вхождение символа ch; в противном случае возвращает false.

Если cs имеет значение Qt::CaseSensitive (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

bool QStringRef::contains(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает contains().

Возвращает true если эта строка содержит вхождение строки str; в противном случае возвращает false.

Если cs имеет значение Qt::CaseSensitive (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

См. также indexOf() и count().

[since 5.14] bool QStringRef::contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает contains().

Возвращает true если эта строка содержит вхождение представления строки str; в противном случае возвращает false.

Если cs имеет значение Qt::CaseSensitive (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

Функция была добавлена в Qt 5.14.

См. также indexOf() и count().

int QStringRef::count() const

Возвращает количество символов, на которые ссылается ссылка на строку. Эквивалентно size() и length().

См. также position() и string().

int QStringRef::count(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Возвращает количество (возможно, перекрывающихся) вхождений строки str в этой строке.

Если cs имеет значение Qt::CaseSensitive (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

См. также QString::count(), contains() и indexOf().

int QStringRef::count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает count().

Возвращает количество вхождений символа ch в строковую ссылку.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск регистрозависимый; в противном случае регистронезависимый.

См. также QString::count(), contains() и indexOf().

int QStringRef::count(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает count().

Возвращает количество (возможно перекрывающихся) вхождений строковой ссылки str в этой строковой ссылке.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск регистрозависимый; в противном случае регистронезависимый.

См. также QString::count(), contains() и indexOf().

[since 5.7] QStringRef::const_reverse_iterator QStringRef::crbegin() const

То же, что и rbegin().

Эта функция была добавлена в Qt 5.7.

См. также begin(), rbegin() и rend().

[since 5.7] QStringRef::const_reverse_iterator QStringRef::crend() const

То же, что и rend().

Эта функция была добавлена в Qt 5.7.

См. также end(), rend() и rbegin().

const QChar *QStringRef::data() const

То же, что и unicode().

[since 5.4] QStringRef::const_iterator QStringRef::end() const

Возвращает указатель на константный итератор STL, указывающий на несуществующий символ после последнего символа в списке.

Эта функция была добавлена в Qt 5.4.

См. также cbegin(), constBegin(), end(), constEnd(), rbegin() и rend().

bool QStringRef::endsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Возвращает true если строковая ссылка заканчивается на str; иначе возвращает false.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск регистрозависимый; в противном случае регистронезависимый.

См. также QString::endsWith() и startsWith().

[since 5.10] bool QStringRef::endsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает endsWith().

Эта функция была добавлена в Qt 5.10.

См. также QString::endsWith() и startsWith().

bool QStringRef::endsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает endsWith().

См. также QString::endsWith() и endsWith().

bool QStringRef::endsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает endsWith().

Возвращает true если строковая ссылка заканчивается на ch; иначе возвращает false.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск регистрозависимый; в противном случае регистронезависимый.

См. также QString::endsWith() и endsWith().

bool QStringRef::endsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает endsWith().

См. также QString::endsWith() и endsWith().

[since 5.10] QChar QStringRef::front() const

Возвращает первый символ в строке. То же, что и at(0).

Эта функция предоставлена для совместимости со STL.

Предупреждение: Вызов этой функции для пустой строки приводит к неопределенному поведению.

Эта функция была добавлена в Qt 5.10.

См. также back(), at() и operator[]().

int QStringRef::indexOf(const QString &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Возвращает индекс первого вхождения строки str в эту строковую ссылку, начиная поиск с индекса from. Возвращает -1, если str не найдена.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск регистрозависимый; в противном случае регистронезависимый.

Если from равно -1, поиск начинается с последнего символа; если -2, со второго с конца и так далее.

См. также QString::indexOf(), lastIndexOf(), contains() и count().

int QStringRef::indexOf(const QStringRef &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает indexOf().

Возвращает индекс первого вхождения строковой ссылки str в эту строковую ссылку, начиная поиск с индекса from. Возвращает -1, если str не найдена.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск регистрозависимый; в противном случае регистронезависимый.

См. также QString::indexOf(), lastIndexOf(), contains() и count().

[since 5.14] int QStringRef::indexOf(QStringView str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает indexOf().

Возвращает индекс первого вхождения строкового представления str в эту строковую ссылку, начиная поиск с индекса from. Возвращает -1, если str не найдена.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск регистрозависимый; в противном случае регистронезависимый.

Если from равно -1, поиск начинается с последнего символа; если -2, со второго с конца и так далее.

Эта функция была добавлена в Qt 5.14.

См. также QString::indexOf(), QStringView::indexOf(), lastIndexOf(), contains() и count().

int QStringRef::indexOf(QChar ch, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает indexOf().

Возвращает индекс первого вхождения символа ch в строковую ссылку, начиная поиск с индекса from. Возвращает -1, если ch не найден.

См. также QString::indexOf(), lastIndexOf(), contains() и count().

int QStringRef::indexOf(QLatin1String str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Возвращает индекс первого вхождения строки str в эту строковую ссылку, начиная поиск с индекса from. Возвращает -1, если str не найдена.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск регистрозависимый; в противном случае регистронезависимый.

Если from равно -1, поиск начинается с последнего символа; если оно равно -2, с предпоследнего символа и так далее.

См. также QString::indexOf(), lastIndexOf(), contains() и count().

bool QStringRef::isEmpty() const

Возвращает true если в строковой ссылке нет символов; в противном случае возвращает false.

Строковая ссылка является пустой, если её размер равен нулю.

См. также size().

bool QStringRef::isNull() const

Возвращает true если эта строковая ссылка не ссылается на строку или если строка, на которую она ссылается, равна null (т. е. QString::isNull() истинно).

См. также size().

[since 5.9] bool QStringRef::isRightToLeft() const

Возвращает true если строка читается справа налево.

Эта функция была добавлена в Qt 5.9.

См. также QString::isRightToLeft().

int QStringRef::lastIndexOf(const QString &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Возвращает позицию индекса последнего вхождения строки str в этой строковой ссылке, выполняя поиск назад с позиции индекса from. Если from равно -1 (по умолчанию), поиск начинается с последнего символа; если from равно -2, с предпоследнего символа и так далее. Возвращает -1, если str не найдена.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

См. также QString::lastIndexOf(), indexOf(), contains() и count().

int QStringRef::lastIndexOf(const QStringRef &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает lastIndexOf().

Возвращает позицию индекса последнего вхождения строковой ссылки str в этой строковой ссылке, выполняя поиск назад с позиции индекса from. Если from равно -1 (по умолчанию), поиск начинается с последнего символа; если from равно -2, с предпоследнего символа и так далее. Возвращает -1, если str не найдена.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

См. также QString::lastIndexOf(), indexOf(), contains() и count().

int QStringRef::lastIndexOf(QChar ch, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает lastIndexOf().

Возвращает позицию индекса последнего вхождения символа ch, выполняя поиск назад с позиции from.

См. также QString::lastIndexOf(), indexOf(), contains() и count().

int QStringRef::lastIndexOf(QLatin1String str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает lastIndexOf().

Возвращает позицию индекса последнего вхождения строки str в этой строковой ссылке, выполняя поиск назад с позиции индекса from. Если from равно -1 (по умолчанию), поиск начинается с последнего символа; если from равно -2, с предпоследнего символа и так далее. Возвращает -1, если str не найдена.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

См. также QString::lastIndexOf(), indexOf(), contains() и count().

[since 5.14] int QStringRef::lastIndexOf(QStringView str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает lastIndexOf().

Возвращает позицию индекса последнего вхождения представления строки str в этой строке, выполняя поиск назад с позиции индекса from. Если from равно -1 (по умолчанию), поиск начинается с последнего символа; если from равно -2, с предпоследнего символа и так далее. Возвращает -1, если str не найдена.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

Эта функция была добавлена в Qt 5.14.

См. также indexOf(), contains() и count().

[since 5.2] QStringRef QStringRef::left(int n) const

Возвращает подстроковую ссылку на n левых символов строки.

Если n больше или равно size(), или меньше нуля, возвращается ссылка на всю строку.

Эта функция была добавлена в Qt 5.2.

См. также right(), mid(), startsWith(), chopped(), chop() и truncate().

int QStringRef::length() const

Возвращает количество символов, на которые ссылается строковая ссылка. Эквивалентно size() и count().

См. также position() и string().

[static] int QStringRef::localeAwareCompare(const QStringRef &s1, const QString &s2)

Сравнивает s1 с s2 и возвращает целое число, меньшее, равное или больше нуля, если s1 меньше, равна или больше s2.

Сравнение выполняется с учётом локале и платформы. Используйте эту функцию для отображения отсортированных списков строк пользователю.

См. также compare(), QLocale и Сравнение строк.

int QStringRef::localeAwareCompare(const QString &other) const

Это перегруженная функция.

Сравнивает эту строку с other строкой и возвращает целое число, меньшее, равное или больше нуля, если эта строка меньше, равна или больше other строки.

Сравнение выполняется с учётом локале и платформы. Используйте эту функцию для отображения отсортированных списков строк пользователю.

См. также Сравнение строк.

int QStringRef::localeAwareCompare(const QStringRef &other) const

Это перегруженная функция.

Сравнивает эту строку с other строкой и возвращает целое число, меньшее, равное или больше нуля, если эта строка меньше, равна или больше other строки.

Сравнение выполняется с учётом локале и платформы. Используйте эту функцию для отображения отсортированных списков строк пользователю.

См. также Сравнение строк.

[static] int QStringRef::localeAwareCompare(const QStringRef &s1, const QStringRef &s2)

Это перегруженная функция.

Сравнивает s1 с s2 и возвращает целое число, меньшее, равное или больше нуля, если s1 меньше, равна или больше s2.

Сравнение выполняется с учётом локале и платформы. Используйте эту функцию для отображения отсортированных списков строк пользователю.

См. также Сравнение строк.

[since 5.2] QStringRef QStringRef::mid(int position, int n = -1) const

Возвращает подстроковую ссылку на n символов этой строки, начиная с указанной position.

Если position превышает длину строки, возвращается нулевая ссылка.

Если в строке доступно меньше, чем n символов, начиная с заданной position, или если n равно -1 (по умолчанию), функция возвращает все символы, начиная с указанной position.

Эта функция была добавлена в Qt 5.2.

См. также left(), right(), chopped(), chop() и truncate().

int QStringRef::position() const

Возвращает начальную позицию в строке, на которую ссылается ссылка на строку.

См. также size() и string().

[since 5.7] QStringRef::const_reverse_iterator QStringRef::rbegin() const

Возвращает постоянный итератор обратного типа STL, указывающий на первый символ в строке в обратном порядке.

Эта функция была представлена в Qt 5.7.

См. также begin(), crbegin() и rend().

[since 5.7] QStringRef::const_reverse_iterator QStringRef::rend() const

Возвращает итератор обратного типа STL, указывающий на позицию после последнего символа в строке в обратном порядке.

Эта функция была представлена в Qt 5.7.

См. также end(), crend() и rbegin().

[since 5.2] QStringRef QStringRef::right(int n) const

Возвращает ссылку на подстроку из n правых символов строки.

Если n больше или равно size(), или меньше нуля, возвращается ссылка на всю строку.

Эта функция была представлена в Qt 5.2.

См. также left(), mid(), endsWith(), chopped(), chop() и truncate().

int QStringRef::size() const

Возвращает количество символов, на которые ссылается ссылка на строку. Эквивалентно length() и count().

См. также position() и string().

[since 5.14] QList<QStringRef> QStringRef::split(const QString &sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Разбивает строку на подстроки в тех местах, где встречается sep, и возвращает список этих строк.

См. QString::split(), чтобы узнать, как взаимодействуют sep, behavior и cs, чтобы сформировать результат.

Примечание: Все ссылки остаются действительными до тех пор, пока эта строка существует. Уничтожение этой строки приведет к тому, что все ссылки станут висячими указателями.

Эта функция была представлена в Qt 5.14.

[since 5.14] QList<QStringRef> QStringRef::split(QChar sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Это перегруженная функция.

Эта функция была представлена в Qt 5.14.

bool QStringRef::startsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Возвращает true, если ссылка на строку начинается с str; в противном случае возвращает false.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск регистрозависимый; в противном случае поиск регистронезависимый.

См. также QString::startsWith() и endsWith().

[since 5.10] bool QStringRef::startsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает startsWith().

Эта функция была представлена в Qt 5.10.

См. также QString::startsWith() и endsWith().

bool QStringRef::startsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает startsWith().

См. также QString::startsWith() и endsWith().

bool QStringRef::startsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает startsWith().

Возвращает true если ссылка на строку начинается с ch; в противном случае возвращает false.

Если cs равно Qt::CaseSensitive (по умолчанию), поиск регистрозависимый; в противном случае поиск регистронезависимый.

См. также QString::startsWith() и endsWith().

bool QStringRef::startsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Эта функция перегружает startsWith().

См. также QString::startsWith() и endsWith().

const QString *QStringRef::string() const

Возвращает указатель на строку, на которую ссылается ссылка на строку, или 0, если она не ссылается на строку.

См. также unicode().

[since 5.1] double QStringRef::toDouble(bool *ok = nullptr) const

Возвращает строку, преобразованную в значение с плавающей точкой.

Возвращает бесконечность, если преобразование приводит к переполнению, или 0.0, если преобразование завершается неудачно по другим причинам (например, подпоток).

Если ok не равен нулю, ошибка сообщается, устанавливая *ok в false, а успешное выполнение — устанавливая *ok в true.

Преобразование строки всегда происходит в локале 'C'. Для преобразования, зависящего от локали, используйте QLocale::toDouble()

По историческим причинам эта функция не обрабатывает разделители тысяч. Если вам нужно преобразовать такие числа, используйте QLocale::toDouble().

Эта функция была представлена в Qt 5.1.

См. также QString::toDouble().

[since 5.1] float QStringRef::toFloat(bool *ok = nullptr) const

Возвращает строку, преобразованную в значение с плавающей точкой.

Возвращает бесконечность, если преобразование приводит к переполнению, или 0.0, если преобразование завершается неудачно по другим причинам (например, подпоток).

Если ok не равен нулю, ошибка сообщается, устанавливая *ok в false, а успешное выполнение — устанавливая *ok в true.

Преобразование строки всегда происходит в локале 'C'. Для преобразования, зависящего от локали, используйте QLocale::toFloat()

Эта функция была представлена в Qt 5.1.

См. также QString::toFloat().

[since 5.1] int QStringRef::toInt(bool *ok = nullptr, int base = 10) const

Возвращает строку, преобразованную в целое число с основанием base, которое по умолчанию равно 10 и должно находиться в диапазоне от 2 до 36 или 0. Возвращает 0, если преобразование завершается неудачно.

Если ok не равен нулю, ошибка сообщается, устанавливая *ok в false, а успешное выполнение — устанавливая *ok в true.

Если base равно 0, используется соглашение языка C: если строка начинается с "0x", используется основание 16; если строка начинается с "0", используется основание 8; в противном случае используется основание 10.

Преобразование строки всегда происходит в локале 'C'. Для преобразования, зависящего от локали, используйте QLocale::toInt()

Эта функция была представлена в Qt 5.1.

См. также QString::toInt().

QByteArray QStringRef::toLatin1() const

Возвращает латинское представление строки в виде QByteArray.

Возвращаемый массив байтов неопределен, если строка содержит символы, не относящиеся к латинскому коду. Эти символы могут быть подавлены или заменены вопросительным знаком.

См. также toUtf8(), toLocal8Bit() и QStringEncoder.

QByteArray QStringRef::toLocal8Bit() const

Возвращает локальное 8-битное представление строки в виде QByteArray. Возвращаемый массив байтов неопределен, если строка содержит символы, не поддерживаемые локальным 8-битным кодированием.

В системах Unix это эквивалентно toUtf8(), в системах Windows используется текущая кодовая страница системы.

Если эта строка содержит символы, которые не могут быть закодированы в локали, возвращаемый массив байтов неопределен. Эти символы могут быть подавлены или заменены другим.

См. также toLatin1(), toUtf8() и QStringEncoder.

[since 5.1] long QStringRef::toLong(bool *ok = nullptr, int base = 10) const

Возвращает строку, преобразованную в long с основанием base, которое по умолчанию равно 10 и должно быть в диапазоне от 2 до 36 или 0. Возвращает 0, если преобразование завершается неудачно.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Если base равно 0, используется соглашение языка C: если строка начинается с «0x», используется основание 16; если строка начинается с «0», используется основание 8; в противном случае используется основание 10.

Преобразование строки всегда происходит в локали 'C'. Для преобразования, зависящего от локали, используйте QLocale::toLong()

Эта функция была добавлена в Qt 5.1.

См. также QString::toLong().

[since 5.1] qlonglong QStringRef::toLongLong(bool *ok = nullptr, int base = 10) const

Возвращает строку, преобразованную в long long с основанием base, которое по умолчанию равно 10 и должно быть в диапазоне от 2 до 36 или 0. Возвращает 0, если преобразование завершается неудачно.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Если base равно 0, используется соглашение языка C: если строка начинается с «0x», используется основание 16; если строка начинается с «0», используется основание 8; в противном случае используется основание 10.

Преобразование строки всегда происходит в локали 'C'. Для преобразования, зависящего от локали, используйте QLocale::toLongLong()

Эта функция была добавлена в Qt 5.1.

См. также QString::toLongLong().

[since 5.1] short QStringRef::toShort(bool *ok = nullptr, int base = 10) const

Возвращает строку, преобразованную в short с основанием base, которое по умолчанию равно 10 и должно быть в диапазоне от 2 до 36 или 0. Возвращает 0, если преобразование завершается неудачно.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Если base равно 0, используется соглашение языка C: если строка начинается с «0x», используется основание 16; если строка начинается с «0», используется основание 8; в противном случае используется основание 10.

Преобразование строки всегда происходит в локали 'C'. Для преобразования, зависящего от локали, используйте QLocale::toShort()

Эта функция была добавлена в Qt 5.1.

См. также QString::toShort().

QString QStringRef::toString() const

Возвращает копию ссылки на строку в виде объекта QString.

Если ссылка на строку не является полной ссылкой на строку (то есть position() равно 0, а size() равно string()->size()), эта функция выделит новую строку для возврата.

См. также string().

[since 5.1] uint QStringRef::toUInt(bool *ok = nullptr, int base = 10) const

Возвращает строку, преобразованную в unsigned int с основанием base, которое по умолчанию равно 10 и должно быть в диапазоне от 2 до 36 или 0. Возвращает 0, если преобразование завершается неудачно.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Если base равно 0, используется соглашение языка C: если строка начинается с «0x», используется основание 16; если строка начинается с «0», используется основание 8; в противном случае используется основание 10.

Преобразование строки всегда происходит в локали 'C'. Для преобразования, зависящего от локали, используйте QLocale::toUInt()

Эта функция была добавлена в Qt 5.1.

См. также QString::toUInt().

[since 5.1] ulong QStringRef::toULong(bool *ok = nullptr, int base = 10) const

Возвращает строку, преобразованную в unsigned long с основанием base, которое по умолчанию равно 10 и должно быть в диапазоне от 2 до 36 или 0. Возвращает 0, если преобразование завершается неудачно.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Если base равно 0, используется соглашение языка C: если строка начинается с «0x», используется основание 16; если строка начинается с «0», используется основание 8; в противном случае используется основание 10.

Преобразование строки всегда происходит в локали 'C'. Для преобразования, зависящего от локали, используйте QLocale::toULongLong()

Эта функция была добавлена в Qt 5.1.

См. также QString::toULong().

[since 5.1] qulonglong QStringRef::toULongLong(bool *ok = nullptr, int base = 10) const

Возвращает строку, преобразованную в unsigned long long с основанием base, которое по умолчанию равно 10 и должно быть в диапазоне от 2 до 36 или 0. Возвращает 0, если преобразование завершается неудачно.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Если base равно 0, используется соглашение языка C: если строка начинается с «0x», используется основание 16; если строка начинается с «0», используется основание 8; в противном случае используется основание 10.

Преобразование строки всегда происходит в локали 'C'. Для преобразования, зависящего от локали, используйте QLocale::toULongLong()

Эта функция была добавлена в Qt 5.1.

См. также QString::toULongLong().

[since 5.1] ushort QStringRef::toUShort(bool *ok = nullptr, int base = 10) const

Возвращает строку, преобразованную в unsigned short с основанием base, которое по умолчанию равно 10 и должно быть в диапазоне от 2 до 36 или 0. Возвращает 0, если преобразование завершается неудачно.

Если ok не nullptr, неудача сообщается путем установки *ok в false, а успех — путем установки *ok в true.

Если base равно 0, используется соглашение языка C: если строка начинается с «0x», используется основание 16; если строка начинается с «0», используется основание 8; в противном случае используется основание 10.

Преобразование строки всегда происходит в локали 'C'. Для преобразования, зависящего от локали, используйте QLocale::toUShort()

Эта функция была добавлена в Qt 5.1.

См. также QString::toUShort().

QList<uint> QStringRef::toUcs4() const

Возвращает UCS-4/UTF-32 представление строки в виде QList<uint>.

UCS-4 — это кодировка Unicode, поэтому она без потерь. Все символы из этой строки будут закодированы в UCS-4. Любая некорректная последовательность кодовых единиц в этой строке заменяется универсальным символом замены Unicode (QChar::ReplacementCharacter, что соответствует U+FFFD).

Возвращаемый список не завершается символом '\0'.

См. также toUtf8(), toLatin1(), toLocal8Bit(), и QStringEncoder.

QByteArray QStringRef::toUtf8() const

Возвращает UTF-8 представление строки в виде QByteArray.

UTF-8 — это кодировка Unicode и может представлять все символы в строке Unicode, как в QString.

См. также toLatin1(), toLocal8Bit(), и QStringEncoder.

[since 5.1] QStringRef QStringRef::trimmed() const

Возвращает строку, из которой удалены пробелы в начале и в конце.

Пробелы означают любые символы, для которых QChar::isSpace() возвращает true. Это включает ASCII-символы '\t', '\n', '\v', '\f', '\r' и ' '.

В отличие от QString::simplified(), trimmed() оставляет внутренние пробелы без изменений.

Эта функция была добавлена в Qt 5.1.

См. также QString::trimmed().

[since 5.6] void QStringRef::truncate(int position)

Усекает строку по заданному индексу position.

Если указанный индекс position выходит за пределы строки, ничего не происходит.

Если position отрицательный, он эквивалентен нулю.

Эта функция была добавлена в Qt 5.6.

См. также QString::truncate().

const QChar *QStringRef::unicode() const

Возвращает Unicode представление ссылки на строку. Поскольку данные непосредственно берутся из ссылаемой строки, она не завершается '\0', если только ссылка на строку не включает нулевой терминатор строки.

См. также string().

bool QStringRef::operator!=(const char *s) const

Эта функция перегружает оператор!=().

Указатель s const char преобразуется в QStringRef с помощью функции fromUtf8().

Вы можете отключить этот оператор, определив QT_NO_CAST_FROM_ASCII при компиляции своих приложений. Это может быть полезно, если вы хотите гарантировать, что все отображаемые пользователю строки проходят через QObject::tr(), например.

Возвращает true если эта строка не лексически равна строке-параметру s. В противном случае возвращает false.

См. также QT_NO_CAST_FROM_ASCII.

bool QStringRef::operator<(const char *s) const

Эта функция перегружает оператор<().

Указатель s типа const char преобразуется в QStringRef с помощью функции fromUtf8().

Вы можете отключить этот оператор, определив QT_NO_CAST_FROM_ASCII при компиляции своих приложений. Это может быть полезно, если вы хотите гарантировать, что все отображаемые пользователю строки проходят через QObject::tr(), например.

Возвращает true если эта строка лексически меньше строки-параметра s. В противном случае возвращает false.

См. также QT_NO_CAST_FROM_ASCII.

bool QStringRef::operator<=(const char *s) const

Эта функция перегружает оператор<=().

Указатель s типа const char преобразуется в QStringRef с помощью функции fromUtf8().

Вы можете отключить этот оператор, определив QT_NO_CAST_FROM_ASCII при компиляции своих приложений. Это может быть полезно, если вы хотите гарантировать, что все отображаемые пользователю строки проходят через QObject::tr(), например.

Возвращает true если эта строка лексически меньше или равна строке-параметру s. В противном случае возвращает false.

См. также QT_NO_CAST_FROM_ASCII.

QStringRef &QStringRef::operator=(const QString *string)

Создаёт ссылку на строку string и присваивает её этой строковой ссылке, возвращая результат.

bool QStringRef::operator==(const char *s) const

Эта функция перегружает оператор==().

Массив байтов s преобразуется в QStringRef с помощью функции fromUtf8(). Функция останавливает преобразование при обнаружении первого нулевого символа или в конце массива байтов.

Вы можете отключить этот оператор, определив QT_NO_CAST_FROM_ASCII при компиляции своих приложений. Это может быть полезно, если вы хотите гарантировать, что все отображаемые пользователю строки проходят через QObject::tr(), например.

Возвращает true если эта строка лексически равна строке-параметру s. В противном случае возвращает false.

См. также QT_NO_CAST_FROM_ASCII.

bool QStringRef::operator>(const char *s) const

Эта функция перегружает оператор>().

Указатель s типа const char преобразуется в QStringRef с помощью функции fromUtf8().

Вы можете отключить этот оператор, определив QT_NO_CAST_FROM_ASCII при компиляции своих приложений. Это может быть полезно, если вы хотите гарантировать, что все отображаемые пользователю строки проходят через QObject::tr(), например.

Возвращает true если эта строка лексически больше строки-параметра s. В противном случае возвращает false.

См. также QT_NO_CAST_FROM_ASCII.

bool QStringRef::operator>=(const char *s) const

Эта функция перегружает оператор>=().

Указатель s типа const char преобразуется в QStringRef с помощью функции fromUtf8().

Вы можете отключить этот оператор, определив QT_NO_CAST_FROM_ASCII при компиляции своих приложений. Это может быть полезно, если вы хотите гарантировать, что все отображаемые пользователю строки проходят через QObject::tr(), например.

Возвращает true если эта строка лексически больше или равна строке-параметру s. В противном случае возвращает false.

См. также QT_NO_CAST_FROM_ASCII.

[since 5.7] QChar QStringRef::operator[](int position) const

Возвращает символ по заданному индексу position в строковой ссылке.

position должен быть допустимым индексом в строковой ссылке (т.е., 0 <= position < size()).

Эта функция была добавлена в Qt 5.7.

См. также at().