Класс QStringRef

Класс QStringRef предоставляет тонкий обертка вокруг подстрок QString. Подробнее...

Этот класс был представлен в Qt 4.3.

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также Неявно совмещенные классы.

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

typedef QStringRef::const_iterator

Этот typedef предоставляет итератор типа const iterator в стиле STL для QStringRef.

Этот typedef был представлен в Qt 5.4.

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

typedef QStringRef::const_reverse_iterator

Этот typedef предоставляет обратный итератор типа const reverse iterator в стиле STL для QStringRef.

Этот typedef был представлен в Qt 5.7.

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

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

QStringRef::QStringRef(const QStringRef &other)

Создает копию ссылки на строку 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()

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

QStringRef &QStringRef::operator=(const QStringRef &other)

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

QStringRef::~QStringRef()

Удаляет ссылку на строку.

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

QStringRef QStringRef::appendTo(QString *string) const

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

const QChar QStringRef::at(int position) const

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

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

QChar QStringRef::back() const

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

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

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

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

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

QStringRef::const_iterator QStringRef::begin() const

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

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

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

QStringRef::const_iterator QStringRef::cbegin() const

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

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

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

QStringRef::const_iterator QStringRef::cend() const

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

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

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

void QStringRef::chop(int n)

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

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

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

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

QStringRef QStringRef::chopped(int len) const

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

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

Эта функция была представлена в 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 = ...)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Это перегруженный метод.

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

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

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

Этот метод был представлен в Qt 4.5.

int QStringRef::compare(const QByteArray &other, Qt::CaseSensitivity cs = ...) 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 = ...)

Это перегруженный метод.

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

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

Этот метод был представлен в Qt 4.5.

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

Это перегруженный метод.

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

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

Этот метод был представлен в Qt 4.5.

QStringRef::const_iterator QStringRef::constBegin() const

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

Этот метод был представлен в Qt 5.9.

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

const QChar *QStringRef::constData() const

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

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 = ...) const

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

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

Этот метод был представлен в Qt 4.8.

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

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

Этот метод перегружает contains().

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

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

Этот метод был представлен в Qt 4.8.

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

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

Этот метод перегружает contains().

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

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

Этот метод был представлен в Qt 4.8.

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

Этот метод перегружает contains().

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

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

Этот метод был представлен в Qt 4.8.

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

bool QStringRef::contains(QStringView str, Qt::CaseSensitivity cs = ...) 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 (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

Этот метод был представлен в Qt 4.8.

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

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

Этот метод перегружает count().

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

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

Этот метод был представлен в Qt 4.8.

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

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

Этот метод перегружает count().

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

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

Этот метод был представлен в Qt 4.8.

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

QStringRef::const_reverse_iterator QStringRef::crbegin() const

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

Этот метод был представлен в Qt 5.7.

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

QStringRef::const_reverse_iterator QStringRef::crend() const

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

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

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

const QChar *QStringRef::data() const

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

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 (по умолчанию), поиск регистрозависимый; в противном случае — регистронезависимый.

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

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

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().

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

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

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

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

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

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

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

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

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

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

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

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

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, со второго с конца и так далее.

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

См. также 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 (по умолчанию), поиск регистрозависимый; в противном случае — регистронезависимый.

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

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

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 не найден.

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

См. также 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, со второго с конца и так далее.

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

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

bool QStringRef::isEmpty() const

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

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

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

bool QStringRef::isNull() const

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

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

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 (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

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

См. также 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 (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

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

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

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

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

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

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

См. также 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 (по умолчанию), поиск выполняется с учётом регистра; в противном случае поиск выполняется без учёта регистра.

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

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

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().

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().

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

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

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

На macOS и iOS эта функция сравнивает согласно настройке «Порядок для отсортированных списков» в панели «Международные настройки».

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

См. также compare() и QLocale.

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

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

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

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

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

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

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

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

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

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

int QStringRef::localeAwareCompare(const QStringRef &s1, const QStringRef &s2)

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

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

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

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

QStringRef QStringRef::mid(int position, int n = ...) const

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

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

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

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

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

int QStringRef::position() const

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

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

QStringRef::const_reverse_iterator QStringRef::rbegin() const

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

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

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

QStringRef::const_reverse_iterator QStringRef::rend() const

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

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

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

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().

QVector<QStringRef> QStringRef::split(const QString &sep, QString::SplitBehavior behavior = QString::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

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

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

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

QVector<QStringRef> QStringRef::split(QChar sep, QString::SplitBehavior behavior = QString::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

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

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

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

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

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

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

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().

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

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

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

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

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

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

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

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

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

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

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

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

const QString *QStringRef::string() const

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

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

double QStringRef::toDouble(bool *ok = nullptr) const

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

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

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

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

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

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

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

float QStringRef::toFloat(bool *ok = nullptr) const

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

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

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

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

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

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

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

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

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

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

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

QByteArray QStringRef::toLocal8Bit() const

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

QTextCodec::codecForLocale() используется для выполнения преобразования из Unicode. Если кодировка локали не может быть определена, эта функция делает то же, что и toLatin1().

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

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

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

long QStringRef::toLong(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::toLong()

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

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

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

Возвращает строку, преобразованную в длинное длинное целое число с основанием 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().

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().

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().

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().

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().

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().

QVector<uint> QStringRef::toUcs4() const

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

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

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

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

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

QByteArray QStringRef::toUtf8() const

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

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

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

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

QStringRef QStringRef::trimmed() const

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

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

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

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

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

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(). Эта функция останавливает преобразование при первом встреченном символе NUL или по достижении конца массива байтов.

Вы можете отключить этот оператор, определив 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.

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

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

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

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

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