#include <QString>

 QString str = "Hello";

 static const QChar data[4] = { 0x0055, 0x006e, 0x10e3, 0x03a3 };
 QString str(data, 4);

 QString str;
 str.resize(4);

 str[0] = QChar('U');
 str[1] = QChar('n');
 str[2] = QChar(0x10e3);
 str[3] = QChar(0x03a3);

 QString str;

 for (int i = 0; i < str.size(); ++i) {
     if (str.at(i) >= QChar('a') && str.at(i) <= QChar('f'))
         qDebug() << "Found character in range [a-f]";
 }

 QString str;

 if (str == "auto" || str == "extern"
         || str == "static" || str == "register") {
     // ...
 }

 QString str = "and";
 str.prepend("rock ");     // str == "rock and"
 str.append(" roll");        // str == "rock and roll"
 str.replace(5, 3, "&");   // str == "rock & roll"

 QString str = "We must be <b>bold</b>, very <b>bold</b>";
 int j = 0;

 while ((j = str.indexOf("<b>", j)) != -1) {
     qDebug() << "Found <b> tag at index position" << j;
     ++j;
 }

 DEFINES += QT_NO_CAST_FROM_ASCII \
            QT_NO_CAST_TO_ASCII

 QString url = QLatin1String("http://www.unicode.org/");

 QString Widget::boolToString(bool b)
 {
     QString result;
     if (b)
         result = "True";
     else
         result = "False";
     return result;
 }

 QString().isNull();               // возвращает true
 QString().isEmpty();              // возвращает true

 QString("").isNull();             // возвращает false
 QString("").isEmpty();            // возвращает true

 QString("abc").isNull();          // возвращает false
 QString("abc").isEmpty();         // возвращает false

     QString foo;
     QString type = "long";

     foo->setText(QLatin1String("vector<") + type + QLatin1String(">::iterator"));

     if (foo.startsWith("(" + type + ") 0x"))
         ...

     #include <QStringBuilder>

     QString hello("hello");
     QStringRef el(&hello, 2, 3);
     QLatin1String world("world");
     QString message =  hello % el % world % QChar('!');

     #define QT_USE_FAST_CONCATENATION

     #define QT_USE_FAST_CONCATENATION
     #define QT_USE_FAST_OPERATOR_PLUS

Описание функций-членов

QString::QString ()

Создаёт нулевую строку. Нулевые строки также являются пустыми.

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

QString::QString ( const QChar * unicode, int size )

Создаёт строку, инициализированную первыми size символами QChar массива unicode.

QString делает глубокую копию строковых данных. Unicode-данные копируются как есть, а символ Byte Order Mark сохраняется, если он присутствует.

QString::QString ( const QChar * unicode )

Создаёт строку, инициализированную символами QChar массива unicode, который должен завершаться 0.

QString делает глубокую копию строковых данных. Unicode-данные копируются как есть, а символ Byte Order Mark сохраняется, если он присутствует.

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

QString::QString ( QChar ch )

Создаёт строку размером 1, содержащую символ ch.

QString::QString ( int size, QChar ch )

Создаёт строку заданного размера size, каждый символ которой установлен в ch.

Смотрите также fill().

QString::QString ( const QLatin1String & str )

Создаёт копию Latin-1 строки str.

Смотрите также fromLatin1().

QString::QString ( const QString & other )

Создаёт копию other.

Эта операция занимает постоянное время, поскольку QString использует неявное совместное использование данных. Это делает возвращение QString, как результата функции, очень быстрым. Если экземпляр с разделением данных изменяется, то он будет скопирован (copy-on-write), и это потребует линейного времени.

Смотрите также operator=().

QString::QString ( const char * str )

Создаёт строку, инициализированную 8-битной строкой str. Получаемый константный указатель на char преобразуется в Unicode при помощи функции fromAscii().

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

Смотрите также fromAscii(), fromLatin1(), fromLocal8Bit() и fromUtf8().

QString::QString ( const QByteArray & ba )

Создаёт строку, инициализированную массивом байт ba. Получаемый массив байт преобразуется в Unicode при помощи fromAscii(). Копирование останавливается на первом символе 0, в противном случае копируется весь массив байт.

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

Смотрите также fromAscii(), fromLatin1(), fromLocal8Bit() и fromUtf8().

QString::~QString ()

Уничтожает строку.

QString & QString::append ( const QString & str )

Добавляет строку str в конец этой строки.

Пример:

 QString x = "free";
 QString y = "dom";

 x.append(y);
 // x == "freedom"

Это то же самое, что и использование функции insert():

 x.insert(x.size(), y);

Функция append() обычно очень быстрая (занимает постоянное время), поскольку QString резервирует дополнительное место в конце строковых данных, что позволяет ему увеличиваться, не перераспределяя строку каждый раз.

Смотрите также operator+=(), prepend() и insert().

QString & QString::append ( const QStringRef & reference )

Добавляет получаемую ссылку reference на строку к этой строке и возвращает результат.

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

QString & QString::append ( const QLatin1String & str )

Эта функция перегружает функцию append().

Добавляет строку str в кодах Latin-1 к этой строке.

QString & QString::append ( const QByteArray & ba )

Эта функция перегружает функцию append().

Добавляет массив байт ba к этой строке. Получаемый массив байт преобразуется в Unicode при помощи функции fromAscii().

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

QString & QString::append ( const char * str )

Эта функция перегружает функцию append().

Добавляет строку str к этой строке. Получаемый константный указатель на char преобразуется в Unicode при помощи функции fromAscii().

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

QString & QString::append ( QChar ch )

Эта функция перегружает функцию append().

Добавляет символ ch к этой строке.

QString QString::arg ( const QString & a, int fieldWidth = 0, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Возвращает копию этой строки с заменённым строкой a маркером размещения с наименьшим номером, например, %1, %2, ..., %99.

fieldWidth определяет минимальное количество места, которое должен занимать аргумент a. Если для a необходимо места меньше, чем fieldWidth, то он дополняется до fieldWidth символом fillChar. Положительное значение fieldWidth производит выравнивание по правому краю. Отрицательное значение fieldWidth производит выравнивание по левому краю.

Этот пример показывает, как мы могли бы создать строку status для отчёта о продвижении при обработке списка файлов:

 QString i;           // текущий номер файла
 QString total;       // количество файлов в обработке
 QString fileName;    // текущее имя файла

 QString status = QString("Processing file %1 of %2: %3")
                 .arg(i).arg(total).arg(fileName);

В начале arg(i) заменяет %1. Затем arg(total) заменяет %2. Наконец, arg(fileName) заменяет %3.

Одним из преимуществ использования arg() над sprintf() является то, что порядок маркеров размещения может измениться, если строки приложения будут переведены на другие языки, но каждый arg() будет всё так же заменять наименьший по номеру не заменённый маркер размещения, независимо от того, где он появляется. Кроме того, если маркер размещения %i появляется в строке несколько раз, arg() заменяет все вхождения.

Если не осталось ни одного не заменённого маркера размещения, то выводится предупреждающее сообщение, и результат не определён. Номера маркеров размещения должны быть в диапазоне от 1 до 99.

QString QString::arg ( const QString & a1, const QString & a2 ) const

Эта функция перегружает функцию arg().

Это то же самое, что и str.arg(a1).arg(a2), за исключением того что строки a1 и a2 заменяются за один проход. Это может иметь значение, если a1 содержит, например, %1:

 QString str;
 str = "%1 %2";

 str.arg("%1f", "Hello");        // возвращает "%1f Hello"
 str.arg("%1f").arg("Hello");    // возвращает "Hellof %2"

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3 ) const

Эта функция перегружает функцию arg().

Это то же самое, что и вызов str.arg(a1).arg(a2).arg(a3), за исключением того что строки a1, a2 и a3 заменяются за один проход.

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3, const QString & a4 ) const

Эта функция перегружает функцию arg().

Это то же самое, что и вызов str.arg(a1).arg(a2).arg(a3).arg(a4), за исключением того что строки a1, a2, a3 и a4 заменяются за один проход.

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5 ) const

Эта функция перегружает функцию arg().

Это то же самое, что и вызов str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5), за исключением того что строки a1, a2, a3, a4 и a5 заменяются за один проход.

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5, const QString & a6 ) const

Эта функция перегружает функцию arg().

Это то же самое, что и вызов str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5).arg(a6), за исключением того что строки a1, a2, a3, a4, a5 и a6 заменяются за один проход.

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5, const QString & a6, const QString & a7 ) const

Эта функция перегружает функцию arg().

Это то же самое, что и вызов str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5).arg(a6).arg(a7), за исключением того что строки a1, a2, a3, a4, a5, a6 и a7 заменяются за один проход.

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5, const QString & a6, const QString & a7, const QString & a8 ) const

Эта функция перегружает функцию arg().

Это то же самое, что и вызов str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5).arg(a6).arg(a7).arg(a8), за исключением того что строки a1, a2, a3, a4, a5, a6, a7 и a8 заменяются за один проход.

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5, const QString & a6, const QString & a7, const QString & a8, const QString & a9 ) const

Эта функция перегружает функцию arg().

Это то же самое, что и вызов str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5).arg(a6).arg(a7).arg(a8).arg(a9), за исключением того что строки a1, a2, a3, a4, a5, a6, a7, a8 и a9 заменяются за один проход.

QString QString::arg ( int a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Эта функция перегружает функцию arg().

Аргумент a представляется по основанию base, которое по умолчанию равно 10 и должно быть между 2 и 36. Для оснований, отличных от 10, a рассматривается как целое число без знака.

fieldWidth определяет минимальное количество места, до которого дополняется a и заполняется символом fillChar. Положительное значение производит выравнивание текста по правому краю, отрицательное - по левому.

За '%' может следовать 'L', в этом случае результат заменяется локализованным представлением a. При преобразовании используется локаль по умолчанию, установленная функцией QLocale::setDefault(). Если локаль по умолчанию не была указана, используется локаль "C". Флаг 'L' игнорируется, если основание base не равно 10.

 QString str;
 str = QString("Decimal 63 is %1 in hexadecimal")
         .arg(63, 0, 16);
 // str == "Decimal 63 is 3f in hexadecimal"

 QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
 str = QString("%1 %L2 %L3")
         .arg(12345)
         .arg(12345)
         .arg(12345, 0, 16);
 // str == "12345 12,345 3039"

Если fillChar равен '0' (цифра 0, ASCII 48), используется ноль локали. Для отрицательных значений ведущие нули могут появиться перед знаком минус.

QString QString::arg ( uint a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Эта функция перегружает функцию arg().

Аргумент base определяет основание, используемое при преобразовании целого a в строку. Основание должно быть между 2 и 36.

Если fillChar равен '0' (цифра 0, ASCII 48), используется ноль локали. Для отрицательных значений ведущие нули могут появиться перед знаком минус.

QString QString::arg ( long a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Эта функция перегружает функцию arg().

fieldWidth определяет минимальное количество места, до которого дополняется a и заполняется символом fillChar. Положительное значение производит выравнивание текста по правому краю, отрицательное - по левому.

Аргумент a представляется по полученному основанию base, которое по умолчанию равно 10 и должно быть между 2 и 36.

За '%' может следовать 'L', в этом случае результат заменяется локализованным представлением a. При преобразовании используется локаль по умолчанию. Локаль по умолчанию определяется из настроек локали системы при запуске приложения. Она может быть изменена с помощью QLocale::setDefault(). Флаг 'L' игнорируется, если основание base не равно 10.

 QString str;
 str = QString("Decimal 63 is %1 in hexadecimal")
         .arg(63, 0, 16);
 // str == "Decimal 63 is 3f in hexadecimal"

 QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
 str = QString("%1 %L2 %L3")
         .arg(12345)
         .arg(12345)
         .arg(12345, 0, 16);
 // str == "12345 12,345 3039"

Если fillChar равен '0' (цифра 0, ASCII 48), используется ноль локали. Для отрицательных значений ведущие нули могут появиться перед знаком минус.

QString QString::arg ( ulong a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Эта функция перегружает функцию arg().

fieldWidth определяет минимальное количество места, до которого дополняется a и заполняется символом fillChar. Положительное значение производит выравнивание текста по правому краю, отрицательное - по левому.

Аргумент base определяет основание, используемое при преобразовании целого a в строку. Основание должно быть между 2 и 36, причём 8 - это восьмеричные числа, 10 - десятичные и 16 - шестнадцатеричные.

Если fillChar равен '0' (цифра 0, ASCII 48), используется ноль локали. Для отрицательных значений ведущие нули могут появиться перед знаком минус.

QString QString::arg ( qlonglong a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Эта функция перегружает функцию arg().

fieldWidth определяет минимальное количество места, до которого дополняется a и заполняется символом fillChar. Положительное значение производит выравнивание текста по правому краю, отрицательное - по левому.

Аргумент base определяет основание, используемое при преобразовании целого a в строку. Основание должно быть между 2 и 36, причём 8 - это восьмеричные числа, 10 - десятичные и 16 - шестнадцатеричные.

Если fillChar равен '0' (цифра 0, ASCII 48), используется ноль локали. Для отрицательных значений ведущие нули могут появиться перед знаком минус.

QString QString::arg ( qulonglong a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Эта функция перегружает функцию arg().

fieldWidth определяет минимальное количество места, до которого дополняется a и заполняется символом fillChar. Положительное значение производит выравнивание текста по правому краю, отрицательное - по левому.

Аргумент base определяет основание, используемое при преобразовании целого a в строку. Основание base должно быть между 2 и 36, причём 8 - это восьмеричные числа, 10 - десятичные и 16 - шестнадцатеричные.

Если fillChar равен '0' (цифра 0, ASCII 48), используется ноль локали. Для отрицательных значений ведущие нули могут появиться перед знаком минус.

QString QString::arg ( short a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Эта функция перегружает функцию arg().

fieldWidth определяет минимальное количество места, до которого дополняется a и заполняется символом fillChar. Положительное значение производит выравнивание текста по правому краю, отрицательное - по левому.

Аргумент base определяет основание, используемое при преобразовании целого a в строку. Основание должно быть между 2 и 36, причём 8 - это восьмеричные числа, 10 - десятичные и 16 - шестнадцатеричные.

Если fillChar равен '0' (цифра 0, ASCII 48), используется ноль локали. Для отрицательных значений ведущие нули могут появиться перед знаком минус.

QString QString::arg ( ushort a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Эта функция перегружает функцию arg().

fieldWidth определяет минимальное количество места, до которого дополняется a и заполняется символом fillChar. Положительное значение производит выравнивание текста по правому краю, отрицательное - по левому.

Аргумент base определяет основание, используемое при преобразовании целого a в строку. Основание должно быть между 2 и 36, причём 8 - это восьмеричные числа, 10 - десятичные и 16 - шестнадцатеричные.

Если fillChar равен '0' (цифра 0, ASCII 48), используется ноль локали. Для отрицательных значений ведущие нули могут появиться перед знаком минус.

QString QString::arg ( QChar a, int fieldWidth = 0, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Эта функция перегружает функцию arg().

QString QString::arg ( char a, int fieldWidth = 0, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Эта функция перегружает функцию arg().

Аргумент a интерпретируется как символ в коде Latin-1.

QString QString::arg ( double a, int fieldWidth = 0, char format = 'g', int precision = -1, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Эта функция перегружает функцию arg().

Аргумент a форматируется в соответствии с указанными форматом format и точностью precision. Для получения подробной информации смотрите Форматы аргументов.

fieldWidth определяет минимальное количество места, до которого дополняется a и заполняется символом fillChar. Положительное значение производит выравнивание текста по правому краю, отрицательное - по левому.

 double d = 12.34;
 QString str = QString("delta: %1").arg(d, 0, 'E', 3);
 // str == "delta: 1.234E+01"

За '%' может следовать 'L', в этом случае результат заменяется локализованным представлением a. При преобразовании используется локаль по умолчанию, установленная функцией QLocale::setDefault(). Если локаль по умолчанию не была указана, используется локаль "C".

Если fillChar равен '0' (цифра 0, ASCII 48), эта функция будет использовать ноль локали для заполнения. Для отрицательных значений ведущие нули, вероятно, появятся перед знаком минус.

Смотрите также QLocale::toString().

const QChar QString::at ( int position ) const

Возвращает символ по указанному индексу position в строке.

Позиция position должна быть действительным индексом в строке (т.е., 0 <= position < size()).

Смотрите также operator[]().

iterator QString::begin ()

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

Смотрите также constBegin() и end().

const_iterator QString::begin () const

Эта функция перегружает функцию begin().

int QString::capacity () const

Возвращает максимальное число символов, которые могут быть сохранены в строке без дополнительного перераспределения памяти.

Единственная цель этой функции - обеспечить оптимальное использование памяти в QString. Вообще, у вас крайне редко возникнет необходимость вызывать эту функцию. Если вы хотите узнать количество символов в массиве, используйте size().

Смотрите также reserve() и squeeze().

void QString::chop ( int n )

Удаляет n символов в конце строки.

Если n больше, чем size(), то вы получите пустую строку.

Пример:

 QString str("LOGOUT\r\n");
 str.chop(2);
 // str == "LOGOUT"

Если вы хотите удалить символы в начале строки, используйте вместо этого remove().

Смотрите также truncate(), resize() и remove().

void QString::clear ()

Очищает содержимое строки и делает её пустой.

Смотрите также resize() и isEmpty().

int QString::compare ( const QString & s1, const QString & s2, Qt::CaseSensitivity cs ) [static]

Сравнивает s1 с s2 и возвращает целое число, меньшее, равное или большее нуля, если s1 меньше, равно или больше, чем s2, соответственно.

Если cs равен Qt::CaseSensitive, то сравнение происходит с учётом регистра, в противном случае - без учёта.

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

 int x = QString::compare("aUtO", "AuTo", Qt::CaseInsensitive);  // x == 0
 int y = QString::compare("auto", "Car", Qt::CaseSensitive);     // y > 0
 int z = QString::compare("auto", "Car", Qt::CaseInsensitive);   // z < 0

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

Смотрите также operator==(), operator<() и operator>().

int QString::compare ( const QString & s1, const QString & s2 ) [static]

Эта функция перегружает функцию compare().

Выполняет сравнение s1 и s2 с учётом регистра.

int QString::compare ( const QString & s1, const QLatin1String & s2, Qt::CaseSensitivity cs = Qt::CaseSensitive ) [static]

Эта функция перегружает функцию compare().

Выполняет сравнение s1 и s2, используя настройку cs учёта регистра.

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

int QString::compare ( const QLatin1String & s1, const QString & s2, Qt::CaseSensitivity cs = Qt::CaseSensitive ) [static]

Эта функция перегружает функцию compare().

Выполняет сравнение s1 и s2, используя настройку cs учёта регистра.

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

int QString::compare ( const QString & other ) const

Эта функция перегружает функцию compare().

Лексически сравнивает эту строку с другой строкой other и возвращает целое число, меньшее, равное или большее нуля, если эта строка меньше, равна или больше другой строки.

Эквивалентно compare(*this, other).

int QString::compare ( const QString & other, Qt::CaseSensitivity cs ) const

Эта функция перегружает функцию compare().

Тоже самое, что и compare(*this, other, cs).

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

int QString::compare ( const QLatin1String & other, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Эта функция перегружает функцию compare().

Тоже самое, что и compare(*this, other, cs).

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

int QString::compare ( const QStringRef & ref, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Эта функция перегружает функцию compare().

Сравнивает ссылку ref на строку со строкой и возвращает целое число, меньшее, равное или большее нуля, если строка меньше, равна или больше, чем ref.

int QString::compare ( const QString & s1, const QStringRef & s2, Qt::CaseSensitivity cs = Qt::CaseSensitive ) [static]

Эта функция перегружает функцию compare().

const_iterator QString::constBegin () const

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

Смотрите также begin() и constEnd().

const QChar * QString::constData () const

Возвращает указатель на данные, хранящиеся в QString. Указатель можно использовать для доступа к символам, которые составляют строку. Для удобства данные завершаются символом '\0'.

Заметьте, что указатель остаётся действительным до тех пор, пока строка не будет изменена.

Смотрите также data() и operator[]().

const_iterator QString::constEnd () const

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

Смотрите также constBegin() и end().

bool QString::contains ( const QString & str, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Возвращает true, если строка содержит вхождения строки str; в противном случае возвращает false.

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

Пример:

 QString str = "Peter Pan";
 str.contains("peter", Qt::CaseInsensitive);    // возвращает true

Смотрите также indexOf() и count().

bool QString::contains ( QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Эта функция перегружает функцию contains().

Возвращает true, если строка содержит вхождение символа ch; в противном случае возвращает false.

bool QString::contains ( const QRegExp & rx ) const

Эта функция перегружает функцию contains().

Возвращает true, если для регулярного выражения rx есть соответствие где-то в этой строке; в противном случае возвращает false.

bool QString::contains ( QRegExp & rx ) const

Эта функция перегружает функцию contains().

Возвращает true, если для регулярного выражения rx есть соответствие где-то в этой строке; в противном случае возвращает false.

Если соответствие найдено, то регулярное выражение rx будет содержать найденное соответствие (смотрите QRegExp::matchedLength, QRegExp::cap).

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

int QString::count ( const QString & str, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Возвращает количество (возможно, перекрывающихся) вхождений строки str в эту строку.

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

Смотрите также contains() и indexOf().

int QString::count ( QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Эта функция перегружает функцию count().

Возвращает количество вхождений символа ch в строке.

int QString::count ( const QRegExp & rx ) const

Эта функция перегружает функцию count().

Возвращает количество найденных соответствий регулярного выражения rx в строке.

Эта функция подсчитывает перекрывающиеся соответствия, так что в примере ниже есть четыре экземпляра "ana" или "ama":

 QString str = "banana and panama";
 str.count(QRegExp("a[nm]a"));    // возвращает 4

int QString::count () const

Эта функция перегружает функцию count().

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

QChar * QString::data ()

Возвращает указатель на данные, хранящиеся в QString. Указатель можно использовать для доступа к символам, которые составляют строку, и их изменения. Для удобства данные завершаются символом '\0'.

Пример:

 QString str = "Hello world";
 QChar *data = str.data();
 while (!data->isNull()) {
     qDebug() << data->unicode();
     ++data;
 }

Заметьте, что указатель остаётся действительным до тех пор, пока строка не будет изменена другими средствами. Если нужен доступ только для чтения, то функция constData() работает быстрее, потому что в этом случае не требуется создавать полную копию данных.

Смотрите также constData() и operator[]().

const QChar * QString::data () const

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

iterator QString::end ()

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

Смотрите также begin() и constEnd().

const_iterator QString::end () const

Эта функция перегружает функцию end().

bool QString::endsWith ( const QString & s, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Возвращает true, если строка заканчивается s; иначе возвращает false.

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

 QString str = "Bananas";
 str.endsWith("anas");         // возвращает true
 str.endsWith("pple");         // возвращает false

Смотрите также startsWith().

bool QString::endsWith ( const QLatin1String & s, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Эта функция перегружает функцию endsWith().

bool QString::endsWith ( const QChar & c, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Возвращает true, если строка заканчивается c; иначе возвращает false.

Эта функция перегружает функцию endsWith().

QString & QString::fill ( QChar ch, int size = -1 )

Присваивает каждому символу в строке значение ch. Если size отличен от -1 (значение по умолчанию), то размер строки предварительно изменяется на size.

Пример:

 QString str = "Berlin";
 str.fill('z');
 // str == "zzzzzz"

 str.fill('A', 2);
 // str == "AA"

Смотрите также resize().

QString QString::fromAscii ( const char * str, int size = -1 ) [static]

Возвращает QString, инициализированный первыми size символами строки str.

Если размер size равен -1 (по умолчанию), то он подсчитывается при помощи qstrlen(str).

Заметьте, что, не смотря на имя, эта функция фактически использует кодек, определённый QTextCodec::setCodecForCStrings(), для преобразования str в Unicode. В зависимости от кодека, она может не принять допустимый для US-ASCII (ANSI X3.4-1986) данные. Если ни один кодек не установлен, то эта функция делает то же самое, что и fromLatin1().

Смотрите также toAscii(), fromLatin1(), fromUtf8() и fromLocal8Bit().

QString QString::fromLatin1 ( const char * str, int size = -1 ) [static]

Возвращает QString, инициализированный первыми size символами строки str в кодах Latin-1.

Если размер size равен -1 (по умолчанию), то он подсчитывается при помощи qstrlen(str).

Смотрите также toLatin1(), fromAscii(), fromUtf8() и fromLocal8Bit().

QString QString::fromLocal8Bit ( const char * str, int size = -1 ) [static]

Возвращает QString, инициализированный первыми size символами 8-битной строки str.

Если размер size равен -1 (по умолчанию), то он подсчитывается при помощи qstrlen(str).

Для преобразования используется QTextCodec::codecForLocale().

Смотрите также toLocal8Bit(), fromAscii(), fromLatin1() и fromUtf8().

QString QString::fromRawData ( const QChar * unicode, int size ) [static]

Создаёт QString, используя первые size Unicode-символов из массива unicode. Данные из unicode не копируются. Вызывающий должен быть уверен, что unicode не будет удалён или изменён, пока существует QString (или его немодифицированная копия).

Любая попытка модификации QString или его копии приведёт к созданию полной копии данных, что гарантирует неизменность исходных данных.

Здесь приведён пример того, как мы можем использовать QRegExp на сырых данных в памяти без необходимости копирования данных в QString:

 QRegExp pattern;
 static const QChar unicode[] = {
         0x005A, 0x007F, 0x00A4, 0x0060,
         0x1009, 0x0020, 0x0020};
 int size = sizeof(unicode) / sizeof(QChar);

 QString str = QString::fromRawData(unicode, size);
 if (str.contains(QRegExp(pattern))) {
     // ...
 }

Предупреждение: Строка, созданная с помощью fromRawData(), не оканчивается символом '\0', за исключением случаев, когда исходный массив содержит символ '\0' в позиции size. Это означает, что unicode() не вернёт нультерминальную строку (хотя utf16() сделает именно так, поскольку копирует сырые данные).

Смотрите также fromUtf16() и setRawData().

QString QString::fromStdString ( const std::string & str ) [static]

Возвращает копию строки str. Получаемая строка преобразуется в Unicode при помощи функции fromAscii().

Этот конструктор доступен только в том случае, если Qt сконфигурирован с включённой поддержкой совместимости с STL.

Смотрите также fromAscii(), fromLatin1(), fromLocal8Bit() и fromUtf8().

QString QString::fromStdWString ( const std::wstring & str ) [static]

Возвращает копию строки str. Предполагается, что получаемая строка закодирована в utf16, если размер wchar_t равен 2 байтам (например, в Windows), и в ucs4, если размер wchar_t равен 4 байтам (в большинстве Unix-систем).

Этот метод доступен только в том случае, если Qt сконфигурирован с включённой поддержкой совместимости с STL.

Смотрите также fromUtf16(), fromLatin1(), fromLocal8Bit(), fromUtf8() и fromUcs4().

QString QString::fromUcs4 ( const uint * unicode, int size = -1 ) [static]

Возвращает QString, инициализированный первыми size символами Unicode-строки unicode (в кодах ISO-10646-UCS-4).

Если size равен -1 (по умолчанию), unicode должна завершаться 0.

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

Смотрите также toUcs4(), fromUtf16(), utf16(), setUtf16() и fromWCharArray().

QString QString::fromUtf8 ( const char * str, int size = -1 ) [static]

Возвращает QString, инициализированный первыми size байтами строки str в кодах UTF-8.

Если размер size равен -1 (по умолчанию), то он подсчитывается при помощи qstrlen(str).

UTF-8 - это Unicode-codec и может представлять все символы в Unicode-строке подобно QString. Тем не менее, в UTF-8 возможны недопустимые последовательности и, если они будут обнаружены, то они будут заменены на один или несколько "заменяющих символов" или исключены. К ним относятся не-Unicode последовательности, не-символы, слишком длинные последовательности или суррогатные кодовые точки, закодированные в UTF-8.

Не-символы - это кодовые точки, которые стандарт Unicode резервирует и которые не должны использоваться в текстовом обмене. Это последние две кодовые точки в каждой из плоскостей Unicode (U+FFFE, U+FFFF, U+1FFFE, U+1FFFF, U+2FFFE и т.д.), а также 16 кодовых точек в диапазоне U+FDD0..U+FDDF включительно.

Смотрите также toUtf8(), fromAscii(), fromLatin1() и fromLocal8Bit().

QString QString::fromUtf16 ( const ushort * unicode, int size = -1 ) [static]

Возвращает QString, инициализированный первыми size символами Unicode-строки unicode (в кодах ISO-10646-UTF-16).

Если size равен -1 (по умолчанию), unicode должна завершаться 0.

Эта функция проверяет Byte Order Mark (BOM). Если он отсутствует, применяется порядок байт хоста.

Эта медленная функция по сравнению с другими функциями преобразования Unicode. По возможности используйте QString(const QChar *, int) or QString(const QChar *).

QString делает полную копию данных Unicode.

Смотрите также utf16() и setUtf16().

QString QString::fromWCharArray ( const wchar_t * string, int size = -1 ) [static]

Возвращает копию строки string, причём кодировка string зависит от размера wchar. Если wchar равен 4 байтам, то строка string интерпретируется как ucs-4, если wchar равен 2 байтам, то как ucs-2.

Если size равен -1 (по умолчанию), то строка string должна иметь завершающий 0.

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

Смотрите также fromUtf16(), fromLatin1(), fromLocal8Bit(), fromUtf8(), fromUcs4() и fromStdWString().

int QString::indexOf ( const QString & str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Возвращает индекс позиции первого вхождения строки str в этой строке, поиск осуществляется вперёд, начиная с позиции с индексом from. Возвращает -1, если str не найдена.

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

Пример:

 QString x = "sticky question";
 QString y = "sti";
 x.indexOf(y);               // возвращает 0
 x.indexOf(y, 1);            // возвращает 10
 x.indexOf(y, 10);           // возвращает 10
 x.indexOf(y, 11);           // возвращает -1

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

Смотрите также lastIndexOf(), contains() и count().

int QString::indexOf ( const QLatin1String & str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Возвращает индекс позиции первого вхождения строки str в этой строке, поиск осуществляется вперёд, начиная с позиции с индексом from. Возвращает -1, если str не найдена.

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

Пример:

 QString x = "sticky question";
 QString y = "sti";
 x.indexOf(y);               // возвращает 0
 x.indexOf(y, 1);            // возвращает 10
 x.indexOf(y, 10);           // возвращает 10
 x.indexOf(y, 11);           // возвращает -1

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

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

Смотрите также lastIndexOf(), contains() и count().

int QString::indexOf ( QChar ch, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Эта функция перегружает функцию indexOf().

Возвращает индекс позиции первого вхождения символа ch в строке, поиск осуществляется вперёд, начиная с позиции с индексом from. Возвращает -1, если ch не может быть найден.

int QString::indexOf ( const QRegExp & rx, int from = 0 ) const

Эта функция перегружает функцию indexOf().

Возвращает индекс позиции первого соответствия регулярного выражения rx в строке, поиск осуществляется вперёд, начиная с позиции с индексом from. Возвращает -1, если соответствия rx не найдено.

Пример:

 QString str = "the minimum";
 str.indexOf(QRegExp("m[aeiou]"), 0);       // возвращает 4

int QString::indexOf ( QRegExp & rx, int from = 0 ) const

Эта функция перегружает функцию indexOf().

Возвращает индекс позиции первого соответствия регулярного выражения rx в строке, поиск осуществляется вперёд, начиная с позиции с индексом from. Возвращает -1, если соответствия rx не найдено.

Если соответствие найдено, то регулярное выражение rx будет содержать найденное соответствие (смотрите QRegExp::matchedLength, QRegExp::cap).

Пример:

 QString str = "the minimum";
 str.indexOf(QRegExp("m[aeiou]"), 0);       // возвращает 4

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

QString & QString::insert ( int position, const QString & str )

Вставляет строку str в позицию по индексу position и возвращает ссылку на эту строку.

Пример:

 QString str = "Meal";
 str.insert(1, QString("ontr"));
 // str == "Montreal"

Если position больше, чем size(), то массив будет сначала расширен с помощью resize().

Смотрите также append(), prepend(), replace() и remove().

QString & QString::insert ( int position, const QLatin1String & str )

Эта функция перегружает функцию insert().

Вставляет строку str в кодах Latin-1 в позицию по индексу position.

QString & QString::insert ( int position, const QChar * unicode, int size )

Эта функция перегружает функцию insert().

Вставляет первые size символов QChar из массива unicode в указанную позицию с индексом position в строке.

QString & QString::insert ( int position, QChar ch )

Эта функция перегружает функцию insert().

Вставляет ch в указанную позицию с индексом position в строке.

bool QString::isEmpty () const

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

Пример:

 QString().isEmpty();            // возвращает true
 QString("").isEmpty();          // возвращает true
 QString("x").isEmpty();         // возвращает false
 QString("abc").isEmpty();       // возвращает false

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

bool QString::isNull () const

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

Пример:

 QString().isNull();             // возвращает true
 QString("").isNull();           // возвращает false
 QString("abc").isNull();        // возвращает false

Qt делает различия между нулевой и пустой строками по историческим причинам. Для большинства приложений важно, содержит строка данные или нет, и это можно определить с помощью функции isEmpty().

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

bool QString::isRightToLeft () const

Возвращает true, если строка читается справа налево.

int QString::lastIndexOf ( const QString & str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

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

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

Пример:

 QString x = "crazy azimuths";
 QString y = "az";
 x.lastIndexOf(y);           // возвращает 6
 x.lastIndexOf(y, 6);        // возвращает 6
 x.lastIndexOf(y, 5);        // возвращает 2
 x.lastIndexOf(y, 1);        // возвращает -1

Смотрите также indexOf(), contains() и count().

int QString::lastIndexOf ( const QLatin1String & str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

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

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

Пример:

 QString x = "crazy azimuths";
 QString y = "az";
 x.lastIndexOf(y);           // возвращает 6
 x.lastIndexOf(y, 6);        // возвращает 6
 x.lastIndexOf(y, 5);        // возвращает 2
 x.lastIndexOf(y, 1);        // возвращает -1

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

Смотрите также indexOf(), contains() и count().

int QString::lastIndexOf ( QChar ch, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Эта функция перегружает функцию lastIndexOf().

Возвращает индекс позиции последнего вхождения символа ch, поиск осуществляется назад, начиная с позиции from.

int QString::lastIndexOf ( const QRegExp & rx, int from = -1 ) const

Эта функция перегружает функцию lastIndexOf().

Возвращает индекс позиции последнего соответствия регулярного выражения rx в строке, поиск осуществляется назад, начиная с позиции с индексом from. Возвращает -1, если соответствия rx не найдено.

Пример:

 QString str = "the minimum";
 str.lastIndexOf(QRegExp("m[aeiou]"));      // возвращает 8

int QString::lastIndexOf ( QRegExp & rx, int from = -1 ) const

Эта функция перегружает функцию lastIndexOf().

Возвращает индекс позиции последнего соответствия регулярного выражения rx в строке, поиск осуществляется назад, начиная с позиции с индексом from. Возвращает -1, если соответствия rx не найдено.

Если соответствие найдено, то регулярное выражение rx будет содержать найденное соответствие (смотрите QRegExp::matchedLength, QRegExp::cap).

Пример:

 QString str = "the minimum";
 str.lastIndexOf(QRegExp("m[aeiou]"));      // возвращает 8

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

QString QString::left ( int n ) const

Возвращает подстроку, которая содержит n первых символов строки.

Строка будет возвращена полностью, если n больше, чем size(), или меньше, чем ноль.

 QString x = "Pineapple";
 QString y = x.left(4);      // y == "Pine"

Смотрите также right(), mid() и startsWith().

QString QString::leftJustified ( int width, QChar fill = QLatin1Char( ' ' ), bool truncate = false ) const

Возвращает строку размером width, которая содержит исходную строку, дополненную символом fill.

Если truncate равно false и размер size() строки больше, чем width, то возвращается копия этой строки.

 QString s = "apple";
 QString t = s.leftJustified(8, '.');    // t == "apple..."

Если truncate равно true и размер size() строки больше, чем width, то возвращается копия строки, у которой символы после позиции width отсечены.

 QString str = "Pineapple";
 str = str.leftJustified(5, '.', true);    // str == "Pinea"

Смотрите также rightJustified().

QStringRef QString::leftRef ( int n ) const

Возвращает ссылку на подстроку из n первых символов строки.

Если n больше, чем size(), или меньше, чем ноль, то будет возвращена ссылка на всю строку.

 QString x = "Pineapple";
 QStringRef y = x.leftRef(4);        // y == "Pine"

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

Смотрите также left(), rightRef(), midRef() и startsWith().

int QString::length () const

Возвращает количество символов в этой строке. Эквивалентно size().

Смотрите также setLength() и resize().

int QString::localeAwareCompare ( const QString & s1, const QString & s2 ) [static]

Сравнивает s1 с s2 и возвращает целое число, меньшее, равное или большее нуля, если s1 меньше, равно или больше, чем s2, соответственно.

Результат сравнения зависит от локали и платформы. Используйте эту функцию для предоставления отсортированных строк пользователю.

В Mac OS X с Qt 4.3 эта функция производит сравнение в зависимости от значения опции "Порядок сортировки списков" ("Order for sorted lists") в панели "Региональные установки" ("International").

Смотрите также compare() и QTextCodec::locale().

int QString::localeAwareCompare ( const QStringRef & other ) const

Эта функция перегружает функцию localeAwareCompare().

Сравнивает эту строку с другой строкой other и возвращает целое число, меньшее, равное или большее нуля, если эта строка меньше, равна или больше другой строки other.

Результат сравнения зависит от локали и платформы. Используйте эту функцию для предоставления отсортированных строк пользователю.

Смотрите также localeAwareCompare(*this, other).

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

int QString::localeAwareCompare ( const QString & s1, const QStringRef & s2 ) [static]

Эта функция перегружает функцию localeAwareCompare().

Сравнивает s1 с s2 и возвращает целое число, меньшее, равное или большее нуля, если s1 меньше, равно или больше, чем s2, соответственно.

Результат сравнения зависит от локали и платформы. Используйте эту функцию для предоставления отсортированных строк пользователю.

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

int QString::localeAwareCompare ( const QString & other ) const

Эта функция перегружает функцию localeAwareCompare().

Сравнивает эту строку с другой строкой other и возвращает целое число, меньшее, равное или большее нуля, если эта строка меньше, равна или больше другой строки other.

Результат сравнения зависит от локали и платформы. Используйте эту функцию для предоставления отсортированных строк пользователю.

Смотрите также localeAwareCompare(*this, other).

QString QString::mid ( int position, int n = -1 ) const

Возвращает строку, которая содержит n символов этой строки, начиная с позиции с указанным индексом position.

Возвращает нулевую строку, если индекс позиции position превышает длину строки. Если в строке доступно меньше, чем n символов, начиная с заданной позиции position, или если n равно -1 (по умолчанию), то функция возвращает все доступные символы, начиная с указанной position.

Пример:

 QString x = "Nine pineapples";
 QString y = x.mid(5, 4);            // y == "pine"
 QString z = x.mid(5);               // z == "pineapples"

Смотрите также left() и right().

QStringRef QString::midRef ( int position, int n = -1 ) const

Возвращает ссылку на подстроку из n символов строки, начиная с указанной позиции position.

Если позиция position превышает длину строки, то будет возвращена пустая ссылка.

Если в строке доступно меньше, чем n символов, начиная с заданной позиции position, или если n равно -1 (по умолчанию), то функция возвращает все символы, начиная с указанной position.

Пример:

 QString x = "Nine pineapples";
 QStringRef y = x.midRef(5, 4);      // y == "pine"
 QStringRef z = x.midRef(5);         // z == "pineapples"

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

Смотрите также mid(), leftRef() и rightRef().

QString QString::normalized ( NormalizationForm mode ) const

Возвращает строку в заданном режиме mode нормализации Unicode.

QString QString::normalized ( NormalizationForm mode, QChar::UnicodeVersion version ) const

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

Возвращает строку в заданном режиме mode нормализации Unicode, в соответствии с указанной версией version стандарта Unicode.

QString QString::number ( long n, int base = 10 ) [static]

Возвращает строку, эквивалентную числу n по указанному основанию base.

Основание по умолчанию равно 10 и должно быть между 2 и 36. Для оснований, отличных от 10, n рассматривается как целое число без знака.

 long a = 63;
 QString s = QString::number(a, 16);             // s == "3f"
 QString t = QString::number(a, 16).toUpper();     // t == "3F"

Смотрите также setNum().

QString QString::number ( double n, char format = 'g', int precision = 6 ) [static]

Возвращает строку, эквивалентную числу n, отформатированному в соответствии с указанным форматом format и точностью precision. Для получения подробной информации смотрите Форматы аргументов.

В отличие от QLocale::toString(), эта функция не обращает внимания на пользовательские настройки локали.

Смотрите также setNum() и QLocale::toString().

QString QString::number ( ulong n, int base = 10 ) [static]

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

QString QString::number ( int n, int base = 10 ) [static]

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

QString QString::number ( uint n, int base = 10 ) [static]

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

QString QString::number ( qlonglong n, int base = 10 ) [static]

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

QString QString::number ( qulonglong n, int base = 10 ) [static]

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

QString & QString::prepend ( const QString & str )

Добавляет строку str к началу этой строки и возвращает ссылку на строку.

Пример:

 QString x = "ship";
 QString y = "air";
 x.prepend(y);
 // x == "airship"

Смотрите также append() и insert().

QString & QString::prepend ( const QLatin1String & str )

Эта функция перегружает функцию prepend().

Добавляет строку str в кодах Latin-1 к началу этой строки.

QString & QString::prepend ( const QByteArray & ba )

Эта функция перегружает функцию prepend().

Добавляет массив байт ba к началу этой строки. Массив байт преобразуется в Unicode при помощи функции fromAscii().

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

QString & QString::prepend ( const char * str )

Эта функция перегружает функцию prepend().

Добавляет строку str к началу этой строки. Указатель на константный char преобразуется в Unicode при помощи функции fromAscii().

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

QString & QString::prepend ( QChar ch )

Эта функция перегружает функцию prepend().

Добавляет символ ch к началу этой строки.

void QString::push_back ( const QString & other )

Эта функция предназначена для совместимости с STL, добавляя полученную строку other в конец этой строки. Это эквивалентно append(other).

Смотрите также append().

void QString::push_back ( QChar ch )

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

Добавляет данный символ ch в конец этой строки.

void QString::push_front ( const QString & other )

Эта функция предназначена для совместимости с STL, добавляя полученную строку other в начало этой строки. Это эквивалентно prepend(other).

Смотрите также prepend().

void QString::push_front ( QChar ch )

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

Добавляет данный символ ch в начало этой строки.

QString & QString::remove ( int position, int n )

Удаляет n символов из строки, начиная с позиции с индексом position, и возвращает ссылку на строку.

Если указанная позиция с индексом position находится в пределах строки, а position + n за пределами конца строки, то строка обрезается до указанной позиции position.

 QString s = "Montreal";
 s.remove(1, 4);
 // s == "Meal"

Смотрите также insert() и replace().

QString & QString::remove ( QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Удаляет все вхождения символа ch в этой строке и возвращает ссылку на эту строку.

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

Пример:

 QString t = "Ali Baba";
 t.remove(QChar('a'), Qt::CaseInsensitive);
 // t == "li Bb"

Это то же самое, что и replace(ch, "", cs).

Смотрите также replace().

QString & QString::remove ( const QString & str, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Удаляет все вхождения указанной строки str в этой строке и возвращает ссылку на эту строку.

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

Это то же самое, что и replace(str, "", cs).

Смотрите также replace().

QString & QString::remove ( const QRegExp & rx )

Удаляет все вхождения регулярного выражения rx в эту строку и возвращает ссылку на строку. Например:

 QString r = "Telephone";
 r.remove(QRegExp("[aeiou]."));
 // r == "The"

Смотрите также indexOf(), lastIndexOf() и replace().

QString QString::repeated ( int times ) const

Возвращает копию этой строки, повторенной заданное количество times раз.

Если количество повторов times меньше 1, то возвращается пустая строка.

Пример:

 QString str("ab");
 str.repeated(4);            // возвращает "abababab"

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

QString & QString::replace ( int position, int n, const QString & after )

Заменяет n символов, начиная с позиции с индексом position, строкой after и возвращает ссылку на эту строку.

Пример:

 QString x = "Say yes!";
 QString y = "no";
 x.replace(4, 3, y);
 // x == "Say no!"

Смотрите также insert() и remove().

QString & QString::replace ( int position, int n, const QChar * unicode, int size )

Эта функция перегружает функцию replace().

Заменяет n символов, начиная с позиции с индексом position, первыми size символами QChar массива unicode и возвращает ссылку на эту строку.

QString & QString::replace ( int position, int n, QChar after )

Эта функция перегружает функцию replace().

Заменяет n символов, начиная с позиции с индексом position, символом after и возвращает ссылку на эту строку.

QString & QString::replace ( const QString & before, const QString & after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Эта функция перегружает функцию replace().

Заменяет каждое вхождение строки before строкой after и возвращает ссылку на эту строку.

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

Пример:

 QString str = "colour behaviour flavour neighbour";
 str.replace(QString("ou"), QString("o"));
 // str == "color behavior flavor neighbor"

Замечание: Заменяющий текст не проверяется заново после вставки.

Пример:

 QString equis = "xxxxxx";
 equis.replace("xx", "x");
 // equis == "xxx"

QString & QString::replace ( const QChar * before, int blen, const QChar * after, int alen, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Эта функция перегружает функцию replace().

Заменяет в этой строке каждое вхождение первых blen символов из before первыми alen символами из after и возвращает ссылку на эту строку.

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

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

QString & QString::replace ( QChar ch, const QString & after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Эта функция перегружает функцию replace().

Заменяет каждое вхождение символа ch в строке на after и возвращает ссылку на эту строку.

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

QString & QString::replace ( QChar before, QChar after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Эта функция перегружает функцию replace().

Заменяет каждое вхождение символа before символом after и возвращает ссылку на эту строку.

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

QString & QString::replace ( const QLatin1String & before, const QLatin1String & after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Эта функция перегружает функцию replace().

Заменяет каждое вхождение строки before строкой after и возвращает ссылку на эту строку.

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

Замечание: Текст не проверяется заново после замены.

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

QString & QString::replace ( const QLatin1String & before, const QString & after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Эта функция перегружает функцию replace().

Заменяет каждое вхождение строки before строкой after и возвращает ссылку на эту строку.

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

Замечание: Текст не проверяется заново после замены.

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

QString & QString::replace ( const QString & before, const QLatin1String & after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Эта функция перегружает функцию replace().

Заменяет каждое вхождение строки before строкой after и возвращает ссылку на эту строку.

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

Замечание: Текст не проверяется заново после замены.

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

QString & QString::replace ( QChar c, const QLatin1String & after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Эта функция перегружает функцию replace().

Заменяет каждое вхождение символа c строкой after и возвращает ссылку на эту строку.

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

Замечание: Текст не проверяется заново после замены.

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

QString & QString::replace ( const QRegExp & rx, const QString & after )

Эта функция перегружает функцию replace().

Заменяет каждое вхождение регулярного выражения rx в строке на after. Возвращает ссылку на строку. Например:

 QString s = "Banana";
 s.replace(QRegExp("a[mn]"), "ox");
 // s == "Boxoxa"

Для регулярных выражений, содержащих захватывающие скобки, вхождения \1, \2, ... в after заменяются на rx.cap(1), cap(2), ...

 QString t = "A <i>bon mot</i>.";
 t.replace(QRegExp("<i>([^<]*)</i>"), "\\emph{\\1}");
 // t == "A \\emph{bon mot}."

Смотрите также indexOf(), lastIndexOf(), remove() и QRegExp::cap().

void QString::reserve ( int size )

Попытка зарезервировать место в памяти размером, по крайней мере, size символов. Если вы знаете наперёд, насколько большой будет строка, вы можете вызвать эту функцию, и, если вы часто изменяете размер строки, то, возможно, получите лучшую производительность. Если size меньше, чем необходимо, то худшее, что может произойти, - это то, что QString будет немного медленнее.

Единственная цель этой функции - обеспечить оптимальное использование памяти в QString. Вообще, у вас крайне редко возникнет необходимость вызывать эту функцию. Если вы хотите изменить размер строки, вызывайте resize().

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

 QString result;
 int maxSize;
 bool condition;
 QChar nextChar;

 result.reserve(maxSize);

 while (condition)
     result.append(nextChar);

 result.squeeze();

Смотрите также squeeze() и capacity().

void QString::resize ( int size )

Устанавливает размер строки в size символов.

Если размер size больше, чем текущий размер, то строка увеличивается до size символов с добавлением дополнительных символов в конец. Новые символы ничем не инициализированы.

Если размер size меньше, чем текущий размер, то удаляются символы из конца строки.

Пример:

 QString s = "Hello world";
 s.resize(5);
 // s == "Hello"

 s.resize(8);
 // s == "Hello???" (где ? обозначает любой символ)

Если вы хотите добавить определённое количество одинаковых символов к строке, используйте не resize(), а operator+=() следующим образом:

 QString t = "Hello";
 t += QString(10, 'X');
 // t == "HelloXXXXXXXXXX"

Если вы хотите увеличить строку до определённой длины и заполнить новые позиции определённым символом, используйте функцию leftJustified():

Если размер size отрицателен, то это эквивалентно передаче нуля.

 QString r = "Hello";
 r = r.leftJustified(10, ' ');
 // r == "Hello     "

Смотрите также truncate() и reserve().

QString QString::right ( int n ) const

Возвращает подстроку, которая содержит n последних символов строки.

Строка будет возвращена полностью, если n больше, чем size(), или меньше, чем ноль.

 QString x = "Pineapple";
 QString y = x.right(5);      // y == "apple"

Смотрите также left(), mid() и endsWith().

QString QString::rightJustified ( int width, QChar fill = QLatin1Char( ' ' ), bool truncate = false ) const

Возвращает строку размером width, которая содержит символ-заполнитель fill, за которым следует строка. Например:

 QString s = "apple";
 QString t = s.rightJustified(8, '.');    // t == "...apple"

Если truncate равно false и размер size() строки больше, чем width, то возвращается копия этой строки.

Если truncate равно true и размер size() строки больше, чем width, то возвращается строка, усечённая в позиции width.

 QString str = "Pineapple";
 str = str.rightJustified(5, '.', true);    // str == "Pinea"

Смотрите также leftJustified().

QStringRef QString::rightRef ( int n ) const

Возвращает ссылку на подстроку из n последних символов строки.

Если n больше, чем size(), или меньше, чем ноль, то будет возвращена ссылка на всю строку.

 QString x = "Pineapple";
 QStringRef y = x.rightRef(5);       // y == "apple"

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

Смотрите также right(), leftRef(), midRef() и endsWith().

QString QString::section ( QChar sep, int start, int end = -1, SectionFlags flags = SectionDefault ) const

Эта функция возвращает часть строки.

Эта строка рассматривается как последовательность полей, разделённых символом sep. Возвращаемая строка содержит поля от позиции start до позиции end включительно. Если end не указан, то включаются все поля от позиции start до конца строки. При подсчёте слева направо поля нумеруются 0, 1, 2 и т.д., при подсчёте справа налево -1, -2 и т.д..

Аргумент flags может быть использован для влияния на некоторые аспекты поведения функции, например, необходимость учёта регистра, пропуска пустых полей и обработки первого и последнего разделителей; смотрите SectionFlags.

 QString str;
 QString csv = "forename,middlename,surname,phone";
 QString path = "/usr/local/bin/myapp"; // Первое поле пустое
 QString::SectionFlag flag = QString::SectionSkipEmpty;

 str = csv.section(',', 2, 2);   // str == "surname"
 str = path.section('/', 3, 4);  // str == "bin/myapp"
 str = path.section('/', 3, 3, flag); // str == "myapp"

Если начало start или конец end отрицательные, то подсчёт полей ведётся с конца строки, самое правое поле имеет номер -1, перед ним - номер -2 и т.д.

 str = csv.section(',', -3, -2);  // str == "middlename,surname"
 str = path.section('/', -1); // str == "myapp"

Смотрите также split().

QString QString::section ( const QString & sep, int start, int end = -1, SectionFlags flags = SectionDefault ) const

Эта функция перегружает функцию section().

 QString str;
 QString data = "forename**middlename**surname**phone";

 str = data.section("**", 2, 2); // str == "surname"
 str = data.section("**", -3, -2); // str == "middlename**surname"

Смотрите также split().

QString QString::section ( const QRegExp & reg, int start, int end = -1, SectionFlags flags = SectionDefault ) const

Эта функция перегружает функцию section().

Эта строка рассматривается как последовательность полей, разделённых регулярным выражением reg.

 QString line = "forename\tmiddlename  surname \t \t phone";
 QRegExp sep("\\s+");
 str = line.section(sep, 2, 2); // s == "surname"
 str = line.section(sep, -3, -2); // s == "middlename  surname"

Предупреждение: Использование этой версии функции, с QRegExp, более дорогое, чем перегруженных версий со строкой и символом.

Смотрите также split() и simplified().

QString & QString::setNum ( int n, int base = 10 )

Устанавливает строку в печатное представление числа n по основанию base и возвращает ссылку на строку.

Основание по умолчанию равно 10 и должно быть между 2 и 36. Для оснований, отличных от 10, n рассматривается как целое число без знака.

 QString str;
 str.setNum(1234);       // str == "1234"

Форматирование всегда использует QLocale::C, например, English/UnitedStates. Для получения локализованного строкового представления числа используйте QLocale::toString() с соответствующей локалью.

QString & QString::setNum ( uint n, int base = 10 )

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

QString & QString::setNum ( long n, int base = 10 )

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

QString & QString::setNum ( ulong n, int base = 10 )

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

QString & QString::setNum ( qlonglong n, int base = 10 )

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

QString & QString::setNum ( qulonglong n, int base = 10 )

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

QString & QString::setNum ( short n, int base = 10 )

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

QString & QString::setNum ( ushort n, int base = 10 )

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

QString & QString::setNum ( double n, char format = 'g', int precision = 6 )

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

Устанавливает строку в печатное представление числа n, отформатированного в соответствии с заданным форматом format и точностью precision, и возвращает ссылку на строку.

format может быть 'f', 'F', 'e', 'E', 'g' или 'G' (смотрите документацию на функцию arg() для получения объяснений по форматам).

В отличие от QLocale::toString() эта функция не обращает внимания на пользовательские настройки локали.

QString & QString::setNum ( float n, char format = 'g', int precision = 6 )

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

Устанавливает строку в печатное представление числа n, отформатированного в соответствии с заданным форматом format и точностью precision, и возвращает ссылку на строку.

QString & QString::setRawData ( const QChar * unicode, int size )

Переустанавливает QString для использования первых size Unicode-символов из массива unicode. Данные из unicode не копируются. Вызывающий должен быть уверен, что unicode не будет удалён или изменён, пока существует QString (или его немодифицированная копия).

Эта функция может быть использована вместо fromRawData() для повторного использования существующих объектов QString для сохранения перераспределения памяти.

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

Смотрите также fromRawData().

QString & QString::setUnicode ( const QChar * unicode, int size )

Изменяет размер строки до size символов и копирует unicode в строку.

Если unicode равен 0, то ничего не копируется, но размер всё равно изменяется на size.

Смотрите также unicode() и setUtf16().

QString & QString::setUtf16 ( const ushort * unicode, int size )

Изменяет размер строки до size символов и копирует unicode в строку.

Если unicode равен 0, то ничего не копируется, но размер всё равно изменяется на size.

Заметьте, что в отличие от fromUtf16() эта функция не учитывает BOM и возможный разный порядок байт.

Смотрите также utf16() и setUnicode().

QString QString::simplified () const

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

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

Пример:

 QString str = "  lots\t of\nwhitespace\r\n ";
 str = str.simplified();
 // str == "lots of whitespace";

Смотрите также trimmed().

int QString::size () const

Возвращает количество символов в этой строке.

Последний символ в строке находится в позиции size() - 1. Кроме того, QString гарантированно всегда содержит в позиции size() символ '\0', так что вы можете использовать значение, возвращаемое функциями data() и constData() в качестве аргумента для функций, требующих строки, оканчивающиеся нулем ('\0').

Пример:

 QString str = "World";
 int n = str.size();         // n == 5
 str.data()[0];              // возвращает 'W'
 str.data()[4];              // возвращает 'd'
 str.data()[5];              // возвращает '\0'

Смотрите также isEmpty() и resize().

QStringList QString::split ( const QString & sep, SplitBehavior behavior = KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Разделяет строку на подстроки по разделителю sep и возвращает список этих строк. Если sep не встретился нигде в строке, split() вернёт список, состоящий из одного элемента, содержащего всю строку.

cs указывает, должен ли sep быть регистрозависимым или нет.

Если behavior равно QString::SkipEmptyParts, то пустые записи не включаются в результат. По умолчанию, пустые записи сохраняются.

Пример:

 QString str = "a,,b,c";

 QStringList list1 = str.split(",");
 // list1: [ "a", "", "b", "c" ]

 QStringList list2 = str.split(",", QString::SkipEmptyParts);
 // list2: [ "a", "b", "c" ]

Смотрите также QStringList::join() и section().

QStringList QString::split ( const QChar & sep, SplitBehavior behavior = KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

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

QStringList QString::split ( const QRegExp & rx, SplitBehavior behavior = KeepEmptyParts ) const

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

Разделяет строку на подстроки по разделителям, соответствующим регулярному выражению rx, и возвращает список этих строк. Если rx не соответствует ничему в строке, то split() вернёт список, состоящий из одного элемента, содержащего всю строку.

Вот пример, где мы извлекаем слова из предложения, используя один или более пробельный символ в качестве разделителя:

 QString str;
 QStringList list;

 str = "Some  text\n\twith  strange whitespace.";
 list = str.split(QRegExp("\\s+"));
 // list: [ "Some", "text", "with", "strange", "whitespace." ]

Вот аналогичный пример, но на этот раз мы используем в качестве разделителя любую последовательность символов, не входящих в слова:

 str = "This time, a normal English sentence.";
 list = str.split(QRegExp("\\W+"), QString::SkipEmptyParts);
 // list: [ "This", "time", "a", "normal", "English", "sentence" ]

Вот третий пример, в котором мы используем утверждение нулевой длины, \b (граница слова), для разделения строки на чередующуюся последовательность лексем "не-слово" и "слово":

 str = "Now: this sentence fragment.";
 list = str.split(QRegExp("\\b"));
 // list: [ "", "Now", ": ", "this", " ", "sentence", " ", "fragment", "." ]

Смотрите также QStringList::join() и section().

QString & QString::sprintf ( const char * cformat, ... )

Безопасно создаёт отформатированную строку из строки формата cformat и произвольного списка аргументов.

Управляющая последовательность %lc ожидает unicode-символ типа ushort (как возвращает QChar::unicode()). Управляющая последовательность %ls ожидает указатель на нуль-терминальный массив unicode-символов типа ushort (как возвращает QString::utf16()).

Замечание: Эта функция ожидает строку в кодах UTF-8 для %s и в кодах Latin-1 для строки формата.

Строка формата поддерживает большинство спецификаторов преобразования, обеспечиваемых printf() в стандартной библиотеке C++. Она не учитывает модификаторы длины (например, h для short, ll для long long). Если они вам необходимы, используйте вместо этого стандартный snprintf():

 size_t BufSize;
 char buf[BufSize];

 ::snprintf(buf, BufSize, "%lld", 123456789LL);
 QString str = QString::fromAscii(buf);

Предупреждение: Мы не рекомендуем использовать QString::sprintf() в новом коде Qt. Вместо этого рассмотрите возможность использования QTextStream или arg(), оба из которых легко и безопасно с точки зрения типов поддерживают Unicode-строки. Вот пример, который использует QTextStream:

 QString result;
 QTextStream(&result) << "pi = " << 3.14;
 // result == "pi = 3.14"

Для перевода, особенно если строки содержат несколько управляющих последовательностей, вы должны рассмотреть возможность использования вместо этого функции arg(). Это позволяет оставить под контролем переводчика порядок замещающих элементов.

Смотрите также arg().

void QString::squeeze ()

Освобождает любую память, не требующуюся для хранения символьных данных.

Единственная цель этой функции - обеспечить оптимальное использование памяти в QString. Вообще, у вас крайне редко возникнет необходимость вызывать эту функцию.

Смотрите также reserve() и capacity().

bool QString::startsWith ( const QString & s, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Возвращает true, если строка начинается с s; иначе возвращает false.

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

 QString str = "Bananas";
 str.startsWith("Ban");     // возвращает true
 str.startsWith("Car");     // возвращает false

Смотрите также endsWith().

bool QString::startsWith ( const QLatin1String & s, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Эта функция перегружает функцию startsWith().

bool QString::startsWith ( const QChar & c, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Эта функция перегружает функцию startsWith().

Возвращает true, если строка начинается с c; иначе возвращает false.

QByteArray QString::toAscii () const

Возвращает 8-битное представление строки как QByteArray.

Если при помощи QTextCodec::setCodecForCStrings() был установлен кодек, то он используется для преобразования Unicode в 8-битные символы; иначе эта функция делает то же самое, что и toLatin1().

Заметьте, что несмотря на название, эта функция не обязательно возвращает строку в кодах US-ASCII (ANSI X3.4-1986), и результат может быть не совместим с US-ASCII.

Смотрите также fromAscii(), toLatin1(), toUtf8(), toLocal8Bit() и QTextCodec.

QString QString::toCaseFolded () const

Возвращает приведённый к одному регистру эквивалент строки. Для большинства Unicode-символов это тоже самое, что и toLower().

double QString::toDouble ( bool * ok = 0 ) const

Возвращает строку, преобразованную в значение типа double.

Возвращает 0.0, если преобразование не удалось.

Если во время преобразования возникает ошибка, то *ok устанавливается в false; в противном случае *ok будет установлен в true.

 QString str = "1234.56";
 double val = str.toDouble();   // val == 1234.56

В значения типа double могут быть преобразованы различные строковые представления чисел с плавающей точкой:

 bool ok;
 double d;

 d = QString( "1234.56e-02" ).toDouble(&ok); // ok == true, d == 12.3456

Эта функция пытается интерпретировать строку в соответствии с текущей локалью. Текущая локаль определяется из системы при запуске приложения и может быть изменена путём вызова QLocale::setDefault(). Если строка не может быть интерпретирована в соответствии с текущей локалью, то эта функция возвращается к локали "C".

 QLocale::setDefault(QLocale::C);
 d = QString( "1234,56" ).toDouble(&ok); // ok == false
 d = QString( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56

 QLocale::setDefault(QLocale::German);
 d = QString( "1234,56" ).toDouble(&ok); // ok == true, d == 1234.56
 d = QString( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56

Из-за неоднозначности между десятичной точкой и разделителем групп разрядов в различных локалях эта функция не обрабатывает разделители групп разрядов. Если вам необходимо преобразовать такое число, смотрите QLocale::toDouble().

 QLocale::setDefault(QLocale::C);
 d = QString( "1234,56" ).toDouble(&ok); // ok == false

Смотрите также number(), QLocale::setDefault(), QLocale::toDouble() и trimmed().

float QString::toFloat ( bool * ok = 0 ) const

Возвращает строку, преобразованную в значение типа float.

Если во время преобразования возникает ошибка, то *ok устанавливается в false; в противном случае *ok будет установлен в true. Возвращает 0.0, если преобразование не удалось.

Пример:

 QString str1 = "1234.56";
 str1.toFloat();             // возвращает 1234.56

 bool ok;
 QString str2 = "R2D2";
 str2.toFloat(&ok);          // возвращает 0.0, устанавливает ok в false

Смотрите также number(), toDouble() и toInt().

int QString::toInt ( bool * ok = 0, int base = 10 ) const

Возвращает строку, преобразованную в значение типа int, используя систему счисления по основанию base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0. Возвращает 0, если преобразование не удалось.

Если во время преобразования возникает ошибка, то *ok устанавливается в false; в противном случае *ok будет установлен в true.

Если основание base равно 0, то используются соглашения языка C: если строка начинается с "0x", используется основание 16; если строка начинается с "0", используется основание 8; в остальных случаях используется основание 10.

Пример:

 QString str = "FF";
 bool ok;
 int hex = str.toInt(&ok, 16);       // hex == 255, ok == true
 int dec = str.toInt(&ok, 10);       // dec == 0, ok == false

Смотрите также number(), toUInt() и toDouble().

QByteArray QString::toLatin1 () const

Возвращает Latin-1 представление строки как QByteArray.

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

Смотрите также fromLatin1(), toAscii(), toUtf8(), toLocal8Bit() и QTextCodec.

QByteArray QString::toLocal8Bit () const

Возвращает локальное 8-битное представление строки как QByteArray. Возвращаемый массив байт не определён, если строка содержит символы, не поддерживаемые локальной 8-битной кодировкой.

Для преобразования из Unicode используется QTextCodec::codecForLocale(). Если локальная кодировка не определена, то эта функция делает то же самое, что и toLatin1().

Если эта строка содержит какие-либо символы, которые не могут быть закодированы в локали, то возвращаемый массив байт будет неопределён. Эти символы могут быть подавлены или заменены другим.

Смотрите также fromLocal8Bit(), toAscii(), toLatin1(), toUtf8() и QTextCodec.

long QString::toLong ( bool * ok = 0, int base = 10 ) const

Возвращает строку, преобразованную в значение типа long, используя систему счисления по основанию base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0. Возвращает 0, если преобразование не удалось.

Если во время преобразования возникает ошибка, то *ok устанавливается в false; в противном случае *ok будет установлен в true.

Если основание base равно 0, то используются соглашения языка C: если строка начинается с "0x", используется основание 16; если строка начинается с "0", используется основание 8; в остальных случаях используется основание 10.

Пример:

 QString str = "FF";
 bool ok;

 long hex = str.toLong(&ok, 16);     // hex == 255, ok == true
 long dec = str.toLong(&ok, 10);     // dec == 0, ok == false

Смотрите также number(), toULong() и toInt().

qlonglong QString::toLongLong ( bool * ok = 0, int base = 10 ) const

Возвращает строку, преобразованную в значение типа long long, используя систему счисления по основанию base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0. Возвращает 0, если преобразование не удалось.

Если во время преобразования возникает ошибка, то *ok устанавливается в false; в противном случае *ok будет установлен в true.

Если основание base равно 0, то используются соглашения языка C: если строка начинается с "0x", используется основание 16; если строка начинается с "0", используется основание 8; в остальных случаях используется основание 10.

Пример:

 QString str = "FF";
 bool ok;

 qint64 hex = str.toLongLong(&ok, 16);      // hex == 255, ok == true
 qint64 dec = str.toLongLong(&ok, 10);      // dec == 0, ok == false

Смотрите также number(), toULongLong() и toInt().

QString QString::toLower () const

Возвращает копию строки в нижнем регистре.

 QString str = "Qt by NOKIA";
 str = str.toLower();        // str == "qt by nokia"

Смотрите также toUpper().

short QString::toShort ( bool * ok = 0, int base = 10 ) const

Возвращает строку, преобразованную в значение типа short, используя систему счисления по основанию base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0. Возвращает 0, если преобразование не удалось.

Если во время преобразования возникает ошибка, то *ok устанавливается в false; в противном случае *ok будет установлен в true.

Если основание base равно 0, то используются соглашения языка C: если строка начинается с "0x", используется основание 16; если строка начинается с "0", используется основание 8; в остальных случаях используется основание 10.

Пример:

 QString str = "FF";
 bool ok;

 short hex = str.toShort(&ok, 16);   // hex == 255, ok == true
 short dec = str.toShort(&ok, 10);   // dec == 0, ok == false

Смотрите также number(), toUShort() и toInt().

std::string QString::toStdString () const

Возвращает объект std::string с данными, содержащимися в этом QString. Данные в кодировке Unicode конвертируются в 8-битные символы с помощью функции toAscii().

Этот оператор в основном используется для передачи QString в функцию, которая принимает объект std::string.

Если QString содержит символы Unicode, которые кодек QTextCodec::codecForCStrings() не может обработать, то использование этого оператора может привести к потере информации.

Этот оператор доступен только в том случае, если Qt сконфигурирован с включённой поддержкой совместимости с STL.

Смотрите также toAscii(), toLatin1(), toUtf8() и toLocal8Bit().

std::wstring QString::toStdWString () const

Возвращает объект std::wstring с данными, содержащимися в этом QString. std::wstring кодируется в utf16 на тех платформах, на которых размер wchar_t равен 2 байтам (например, windows), и в ucs4 на тех платформах, на которых размер wchar_t равен 4 байтам (большинство Unix-систем).

Этот оператор в основном используется для передачи QString в функцию, которая принимает объект std::wstring.

Этот оператор доступен только в том случае, если Qt сконфигурирован с включённой поддержкой совместимости с STL.

Смотрите также utf16(), toAscii(), toLatin1(), toUtf8() и toLocal8Bit().

uint QString::toUInt ( bool * ok = 0, int base = 10 ) const

Возвращает строку, преобразованную в значение типа unsigned int, используя систему счисления по основанию base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0. Возвращает 0, если преобразование не удалось.

Если во время преобразования возникает ошибка, то *ok устанавливается в false; в противном случае *ok будет установлен в true.

Если основание base равно 0, то используются соглашения языка C: если строка начинается с "0x", используется основание 16; если строка начинается с "0", используется основание 8; в остальных случаях используется основание 10.

Пример:

 QString str = "FF";
 bool ok;

 uint hex = str.toUInt(&ok, 16);     // hex == 255, ok == true
 uint dec = str.toUInt(&ok, 10);     // dec == 0, ok == false

Смотрите также number() и toInt().

ulong QString::toULong ( bool * ok = 0, int base = 10 ) const

Возвращает строку, преобразованную в значение типа unsigned long, используя систему счисления по основанию base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0. Возвращает 0, если преобразование не удалось.

Если во время преобразования возникает ошибка, то *ok устанавливается в false; в противном случае *ok будет установлен в true.

Если основание base равно 0, то используются соглашения языка C: если строка начинается с "0x", используется основание 16; если строка начинается с "0", используется основание 8; в остальных случаях используется основание 10.

Пример:

 QString str = "FF";
 bool ok;

 ulong hex = str.toULong(&ok, 16);   // hex == 255, ok == true
 ulong dec = str.toULong(&ok, 10);   // dec == 0, ok == false

Смотрите также number().

qulonglong QString::toULongLong ( bool * ok = 0, int base = 10 ) const

Возвращает строку, преобразованную в значение типа unsigned long long, используя систему счисления по основанию base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0. Возвращает 0, если преобразование не удалось.

Если во время преобразования возникает ошибка, то *ok устанавливается в false; в противном случае *ok будет установлен в true.

Если основание base равно 0, то используются соглашения языка C: если строка начинается с "0x", используется основание 16; если строка начинается с "0", используется основание 8; в остальных случаях используется основание 10.

Пример:

 QString str = "FF";
 bool ok;

 quint64 hex = str.toULongLong(&ok, 16);    // hex == 255, ok == true
 quint64 dec = str.toULongLong(&ok, 10);    // dec == 0, ok == false

Смотрите также number() и toLongLong().

ushort QString::toUShort ( bool * ok = 0, int base = 10 ) const

Возвращает строку, преобразованную в значение типа unsigned short, используя систему счисления по основанию base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0. Возвращает 0, если преобразование не удалось.

Если во время преобразования возникает ошибка, то *ok устанавливается в false; в противном случае *ok будет установлен в true.

Если основание base равно 0, то используются соглашения языка C: если строка начинается с "0x", используется основание 16; если строка начинается с "0", используется основание 8; в остальных случаях используется основание 10.

Пример:

 QString str = "FF";
 bool ok;

 ushort hex = str.toUShort(&ok, 16);     // hex == 255, ok == true
 ushort dec = str.toUShort(&ok, 10);     // dec == 0, ok == false

Смотрите также number() и toShort().

QVector<uint> QString::toUcs4 () const

Возвращает UCS-4/UTF-32 представление строки как QVector<uint>.

UCS-4 является Unicode-кодеком и не теряет информацию. Все символы из этой строки могут быть закодированы в UCS-4. Вектор не завершается символом '\0'.

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

Смотрите также fromUtf8(), toAscii(), toLatin1(), toLocal8Bit(), QTextCodec, fromUcs4() и toWCharArray().

QString QString::toUpper () const

Возвращает копию строки в верхнем регистре.

 QString str = "TeXt";
 str = str.toUpper();        // str == "TEXT"

Смотрите также toLower().

QByteArray QString::toUtf8 () const

Возвращает UTF-8 представление строки как QByteArray.

UTF-8 - это Unicode-codec и может представлять все символы в Unicode-строке подобно QString.

Тем не менее, в диапазоне Unicode существуют определённые кодовые точки, которые не являются символами. Стандарт Unicode резервирует последние две кодовые точки в каждой из плоскостей Unicode (U+FFFE, U+FFFF, U+1FFFE, U+1FFFF, U+2FFFE и т.д.), а также 16 кодовых точек в диапазоне U+FDD0..U+FDDF включительно, как не-символы. Если какой-либо из них появляется в строке, то он может быть отброшен и не будет отображаться в представлении UTF-8, либо он может быть заменён одним или несколькими заменяющими символами.

Смотрите также fromUtf8(), toAscii(), toLatin1(), toLocal8Bit() и QTextCodec.

int QString::toWCharArray ( wchar_t * array ) const

Заполняет массив array данными, содержащимися в этом объекте QString. Массив кодируется в utf16 на тех платформах, на которых размер wchar_t равен 2 байтам (например, windows), и в ucs4 на тех платформах, на которых размер wchar_t равен 4 байтам (большинство Unix-систем).

Массив array должен быть выделен вызывающей стороной и содержать достаточно места для хранения полной строки (выделения массива той же длины, что и строка, всегда достаточно).

Возвращает фактическую длину строки в массиве array.

Замечание: Эта функция не добавляет нулевой символ в массив.

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

Смотрите также utf16(), toUcs4(), toAscii(), toLatin1(), toUtf8(), toLocal8Bit() и toStdWString().

QString QString::trimmed () const

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

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

Пример:

 QString str = "  lots\t of\nwhitespace\r\n ";
 str = str.trimmed();
 // str == "lots\t of\nwhitespace"

В отличие от simplified(), trimmed() удаляет и одиночные пробельные символы.

Смотрите также simplified().

void QString::truncate ( int position )

Обрезает строку в позиции с указанным индексом position.

Если указанная позиция с индексом position находится за пределами конца строки, то ничего не происходит.

Пример:

 QString str = "Vladivostok";
 str.truncate(4);
 // str == "Vlad"

Если position отрицателен, то это эквивалентно передаче нуля.

Смотрите также chop(), resize() и left().

const QChar * QString::unicode () const

Возвращает нультерминальное Unicode-представление строки. Результат остаётся допустимым, пока строка не изменена.

Смотрите также setUnicode() и utf16().

const ushort * QString::utf16 () const

Возвращает QString как нультерминальный массив unsigned shorts. Результат остаётся допустимым, пока строка не изменена.

Возвращаемая строка имеет порядок байт хоста.

Смотрите также setUtf16() и unicode().

QString & QString::vsprintf ( const char * cformat, va_list ap )

Эквивалентно методу sprintf(), но получает va_list ap вместо списка аргументов-переменных. Смотрите документацию по sprintf() для получения описания cformat.

Этот метод не вызывает макрос va_end, за вызов va_end для ap отвечает вызывающая сторона.

Смотрите также sprintf().

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

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

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

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

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

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

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

Массив байт other преобразуется в QString при помощи функции fromAscii(). Если в байтовом массиве содержатся нулевые символы ('\0'), то они будут включены в преобразование.

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

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

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

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

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

QString & QString::operator+= ( const QString & other )

Добавляет строку other в конец этой строки и возвращает ссылку на эту строку.

Пример:

 QString x = "free";
 QString y = "dom";
 x += y;
 // x == "freedom"

Обычно, это очень быстрая операция (занимающая постоянное время), потому что QString резервирует в памяти дополнительное место после строковых данных, чтобы иметь возможность не перераспределять память каждый раз, когда требуется увеличить массив.

Смотрите также append() и prepend().

QString & QString::operator+= ( const QLatin1String & str )

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

Добавляет строку str в кодах Latin-1 к этой строке.

QString & QString::operator+= ( const QByteArray & ba )

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

Добавляет массив байт ba к этой строке. Массив байт преобразуется в Unicode при помощи функции fromAscii(). Если в байтовом массиве ba содержатся нулевые символы ('\0'), то они будут включены в преобразование.

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

QString & QString::operator+= ( const char * str )

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

Добавляет строку str к этой строке. Указатель на константный char преобразуется в Unicode при помощи функции fromAscii().

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

QString & QString::operator+= ( const QStringRef & str )

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

Добавляет часть строки, на которую ссылается str, к этой строке.

QString & QString::operator+= ( char ch )

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

Добавляет символ ch к этой строке. Символ преобразуется в Unicode при помощи функции fromAscii().

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

QString & QString::operator+= ( QChar ch )

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

Добавляет символ ch к строке.

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

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

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

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

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

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

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

Массив байт other преобразуется в QString при помощи функции fromAscii(). Если в байтовом массиве содержатся нулевые символы ('\0'), то они будут включены в преобразование.

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

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

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

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

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

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

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

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

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

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

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

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

Массив байт other преобразуется в QString при помощи функции fromAscii(). Если в байтовом массиве содержатся нулевые символы ('\0'), то они будут включены в преобразование.

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

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

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

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

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

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

Присваивает other этой строке и возвращает ссылку на эту строку.

QString & QString::operator= ( const QLatin1String & str )

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

Присваивает Latin-1 строку str этой строке.

QString & QString::operator= ( const QByteArray & ba )

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

Присваивает ba этой строке. Массив байт преобразуется в Unicode при помощи функции fromAscii(). Эта функция останавливает преобразование на первом найденном символе NUL или по окончании массива байт ba.

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

QString & QString::operator= ( const char * str )

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

Присваивает str этой строке. Указатель на константный char преобразуется в Unicode при помощи функции fromAscii().

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

QString & QString::operator= ( char ch )

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

Присваивает символ ch этой строке. Символ преобразуется в Unicode при помощи функции fromAscii().

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

QString & QString::operator= ( QChar ch )

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

Делает строку содержащей один символ ch.

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

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

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

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

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

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

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

Массив байт other преобразуется в QString при помощи функции fromAscii(). Эта функция останавливает преобразование на первом найденном символе NUL или по окончании массива байт.

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

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

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

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

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

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

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

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

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

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

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

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

Массив байт other преобразуется в QString при помощи функции fromAscii(). Если в байтовом массиве содержатся нулевые символы ('\0'), то они будут включены в преобразование.

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

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

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

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

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

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

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

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

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

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

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

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

Массив байт other преобразуется в QString при помощи функции fromAscii(). Если в байтовом массиве содержатся нулевые символы ('\0'), то они будут включены в преобразование.

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

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

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

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

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

QCharRef QString::operator[] ( int position )

Возвращает символ в указанной позиции position в строке как изменяемую ссылку.

Пример:

 QString str;

 if (str[0] == QChar('?'))
     str[0] = QChar('_');

Возвращаемое значение имеет тип QCharRef, вспомогательный класс для QString. Когда вы получаете объект типа QCharRef, вы можете использовать его так же, как если бы он был QChar &. Если вы присваиваете ему, то присваивание будет применяться к символу в QString, на который вы получили ссылку.

Смотрите также at().

const QChar QString::operator[] ( int position ) const

Эта функция перегружает функцию operator[]().

QCharRef QString::operator[] ( uint position )

Эта функция перегружает функцию operator[]().

Возвращает символ в указанной позиции position в строке как изменяемую ссылку. Эквивалентно at(position).

const QChar QString::operator[] ( uint position ) const

Эта функция перегружает функцию operator[]().