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 предоставляет итератор const-стиля 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 предоставляет обратный итератор const-стиля STL для QLatin1String.

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

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

typedef QLatin1String::difference_type

Псевдоним для int. Предоставлен для совместимости со STL.

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

typedef QLatin1String::iterator

Этот typedef предоставляет итератор const-стиля 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 предоставляет обратный итератор const-стиля STL для QLatin1String.

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

См. также 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(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 является нулевой (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().

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

См. также QT_NO_CAST_FROM_ASCII.

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

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

Массив байтов 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.

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

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

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

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.

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

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

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

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

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

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