Класс 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] QLatin1String::const_iterator

Это псевдоним для iterator.

Этот псевдоним был введён в Qt 5.10.

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

[alias] QLatin1String::const_reference

Это псевдоним для reference.

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

Этот псевдоним был введён в Qt 5.11.

[alias] QLatin1String::const_reverse_iterator

Это псевдоним для reverse_iterator.

Этот псевдоним был введён в Qt 5.10.

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

[alias] QLatin1String::difference_type

Это псевдоним для int.

Псевдоним для int. Предоставлен для совместимости со стандартной библиотекой шаблонов.

Этот псевдоним был введён в Qt 5.10.

[alias] QLatin1String::iterator

Это псевдоним для value_type*.

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

Этот псевдоним был введён в Qt 5.10.

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

[alias] QLatin1String::reference

Это псевдоним для value_type&.

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

Этот псевдоним был введён в Qt 5.10.

[alias] QLatin1String::reverse_iterator

Это псевдоним для std::reverse_iterator<iterator>.

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

Этот псевдоним был введён в Qt 5.10.

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

[alias] QLatin1String::size_type

Это псевдоним для int.

Псевдоним для int. Предоставлен для совместимости со стандартной библиотекой шаблонов.

Этот псевдоним был введён в Qt 5.10.

[alias] QLatin1String::value_type

Это псевдоним для const char.

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

Этот псевдоним был введён в Qt 5.10.

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

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, латинской строки l1 или символа ch, соответственно, в этой латинской строке, выполняя поиск назад с позиции индекса from. Если from равно -1 (по умолчанию), поиск начинается с последнего символа; если from равно -2, то с предпоследнего символа и так далее. Возвращает -1, если str не найдено.

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

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

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

Возвращает true если эта латинская строка содержит вхождение строкового представления str, латинской строки 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, поиск начинается с последнего символа; если from равно -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>().

QLatin1String::QLatin1String(const QByteArray &str)

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

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

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

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

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

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

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

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

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

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

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

Поведение не определено, если 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(int 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().

void QLatin1String::chop(int length)

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

То же, что и *this = left(size() - length).

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

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

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

QLatin1String QLatin1String::chopped(int length) const

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

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

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

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

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

QLatin1String::const_reverse_iterator QLatin1String::crbegin() const

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

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

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

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

QLatin1String::const_reverse_iterator QLatin1String::crend() const

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

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

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

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

const char *QLatin1String::data() const

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

QLatin1String::const_iterator QLatin1String::end() const

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

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

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

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

QLatin1Char QLatin1String::front() const

Возвращает первый символ в строке. То же, что и at(0).

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

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

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

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

bool QLatin1String::isEmpty() const

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

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

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

bool QLatin1String::isNull() const

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

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

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

const char *QLatin1String::latin1() const

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

QLatin1String QLatin1String::left(int length) const

Возвращает подстроку длиной length, начинающуюся с позиции 0 в этом объекте.

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

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

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

QLatin1String QLatin1String::mid(int start) const

Возвращает подстроку, начинающуюся с позиции start в этом объекте и продолжающуюся до конца строки.

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

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

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

QLatin1String QLatin1String::mid(int start, int length) const

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

Возвращает подстроку длиной length, начинающуюся с позиции start в этом объекте.

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

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

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

QLatin1String::const_reverse_iterator QLatin1String::rbegin() const

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

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

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

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

QLatin1String::const_reverse_iterator QLatin1String::rend() const

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

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

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

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

QLatin1String QLatin1String::right(int length) const

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

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

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

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

int QLatin1String::size() const

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

QLatin1String QLatin1String::trimmed() const

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

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

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

void QLatin1String::truncate(int length)

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

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

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

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

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

bool QLatin1String::operator!=(const QString &other) const

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

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

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

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

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

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

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

См. также QT_NO_CAST_FROM_ASCII.

bool QLatin1String::operator!=(const QByteArray &other) const

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

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

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

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

См. также QT_NO_CAST_FROM_ASCII.

bool QLatin1String::operator<(const QString &other) const

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

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

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

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

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

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

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

См. также QT_NO_CAST_FROM_ASCII.

bool QLatin1String::operator<(const QByteArray &other) const

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

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

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

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

См. также QT_NO_CAST_FROM_ASCII.

bool QLatin1String::operator<=(const QString &other) const

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

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

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

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

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

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

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

См. также QT_NO_CAST_FROM_ASCII.

bool QLatin1String::operator<=(const QByteArray &other) const

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

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

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

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

См. также QT_NO_CAST_FROM_ASCII.

bool QLatin1String::operator==(const QString &other) const

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

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

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

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

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

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

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

См. также QT_NO_CAST_FROM_ASCII.

bool QLatin1String::operator==(const QByteArray &other) const

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

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

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

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

См. также QT_NO_CAST_FROM_ASCII.

bool QLatin1String::operator>(const QString &other) const

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

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

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

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

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

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

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

См. также QT_NO_CAST_FROM_ASCII.

bool QLatin1String::operator>(const QByteArray &other) const

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

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

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

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

См. также QT_NO_CAST_FROM_ASCII.

bool QLatin1String::operator>=(const QString &other) const

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

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

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

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

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

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

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

См. также QT_NO_CAST_FROM_ASCII.

bool QLatin1String::operator>=(const QByteArray &other) const

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

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

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

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

См. также QT_NO_CAST_FROM_ASCII.

QLatin1Char QLatin1String::operator[](int pos) const

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

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

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

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