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 и 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 предоставляет итератор в стиле 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.

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

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

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

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

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

Этот метод был добавлен в Qt 5.8.

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