Класс QStringRef

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

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

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

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

Общие типы

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

Статические открытые члены

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

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

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

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

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

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

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

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

См. также Неявные объединённые классы.

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

typedef QStringRef::const_iterator

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

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

typedef QStringRef::const_reverse_iterator

Этот 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

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

Эта функция была введена в 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 больше или равно size(), результатом является пустая строка; если n отрицательное, это эквивалентно передаче нуля.

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

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

QStringRef QStringRef::chopped(int len) const

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

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

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

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

void QStringRef::clear()

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 и возвращает целое число, меньшее, равное или большее нуля, если эта строка меньше, равна или больше строки other.

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

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

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

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

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

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

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

Сравнивает строку 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 = Qt::CaseSensitive) const

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

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

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

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

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

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

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

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

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

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

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

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

Если 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() возвращает true).

См. также 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 соответственно.

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

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

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

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

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

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

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

int QStringRef::position() const

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

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

QStringRef::const_reverse_iterator QStringRef::rbegin() 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, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

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

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

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

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

Эта функция была добавлена в 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, а успех - в true.

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

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

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

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

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

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

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

Если ok не равен нулю, неудача при преобразовании сообщается, установив *ok в false, а успех - в 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, а успех - в true.

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

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

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

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

QByteArray QStringRef::toLatin1() const

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

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

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

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

QByteArray QStringRef::toLocal8Bit() const

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

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

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

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

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

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

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

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

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

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

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

QByteArray QStringRef::toUtf8() const

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

UTF-8 — это кодировка Юникода и может представлять все символы в строке Юникода, такой как 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(). Функция останавливает преобразование при обнаружении первого нулевого символа или в конце массива байтов.

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