Класс QStringRef

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

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

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

Типы публичного доступа

Функции публичного доступа

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

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

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

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

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

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

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

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

См. также Встроенные общие классы.

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

[since 5.4] QStringRef::const_iterator

Этот тип данных был добавлен в Qt 5.4.

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

[since 5.7] QStringRef::const_reverse_iterator

Этот тип данных был добавлен в Qt 5.7.

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

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

[default] 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 должна быть положительной или 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 левых символов этой строки.

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

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

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

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

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

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

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

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

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

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

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

См. также 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 превышает длину строки, возвращается нулевая ссылка.

Если в строке, начиная с указанной position, имеется меньше n символов, или если 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

QByteArray QStringRef::toLatin1() const

Возвращает латинско-1 представление строки как 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, а успех — в 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, а успех — в 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, а успех — в 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, а успех — в 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, а успех — в 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, а успех — в 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, а успех — в 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(). Функция останавливает преобразование при обнаружении первого символа NULL или в конце массива байтов.

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