Класс 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);

См. также 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).

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

[alias, since 5.10] QLatin1String::value_type

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

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

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

[since 6.0] 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.

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

QStringTokenizer result = sv.tokenize(sep);

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

auto result = sv.tokenize(sep);

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

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

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

[since 5.14] 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().

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

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

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

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

Возвращает индекс позиции последнего вхождения строки-представления str, строки Latin-1 l1 или символа c, соответственно, в этой строке 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, строки l1 Latin-1 или символа ch; в противном случае возвращает false.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает целое число, которое сравнивает с нулем, как эта строка Latin-1 сравнивается со строковым фрагментом str, строкой l1 Latin-1 или символом ch, соответственно.

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

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

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

QLatin1String::QLatin1String(const QByteArray &str)

Создаёт объект QLatin1String, который хранит str.

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

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

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

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

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

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

[since 5.10] QLatin1String::QLatin1String(const char *first, const char *last)

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

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

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

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

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

QLatin1String::QLatin1String(const char *str)

Создаёт объект QLatin1String, который хранит str.

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

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

[since 5.6] QLatin1String::QLatin1String()

Создаёт объект QLatin1String, хранящий nullptr.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[since 5.10] 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).

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

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

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

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

То же самое, что и left(size() - length).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Указатель other const char преобразуется в 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.

Указатель other const char преобразуется в 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.

Указатель other const char преобразуется в 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.

Указатель other const char преобразуется в 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 в этом объекте.

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

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