Описание класса QByteArray
|
| Формат | Значение |
|---|---|
| e | представляется как [-]9.9e[+|-]999 |
| E | представляется как [-]9.9E[+|-]999 |
| f | представляется как [-]9.9 |
| g | используется формат e или f, смотря какой окажется короче |
| G | используется формат E или f, смотря какой окажется короче |
Для 'e', 'E' и 'f' параметр prec указывает количество цифр после точки. Для 'g' и 'G' параметр prec указывает максимальное количество значащих цифр (замыкающие нули опускаются).
QByteArray ba = QByteArray::number(12.3456, 'E', 3);
// ba == 1.235E+01
Замечание: Формат числа не локализован; по умолчанию используется локаль Cи независимо от пользовательской локали.
Смотрите также toDouble().
QByteArray & QByteArray::prepend ( const QByteArray & ba )
Добавляет массив ba перед этим массивом и возвращает ссылку на этот массив.
Пример:
QByteArray x("ship");
QByteArray y("air");
x.prepend(y);
// x == "airship"
Это то же самое, что и insert(0, ba).
Замечание: QByteArray это класс с неявным совместным использованием данных. Следовательно, если this является пустым QByteArray, то this просто будет совместно использовать данные хранящиеся в ba. В этом случае, данные не копируются.
Смотрите также append() и insert().
QByteArray & QByteArray::prepend ( const char * str )
Это перегруженная функция.
Добавляет строку str перед этим массивом.
QByteArray & QByteArray::prepend ( char ch )
Это перегруженная функция.
Добавляет символ chперед этим массивом.
void QByteArray::push_back ( const QByteArray & other )
Эта функция обеспечивает совместимость с STL. Это эквивалентно append(other).
void QByteArray::push_back ( const char * str )
Это перегруженная функция.
Тоже самое, что и append(str).
void QByteArray::push_back ( char ch )
Это перегруженная функция.
Тоже самое, что и append(ch).
void QByteArray::push_front ( const QByteArray & other )
Эта функция обеспечивает совместимость с STL. Это эквивалентно prepend(other).
void QByteArray::push_front ( const char * str )
Это перегруженная функция.
Тоже самое, что и prepend(str).
void QByteArray::push_front ( char ch )
Это перегруженная функция.
Тоже самое, что и prepend(ch).
QByteArray & QByteArray::remove ( int pos, int len )
Удаляет len байт из массива, начиная с позиции с индексом pos, и возвращает ссылку на массив.
Если pos не попадает в границы массива, то ничего не происходит. Если pos действительный, но pos + len больше, чем размер массива, то массив усекается по позиции pos.
Пример:
QByteArray ba("Montreal");
ba.remove(1, 4);
// ba == "Meal"
Смотрите также insert() и replace().
QByteArray QByteArray::repeated ( int times ) const
Возвращает копию данного байтового массива, повторенную заданного количество раз.
Если количество раз меньше 1, то возвращается пустой байтовый массив.
Пример:
QByteArray ba("ab");
ba.repeated(4); // возвращает "abababab"
Эта функция была введена в Qt 4.5.
QByteArray & QByteArray::replace ( int pos, int len, const QByteArray & after )
Заменяет len байт начиная с позиции с индексом pos на байтовый массив after, и возвращает ссылку на этот массив.
Пример:
QByteArray x("Say yes!");
QByteArray y("no");
x.replace(4, 3, y);
// x == "Say no!"
Смотрите также insert() и remove().
QByteArray & QByteArray::replace ( int pos, int len, const char * after )
Это перегруженная функция.
QByteArray & QByteArray::replace ( const QByteArray & before, const QByteArray & after )
Это перегруженная функция.
Заменяет каждое вхождение массива before на массив after.
Пример:
QByteArray ba("colour behaviour flavour neighbour");
ba.replace(QByteArray("ou"), QByteArray("o"));
// ba == "color behavior flavor neighbor"
QByteArray & QByteArray::replace ( const char * before, const QByteArray & after )
Это перегруженная функция.
Заменяет каждое вхождение строки before на массив after.
QByteArray & QByteArray::replace ( const char * before, int bsize, const char * after, int asize )
Это перегруженная функция.
Заменяет каждое вхождение строки before на строку after. Поскольку размеры строк заданы bsize и asize, они могут содержать нулевые символы и им не нужно заканчиваться нулем.
QByteArray & QByteArray::replace ( const QByteArray & before, const char * after )
Это перегруженная функция.
Заменяет каждое вхождение массива before на строку after.
QByteArray & QByteArray::replace ( const QString & before, const QByteArray & after )
Это перегруженная функция.
Заменяет каждое вхождение строки before на массив after. Данные в Unicode конвертируются в 8-битные символы используя функцию QString::toAscii().
Если QString содержит не-ASCII Unicode символы, использование этой функции может привести к потере информации. Вы можете запретить эту функцию объявив макрос QT_NO_CAST_TO_ASCII, перед компиляцией приложения. Теперь вы должны будете вызвать QString::toAscii() (или QString::toLatin1(), или QString::toUtf8(), или QString::toLocal8Bit()), если вам нужно конвертировать данные в const char *.
QByteArray & QByteArray::replace ( const QString & before, const char * after )
Это перегруженная функция.
Заменяет каждое вхождение строки before на строку after.
QByteArray & QByteArray::replace ( const char * before, const char * after )
Это перегруженная функция.
Заменяет каждое вхождение строки before на строку after.
QByteArray & QByteArray::replace ( char before, const QByteArray & after )
Это перегруженная функция.
Заменяет каждое вхождение символа before на массив after.
QByteArray & QByteArray::replace ( char before, const QString & after )
Это перегруженная функция.
Заменяет каждое вхождение символа before на строку after. Данные в Unicode конвертируются в 8-битные символы используя функцию QString::toAscii().
Если QString содержит не-ASCII Unicode символы, использование этой функции может привести к потере информации. Вы можете запретить эту функцию объявив макрос QT_NO_CAST_TO_ASCII, перед компиляцией приложения. Теперь вы должны будете вызвать QString::toAscii() (или QString::toLatin1(), или QString::toUtf8(), или QString::toLocal8Bit()), если вам нужно конвертировать данные в const char *.
QByteArray & QByteArray::replace ( char before, const char * after )
Это перегруженная функция.
Заменяет каждое вхождение символа before на строку after.
QByteArray & QByteArray::replace ( char before, char after )
Это перегруженная функция.
Заменяет каждое вхождение символа before на символ after.
void QByteArray::reserve ( int size )
Попытка зарезервировать место в памяти размером, по крайней мере, size байт. Если вы знаете наперёд насколько большим будет массив, вы можете вызвать эту функцию, и, если вы вызываете resize() много раз, то, возможно, получите лучшую производительность. Если size недооценён, то самое худшее, что может произойти это то, что QByteArray будет работать медленнее.
Единственная цель этой функции обеспечить оптимальное использование памяти в QByteArray. Вообще, у вас крайне редко возникнет необходимость вызывать эту функцию. Если вы хотите изменить размер массива, вызывайте resize().
Смотрите также squeeze() и capacity().
void QByteArray::resize ( int size )
Устанавливает размер массива в size байт.
Если size больше, чем текущий размер, то байтовый массив увеличится до size байт, добавив дополнительные байты в конец. Новые байты ничем не проинициализированы.
Если size меньше, чем текущий размер, то в конце массива будут удалены лишние байты.
Смотрите также size().
QByteArray QByteArray::right ( int len ) const
Возвращает массив, содержащий len крайних справа байт из этого массива.
Массив будет возвращен полностью, если len больше, чем size().
Пример:
QByteArray x("Pineapple");
QByteArray y = x.right(5);
// y == "apple"
Смотрите также endsWith(), left() и mid().
QByteArray QByteArray::rightJustified ( int width, char fill = ' ', bool truncate = false ) const
Возвращает байтовый массив размером width, который содержит символ fill, за которым следует этот массив.
Если truncate равно false и размер массива больше, чем width, то возвращается массив, являющийся копией этого массива.
Если truncate равен true и размер массива больше, чем width, то возвращается массив, усечённый в позиции width.
Пример:
QByteArray x("apple");
QByteArray y = x.rightJustified(8, '.'); // y == "...apple"
Смотрите также leftJustified().
QByteArray & QByteArray::setNum ( int n, int base = 10 )
Устанавливает массив в печатное представление числа n по основанию base (по умолчанию 10) и возвращает ссылку на массив. Параметр base может быть любым значением от 2 до 36.
Пример:
QByteArray ba; int n = 63; ba.setNum(n); // ba == "63" ba.setNum(n, 16); // ba == "3f"
Замечание: Формат числа не локализован; по умолчанию используется локаль Cи независимо от пользовательской локали.
Смотрите также number() и toInt().
QByteArray & QByteArray::setNum ( uint n, int base = 10 )
Это перегруженная функция.
Смотрите также toUInt().
QByteArray & QByteArray::setNum ( short n, int base = 10 )
Это перегруженная функция.
Смотрите также toShort().
QByteArray & QByteArray::setNum ( ushort n, int base = 10 )
Это перегруженная функция.
Смотрите также toUShort().
QByteArray & QByteArray::setNum ( qlonglong n, int base = 10 )
Это перегруженная функция.
Смотрите также toLongLong().
QByteArray & QByteArray::setNum ( qulonglong n, int base = 10 )
Это перегруженная функция.
Смотрите также toULongLong().
QByteArray & QByteArray::setNum ( double n, char f = 'g', int prec = 6 )
Это перегруженная функция.
Устанавливает массив в печатное представление числа n, представленное в формате f с точностью prec и возвращает ссылку на байтовый массив.
Формат f может быть следующим:
| Формат | Значение |
|---|---|
| e | представляется как [-]9.9e[+|-]999 |
| E | представляется как [-]9.9E[+|-]999 |
| f | представляется как [-]9.9 |
| g | используется формат e или f, смотря какой окажется короче |
| G | используется формат E или f, смотря какой окажется короче |
Для 'e', 'E' и 'f' параметр prec указывает количество цифр после точки. Для 'g' и 'G' параметр prec указывает максимальное количество значащих цифр (замыкающие нули опускаются).
Замечание: Формат числа не локализован; по умолчанию используется локаль Cи независимо от пользовательской локали.
Смотрите также toDouble().
QByteArray & QByteArray::setNum ( float n, char f = 'g', int prec = 6 )
Это перегруженная функция.
Устанавливает массив в печатное представление числа n, представленное в формате f с точностью prec и возвращает ссылку на байтовый массив.
Замечание: Формат числа не локализован; по умолчанию используется локаль Cи независимо от пользовательской локали.
Смотрите также toFloat().
QByteArray QByteArray::simplified () const
Возвращает байтовый массив, у которого удалены пробельные символы в начале и в конце, и у которого все последовательные пробельные символы заменены одиночным пробелом.
Символами-разделителями являются символы, для которых по стандарту C++ функция isspace() возвращает true. Они включают ASCII символы '\t', '\n', '\v', '\f', '\r' и ' '.
Пример:
QByteArray ba(" lots\t of\nwhitespace\r\n ");
ba = ba.simplified();
// ba == "lots of whitespace";
Смотрите также trimmed().
int QByteArray::size () const
Возвращает количество байт в этом массиве.
Последний байт в массиве находится в позиции size() - 1. Кроме того, QByteArray гарантированно всегда содержит в позиции size() символ '\0', так что вы можете использовать значение, возвращаемое функциями data() и constData() в качестве аргумента для функций, требующих строки, оканчивающиеся нулем ('\0').
Пример:
QByteArray ba("Hello");
int n = ba.size(); // n == 5
ba.data()[0]; // вернёт 'H'
ba.data()[4]; // вернёт 'o'
ba.data()[5]; // вернёт '\0'
Смотрите также isEmpty() и resize().
QList<QByteArray> QByteArray::split ( char sep ) const
Расщепляет массив там, где встречается символ sep, и возвращает список получившихся массивов. Если sep не встретился нигде в массиве, split() вернет список, состоящий из одного элемента, содержащего весь массив.
void QByteArray::squeeze ()
Освобождает любую память, не требующуюся для хранения данных массива.
Единственная цель этой функции обеспечить оптимальное использование памяти в QByteArray. Вообще, у вас крайне редко возникнет необходимость вызывать эту функцию.
Смотрите также reserve() и capacity().
bool QByteArray::startsWith ( const QByteArray & ba ) const
Возвращает true, если этот массив начинается с массива ba; в противном случае возвращает false.
Пример:
QByteArray url("ftp://ftp.qt.nokia.com/");
if (url.startsWith("ftp:"))
...
Смотрите также endsWith() и left().
bool QByteArray::startsWith ( const char * str ) const
Это перегруженная функция.
Возвращает true, если массив начинается со строки str; в противном случае возвращает false.
bool QByteArray::startsWith ( char ch ) const
Это перегруженная функция.
Возвращает true, если массив начинается с символа ch; в противном случае возвращает false.
QByteArray QByteArray::toBase64 () const
Возвращает копию массива в кодировке Base64.
QByteArray text("Qt is great!");
text.toBase64(); // вернёт "UXQgaXMgZ3JlYXQh"
Алгоритм, использующийся при кодировании в кодировке Base64, определен в RFC 2045.
Смотрите также fromBase64().
double QByteArray::toDouble ( bool * ok = 0 ) const
Возвращает массив преобразованный в значение типа double.
Вернёт 0.0, если преобразование не удалось.
Если ok не 0: если произошла ошибка, то *ok будет установлен в false; в противном случае *ok будет установлен в true.
QByteArray string("1234.56");
double a = string.toDouble(); // a == 1234.56
Замечание: Конвертирование числа выполняется, по умолчанию, в локали Си, независимо от пользовательской локали.
Смотрите также number().
float QByteArray::toFloat ( bool * ok = 0 ) const
Возвращает массив преобразованный в значение типа float.
Вернёт 0.0, если преобразование не удалось.
Если ok не 0: если произошла ошибка, то *ok будет установлен в false; в противном случае *ok будет установлен в true.
Замечание: Конвертирование числа выполняется, по умолчанию, в локали Си, независимо от пользовательской локали.
Смотрите также number().
QByteArray QByteArray::toHex () const
Возвращает копию массива, преобразованного в шестнадцатеричный вид. Шестнадцатеричное представление использует цифры 0-9 и буквы a-f.
Смотрите также fromHex().
int QByteArray::toInt ( bool * ok = 0, int base = 10 ) const
Возвращает массив, преобразованный в значение типа int, используя систему исчисления base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0.
Если base равна 0, то система исчисления определяется автоматически по следующим правилам: если массив начинается с "0x" - это шестнадцатеричное представление; если массив начинается с "0" - это восьмеричное представление числа; в остальных случаях это десятичное представление.
Возвращает 0, если преобразование не удалось.
Если ok не 0: если произошла ошибка, то *ok будет установлен в false; в противном случае *ok будет установлен в true.
QByteArray 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().
long QByteArray::toLong ( bool * ok = 0, int base = 10 ) const
Возвращает массив, преобразованный в значение типа long, используя систему исчисления по базе base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0.
Если base равна 0, то система исчисления определяется автоматически по следующим правилам: если массив начинается с "0x" - это шестнадцатеричное представление; если массив начинается с "0" - это восьмеричное представление числа; в остальных случаях это десятичное представление.
Возвращает 0, если преобразование не удалось.
Если ok не 0: если произошла ошибка, то *ok будет установлен в false; в противном случае *ok будет установлен в true.
QByteArray str("FF");
bool ok;
long hex = str.toLong(&ok, 16); // hex == 255, ok == true
long dec = str.toLong(&ok, 10); // dec == 0, ok == false
Замечание: Конвертирование числа выполняется, по умолчанию, в локали Си, независимо от пользовательской локали.
Эта функция была введена в Qt 4.1.
Смотрите также number().
qlonglong QByteArray::toLongLong ( bool * ok = 0, int base = 10 ) const
Возвращает массив, преобразованный в значение типа long long, используя систему исчисления по базе base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0.
Если base равна 0, то система исчисления определяется автоматически по следующим правилам: если массив начинается с "0x" - это шестнадцатеричное представление; если массив начинается с "0" - это восьмеричное представление числа; в остальных случаях это десятичное представление.
Возвращает 0, если преобразование не удалось.
Если ok не 0: если произошла ошибка, то *ok будет установлен в false; в противном случае *ok будет установлен в true.
Замечание: Конвертирование числа выполняется, по умолчанию, в локали Си, независимо от пользовательской локали.
Смотрите также number().
QByteArray QByteArray::toLower () const
Возвращает копию массива с символами в нижнем регистре. Массив воспринимается как строка в кодировке Latin-1.
Пример:
QByteArray x("Qt by NOKIA");
QByteArray y = x.toLower();
// y == "qt by nokia"
Смотрите также toUpper() и Сравнении 8-битных символов.
QByteArray QByteArray::toPercentEncoding ( const QByteArray & exclude = QByteArray(), const QByteArray & include = QByteArray(), char percent = '%' ) const
Возвращает копию массива в процентном представлении в URI/URL-стиле. Параметр percent позволяет вам переопределить умалчиваемый символ '%' на другой символ.
По умолчанию эта функция перекодирует все символы, которые не входят в следующее множество:
ALPHA (от "a" до "z" и от "A" до "Z") / DIGIT (от 0 до 9) / "-" / "." / "_" / "~"
Чтобы предотвратить перекодировку символа, укажите его в аргументе exclude. Чтобы заставить перекодировать символ (из выше указанного множества), укажите его в аргументе include. Символ percent всегда перекодируется.
Пример:
QByteArray text = "{a fishy string?}";
QByteArray ba = text.toPercentEncoding("{}", "s");
qDebug(ba.constData());
// напечатает "{a fi%73hy %73tring%3F}"
Шестнадцатеричное кодирование использует цифры 0-9 и буквы A-F в верхнем регистре.
Эта функция была введена в Qt 4.4.
Смотрите также fromPercentEncoding() и QUrl::toPercentEncoding().
short QByteArray::toShort ( bool * ok = 0, int base = 10 ) const
Возвращает массив, преобразованный в значение типа short, используя систему исчисления по базе base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0.
Если base равна 0, то система исчисления определяется автоматически по следующим правилам: если массив начинается с "0x" - это шестнадцатеричное представление; если массив начинается с "0" - это восьмеричное представление числа; в остальных случаях это десятичное представление.
Возвращает 0, если преобразование не удалось.
Если ok не 0: если произошла ошибка, то *ok будет установлен в false; в противном случае *ok будет установлен в true.
Замечание: Конвертирование числа выполняется, по умолчанию, в локали Си, независимо от пользовательской локали.
Смотрите также number().
uint QByteArray::toUInt ( bool * ok = 0, int base = 10 ) const
Возвращает массив, преобразованный в значение типа unsigned int, используя систему исчисления по базе base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0.
Если base равна 0, то система исчисления определяется автоматически по следующим правилам: если массив начинается с "0x" - это шестнадцатеричное представление; если массив начинается с "0" - это восьмеричное представление числа; в остальных случаях это десятичное представление.
Возвращает 0, если преобразование не удалось.
Если ok не 0: если произошла ошибка, то *ok будет установлен в false; в противном случае *ok будет установлен в true.
Замечание: Конвертирование числа выполняется, по умолчанию, в локали Си, независимо от пользовательской локали.
Смотрите также number().
ulong QByteArray::toULong ( bool * ok = 0, int base = 10 ) const
Возвращает массив, преобразованный в значение типа unsigned long int, используя систему исчисления по базе base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0.
Если base равна 0, то система исчисления определяется автоматически по следующим правилам: если массив начинается с "0x" - это шестнадцатеричное представление; если массив начинается с "0" - это восьмеричное представление числа; в остальных случаях это десятичное представление.
Возвращает 0, если преобразование не удалось.
Если ok не 0: если произошла ошибка, то *ok будет установлен в false; в противном случае *ok будет установлен в true.
Замечание: Конвертирование числа выполняется, по умолчанию, в локали Си, независимо от пользовательской локали.
Эта функция была введена в Qt 4.1.
Смотрите также number().
qulonglong QByteArray::toULongLong ( bool * ok = 0, int base = 10 ) const
Возвращает массив, преобразованный в значение типа unsigned long long, используя систему исчисления по базе base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0.
Если base равна 0, то система исчисления определяется автоматически по следующим правилам: если массив начинается с "0x" - это шестнадцатеричное представление; если массив начинается с "0" - это восьмеричное представление числа; в остальных случаях это десятичное представление.
Возвращает 0, если преобразование не удалось.
Если ok не 0: если произошла ошибка, то *ok будет установлен в false; в противном случае *ok будет установлен в true.
Замечание: Конвертирование числа выполняется, по умолчанию, в локали Си, независимо от пользовательской локали.
Смотрите также number().
ushort QByteArray::toUShort ( bool * ok = 0, int base = 10 ) const
Возвращает массив, преобразованный в значение типа unsigned short, используя систему исчисления по базе base, которая по умолчанию равна 10 и может быть любым числом от 2 до 36 или 0.
Если base равна 0, то система исчисления определяется автоматически по следующим правилам: если массив начинается с "0x" - это шестнадцатеричное представление; если массив начинается с "0" - это восьмеричное представление числа; в остальных случаях это десятичное представление.
Возвращает 0, если преобразование не удалось.
Если ok не 0: если произошла ошибка, то *ok будет установлен в false; в противном случае *ok будет установлен в true.
Замечание: Конвертирование числа выполняется, по умолчанию, в локали Си, независимо от пользовательской локали.
Смотрите также number().
QByteArray QByteArray::toUpper () const
Возвращает копию массива в верхнем регистре. Массив воспринимается как строка в кодировке Latin-1.
Пример:
QByteArray x("Qt by NOKIA");
QByteArray y = x.toUpper();
// y == "QT BY NOKIA"
Смотрите также toLower() и Сравнении 8-битных символов.
QByteArray QByteArray::trimmed () const
Возвращает массив, у которого в начале и в конце удалены пробельные символы.
Символами-разделителями являются символы, для которых по стандарту C++ функция isspace() возвращает true. Они включают ASCII символы '\t', '\n', '\v', '\f', '\r' и ' '.
Пример:
QByteArray ba(" lots\t of\nwhitespace\r\n ");
ba = ba.trimmed();
// ba == "lots\t of\nwhitespace";
В отличие от simplified(), trimmed() удаляет и одиночные символы-разделители.
Смотрите также simplified().
void QByteArray::truncate ( int pos )
Усекает байтовый массив в позиции с индексом pos.
Если pos выходит за пределы массива, ничего не происходит.
Пример:
QByteArray ba("Stockholm");
ba.truncate(5); // ba == "Stock"
Смотрите также chop(), resize() и left().
QByteArray::operator const char * () const
Возвращает указатель на данные, хранящиеся массиве. Указатель можно использовать для доступа к байтам, которые составляют массив. Данные завершаются символом '\0'. Указатель остается действительным до тех пор, пока массив не будет перераспределен в памяти или разрушен.
Этот оператор в основном используется для передачи массива в функцию, которая принимает const char *.
Вы можете запретить этот оператор, объявив макрос QT_NO_CAST_FROM_BYTEARRAY, перед компиляцией приложения.
Замечание: QByteArray может хранить любые значения байт, включая '\0', но большинство функций, которые принимают в качестве аргумента char * предполагают, что данные завершаются первым встретившимся '\0'.
Смотрите также constData().
QByteArray::operator const void * () const
Возвращает указатель на данные, хранящиеся массиве. Указатель можно использовать для доступа к байтам, которые составляют массив. Данные завершаются символом '\0'. Указатель остается действительным до тех пор, пока массив не будет перераспределен в памяти или разрушен.
Этот оператор в основном используется для передачи массива в функцию, которая принимает const char *.
Вы можете запретить этот оператор, объявив макрос QT_NO_CAST_FROM_BYTEARRAY, перед компиляцией приложения.
Замечание: QByteArray может хранить любые значения байт, включая '\0', но большинство функций, которые принимают в качестве аргумента char * предполагают, что данные завершаются первым встретившимся '\0'.
Смотрите также constData().
bool QByteArray::operator!= ( const QString & str ) const
Возвращает true, если этот байтовый массив не равен строке str; в противном случае возвращает false.
Данные в Unicode конвертируются в 8-битные символы с использованием QString::toAscii().
Сравнение чувствительно к регистру.
Вы можете запретить этот оператор, объявив макрос QT_NO_CAST_TO_ASCII, перед компиляцией приложения. Теперь вам нужно явно вызывать QString::fromAscii(), QString::fromLatin1(), QString::fromUtf8() или QString::fromLocal8Bit(), если вы хотите преобразовать байтовый массив в QString перед тем, как выполнить сравнение.
QByteArray & QByteArray::operator+= ( const QByteArray & ba )
Добавляет байтовый массив ba в конец этого байтового массива и возвращает ссылку на этот байтовый массив.
Пример:
QByteArray x("free");
QByteArray y("dom");
x += y;
// x == "freedom"
Обычно, это очень быстрая операция (занимающая фиксированное время (constant time)), потому что QByteArray резервирует в памяти дополнительное место после данных, чтобы иметь возможность не переаспределять память каждый раз, когда требуется увеличить массив.
Смотрите также append() и prepend().
QByteArray & QByteArray::operator+= ( const QString & str )
Это перегруженная функция.
Добавляет строку str в конец этого байтового массива и возвращает ссылку на этот байтовый массив. Данные в кодировке Unicode конвертируются в 8-битные символы с помощью QString::toAscii().
Если в QString содержатся не ASCII символы в кодировке Unicode, использование этого оператора может привести к потере информации. Вы можете запретить использование этого оператора, объявив макрос QT_NO_CAST_TO_ASCII, перед компиляцией вашего приложения Теперь вы должны будете вызвать QString::toAscii() (или QString::toLatin1(), или QString::toUtf8(), или QString::toLocal8Bit()), если вам нужно конвертировать данные в const char *.
QByteArray & QByteArray::operator+= ( const char * str )
Это перегруженная функция.
Добавляет строку str в конец этого байтового массива и возвращает ссылку на этот байтовый массив.
QByteArray & QByteArray::operator+= ( char ch )
Это перегруженная функция.
Добавляет символ ch в конец этого байтового массива и возвращает ссылку на этот массив.
bool QByteArray::operator< ( const QString & str ) const
Возвращает true, если этот байтовый массив лексически короче, чем строка str; в противном случае возвращает false.
Данные в Unicode конвертируются в 8-битные символы с использованием QString::toAscii().
Сравнение чувствительно к регистру.
Вы можете запретить этот оператор, объявив макрос QT_NO_CAST_TO_ASCII, перед компиляцией приложения. Теперь вам нужно явно вызывать QString::fromAscii(), QString::fromLatin1(), QString::fromUtf8() или QString::fromLocal8Bit(), если вы хотите преобразовать байтовый массив в QString перед тем, как выполнить сравнение.
bool QByteArray::operator<= ( const QString & str ) const
Возвращает true, если байтовый массив лексически меньше или равен строке str; в противном случае возвращает false.
Данные в Unicode конвертируются в 8-битные символы с использованием QString::toAscii().
Сравнение чувствительно к регистру.
Вы можете запретить этот оператор, объявив макрос QT_NO_CAST_TO_ASCII, перед компиляцией приложения. Теперь вам нужно явно вызывать QString::fromAscii(), QString::fromLatin1(), QString::fromUtf8() или QString::fromLocal8Bit(), если вы хотите преобразовать байтовый массив в QString перед тем, как выполнить сравнение.
QByteArray & QByteArray::operator= ( const QByteArray & other )
Присваивает other этому байтовому массиву и возвращает ссылку на этот байтовый массив.
QByteArray & QByteArray::operator= ( const char * str )
Это перегруженная функция.
Присваивает str этому байтовому массиву.
bool QByteArray::operator== ( const QString & str ) const
Возвращает true, если этот байтовый массив равен строке str; в противном случае возвращает false.
Данные в Unicode конвертируются в 8-битные символы с использованием QString::toAscii().
Сравнение чувствительно к регистру.
Вы можете запретить этот оператор, объявив макрос QT_NO_CAST_TO_ASCII, перед компиляцией приложения. Теперь вам нужно явно вызывать QString::fromAscii(), QString::fromLatin1(), QString::fromUtf8() или QString::fromLocal8Bit(), если вы хотите преобразовать байтовый массив в QString перед тем, как выполнить сравнение.
bool QByteArray::operator> ( const QString & str ) const
Возвращает true, если этот байтовый массив лексически больше, чем строка str; в противном случае возвращает false.
Данные в Unicode конвертируются в 8-битные символы с использованием QString::toAscii().
Сравнение чувствительно к регистру.
Вы можете запретить этот оператор, объявив макрос QT_NO_CAST_TO_ASCII, перед компиляцией приложения. Теперь вам нужно явно вызывать QString::fromAscii(), QString::fromLatin1(), QString::fromUtf8() или QString::fromLocal8Bit(), если вы хотите преобразовать байтовый массив в QString перед тем, как выполнить сравнение.
bool QByteArray::operator>= ( const QString & str ) const
Возвращает true, если байтовый массив больше или равен строке str; в противном случае возвращает false.
Данные в Unicode конвертируются в 8-битные символы с использованием QString::toAscii().
Сравнение чувствительно к регистру.
Вы можете запретить этот оператор, объявив макрос QT_NO_CAST_TO_ASCII, перед компиляцией приложения. Теперь вам нужно явно вызывать QString::fromAscii(), QString::fromLatin1(), QString::fromUtf8() или QString::fromLocal8Bit(), если вы хотите преобразовать байтовый массив в QString перед тем, как выполнить сравнение.
QByteRef QByteArray::operator[] ( int i )
Возвращает байт из позиции с индексом i, доступный для изменения.
Если присваивание производится за пределами байтового массива, перед присваиванием массив будет удлинен с помощью resize().
Пример:
QByteArray ba;
for (int i = 0; i < 10; ++i)
ba[i] = 'A' + i;
// ba == "ABCDEFGHIJ"
Возвращаемое значение имеет тип QByteRef, это вспомогательный класс QByteArray. Когда вы получаете объект типа QByteRef, вы можете использовать его, как если бы он был char &. Если вы присваиваете ему, то присваивание будет применяться к символу в QByteArray на который вы получили ссылку.
Смотрите также at().
char QByteArray::operator[] ( int i ) const
Это перегруженная функция.
Тоже самое, что и at(i).
QByteRef QByteArray::operator[] ( uint i )
Это перегруженная функция.
char QByteArray::operator[] ( uint i ) const
Это перегруженная функция.
Связанные нечлены класса
quint16 qChecksum ( const char * data, uint len )
Возвращает контрольную сумму CRC-16 для первых len байт из data.
Контрольная сумма не зависит от порядка байтов (endianness).
Замечание: Эта функция является реализацией алгоритма быстрого (табличного) расчёта CRC-16-CCITT.
QByteArray qCompress ( const QByteArray & data, int compressionLevel = -1 )
Упаковывает байтовый массив data и возвращает упакованные данные в виде нового байтового массива.
Параметр compressionLevel определяет, какая степень сжатия должна использоваться. Допустимые значения от 0 до 9, 9 соответствует максимальному сжатию (т.е. минимальный размер сжатых данных) за счет использования более медленного алгоритма. Меньшие значения (8, 7, ..., 1) обеспечивают, соответственно, меньшее сжатие за чуть меньшее время. Значение 0 отменяет сжатие совсем. Значение по умолчанию равно -1, что указывает библиотеке zlib сжатие по умолчанию.
Смотрите также qUncompress().
QByteArray qCompress ( const uchar * data, int nbytes, int compressionLevel = -1 )
Это перегруженная функция.
Упаковывает первые nbytes из data и возвращает упакованные данные в виде нового массива.
QByteArray qUncompress ( const QByteArray & data )
Распаковывает байтовый массив data и возвращает новый байтовый массив с распакованными данными.
Возвращает пустой (empty) QByteArray, если входные данные испорчены.
Эта функция распакует данные, сжатые с помощью qCompress() из этой и любой предыдущей версии Qt, начиная с Qt 3.1, когда эта возможность была введена.
Замечание: Если вы хотите использовать эту функцию, чтобы распаковывать внешние данные, сжатые с помощью библиотеки zlib, вы сначала должны добавить спереди четыре байта к массиву, которые будут хранить ожидаемый размер (в виде числа без знака) распакованных данных, записанных в обратном порядке (старший байт первый).
Смотрите также qCompress().
QByteArray qUncompress ( const uchar * data, int nbytes )
Это перегруженная функция.
Распаковывает первые nbytes из data и возвращает новый массив с распакованными данными.
int qsnprintf ( char * str, size_t n, const char * fmt, ... )
Портированная функция snprintf(), вызывает qvsnprintf.
fmt - это строка форматирования printf(). Результат помещается в str, который является буфером по крайней мере из n байт.
Предупреждение: Вызывайте эту функцию только тогда, когда вы знаете, что вы делаете, так как она по-разному работает на различных платформах. Взамен используйте QString::sprintf() для формирования строки по формату.
Смотрите также qvsnprintf() и QString::sprintf().
int qstrcmp ( const char * str1, const char * str2 )
Безопасная функция strcmp().
Сравнивает str1 и str2. Возвращает отрицательное значение, если str1 меньше, чем str2, 0, если str1 эквивалентна str2 или положительное значение, если str1 больше, чем str2.
Особый случай 1: Возвращает 0, если str1 и str2 обе 0.
Особый случай 2: Возвращает случайное ненулевое значение, если str1 равна 0 или str2 равна 0 (но не обе).
Смотрите также qstrcmp(), qstricmp(), qstrnicmp() и Сравнение 8-битных символов.
char * qstrcpy ( char * dst, const char * src )
Копирует все символы, включая '\0', из src в dst и возвращает указатель на dst. Если src равна 0, немедленно возвращается 0.
Эта функция предполагает, что dst достаточно большая, чтобы в нее поместились все данные из src.
Смотрите также qstrncpy().
char * qstrdup ( const char * src )
Возвращает дубликат строки.
Выделяет память для копии src, копирует её и возвращает указатель на копию. Если src равен 0, то сразу же возвращается 0.
Владельцем становится вызывающий, поэтому возвращаемая строка должна быть удалена с помощью delete[].
int qstricmp ( const char * str1, const char * str2 )
Безопасная функция stricmp().
Сравнивает str1 и str2 игнорируя регистр символов. Предполагается, что строка в кодировке Latin-1.
Возвращает отрицательное значение, если str1 меньше, чем str2, 0, если str1 равна str2 или положительное значение, если str1 больше, чем str2.
Особый случай 1: Возвращает 0, если str1 и str2 обе 0.
Особый случай 2: Возвращает случайное ненулевое значение, если str1 равна 0 или str2 равна 0 (но не обе).
Смотрите также qstrcmp(), qstrncmp(), qstrnicmp() и Сравнение 8-битных символов.
uint qstrlen ( const char * str )
Безопасная функция strlen().
Возвращает количество символов, которое предшествует символу '\0', или 0, если str равна 0.
Смотрите также qstrnlen().
int qstrncmp ( const char * str1, const char * str2, uint len )
Безопасная функция strncmp().
Сравнивает не больше, чем len байт в str1 и str2.
Возвращает отрицательное значение, если str1 меньше, чем str2, 0, если str1 равна str2 или положительное значение, если str1 больше, чем str2.
Особый случай 1: Возвращает 0, если str1 и str2 обе 0.
Особый случай 2: Возвращает случайное ненулевое значение, если str1 равна 0 или str2 равна 0 (но не обе).
Смотрите также qstrcmp(), qstricmp(), qstrnicmp() и Сравнение 8-битных символов.
char * qstrncpy ( char * dst, const char * src, uint len )
Безопасная функция strncpy().
Копирует не больше чем len байт из src (останавливается на len или на конечном '\0', в зависимости от того, что встретится первым) в dst и возвращает указатель на dst. Гарантирует, что dst заканчивается '\0'. Если src или dst равны 0, немедленно возвращается 0.
Эта функция подразумевает, что dst по меньшей мере длиной в len символов.
Смотрите также qstrcpy().
int qstrnicmp ( const char * str1, const char * str2, uint len )
Безопасная функция strnicmp().
Сравнивает не больше len байт str1 и str2, игнорируя регистр символов. Предполагается, что строка в кодировке Latin-1.
Возвращает отрицательное значение, если str1 меньше, чем str2, 0, если str1 равна str2 или положительное значение, если str1 больше, чем str2.
Особый случай 1: Возвращает 0, если str1 и str2 обе 0.
Особый случай 2: Возвращает случайное ненулевое значение, если str1 равна 0 или str2 равна 0 (но не обе).
Смотрите также qstrcmp(), qstrncmp(), qstrnicmp() и Сравнение 8-битных символов.
uint qstrnlen ( const char * str, uint maxlen )
Безопаснся функция strnlen().
Возвращает количество символов, которое предшествует символу '\0', но не более maxlen. Если str равна 0, возвращается 0.
Эта функция была введена в Qt 4.2.
Смотрите также qstrlen().
int qvsnprintf ( char * str, size_t n, const char * fmt, va_list ap )
Портированная функция vsnprintf(). Будет вызвана функция ::vsnprintf(), ::_vsnprintf() или ::vsnprintf_s, в зависимости от системы или переход к внутренней версии.
fmt - это строка форматирования printf(). Результат помещается в str, который является буфером по крайней мере из n байт.
Вызывающий ответственен за вызов функции va_end() у ap.
Предупреждение: Поскольку vsnprintf() по-разному работает на разных платформах, то вы не должны полагаться на возвращаемое значение или на то, что всегда будете получать строки с завершающим 0.
В идеале, вы никогда не должны вызывать эту функцию, а использовать вместо неё QString::sprintf().
Смотрите такжеqsnprintf() и QString::sprintf().
bool operator!= ( const QByteArray & a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает true, если байтовый массив a1 не равен байтовому массиву a2; в противном случае возвращает false.
bool operator!= ( const QByteArray & a1, const char * a2 )
Это перегруженная функция.
Возвращает true, если байтовый массив a1 не равен строке a2; в противном случае возвращает false.
bool operator!= ( const char * a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает true, если строка a1 не равна байтовому массиву a2; в противном случае возвращает false.
const QByteArray operator+ ( const char * a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает байтовый массив, который является результатом конкатенации строки a1 и байтового массива a2.
const QByteArray operator+ ( char a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает байтовый массив, который является результатом конкатенации символа a1 и байтового массива a2.
const QByteArray operator+ ( const QByteArray & a1, const QByteArray & a2 )
Возвращает байтовый массив, который является результатом конкатенации байтового массива a1 и байтового массива a2.
Смотрите также QByteArray::operator+=().
const QByteArray operator+ ( const QByteArray & a1, const char * a2 )
Это перегруженная функция.
Возвращает байтовый массив, который является результатом конкатенации байтового массива a1 и строки a2.
const QByteArray operator+ ( const QByteArray & a1, char a2 )
Это перегруженная функция.
Возвращает байтовый массив, который является результатом конкатенации байтового массива a1 и символа a2.
bool operator< ( const QByteArray & a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает true, если байтовый массив a1 лексически меньше, чем байтовый массив a2; в противном случае возвращает false.
bool operator< ( const QByteArray & a1, const char * a2 )
Это перегруженная функция.
Возвращает true, если байтовый массив a1 лексически меньше, чем строка a2; в противном случае возвращает false.
bool operator< ( const char * a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает true, если строка a1 лексически меньше, чем байтовый массив a2; в противном случае возвращает false.
QDataStream & operator<< ( QDataStream & out, const QByteArray & ba )
Записывает байтовый массив ba в поток out и возвращает ссылку на поток.
Смотрите также Формат операторов QDataStream.
bool operator<= ( const QByteArray & a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает true, если байтовый массив a1 лексически меньше или равен, байтовому массиву a2; в противном случае возвращает false.
bool operator<= ( const QByteArray & a1, const char * a2 )
Это перегруженная функция.
Возвращает true, если байтовый массив a1 лексически меньше или равен строке a2; в противном случае возвращает false.
bool operator<= ( const char * a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает true, если строка a1 лексически меньше или равна байтовому массиву a2; в противном случае возвращает false.
bool operator== ( const QByteArray & a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает true, если байтовый массив a1 равен байтовому массиву a2; в противном случае возвращает false.
bool operator== ( const QByteArray & a1, const char * a2 )
Это перегруженная функция.
Возвращает true, если байтовый массив a1 равен строке a2; в противном случае возвращает false.
bool operator== ( const char * a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает true, если строка a1 равна байтовому массиву a2; в противном случае возвращает false.
bool operator> ( const QByteArray & a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает true, если байтовый массив a1 лексически больше, чем байтовый массив a2; в противном случае возвращает false.
bool operator> ( const QByteArray & a1, const char * a2 )
Это перегруженная функция.
Возвращает true, если байтовый массив a1 лексически больше, чем строка a2; в противном случае возвращает false.
bool operator> ( const char * a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает true, если строка a1 лексически больше, чем байтовый массив a2; в противном случае возвращает false.
bool operator>= ( const QByteArray & a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает true, если байтовый массив a1 лексически больше или равен, байтовому массиву a2; в противном случае возвращает false.
bool operator>= ( const QByteArray & a1, const char * a2 )
Это перегруженная функция.
Возвращает true, если байтовый массив a1 лексически больше или равен строке a2; в противном случае возвращает false.
bool operator>= ( const char * a1, const QByteArray & a2 )
Это перегруженная функция.
Возвращает true, если строка a1 лексически больше или равна байтовому массиву a2; в противном случае возвращает false.
QDataStream & operator>> ( QDataStream & in, QByteArray & ba )
Читает байтовый массив в ba из потока in и возвращает ссылку на поток.
Смотрите также Формат операторов QDataStream.
Описание макросов
QT_NO_CAST_FROM_BYTEARRAY
Отключает автоматическое преобразование из QByteArray в const char * or const void *.
Смотрите также QT_NO_CAST_TO_ASCII и QT_NO_CAST_FROM_ASCII.
| Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) | Торговые марки | Qt 4.5.3 |
|
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |