Класс QLatin1String

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

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

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

Публичные типы

Публичные функции

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

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

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

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

typedef QLatin1String::const_iterator

Этот typedef предоставляет итератор типа STL для константного доступа к QLatin1String.

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

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

typedef QLatin1String::const_reference

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

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

typedef QLatin1String::const_reverse_iterator

Этот typedef предоставляет обратный итератор типа STL для константного доступа к QLatin1String.

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

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

typedef QLatin1String::difference_type

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

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

typedef QLatin1String::iterator

Этот typedef предоставляет итератор типа STL для константного доступа к QLatin1String.

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

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

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

typedef QLatin1String::reference

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

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

typedef QLatin1String::reverse_iterator

Этот typedef предоставляет обратный итератор типа STL для константного доступа к QLatin1String.

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

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

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

typedef QLatin1String::size_type

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

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

typedef QLatin1String::value_type

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

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

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

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

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

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

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

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

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

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

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

QLatin1String::QLatin1String()

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

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

QLatin1String::QLatin1String(const char *str)

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

Данные строки не копируются. Вызывающий код должен гарантировать, что 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.

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

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

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

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

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

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

QLatin1String::QLatin1String(const QByteArray &str)

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

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

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

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

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

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

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

bool QLatin1String::isNull() const

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

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

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

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

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

Сравнение основано исключительно на числовых значениях Unicode символов и очень быстрое, но не соответствует ожиданиям человека. Рассмотрите сортировку строк пользовательского интерфейса с помощью QString::localeAwareCompare().

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

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

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

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

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

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

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

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

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

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

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

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

Сравнение основано исключительно на числовых значениях Unicode символов и очень быстрое, но не соответствует ожиданиям человека. Рассмотрите сортировку строк пользовательского интерфейса с использованием функции QString::localeAwareCompare().

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

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

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

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

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

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

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

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

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

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

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

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

Сравнение основано исключительно на числовых значениях Unicode символов и очень быстрое, но не соответствует ожиданиям человека. Рассмотрите сортировку строк пользовательского интерфейса с помощью QString::localeAwareCompare().

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

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

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

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

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

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 QString &other) const

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

Сравнение основано исключительно на числовых значениях Unicode символов и очень быстрое, но не соответствует ожиданиям человека. Рассмотрите сортировку строк пользовательского интерфейса с помощью QString::localeAwareCompare().

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

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

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

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

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

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 QString &other) const

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

Сравнение основано исключительно на числовых значениях Unicode символов и очень быстрое, но не соответствует ожиданиям человека. Рассмотрите сортировку строк пользовательского интерфейса с помощью QString::localeAwareCompare().

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

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

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

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

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

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

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

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

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

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

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

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

Сравнение основано исключительно на числовых значениях Юникода символов и очень быстрое, но не соответствует ожиданиям человека. Для сортировки строк пользовательского интерфейса следует использовать QString::localeAwareCompare().

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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