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.

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

typedef QLatin1String::const_iterator

Этот typedef предоставляет итератор типа STL для QLatin1String с чтением.

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

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

typedef QLatin1String::const_reference

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

Этот 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. Предоставлен для совместимости со стандартной библиотекой шаблонов.

Этот 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 &. Предоставлен для совместимости со стандартной библиотекой шаблонов.

Этот 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. Предоставлен для совместимости со стандартной библиотекой шаблонов.

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

typedef QLatin1String::value_type

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

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

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

Возвращает индекс последнего вхождения строки-представления str, строки Latin-1 l1 или символа ch, соответственно, в этой строке Latin-1, выполняя поиск назад с индекса from. Если from равно -1 (по умолчанию), поиск начинается с последнего символа; если from равно -2, со второго последнего символа и так далее. Возвращает -1, если str не найдено.

Если 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, строки Latin-1 l1 или символа ch соответственно в этой строке Latin-1, выполняя поиск вперёд с позиции индекса from. Возвращает -1, если str не найдено.

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

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

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

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

Возвращает 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(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.

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

Сравнение основано исключительно на числовых значениях 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.

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

Сравнение основано исключительно на числовых значениях кодов Юникода символов и выполняется очень быстро, но не так, как ожидает человек. Рассмотрите возможность сортировки строк пользовательского интерфейса с помощью функции 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.

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

Сравнение основано исключительно на числовых значениях кодов Юникода символов и выполняется очень быстро, но не так, как ожидает человек. Рассмотрите возможность сортировки строк пользовательского интерфейса с помощью 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.

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

Сравнение основано исключительно на числовых значениях кодов Юникода символов и выполняется очень быстро, но не так, как ожидает человек. Рассмотрите возможность сортировки строк пользовательского интерфейса с помощью 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.

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

Сравнение основано исключительно на числовых значениях кодов Юникода символов и выполняется очень быстро, но не так, как ожидает человек. Рассмотрите возможность сортировки строк пользовательского интерфейса с помощью 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.

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

Сравнение основано исключительно на числовых значениях кодов Юникода символов и выполняется очень быстро, но не так, как ожидает человек. Рассмотрите возможность сортировки строк пользовательского интерфейса с помощью 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.

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