Класс QLatin1String

Класс QLatin1String предоставляет тонкий оболочку вокруг строковой литерал с кодировкой US-ASCII/Latin-1. Подробнее...

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

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

Типы

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

Связанные внешние функции

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

Многие функции-члены QString перегружены для принятия const char * вместо QString. Это включает в себя конструктор копирования, оператор присваивания, операторы сравнения и различные другие функции, такие как insert(), replace() и indexOf(). Эти функции обычно оптимизированы для того, чтобы избежать создания объекта QString для данных const char *. Например, предполагая, что str является QString,

if (str == "auto" || str == "extern"
        || str == "static" || str == "register") {
    ...
}

намного быстрее, чем

if (str == QString("auto") || str == QString("extern")
        || str == QString("static") || str == QString("register")) {
    ...
}

потому что он не создает четыре временных объекта QString и не делает глубокую копию данных символов.

Приложения, которые определяют QT_NO_CAST_FROM_ASCII (как объясняется в документации QString) не имеют доступа к const char * API QString. Для эффективного задания константных строк Latin-1 Qt предоставляет QLatin1String, которая представляет собой очень тонкий оберточный класс над const char *. Используя QLatin1String, пример кода выше становится

if (str == QLatin1String("auto")
        || str == QLatin1String("extern")
        || str == QLatin1String("static")
        || str == QLatin1String("register") {
    ...
}

Это немного длиннее для набора, но оно обеспечивает те же преимущества, что и первая версия кода, и быстрее, чем преобразование строк Latin-1 с помощью QString::fromLatin1().

Благодаря конструктору QString(QLatin1String), QLatin1String можно использовать везде, где ожидается QString. Например:

QLabel *label = new QLabel(QLatin1String("MOD"), this);

Примечание: Если вызываемая функция с аргументом QLatin1String фактически не перегружена для принятия QLatin1String, неявное преобразование в QString вызовет выделение памяти, чего обычно и следует избегать, используя QLatin1String в первую очередь. В таких случаях использование QStringLiteral может быть лучшим вариантом.

См. также QString, QLatin1Char, QStringLiteral и QT_NO_CAST_FROM_ASCII.

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

[alias, since 5.10] QLatin1String::const_iterator

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

См. также iterator и const_reverse_iterator.

[alias, since 5.11] QLatin1String::const_reference

Псевдоним для reference. Предоставлен для совместимости со стандартной библиотекой шаблонов (STL).

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

[alias, since 5.10] QLatin1String::const_reverse_iterator

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

См. также reverse_iterator и const_iterator.

[alias, since 5.10] QLatin1String::difference_type

Псевдоним для qsizetype. Предоставлен для совместимости со стандартной библиотекой шаблонов (STL).

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

[alias, since 5.10] QLatin1String::iterator

QLatin1String не поддерживает изменяемые итераторы, поэтому он идентичен const_iterator.

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

См. также const_iterator и reverse_iterator.

[alias, since 5.10] QLatin1String::reference

Псевдоним для value_type &. Предоставлен для совместимости со стандартной библиотекой шаблонов (STL).

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

[alias, since 5.10] QLatin1String::reverse_iterator

QLatin1String не поддерживает изменяемые обратные итераторы, поэтому он идентичен const_reverse_iterator.

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

См. также const_reverse_iterator и iterator.

[alias, since 5.10] QLatin1String::size_type

Псевдоним для qsizetype. Предоставлен для совместимости со стандартной библиотекой шаблонов (STL).

Примечание: В версиях Qt до Qt 6 это был псевдоним для int, ограничивая объём данных, которые могут храниться в QLatin1String на 64-битных архитектурах.

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

[alias, since 5.10] QLatin1String::value_type

Псевдоним для const char. Предоставлен для совместимости со стандартной библиотекой шаблонов (STL).

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

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

template <typename Needle, typename Flags> decltype(qTokenize(*this, std::forward<Needle>(needle), flags...)) QLatin1String::tokenize(Needle &&sep, Flags... flags) const

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

Эквивалентно

return QStringTokenizer{std::forward<Needle>(sep), flags...};

за исключением того, что оно работает без включённого в компилятор C++17 вывода аргументов шаблона (CTAD).

См. QStringTokenizer, чтобы узнать, как sep и flags взаимодействуют, формируя результат.

Примечание: Хотя эта функция возвращает QStringTokenizer, вы никогда не должны явно называть её аргументы шаблона. Если вы можете использовать вывод аргументов шаблона C++17 (CTAD), вы можете написать

QStringTokenizer result = sv.tokenize(sep);

(без аргументов шаблона). Если вы не можете использовать C++17 CTAD, вы должны хранить возвращаемое значение только в auto переменных:

auto result = sv.tokenize(sep);

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

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

См. также QStringTokenizer и qTokenize().

template <typename Args> QString QLatin1String::arg(Args &&... args) const

Заменяет вхождения %N в этой строке соответствующим аргументом из args. Аргументы не позиционные: первый из args заменяет %N с наименьшим N (все из них), второй из args заменяет %N с последующим наименьшим N и т.д.

Args может содержать что угодно, что неявно преобразуется в QString, QStringView или QLatin1String.

Кроме того, также поддерживаются следующие типы: QChar, QLatin1Char.

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

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

Возвращает индекс позиции последнего вхождения подстроки str, строки Latin-1 l1 или символа ch, соответственно, в этой строке Latin-1, выполняя поиск назад с индекса from. Возвращает -1, если str не найдено.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает true если эта латинская строка начинается со строкового представления str, латинской строки l1 или символа ch соответственно; в противном случае возвращает false.

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

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

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

Возвращает целое число, которое сравнивается с нулём, как эта латинская строка сравнивается со строковым представлением str, латинской строкой l1 или символом ch соответственно.

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

См. также operator==(), operator<() и operator>().

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

QLatin1String::QLatin1String(const QByteArray &str)

Конструирует объект QLatin1String, который хранит str.

Данные строки не копируются. Вызывающий код должен гарантировать, что str не будет удалён или изменён до тех пор, пока существует объект QLatin1String.

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

QLatin1String::QLatin1String(const char *str, qsizetype size)

Конструирует объект QLatin1String, который хранит str размером size.

Данные строки не копируются. Вызывающий код должен гарантировать, что str не будет удалён или изменён до тех пор, пока существует объект QLatin1String.

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

QLatin1String::QLatin1String(const char *first, const char *last)

Конструирует объект QLatin1String, который хранит first длиной (last - first).

Диапазон [first,last) должен оставаться валидным для всего срока существования этого объекта латинской строки.

Передача nullptr в качестве first безопасна, если last также nullptr, и приводит к нулевой латинской строке.

Поведение не определено, если last предшествует first, first это nullptr и last нет, или если last - first > INT_MAX.

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

QLatin1String::QLatin1String(const char *str)

Конструирует объект QLatin1String, который хранит str.

Данные строки не копируются. Вызывающий код должен гарантировать, что str не будет удалён или изменён до тех пор, пока существует объект QLatin1String.

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

QLatin1String::QLatin1String()

Конструирует объект QLatin1String, который хранит nullptr.

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

QLatin1Char QLatin1String::at(qsizetype pos) const

Возвращает символ в позиции pos в этом объекте.

Примечание: Эта функция не выполняет проверки ошибок. Поведение неопределено, когда pos < 0 или pos >= size().

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

См. также operator[]().

QLatin1Char QLatin1String::back() const

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

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

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

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

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

QLatin1String::const_iterator QLatin1String::begin() const

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

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

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

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

QLatin1String::const_iterator QLatin1String::cbegin() const

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

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

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

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

QLatin1String::const_iterator QLatin1String::cend() const

Аналогично end().

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

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

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

[since 5.10] void QLatin1String::chop(qsizetype length)

Усекает строку на length символов.

Аналогично *this = left(size() - length).

Примечание: Поведение неопределено, когда length < 0 или length > size().

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

См. также sliced(), first(), last(), chopped() и truncate().

[since 5.10] QLatin1String QLatin1String::chopped(qsizetype length) const

Возвращает подстроку длиной size() - length, начиная с начала объекта.

Аналогично left(size() - length).

Примечание: Поведение неопределено, когда length < 0 или length > size().

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

См. также sliced(), first(), last(), chop() и truncate().

[since 5.10] QLatin1String::const_reverse_iterator QLatin1String::crbegin() const

Аналогично rbegin().

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

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

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

[since 5.10] QLatin1String::const_reverse_iterator QLatin1String::crend() const

Аналогично rend().

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

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

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

const char *QLatin1String::data() const

Возвращает строку Latin-1, хранящуюся в этом объекте.

[since 5.10] QLatin1String::const_iterator QLatin1String::end() const

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

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

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

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

[since 6.0] QLatin1String QLatin1String::first(qsizetype n) const

Возвращает строку Latin-1, содержащую первые n символов этой строки Latin-1.

Примечание: Поведение неопределено, когда n < 0 или n > size().

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

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

[since 5.10] QLatin1Char QLatin1String::front() const

Возвращает первый символ в строке. Аналогично at(0).

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

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

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

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

[since 5.10] bool QLatin1String::isEmpty() const

Возвращает значение, указывающее, пуста ли хранимая в этом объекте строка Latin-1 (size() == 0) или нет.

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

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

[since 5.10] bool QLatin1String::isNull() const

Возвращает значение, указывающее, является ли хранимая в этом объекте строка Latin-1 нулевой (data() == nullptr) или нет.

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

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

[since 6.0] QLatin1String QLatin1String::last(qsizetype n) const

Возвращает строку Latin-1, содержащую последние n символов этой строки Latin-1.

Примечание: Поведение неопределено, когда n < 0 или n > size().

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

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

const char *QLatin1String::latin1() const

Возвращает строку Latin-1, хранящуюся в этом объекте.

[since 5.8] QLatin1String QLatin1String::left(qsizetype length) const

Если известно, что length не может быть вне границ, используйте first() вместо этого в новом коде, так как он быстрее.

Возвращает подстроку длиной length, начиная с позиции 0 в этой строке Latin-1.

Возвращается вся строка Latin-1, если length больше или равно size() или меньше нуля.

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

См. также first(), last(), sliced(), startsWith(), chopped(), chop() и truncate().

[since 5.8] QLatin1String QLatin1String::mid(qsizetype start, qsizetype length = -1) const

Возвращает подстроку длиной length, начиная с позиции start в этой строке Latin-1.

Если известно, что start и length не могут быть вне границ, используйте sliced() вместо этого в новом коде, так как он быстрее.

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

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

См. также first(), last(), sliced(), chopped(), chop() и truncate().

[since 5.10] QLatin1String::const_reverse_iterator QLatin1String::rbegin() const

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

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

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

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

[since 5.10] QLatin1String::const_reverse_iterator QLatin1String::rend() const

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

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

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

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

[since 5.8] QLatin1String QLatin1String::right(qsizetype length) const

Если известно, что length не может быть вне границ, используйте last() вместо этого в новом коде, так как он быстрее.

Возвращает подстроку длиной length, начиная с позиции size() - length в этой строке Latin-1.

Возвращается вся строка Latin-1, если length больше или равно size() или меньше нуля.

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

См. также first(), last(), sliced(), endsWith(), chopped(), chop() и truncate().

qsizetype QLatin1String::size() const

Возвращает размер строки Latin-1, хранящейся в этом объекте.

Примечание: В версиях Qt до 6 эта функция возвращала int, ограничивая количество данных, которые можно хранить в QLatin1String на 64-битных архитектурах.

[since 6.0] QLatin1String QLatin1String::sliced(qsizetype pos) const

Возвращает строку Latin-1, начинающуюся с позиции pos в этой строке Latin-1 и продолжающуюся до её конца.

Примечание: Поведение не определено, когда pos < 0 или pos > size().

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

См. также first(), last(), chopped(), chop() и truncate().

[since 6.0] QLatin1String QLatin1String::sliced(qsizetype pos, qsizetype n) const

Возвращает строку Latin-1, которая указывает на n символов этой строки Latin-1, начиная с позиции pos.

Примечание: Поведение не определено, когда pos < 0, n < 0 или pos + n > size().

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

См. также first(), last(), chopped(), chop() и truncate().

[since 6.0] QString QLatin1String::toString() const

Преобразует эту строку Latin-1 в QString. Эквивалентно

return QString(*this);

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

[since 5.10] QLatin1String QLatin1String::trimmed() const

Удаляет начальные и конечные пробелы и возвращает результат.

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

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

[since 5.10] void QLatin1String::truncate(qsizetype length)

Усекает эту строку до длины length.

То же самое, что и *this = left(length).

Примечание: Поведение не определено, когда length < 0 или length > size().

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

См. также sliced(), first(), last(), chopped() и chop().

bool QLatin1String::operator!=(const char *other) const

Возвращает true если эта строка не равна указателю const char other; в противном случае возвращает false.

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

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

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

[since 5.0] bool QLatin1String::operator!=(const QByteArray &other) const

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

Массив байтов other преобразуется в QString с помощью функции QString::fromUtf8().

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

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

bool QLatin1String::operator<(const char *other) const

Возвращает true если эта строка лексически меньше указателя const char other; в противном случае возвращает false.

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

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

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

[since 5.0] bool QLatin1String::operator<(const QByteArray &other) const

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

Массив байтов other преобразуется в QString с помощью функции QString::fromUtf8().

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

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

bool QLatin1String::operator<=(const char *other) const

Возвращает true если эта строка лексически меньше или равна указателю const char other; в противном случае возвращает false.

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

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

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

[since 5.0] bool QLatin1String::operator<=(const QByteArray &other) const

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

Массив байтов other преобразуется в QString с помощью функции QString::fromUtf8().

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

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

bool QLatin1String::operator==(const char *other) const

Возвращает true если строка равна указателю const char other; в противном случае возвращает false.

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

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

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

[since 5.0] bool QLatin1String::operator==(const QByteArray &other) const

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

Массив байтов other преобразуется в QString с помощью функции QString::fromUtf8().

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

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

bool QLatin1String::operator>(const char *other) const

Возвращает true если эта строка лексически больше указателя const char other; в противном случае возвращает false.

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

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

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

[since 5.0] bool QLatin1String::operator>(const QByteArray &other) const

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

Массив байтов other преобразуется в QString с помощью функции QString::fromUtf8().

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

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

bool QLatin1String::operator>=(const char *other) const

Возвращает true если эта строка лексически больше или равна указателю const char other; в противном случае возвращает false.

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

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

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

[since 5.0] bool QLatin1String::operator>=(const QByteArray &other) const

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

Массив байтов other преобразуется в QString с помощью функции QString::fromUtf8().

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

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

[since 5.8] QLatin1Char QLatin1String::operator[](qsizetype pos) const

Возвращает символ в позиции pos в этом объекте.

Примечание: Эта функция не выполняет проверки ошибок. Поведение не определено, когда pos < 0 или pos >= size().

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

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