QByteArray Class

Documentación de funciones miembro

[constexpr noexcept] QByteArray::QByteArray()

Construye una matriz de bytes vacía.

Véase también isEmpty().

[explicit, since 6.8] QByteArray::QByteArray(QByteArrayView v)

Construye una matriz de bytes inicializada con los datos de la vista de matriz de bytes.

El QByteArray será null si y sólo si v es null.

Esta función se introdujo en Qt 6.8.

QByteArray::QByteArray(const char *data, qsizetype size = -1)

Construye una matriz de bytes que contiene los primeros size bytes de la matriz data.

Si data es 0, se construye una matriz de bytes nula.

Si size es negativo, se asume que data apunta a una cadena '\0'terminada y su longitud se determina dinámicamente.

QByteArray realiza una copia profunda de los datos de la cadena.

Véase también fromRawData().

QByteArray::QByteArray(qsizetype size, Qt::Initialization)

Construye una matriz de bytes de tamaño size con contenido no inicializado.

Por ejemplo:

QByteArray buffer(123, Qt::Uninitialized);

QByteArray::QByteArray(qsizetype size, char ch)

Construye una matriz de bytes de tamaño size con cada byte establecido a ch.

Véase también fill().

[noexcept] QByteArray::QByteArray(const QByteArray &other)

Construye una copia de other.

Esta operación toma un tiempo constante, porque QByteArray es implícitamente compartido. Esto hace que devolver un QByteArray desde una función sea muy rápido. Si se modifica una instancia compartida, se copiará (copy-on-write), tardando un tiempo lineal.

Véase también operator=().

[noexcept] QByteArray::QByteArray(QByteArray &&other)

Move-construye una instancia de QByteArray, haciendo que apunte al mismo objeto al que apuntaba other.

[noexcept] QByteArray::~QByteArray()

Destruye la matriz de bytes.

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

Añade la matriz de bytes ba al final de esta matriz de bytes.

Ejemplo:

QByteArray x("free");
QByteArray y("dom");
x.append(y);
// x == "freedom"

Es lo mismo que insertar(size(), ba).

Nota: QByteArray es una clase implícitamente compartida. En consecuencia, si se anexa a una matriz de bytes vacía, entonces la matriz de bytes sólo compartirá los datos contenidos en ba. En este caso, no se realiza ninguna copia de datos, tomándose un tiempo constante. Si se modifica una instancia compartida, se copiará (copy-on-write), tardando un tiempo lineal.

Si la matriz de bytes a la que se añade no está vacía, se realiza una copia en profundidad de los datos, lo que lleva un tiempo lineal.

La función append() suele ser muy rápida(tiempo constante), ya que QByteArray preasigna espacio extra al final de los datos, por lo que puede crecer sin reasignar toda la matriz cada vez.

Véase también operator+=(), prepend() y insert().

QByteArray &QByteArray::append(QByteArrayView data)

Añade data a esta matriz de bytes.

QByteArray &QByteArray::append(char ch)

Añade el byte ch a esta matriz de bytes.

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

Añade la cadena '\0'-terminada str a esta matriz de bytes.

QByteArray &QByteArray::append(const char *str, qsizetype len)

Añade los primeros len bytes comenzando en str a esta matriz de bytes y devuelve una referencia a esta matriz de bytes. Los bytes añadidos pueden incluir '\0' bytes.

Si len es negativo, se asumirá que str es una cadena '\0'terminada y la longitud a copiar se determinará automáticamente usando qstrlen().

Si len es cero o str es nulo, no se añade nada a la matriz de bytes. Asegúrese de que len no es más largo que str.

QByteArray &QByteArray::append(qsizetype count, char ch)

Añade count copias del byte ch a esta matriz de bytes y devuelve una referencia a esta matriz de bytes.

Si count es negativo o cero no se añade nada a la matriz de bytes.

[since 6.6] QByteArray &QByteArray::assign(QByteArrayView v)

Sustituye el contenido de esta matriz de bytes por una copia de v y devuelve una referencia a esta matriz de bytes.

El tamaño de esta matriz de bytes será igual al tamaño de v.

Esta función sólo asigna memoria si el tamaño de v excede la capacidad de esta matriz de bytes o si esta matriz de bytes está compartida.

Esta función se introdujo en Qt 6.6.

[since 6.6] template <typename InputIterator, QByteArray::if_input_iterator<InputIterator> = true> QByteArray &QByteArray::assign(InputIterator first, InputIterator last)

Sustituye el contenido de esta matriz de bytes por una copia de los elementos del rango del iterador [first, last) y devuelve una referencia a esta matriz de bytes.

El tamaño de esta matriz de bytes será igual al número de elementos del rango [first, last).

Esta función sólo asignará memoria si el número de elementos en el rango excede la capacidad de esta matriz de bytes o esta matriz de bytes es compartida.

Restricciones

Participa en la resolución de sobrecargas sólo si InputIterator cumple los requisitos de un LegacyInputIterator.

Esta función se introdujo en Qt 6.6.

[since 6.6] QByteArray &QByteArray::assign(qsizetype n, char c)

Sustituye el contenido de esta matriz de bytes por n copias de c y devuelve una referencia a esta matriz de bytes.

El tamaño de esta matriz de bytes será igual a n, que tiene que ser no negativo.

Esta función sólo asignará memoria si n excede la capacidad de esta matriz de bytes o esta matriz de bytes está compartida.

Esta función se introdujo en Qt 6.6.

Véase también fill().

char QByteArray::at(qsizetype i) const

Devuelve el byte en la posición de índice i en la matriz de bytes.

i debe ser una posición de índice válida en la matriz de bytes (es decir, 0 <= i < size()).

Véase también operator[]().

char &QByteArray::back()

Devuelve una referencia al último byte de la matriz de bytes. Igual que operator[](size() - 1).

Esta función se proporciona por compatibilidad con STL.

Véase también front(), at(), y operator[]().

char QByteArray::back() const

Devuelve el último byte de la matriz de bytes. Igual que at(size() - 1).

Esta función se proporciona por compatibilidad con STL.

Véase también front(), at(), y operator[]().

QByteArray::iterator QByteArray::begin()

Devuelve un iterador de estilo STL que apunta al primer byte de la matriz de bytes.

Véase también constBegin() y end().

[noexcept] QByteArray::const_iterator QByteArray::begin() const

qsizetype QByteArray::capacity() const

Devuelve el número máximo de bytes que pueden almacenarse en la matriz de bytes sin forzar una reasignación.

El único propósito de esta función es proporcionar un medio para ajustar el uso de memoria de QByteArray. En general, rara vez necesitará llamar a esta función. Si desea saber cuántos bytes hay en la matriz de bytes, llame a size().

Véase también reserve() y squeeze().

[noexcept] QByteArray::const_iterator QByteArray::cbegin() const

Devuelve un iterador const de estilo STL que apunta al primer byte de la matriz de bytes.

Véase también begin() y cend().

[noexcept] QByteArray::const_iterator QByteArray::cend() const

Devuelve un iterador const de estilo STL que apunta justo después del último byte de la matriz de bytes.

Véase también cbegin() y end().

void QByteArray::chop(qsizetype n)

Elimina n bytes del final de la matriz de bytes.

Si n es mayor que size(), el resultado es una matriz de bytes vacía.

Ejemplo:

QByteArray ba("STARTTLS\r\n");
ba.chop(2);                 // ba == "STARTTLS"

Véase también truncate(), resize(), y first().

Devuelve una matriz de bytes que contiene los bytes size() - len situados más a la izquierda de esta matriz de bytes.

Véase también endsWith(), first(), last(), sliced(), chop(), truncate(), y slice().

void QByteArray::clear()

Borra el contenido de la matriz de bytes y la hace nula.

Véase también resize() y isNull().

[noexcept, since 6.0] int QByteArray::compare(QByteArrayView bv, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve un entero menor, igual o mayor que cero dependiendo de si este QByteArray ordena antes, en la misma posición o después que el QByteArrayView bv . La comparación se realiza teniendo en cuenta mayúsculas y minúsculas cs.

Esta función se introdujo en Qt 6.0.

Véase también operator== y Character Case.

[noexcept] QByteArray::const_iterator QByteArray::constBegin() const

Devuelve un iterador const de estilo STL que apunta al primer byte de la matriz de bytes.

Véase también begin() y constEnd().

[noexcept] const char *QByteArray::constData() const

Devuelve un puntero a los datos const almacenados en la matriz de bytes. El puntero puede utilizarse para acceder a los bytes que componen la matriz. Los datos son '\0'-terminados a menos que el objeto QByteArray haya sido creado a partir de datos sin procesar.

El puntero sigue siendo válido mientras no se produzca una separación y no se modifique QByteArray.

Esta función es útil sobre todo para pasar una matriz de bytes a una función que acepte un const char *.

Nota: Un QByteArray puede almacenar cualquier valor de byte incluyendo '\0's, pero la mayoría de las funciones que toman argumentos char * asumen que los datos terminan en el primer '\0' que encuentran.

Véase también data(), operator[]() y fromRawData().

[noexcept] QByteArray::const_iterator QByteArray::constEnd() const

Devuelve un iterador const de estilo STL que apunta justo después del último byte de la matriz de bytes.

Véase también constBegin() y end().

[since 6.0] bool QByteArray::contains(QByteArrayView bv) const

Devuelve true si este array de bytes contiene una ocurrencia de la secuencia de bytes vista por bv; en caso contrario devuelve false.

Esta función se introdujo en Qt 6.0.

Véase también indexOf() y count().

bool QByteArray::contains(char ch) const

Devuelve true si la matriz de bytes contiene el byte ch; en caso contrario devuelve false.

[since 6.0] qsizetype QByteArray::count(QByteArrayView bv) const

Devuelve el número de ocurrencias (potencialmente solapadas) de la secuencia de bytes vista por bv en este array de bytes.

Esta función se introdujo en Qt 6.0.

Véase también contains() y indexOf().

qsizetype QByteArray::count(char ch) const

Devuelve el número de apariciones del byte ch en la matriz de bytes.

Véase también contains() y indexOf().

[noexcept] QByteArray::const_reverse_iterator QByteArray::crbegin() const

Devuelve un iterador inverso estilo STL que apunta al primer byte de la matriz de bytes, en orden inverso.

Véase también begin(), rbegin(), y rend().

[noexcept] QByteArray::const_reverse_iterator QByteArray::crend() const

Devuelve un iterador inverso estilo STL que apunta justo después del último byte de la matriz de bytes, en orden inverso.

Véase también end(), rend(), y rbegin().

char *QByteArray::data()

Devuelve un puntero a los datos almacenados en la matriz de bytes. El puntero puede utilizarse para acceder y modificar los bytes que componen la matriz. Los datos están '\0'-terminados, es decir, el número de bytes a los que se puede acceder siguiendo el puntero devuelto es size() + 1, incluido el terminador '\0'.

Ejemplo:

QByteArray ba("Hello world");
char *data = ba.data();
while (*data) {
    cout << "[" << *data << "]" << endl;
    ++data;
}

El puntero sigue siendo válido mientras no se produzca una separación y no se modifique QByteArray.

Para el acceso de sólo lectura, constData() es más rápido porque nunca provoca una copia profunda.

Esta función es útil sobre todo para pasar una matriz de bytes a una función que acepte un const char *.

El siguiente ejemplo hace una copia del char* devuelto por data(), pero corromperá el heap y causará un crash porque no asigna un byte para el '\0' al final:

QString tmp = "test";
QByteArray text = tmp.toLocal8Bit();
char *data = new char[text.size()];
strcpy(data, text.data());
delete [] data;

Este asigna la cantidad correcta de espacio:

QString tmp = "test";
QByteArray text = tmp.toLocal8Bit();
char *data = new char[text.size() + 1];
strcpy(data, text.data());
delete [] data;

Nota: Un QByteArray puede almacenar cualquier valor de byte incluyendo '\0's, pero la mayoría de las funciones que toman argumentos char * asumen que los datos terminan en el primer '\0' que encuentran.

Véase también constData() y operator[]().

[noexcept] const char *QByteArray::data() const

QByteArray::iterator QByteArray::end()

Devuelve un iterador de estilo STL que apunta justo después del último byte de la matriz de bytes.

Véase también begin() y constEnd().

[noexcept] QByteArray::const_iterator QByteArray::end() const

[since 6.0] bool QByteArray::endsWith(QByteArrayView bv) const

Devuelve true si esta matriz de bytes termina con la secuencia de bytes vista por bv; en caso contrario devuelve false.

Ejemplo:

QByteArray url("http://qt-project.org/doc/qt-5.0/qtdoc/index.html");
if (url.endsWith(".html"))
    {/*...*/}

Esta función se introdujo en Qt 6.0.

Véase también startsWith() y last().

bool QByteArray::endsWith(char ch) const

Devuelve true si esta matriz de bytes termina con el byte ch; en caso contrario devuelve false.

[since 6.1] QByteArray::iterator QByteArray::erase(QByteArray::const_iterator first, QByteArray::const_iterator last)

Elimina de la matriz de bytes los caracteres del rango semiabierto [ first, last ). Devuelve un iterador al carácter referido por last antes del borrado.

Esta función se introdujo en Qt 6.1.

[since 6.5] QByteArray::iterator QByteArray::erase(QByteArray::const_iterator it)

Elimina el carácter indicado por it de la matriz de bytes. Devuelve un iterador al carácter inmediatamente posterior al carácter borrado.

QByteArray ba = "abcdefg";
auto it = ba.erase(ba.cbegin()); // ba is now "bcdefg" and it points to "b"

Esta función se introdujo en Qt 6.5.

QByteArray &QByteArray::fill(char ch, qsizetype size = -1)

Establece cada byte de la matriz de bytes en ch. Si size es diferente de -1 (por defecto), la matriz de bytes se redimensiona previamente al tamaño size.

Ejemplo:

QByteArray ba("Istambul");
ba.fill('o');
// ba == "oooooooo"

ba.fill('X', 2);
// ba == "XX"

Véase también resize().

Devuelve los primeros n bytes de la matriz de bytes.

Ejemplo:

QByteArray x("Pineapple");
QByteArray y = x.first(4);
// y == "Pine"

Estas funciones se introdujeron en Qt 6.0.

Véase también last(), sliced(), startsWith(), chopped(), chop(), truncate(), y slice().

[static] QByteArray QByteArray::fromBase64(const QByteArray &base64, QByteArray::Base64Options options = Base64Encoding)

Devuelve una copia descodificada de la matriz Base64 base64, utilizando las opciones definidas por options. Si options contiene IgnoreBase64DecodingErrors (por defecto), no se comprueba la validez de la entrada; los caracteres no válidos de la entrada se omiten, permitiendo que el proceso de descodificación continúe con los caracteres siguientes. Si options contiene AbortOnBase64DecodingErrors, la descodificación se detendrá en el primer carácter no válido.

Por ejemplo:

QByteArray text = QByteArray::fromBase64("UXQgaXMgZ3JlYXQh");
text.data();            // returns "Qt is great!"

QByteArray::fromBase64("PHA+SGVsbG8/PC9wPg==", QByteArray::Base64Encoding); // returns "<p>Hello?</p>"
QByteArray::fromBase64("PHA-SGVsbG8_PC9wPg==", QByteArray::Base64UrlEncoding); // returns "<p>Hello?</p>"

El algoritmo utilizado para descodificar datos codificados en Base64 se define en RFC 4648.

Devuelve los datos descodificados o, si se ha pasado la opción AbortOnBase64DecodingErrors y los datos de entrada no eran válidos, una matriz de bytes vacía.

Véase también toBase64() y fromBase64Encoding().

Decodifica la matriz Base64 base64, utilizando las opciones definidas por options. Si options contiene IgnoreBase64DecodingErrors (por defecto), no se comprueba la validez de la entrada; los caracteres no válidos de la entrada se omiten, permitiendo que el proceso de descodificación continúe con los caracteres siguientes. Si options contiene AbortOnBase64DecodingErrors, la descodificación se detendrá en el primer carácter no válido.

Por ejemplo:

void process(const QByteArray &);

if (auto result = QByteArray::fromBase64Encoding(encodedData))
    process(*result);

El algoritmo utilizado para descodificar datos codificados en Base64 se define en RFC 4648.

Devuelve un objeto QByteArrayFromBase64Result, que contiene los datos decodificados y una bandera que indica si la decodificación se ha realizado correctamente. Si se pasó la opción AbortOnBase64DecodingErrors y los datos de entrada no eran válidos, no se especifica qué contienen los datos descodificados.

Véase también toBase64().

[static] QByteArray QByteArray::fromCFData(CFDataRef data)

Construye un nuevo QByteArray que contiene una copia del CFData data.

Véase también fromRawCFData(), fromRawData(), toRawCFData(), y toCFData().

[static, since 6.5] QByteArray QByteArray::fromEcmaUint8Array(emscripten::val uint8array)

Construye un nuevo QByteArray que contiene una copia del Uint8Array uint8array.

Esta función transfiere datos desde un buffer de datos JavaScript - que no es direccionable desde código C++ - a la memoria heap propiedad de un QByteArray. El Uint8Array puede ser liberado una vez que esta función retorna y se ha hecho una copia.

El argumento uint8array debe ser un emscripten::val que haga referencia a un objeto Uint8Array, por ejemplo, obtenido de una variable global JavaScript:

emscripten::val uint8array = emscripten::val::global("g_uint8array");
QByteArray byteArray = QByteArray::fromEcmaUint8Array(uint8array);

Esta función devuelve un QByteArray nulo si el tamaño del Uint8Array excede la capacidad máxima de QByteArray, o si el argumento uint8array no es del tipo Uint8Array.

Esta función se introdujo en Qt 6.5.

Véase también toEcmaUint8Array().

[static] QByteArray QByteArray::fromHex(const QByteArray &hexEncoded)

Devuelve una copia descodificada de la matriz codificada hexadecimalmente hexEncoded. No se comprueba la validez de la entrada; los caracteres no válidos de la entrada se omiten, lo que permite que el proceso de descodificación continúe con los caracteres siguientes.

Por ejemplo:

QByteArray text = QByteArray::fromHex("517420697320677265617421");
text.data();            // returns "Qt is great!"

Véase también toHex().

[static] QByteArray QByteArray::fromNSData(const NSData *data)

Construye un nuevo QByteArray que contiene una copia del NSData data.

Véase también fromRawNSData(), fromRawData(), toNSData() y toRawNSData().

[static] QByteArray QByteArray::fromPercentEncoding(const QByteArray &input, char percent = '%')

Decodifica input a partir de la codificación porcentual estilo URI/URL.

Devuelve una matriz de bytes que contiene el texto descodificado. El parámetro percent permite utilizar un carácter distinto de '%' (por ejemplo, '_' o '=') como carácter de escape. Equivale a la entrada.percentDecoded(porcentaje).

Por ejemplo:

QByteArray text = QByteArray::fromPercentEncoding("Qt%20es%20genial%33");qDebug("%s", text.data());      // reports "Qt is great!"

Véase también percentDecoded().

[static, since 6.11] QByteArray QByteArray::fromPercentEncoding(QByteArray &&input, char percent = '%')

Esta función se introdujo en Qt 6.11.

[static] QByteArray QByteArray::fromRawCFData(CFDataRef data)

Construye un QByteArray que utiliza los bytes del CFData data.

Los bytes de data no se copian.

El invocador garantiza que el CFData no será borrado o modificado mientras exista este objeto QByteArray.

Véase también fromCFData(), fromRawData(), toRawCFData() y toCFData().

[static] QByteArray QByteArray::fromRawData(const char *data, qsizetype size)

Construye un QByteArray que utiliza los primeros size bytes de la matriz data. Los bytes no se copian. El QByteArray contendrá el puntero data. El invocador garantiza que data no será borrado o modificado mientras exista este QByteArray y cualquier copia del mismo que no haya sido modificada. En otras palabras, dado que QByteArray es una clase implícitamente compartida y la instancia devuelta por esta función contiene el puntero data, el invocador no debe borrar data ni modificarlo directamente mientras exista el QByteArray devuelto y cualquier copia del mismo. Sin embargo, QByteArray no se apropia de data, por lo que el destructor de QByteArray nunca borrará el puntero data, incluso cuando se destruya el último QByteArray que hace referencia a data.

Un intento posterior de modificar el contenido del QByteArray devuelto o de cualquier copia realizada a partir de él hará que se cree una copia profunda del array data antes de realizar la modificación. Esto asegura que la matriz data en bruto nunca será modificada por QByteArray.

A continuación se muestra un ejemplo de cómo leer datos utilizando un QDataStream sobre datos brutos en memoria sin copiar los datos brutos en un QByteArray:

static const char mydata[] = {
    '\x00', '\x00', '\x03', '\x84', '\x78', '\x9c', '\x3b', '\x76',
    '\xec', '\x18', '\xc3', '\x31', '\x0a', '\xf1', '\xcc', '\x99',
    //...
    '\x6d', '\x5b'
};

QByteArray data = QByteArray::fromRawData(mydata, sizeof(mydata));
QDataStream in(&data, QIODevice::ReadOnly);
//...

Véase también setRawData(), data(), constData(), nullTerminate() y nullTerminated().

[static] QByteArray QByteArray::fromRawNSData(const NSData *data)

Construye un QByteArray que utiliza los bytes del NSData data.

Los bytes de data no se copian.

El invocador garantiza que el NSData no se borrará ni modificará mientras exista este objeto QByteArray.

Véase también fromNSData(), fromRawData(), toRawNSData() y toNSData().

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

Devuelve una copia de la cadena str como QByteArray.

Véase también toStdString() y QString::fromStdString().

char &QByteArray::front()

Devuelve una referencia al primer byte de la matriz de bytes. Igual que operator[](0).

Esta función se proporciona por compatibilidad con STL.

Véase también back(), at(), y operator[]().

char QByteArray::front() const

Devuelve el primer byte de la matriz de bytes. Igual que at(0).

Esta función se proporciona por compatibilidad con STL.

Véase también back(), at(), y operator[]().

[since 6.0] qsizetype QByteArray::indexOf(QByteArrayView bv, qsizetype from = 0) const

Devuelve la posición del índice del inicio de la primera ocurrencia de la secuencia de bytes vista por bv en esta matriz de bytes, buscando hacia adelante desde la posición del índice from. Devuelve -1 si no se encuentra ninguna coincidencia.

Ejemplo:

QByteArray x("sticky question");
QByteArrayView y("sti");
x.indexOf(y);               // returns 0
x.indexOf(y, 1);            // returns 10
x.indexOf(y, 10);           // returns 10
x.indexOf(y, 11);           // returns -1

Esta función se introdujo en Qt 6.0.

Véase también lastIndexOf(), contains(), y count().

qsizetype QByteArray::indexOf(char ch, qsizetype from = 0) const

Devuelve la posición del índice del inicio de la primera aparición del byte ch en esta matriz de bytes, buscando hacia delante desde la posición del índice from. Devuelve -1 si no se encuentra ninguna coincidencia.

Ejemplo:

QByteArray ba("ABCBA");
ba.indexOf("B");            // returns 1
ba.indexOf("B", 1);         // returns 1
ba.indexOf("B", 2);         // returns 3
ba.indexOf("X");            // returns -1

Véase también lastIndexOf() y contains().

[since 6.0] QByteArray &QByteArray::insert(qsizetype i, QByteArrayView data)

Inserta data en la posición de índice i y devuelve una referencia a esta matriz de bytes.

Ejemplo:

QByteArray ba("Meal");
ba.insert(1, QByteArrayView("ontr"));
// ba == "Montreal"

Para matrices de bytes grandes, esta operación puede ser lenta(tiempo lineal), porque requiere mover todos los bytes en los índices i y superiores al menos una posición más en memoria.

Esta matriz crece para acomodar la inserción. Si i está más allá del final del array, el array se extiende primero con caracteres de espacio para alcanzar este i.

Esta función se introdujo en Qt 6.0.

Véase también append(), prepend(), replace(), y remove().

QByteArray &QByteArray::insert(qsizetype i, const QByteArray &data)

Inserta data en la posición de índice i y devuelve una referencia a esta matriz de bytes.

Esta matriz crece para acomodar la inserción. Si i está más allá del final de la matriz, la matriz se amplía primero con caracteres de espacio para llegar a este i.

Véase también append(), prepend(), replace() y remove().

QByteArray &QByteArray::insert(qsizetype i, const char *s)

Inserta s en la posición de índice i y devuelve una referencia a esta matriz de bytes.

Esta matriz crece para acomodar la inserción. Si i está más allá del final de la matriz, la matriz se amplía primero con caracteres de espacio para alcanzar este i.

La función es equivalente a insert(i, QByteArrayView(s))

Véase también append(), prepend(), replace() y remove().

QByteArray &QByteArray::insert(qsizetype i, char ch)

Inserta el byte ch en la posición de índice i de la matriz de bytes.

Esta matriz crece para acomodar la inserción. Si i está más allá del final de la matriz, la matriz se amplía primero con caracteres de espacio para alcanzar este i.

QByteArray &QByteArray::insert(qsizetype i, const char *data, qsizetype len)

Inserta len bytes, comenzando en data, en la posición i de la matriz de bytes.

Esta matriz crece para acomodar la inserción. Si i está más allá del final de la matriz, la matriz se amplía primero con caracteres de espacio para alcanzar este i.

QByteArray &QByteArray::insert(qsizetype i, qsizetype count, char ch)

Inserta count copias del byte ch en la posición de índice i en la matriz de bytes.

Esta matriz crece para acomodar la inserción. Si i está más allá del final de la matriz, la matriz se amplía primero con caracteres de espacio para alcanzar este i.

[constexpr noexcept] bool QByteArray::isEmpty() const

Devuelve true si la matriz de bytes tiene tamaño 0; en caso contrario devuelve false.

Ejemplo:

QByteArray().isEmpty();         // returns true
QByteArray("").isEmpty();       // returns true
QByteArray("abc").isEmpty();    // returns false

Véase también size().

bool QByteArray::isLower() const

Devuelve true si esta matriz de bytes está en minúsculas, es decir, si es idéntica a su plegado toLower().

Tenga en cuenta que esto no significa que la matriz de bytes sólo contenga letras minúsculas; sólo que no contiene letras mayúsculas ASCII.

Véase también isUpper() y toLower().

[noexcept] bool QByteArray::isNull() const

Devuelve true si esta matriz de bytes es nula; en caso contrario devuelve false.

Ejemplo:

QByteArray().isNull();          // returns true
QByteArray("").isNull();        // returns false
QByteArray("abc").isNull();     // returns false

Qt distingue entre matrices de bytes nulas y vacías por razones históricas. Para la mayoría de las aplicaciones, lo que importa es si una matriz de bytes contiene o no datos, y esto puede determinarse utilizando isEmpty().

Véase también isEmpty().

bool QByteArray::isUpper() const

Devuelve true si esta matriz de bytes está en mayúsculas, es decir, si es idéntica a su plegado toUpper().

Tenga en cuenta que esto no significa que la matriz de bytes sólo contenga letras mayúsculas; sólo que no contiene letras ASCII minúsculas.

Véase también isLower() y toUpper().

[noexcept, since 6.3] bool QByteArray::isValidUtf8() const

Devuelve true si esta matriz de bytes contiene datos codificados en UTF-8 válidos, o false en caso contrario.

Esta función se introdujo en Qt 6.3.

Devuelve los últimos n bytes de la matriz de bytes.

Ejemplo:

QByteArray x("Pineapple");
QByteArray y = x.last(5);
// y == "apple"

Estas funciones se introdujeron en Qt 6.0.

Véase también first(), sliced(), endsWith(), chopped(), chop(), truncate(), y slice().

[since 6.0] qsizetype QByteArray::lastIndexOf(QByteArrayView bv, qsizetype from) const

Devuelve la posición del índice del comienzo de la última aparición de la secuencia de bytes vista por bv en esta matriz de bytes, buscando hacia atrás desde la posición del índice from.

Si from es -1, la búsqueda comienza en el último carácter; si es -2, en el penúltimo carácter y así sucesivamente.

Devuelve -1 si no se encuentra ninguna coincidencia.

Ejemplo:

QByteArray x("crazy azimuths");
QByteArrayView y("az");
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

Esta función se introdujo en Qt 6.0.

Véase también indexOf(), contains() y count().

[since 6.2] qsizetype QByteArray::lastIndexOf(QByteArrayView bv) const

Devuelve la posición del índice del inicio de la última ocurrencia de la secuencia de bytes vista por bv en esta matriz de bytes, buscando hacia atrás desde el final de la matriz de bytes. Devuelve -1 si no se encuentra ninguna coincidencia.

Ejemplo:

QByteArray x("crazy azimuths");
QByteArrayView y("az");
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

Esta función se introdujo en Qt 6.2.

Véase también indexOf(), contains(), y count().

qsizetype QByteArray::lastIndexOf(char ch, qsizetype from = -1) const

Devuelve la posición del índice del inicio de la última aparición del byte ch en esta matriz de bytes, buscando hacia atrás desde la posición del índice from. Si from es -1 (por defecto), la búsqueda comienza en el último byte (en el índice size() - 1). Devuelve -1 si no se encuentra ninguna coincidencia.

Ejemplo:

QByteArray ba("ABCBA");
ba.lastIndexOf("B");        // returns 3
ba.lastIndexOf("B", 3);     // returns 3
ba.lastIndexOf("B", 2);     // returns 1
ba.lastIndexOf("X");        // returns -1

Véase también indexOf() y contains().

Devuelve una matriz de bytes que contiene los primeros len bytes de esta matriz de bytes.

Si sabe que len no puede estar fuera de los límites, utilice first() en su lugar en código nuevo, porque es más rápido.

Se devuelve toda la matriz de bytes si len es mayor que size().

Devuelve un QByteArray vacío si len es menor que 0.

Ver también first(), last(), startsWith(), chopped(), chop(), y truncate().

QByteArray QByteArray::leftJustified(qsizetype width, char fill = ' ', bool truncate = false) const

Devuelve una matriz de bytes de tamaño width que contiene esta matriz de bytes rellenada con el byte fill.

Si truncate es falso y size() de la matriz de bytes es mayor que width, entonces la matriz de bytes devuelta es una copia de esta matriz de bytes.

Si truncate es verdadero y size() de la matriz de bytes es mayor que width, entonces cualquier byte en una copia de la matriz de bytes después de la posición width es eliminado, y la copia es devuelta.

Ejemplo:

QByteArray x("apple");
QByteArray y = x.leftJustified(8, '.');   // y == "apple..."

Véase también rightJustified().

[constexpr noexcept] qsizetype QByteArray::length() const

Igual que size().

Devuelve el número máximo de elementos que teóricamente puede contener la matriz de bytes. En la práctica, el número puede ser mucho menor, limitado por la cantidad de memoria disponible en el sistema.

Estas funciones se introdujeron en Qt 6.8.

Devuelve una matriz de bytes que contiene len bytes de esta matriz de bytes, comenzando en la posición pos.

Si sabe que pos y len no pueden estar fuera de los límites, utilice sliced() en su lugar en código nuevo, porque es más rápido.

Si len es -1 (por defecto), o pos + len >= size(), devuelve una matriz de bytes que contiene todos los bytes comenzando en la posición pos hasta el final de la matriz de bytes.

Véase también first(), last(), sliced(), chopped(), chop(), truncate(), y slice().

[since 6.10] QByteArray &QByteArray::nullTerminate()

Si los datos de esta matriz de bytes no están terminados en cero, este método hará una copia profunda de los datos y los terminará en cero.

Un QByteArray está terminado en cero por defecto, sin embargo, en algunos casos (por ejemplo, cuando se utiliza fromRawData()), los datos no terminan necesariamente con un carácter \0, lo que podría ser un problema al llamar a métodos que esperan una cadena terminada en cero (por ejemplo, C API).

Esta función se introdujo en Qt 6.10.

Véase también nullTerminated(), fromRawData() y setRawData().

Devuelve una copia de esta matriz de bytes que siempre está terminada en cero. Véase nullTerminate().

Estas funciones se introdujeron en Qt 6.10.

Véase también nullTerminate(), fromRawData() y setRawData().

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

Devuelve una matriz de bytes que representa el número entero n como texto.

Devuelve una matriz de bytes que contiene una cadena que representa n, utilizando el base especificado (diez por defecto). Se admiten las bases 2 a 36, utilizando letras para los dígitos a partir de 9: A es diez, B es once, etc.

Ejemplo:

int n = 63;
QByteArray::number(n);              // returns "63"
QByteArray::number(n, 16);          // returns "3f"
QByteArray::number(n, 16).toUpper();  // returns "3F"

Véase también setNum() y toInt().

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

Véase también toLong().

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

Véase también toLongLong().

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

Véase también toULongLong().

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

Véase también toUInt().

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

Véase también toULong().

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

Devuelve una matriz de bytes que representa el número de coma flotante n como texto.

Devuelve una matriz de bytes que contiene una cadena que representa n, con un format y precision dados, con los mismos significados que para QLocale::toString(double, char, int). Por ejemplo:

QByteArray ba = QByteArray::number(12.3456, 'E', 3);
// ba == 1.235E+01

Véase también toDouble() y QLocale::FloatingPointPrecisionOption.

[since 6.4] QByteArray QByteArray::percentDecoded(char percent = '%') const &

Decodifica la codificación porcentual estilo URI/URL.

Devuelve una matriz de bytes que contiene el texto descodificado. El parámetro percent permite utilizar un carácter distinto de "%" (por ejemplo, "_" o "=") como carácter de escape.

Por ejemplo:

QByteArray encoded("Qt%20is%20great%33");
QByteArray decoded = encoded.percentDecoded(); // Set to "Qt is great!"

Esta función se introdujo en Qt 6.4.

Véase también toPercentEncoding() y QUrl::fromPercentEncoding().

[since 6.11] QByteArray QByteArray::percentDecoded(char percent = '%') &&

Esta función se introdujo en Qt 6.11.

QByteArray &QByteArray::prepend(QByteArrayView ba)

Antepone la vista de matriz de bytes ba a esta matriz de bytes y devuelve una referencia a esta matriz de bytes.

Esta operación suele ser muy rápida(tiempo constante), ya que QByteArray preasigna espacio extra al principio de los datos, por lo que puede crecer sin reasignar todo el array cada vez.

Ejemplo:

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

Es lo mismo que insert(0, ba).

Véase también append() y insert().

QByteArray &QByteArray::prepend(char ch)

Añade el byte ch a esta matriz de bytes.

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

Añade ba a esta matriz de bytes.

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

Añade la cadena '\0'-terminada str a esta matriz de bytes.

QByteArray &QByteArray::prepend(const char *str, qsizetype len)

Añade a esta matriz de bytes len bytes a partir de str. Los bytes añadidos pueden incluir '\0' bytes.

QByteArray &QByteArray::prepend(qsizetype count, char ch)

Añade count copias del byte ch a esta matriz de bytes.

void QByteArray::push_back(const QByteArray &other)

Esta función se proporciona por compatibilidad con STL. Es equivalente a append(other).

[since 6.0] void QByteArray::push_back(QByteArrayView str)

Igual que append(str).

Esta función se introdujo en Qt 6.0.

void QByteArray::push_back(char ch)

Igual que append(ch).

void QByteArray::push_back(const char *str)

Igual que append(str).

void QByteArray::push_front(const QByteArray &other)

Esta función se proporciona por compatibilidad con STL. Es equivalente a prepend(other).

[since 6.0] void QByteArray::push_front(QByteArrayView str)

Igual que prepend(str).

Esta función se introdujo en Qt 6.0.

void QByteArray::push_front(char ch)

Igual que prepend(ch).

void QByteArray::push_front(const char *str)

Igual que prepend(str).

QByteArray::reverse_iterator QByteArray::rbegin()

Devuelve un iterador inverso estilo STL que apunta al primer byte de la matriz de bytes, en orden inverso.

Véase también begin(), crbegin(), y rend().

[noexcept] QByteArray::const_reverse_iterator QByteArray::rbegin() const

QByteArray &QByteArray::remove(qsizetype pos, qsizetype len)

Elimina len bytes de la matriz, comenzando en la posición de índice pos, y devuelve una referencia a la matriz.

Si pos está fuera de rango, no ocurre nada. Si pos es válido, pero pos + len es mayor que el tamaño del array, el array se trunca en la posición pos.

Ejemplo:

QByteArray ba("Montreal");
ba.remove(1, 4);
// ba == "Meal"

La eliminación de elementos preservará la capacidad de la matriz y no reducirá la cantidad de memoria asignada. Para eliminar capacidad extra y liberar tanta memoria como sea posible, llame a squeeze() después del último cambio en el tamaño del array.

Véase también insert(), replace() y squeeze().

[since 6.5] QByteArray &QByteArray::removeAt(qsizetype pos)

Elimina el carácter en el índice pos. Si pos está fuera de los límites (es decir, pos >= size()) esta función no hace nada.

Esta función se introdujo en Qt 6.5.

Véase también remove().

[since 6.5] QByteArray &QByteArray::removeFirst()

Elimina el primer carácter de esta matriz de bytes. Si la matriz de bytes está vacía, esta función no hace nada.

Esta función se introdujo en Qt 6.5.

Véase también remove().

[since 6.1] template <typename Predicate> QByteArray &QByteArray::removeIf(Predicate pred)

Elimina de la matriz de bytes todos los bytes para los que el predicado pred devuelve verdadero. Devuelve una referencia a la matriz de bytes.

Esta función se introdujo en Qt 6.1.

Véase también remove().

[since 6.5] QByteArray &QByteArray::removeLast()

Elimina el último carácter de esta matriz de bytes. Si la matriz de bytes está vacía, esta función no hace nada.

Esta función se introdujo en Qt 6.5.

Véase también remove().

QByteArray::reverse_iterator QByteArray::rend()

Devuelve un iterador inverso estilo STL que apunta justo después del último byte de la matriz de bytes, en orden inverso.

Véase también end(), crend(), y rbegin().

[noexcept] QByteArray::const_reverse_iterator QByteArray::rend() const

QByteArray QByteArray::repeated(qsizetype times) const

Devuelve una copia de esta matriz de bytes repetida el número especificado de times.

Si times es menor que 1, se devuelve una matriz de bytes vacía.

Ejemplo:

QByteArray ba("ab");
ba.repeated(4);             // returns "abababab"

QByteArray &QByteArray::replace(qsizetype pos, qsizetype len, QByteArrayView after)

Reemplaza len bytes desde la posición de índice pos con la matriz de bytes after, y devuelve una referencia a esta matriz de bytes.

Ejemplo:

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

Véase también insert() y remove().

[since 6.0] QByteArray &QByteArray::replace(QByteArrayView before, QByteArrayView after)

Sustituye cada aparición de la matriz de bytes before por la matriz de bytes after.

Ejemplo:

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

Esta función se introdujo en Qt 6.0.

QByteArray &QByteArray::replace(char before, QByteArrayView after)

Sustituye cada aparición del byte before por la matriz de bytes after.

QByteArray &QByteArray::replace(char before, char after)

Sustituye cada aparición del byte before por el byte after.

QByteArray &QByteArray::replace(const char *before, qsizetype bsize, const char *after, qsizetype asize)

Sustituye todos los bytes de bsize que comienzan en before por los bytes de asize que comienzan en after. Dado que los tamaños de las cadenas vienen dados por bsize y asize, pueden contener bytes '\0' y no es necesario que terminen en '\0'.

QByteArray &QByteArray::replace(qsizetype pos, qsizetype len, const char *after, qsizetype alen)

Sustituye los bytes len de la posición de índice pos por bytes alen que comienzan en la posición after. Los bytes insertados pueden incluir '\0' bytes.

void QByteArray::reserve(qsizetype size)

Intenta asignar memoria para al menos size bytes.

Si conoce de antemano el tamaño que tendrá la matriz de bytes, puede llamar a esta función, y si llama a menudo a resize() es probable que obtenga un mejor rendimiento.

En caso de duda sobre cuánto espacio se necesitará, suele ser mejor utilizar un límite superior como size, o una estimación alta del tamaño más probable, si un límite superior estricto fuera mucho mayor que éste. Si size es una subestimación, el array crecerá según sea necesario una vez que se exceda el tamaño reservado, lo que puede llevar a una asignación mayor que la que tendría su mejor sobreestimación y ralentizará la operación que la desencadena.

El único propósito de esta función es proporcionar un medio para ajustar el uso de memoria de QByteArray. En general, rara vez necesitará llamar a esta función.

Véase también squeeze() y capacity().

void QByteArray::resize(qsizetype size)

Establece el tamaño de la matriz de bytes en size bytes.

Si size es mayor que el tamaño actual, la matriz de bytes se amplía para convertirse en size bytes con los bytes adicionales añadidos al final. Los nuevos bytes no se inicializan.

Si size es menor que el tamaño actual, los bytes más allá de la posición size se excluyen de la matriz de bytes.

Véase también size(), truncate() y squeeze().

[since 6.4] void QByteArray::resize(qsizetype newSize, char c)

Establece el tamaño de la matriz de bytes en newSize bytes.

Si newSize es mayor que el tamaño actual, la matriz de bytes se amplía para convertirse en newSize bytes con los bytes adicionales añadidos al final. Los nuevos bytes se inicializan a c.

Si newSize es menor que el tamaño actual, los bytes más allá de la posición newSize se excluyen de la matriz de bytes.

Esta función se introdujo en Qt 6.4.

Véase también size(), truncate(), y squeeze().

[since 6.8] void QByteArray::resizeForOverwrite(qsizetype size)

Redimensiona la matriz de bytes a size bytes. Si el tamaño de la matriz de bytes crece, los nuevos bytes no se inicializan.

El comportamiento es idéntico a resize(size).

Esta función se introdujo en Qt 6.8.

Véase también resize().

Devuelve una matriz de bytes que contiene los últimos len bytes de esta matriz de bytes.

Si sabe que len no puede estar fuera de los límites, utilice last() en su lugar en código nuevo, porque es más rápido.

Se devuelve toda la matriz de bytes si len es mayor que size().

Devuelve un QByteArray vacío si len es menor que 0.

Ver también endsWith(), last(), first(), sliced(), chopped(), chop(), truncate(), y slice().

QByteArray QByteArray::rightJustified(qsizetype width, char fill = ' ', bool truncate = false) const

Devuelve una matriz de bytes de tamaño width que contiene el byte fill seguido de esta matriz de bytes.

Si truncate es falso y el tamaño de la matriz de bytes es mayor que width, entonces la matriz de bytes devuelta es una copia de esta matriz de bytes.

Si truncate es verdadero y el tamaño de la matriz de bytes es mayor que width, entonces la matriz de bytes resultante se trunca en la posición width.

Ejemplo:

QByteArray x("apple");
QByteArray y = x.rightJustified(8, '.');    // y == "...apple"

Véase también leftJustified().

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

Representa el número entero n como texto.

Establece esta matriz de bytes en una cadena que representa n en base base (diez por defecto) y devuelve una referencia a esta matriz de bytes. Se admiten las bases 2 a 36, utilizando letras para los dígitos a partir de 9; A es diez, B es once y así sucesivamente.

Ejemplo:

QByteArray ba;
int n = 63;
ba.setNum(n);           // ba == "63"
ba.setNum(n, 16);       // ba == "3f"

Véase también number() y toInt().

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

Véase también toLong().

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

Véase también toLongLong().

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

Véase también toULongLong().

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

Véase también toShort().

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

Véase también toUInt().

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

Véase también toULong().

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

Véase también toUShort().

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

Representa el número de punto flotante n como texto.

Establece esta matriz de bytes en una cadena que representa n, con un format y precision dados (con los mismos significados que para QString::number(double, char, int)), y devuelve una referencia a esta matriz de bytes.

Véase también toDouble() y QLocale::FloatingPointPrecisionOption.

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

Representa el número de punto flotante n como texto.

Establece esta matriz de bytes en una cadena que representa n, con un format y precision dados (con los mismos significados que para QString::number(double, char, int)), y devuelve una referencia a esta matriz de bytes.

Véase también toFloat().

QByteArray &QByteArray::setRawData(const char *data, qsizetype size)

Restablece QByteArray para utilizar los primeros bytes de size de la matriz data. Los bytes no se copian. QByteArray contendrá el puntero data. El llamante garantiza que data no se borrará ni modificará mientras exista este QByteArray y cualquier copia del mismo que no haya sido modificada.

Esta función puede utilizarse en lugar de fromRawData() para reutilizar objetos QByteArray existentes y ahorrar reasignaciones de memoria.

Véase también fromRawData(), data(), constData(), nullTerminate() y nullTerminated().

void QByteArray::shrink_to_fit()

Esta función se proporciona por compatibilidad con STL. Es equivalente a squeeze().

QByteArray QByteArray::simplified() const

Devuelve una copia de esta matriz de bytes a la que se le han eliminado los caracteres de espaciado del inicio y del final, y en la que cada secuencia de caracteres de espaciado interno se sustituye por un único espacio.

Los caracteres de espaciado son aquellos para los que la función estándar de C++ isspace() devuelve true en la configuración regional de C; se trata de los caracteres ASCII tabulación '\t', avance de línea '\n', retorno de carro '\r', tabulación vertical '\v', avance de forma '\f', y espacio ' '.

Ejemplo:

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

Véase también trimmed(), QChar::SpecialCharacter, y Spacing Characters.

[constexpr noexcept] qsizetype QByteArray::size() const

Devuelve el número de bytes de esta matriz de bytes.

El último byte de la matriz de bytes está en la posición size() - 1. Además, QByteArray se asegura de que el byte en la posición size() sea siempre '\0', para que pueda usar el valor de retorno de data() y constData() como argumentos de funciones que esperan cadenas '\0'terminadas. Si el objeto QByteArray se creó a partir de un objeto raw data que no incluía el byte de terminación '\0', entonces QByteArray no lo añade automáticamente a menos que se cree una copia profunda.

Ejemplo:

QByteArray ba("Hello");
qsizetype n = ba.size();    // n == 5
ba.data()[0];               // returns 'H'
ba.data()[4];               // returns 'o'
ba.data()[5];               // returns '\0'

Véase también isEmpty() y resize().

[since 6.8] QByteArray &QByteArray::slice(qsizetype pos, qsizetype n)

Modifica esta matriz de bytes para que comience en la posición pos, extendiéndose para los bytes n, y devuelve una referencia a esta matriz de bytes.

Ejemplo:

QByteArray x = "Five pineapples"_ba;
x.slice(5);     // x == "pineapples"
x.slice(4, 3);  // x == "app"

Esta función se introdujo en Qt 6.8.

Véase también sliced(), first(), last(), chopped(), chop(), y truncate().

[since 6.8] QByteArray &QByteArray::slice(qsizetype pos)

Modifica esta matriz de bytes para que comience en la posición pos, extendiéndose hasta su final, y devuelve una referencia a esta matriz de bytes.

Esta función se introdujo en Qt 6.8.

Ver también sliced(), first(), last(), chopped(), chop(), y truncate().

Devuelve una matriz de bytes que contiene los n bytes de este objeto comenzando en la posición pos.

Ejemplo:

QByteArray x("Five pineapples");
QByteArray y = x.sliced(5, 4);     // y == "pine"
QByteArray z = x.sliced(5);        // z == "pineapples"

Estas funciones se introdujeron en Qt 6.0.

Véase también first(), last(), chopped(), chop(), truncate(), y slice().

Devuelve una matriz de bytes que contiene los bytes que comienzan en la posición pos de este objeto y se extienden hasta el final del mismo.

Estas funciones se introdujeron en Qt 6.0.

Véase también first(), last(), chopped(), chop(), truncate(), y slice().

QList<QByteArray> QByteArray::split(char sep) const

Divide la matriz de bytes en submatrices dondequiera que aparezca sep, y devuelve la lista de esas matrices. Si sep no coincide en ninguna parte de la matriz de bytes, split() devuelve una lista de un solo elemento que contiene esta matriz de bytes.

void QByteArray::squeeze()

Libera la memoria no necesaria para almacenar los datos de la matriz.

El único propósito de esta función es proporcionar un medio para ajustar el uso de memoria de QByteArray. En general, rara vez necesitará llamar a esta función.

Véase también reserve() y capacity().

[since 6.0] bool QByteArray::startsWith(QByteArrayView bv) const

Devuelve true si esta matriz de bytes comienza con la secuencia de bytes vista por bv; en caso contrario devuelve false.

Ejemplo:

QByteArray url("ftp://ftp.qt-project.org/");
if (url.startsWith("ftp:"))
    {/*...*/}

Esta función se introdujo en Qt 6.0.

Véase también endsWith() y first().

bool QByteArray::startsWith(char ch) const

Devuelve true si esta matriz de bytes comienza con el byte ch; en caso contrario devuelve false.

[noexcept] void QByteArray::swap(QByteArray &other)

Intercambia esta matriz de bytes con other. Esta operación es muy rápida y nunca falla.

QByteArray QByteArray::toBase64(QByteArray::Base64Options options = Base64Encoding) const

Devuelve una copia de la matriz de bytes, codificada utilizando las opciones options.

QByteArray text("Qt is great!");
text.toBase64();        // returns "UXQgaXMgZ3JlYXQh"

QByteArray hello("<p>Hello?</p>");
hello.toBase64(QByteArray::Base64Encoding | QByteArray::OmitTrailingEquals);      // returns "PHA+SGVsbG8/PC9wPg"
hello.toBase64(QByteArray::Base64Encoding);                                       // returns "PHA+SGVsbG8/PC9wPg=="
hello.toBase64(QByteArray::Base64UrlEncoding);                                    // returns "PHA-SGVsbG8_PC9wPg=="
hello.toBase64(QByteArray::Base64UrlEncoding | QByteArray::OmitTrailingEquals);   // returns "PHA-SGVsbG8_PC9wPg"

El algoritmo utilizado para codificar datos en Base64 se define en RFC 4648.

Véase también fromBase64().

CFDataRef QByteArray::toCFData() const

Crea un CFData a partir de QByteArray.

La persona que llama posee el objeto CFData y es responsable de liberarlo.

Véase también toRawCFData(), fromCFData(), fromRawCFData() y fromRawData().

double QByteArray::toDouble(bool *ok = nullptr) const

Devuelve la matriz de bytes convertida a un valor double.

Devuelve un infinito si la conversión se desborda o 0.0 si la conversión falla por otras razones (por ejemplo, desbordamiento por defecto).

Si ok no es nullptr, el fallo se notifica estableciendo *ok en false, y el éxito estableciendo *ok en true.

QByteArray string("1234.56");
bool ok;
double a = string.toDouble(&ok);   // a == 1234.56, ok == true

string = "1234.56 Volt";
a = string.toDouble(&ok);             // a == 0, ok == false

Esta función ignora los espacios en blanco iniciales y finales.

Véase también number().

[since 6.5] emscripten::val QByteArray::toEcmaUint8Array()

Crea un Uint8Array a partir de un QByteArray.

Esta función transfiere datos de la memoria heap propiedad de un QByteArray a un búfer de datos JavaScript. La función asigna y copia en un ArrayBuffer, y devuelve una vista Uint8Array a ese buffer.

Los objetos JavaScript poseen una copia de los datos, y este QByteArray puede ser borrado con seguridad después de que la copia haya sido realizada.

QByteArray byteArray = "test";
emscripten::val uint8array = byteArray.toEcmaUint8Array();

Esta función se introdujo en Qt 6.5.

Véase también fromEcmaUint8Array().

float QByteArray::toFloat(bool *ok = nullptr) const

Devuelve la matriz de bytes convertida a un valor float.

Devuelve un infinito si la conversión se desborda o 0.0 si la conversión falla por otras razones (por ejemplo, desbordamiento por defecto).

Si ok no es nullptr, el fallo se notifica estableciendo *ok en false, y el éxito estableciendo *ok en true.

QByteArray string("1234.56");
bool ok;
float a = string.toFloat(&ok);    // a == 1234.56, ok == true

string = "1234.56 Volt";
a = string.toFloat(&ok);              // a == 0, ok == false

Esta función ignora los espacios en blanco iniciales y finales.

Véase también number().

QByteArray QByteArray::toHex(char separator = '\0') const

Devuelve una copia codificada hexadecimal de la matriz de bytes.

La codificación hexadecimal utiliza los números 0-9 y las letras a-f.

Si separator no es '\0', se inserta el carácter separador entre los bytes hexadecimales.

Ejemplo:

QByteArray macAddress = QByteArray::fromHex("123456abcdef");
macAddress.toHex(':'); // returns "12:34:56:ab:cd:ef"
macAddress.toHex(0);   // returns "123456abcdef"

Véase también fromHex().

int QByteArray::toInt(bool *ok = nullptr, int base = 10) const

Devuelve la matriz de bytes convertida a int utilizando la base base, que es diez por defecto. Se admiten las bases 0 y 2 hasta 36, utilizando letras para los dígitos más allá de 9; A es diez, B es once y así sucesivamente.

Si base es 0, la base se determina automáticamente utilizando las siguientes reglas: Si la matriz de bytes empieza por "0x", se asume que es hexadecimal (base 16); en caso contrario, si empieza por "0b", se asume que es binaria (base 2); en caso contrario, si empieza por "0", se asume que es octal (base 8); en caso contrario, se asume que es decimal.

Devuelve 0 si la conversión falla.

Si ok no es nullptr, se informa del fallo estableciendo *ok en false, y del éxito estableciendo *ok en 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

Véase también number().

long QByteArray::toLong(bool *ok = nullptr, int base = 10) const

Devuelve la matriz de bytes convertida a un int long utilizando la base base, que es diez por defecto. Se admiten las bases 0 y 2 hasta 36, utilizando letras para los dígitos más allá de 9; A es diez, B es once y así sucesivamente.

Si base es 0, la base se determina automáticamente utilizando las siguientes reglas: Si la matriz de bytes empieza por "0x", se asume que es hexadecimal (base 16); en caso contrario, si empieza por "0b", se asume que es binaria (base 2); en caso contrario, si empieza por "0", se asume que es octal (base 8); en caso contrario, se asume que es decimal.

Devuelve 0 si la conversión falla.

Si ok no es nullptr, se informa del fallo estableciendo *ok en false, y del éxito estableciendo *ok en 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

Véase también number().

qlonglong QByteArray::toLongLong(bool *ok = nullptr, int base = 10) const

Devuelve la matriz de bytes convertida a long long utilizando la base base, que es diez por defecto. Se admiten las bases 0 y 2 hasta 36, utilizando letras para los dígitos más allá de 9; A es diez, B es once y así sucesivamente.

Si base es 0, la base se determina automáticamente utilizando las siguientes reglas: Si la matriz de bytes empieza por "0x", se asume que es hexadecimal (base 16); en caso contrario, si empieza por "0b", se asume que es binaria (base 2); en caso contrario, si empieza por "0", se asume que es octal (base 8); en caso contrario, se asume que es decimal.

Devuelve 0 si la conversión falla.

Si ok no es nullptr, se informa del fallo estableciendo *ok en false, y del éxito estableciendo *ok en true.

Véase también number().

QByteArray QByteArray::toLower() const

Devuelve una copia de la matriz de bytes en la que cada letra ASCII mayúscula convertida a minúscula.

Ejemplo:

QByteArray x("Qt by THE QT COMPANY");
QByteArray y = x.toLower();
// y == "qt by the qt company"

Véase también isLower(), toUpper(), y Character Case.

NSData *QByteArray::toNSData() const

Crea un NSData a partir de QByteArray.

El objeto NSData se libera automáticamente.

Véase también fromNSData(), fromRawNSData(), fromRawData() y toRawNSData().

QByteArray QByteArray::toPercentEncoding(const QByteArray &exclude = QByteArray(), const QByteArray &include = QByteArray(), char percent = '%') const

Devuelve una copia codificada en porcentaje estilo URI/URL de esta matriz de bytes. El parámetro percent permite sustituir el carácter '%' predeterminado por otro.

Por defecto, esta función codificará todos los bytes que no sean uno de los siguientes:

ALFA ("a" a "z" y "A" a "Z") / DIGITO (0 a 9) / "-" / "." / "_" / "~"

Para evitar que se codifiquen los bytes, páselos a exclude. Para forzar la codificación de los bytes, páselos a include. El carácter percent siempre se codifica.

Ejemplo:

QByteArray text = "{¿una cadena de pescado?}";QByteArray ba = text.toPercentEncoding("{}", "s");qDebug("%s", ba.constData());
// imprime "{a fi%73hy %73tring%3F}"

La codificación hexadecimal utiliza los números 0-9 y las letras mayúsculas A-F.

Véase también fromPercentEncoding() y QUrl::toPercentEncoding().

CFDataRef QByteArray::toRawCFData() const

Construye un CFData que utiliza los bytes de QByteArray.

Los bytes de QByteArray no se copian.

El llamante garantiza que el QByteArray no será borrado o modificado mientras exista este objeto CFData.

Véase también toCFData(), fromRawCFData(), fromCFData() y fromRawData().

NSData *QByteArray::toRawNSData() const

Construye un NSData que utiliza los bytes de QByteArray.

Los bytes de QByteArray no se copian.

El que llama garantiza que el QByteArray no será borrado o modificado mientras exista este objeto NSData.

Véase también fromRawNSData(), fromNSData(), fromRawData() y toNSData().

short QByteArray::toShort(bool *ok = nullptr, int base = 10) const

Devuelve la matriz de bytes convertida a short utilizando la base base, que es diez por defecto. Se admiten las bases 0 y 2 hasta 36, utilizando letras para los dígitos más allá de 9; A es diez, B es once y así sucesivamente.

Si base es 0, la base se determina automáticamente utilizando las siguientes reglas: Si la matriz de bytes empieza por "0x", se asume que es hexadecimal (base 16); en caso contrario, si empieza por "0b", se asume que es binaria (base 2); en caso contrario, si empieza por "0", se asume que es octal (base 8); en caso contrario, se asume que es decimal.

Devuelve 0 si la conversión falla.

Si ok no es nullptr, se informa del fallo estableciendo *ok en false, y del éxito estableciendo *ok en true.

Véase también number().

std::string QByteArray::toStdString() const

Devuelve un objeto std::string con los datos contenidos en este QByteArray.

Este operador es útil sobre todo para pasar un QByteArray a una función que acepte un objeto std::string.

Véase también fromStdString() y QString::toStdString().

uint QByteArray::toUInt(bool *ok = nullptr, int base = 10) const

Devuelve la matriz de bytes convertida a unsigned int utilizando la base base, que es diez por defecto. Se admiten las bases 0 y 2 hasta 36, utilizando letras para los dígitos más allá de 9; A es diez, B es once y así sucesivamente.

Si base es 0, la base se determina automáticamente utilizando las siguientes reglas: Si la matriz de bytes empieza por "0x", se asume que es hexadecimal (base 16); en caso contrario, si empieza por "0b", se asume que es binaria (base 2); en caso contrario, si empieza por "0", se asume que es octal (base 8); en caso contrario, se asume que es decimal.

Devuelve 0 si la conversión falla.

Si ok no es nullptr, se informa del fallo estableciendo *ok en false, y del éxito estableciendo *ok en true.

Véase también number().

ulong QByteArray::toULong(bool *ok = nullptr, int base = 10) const

Devuelve la matriz de bytes convertida a unsigned long int utilizando la base base, que es diez por defecto. Se admiten las bases 0 y 2 hasta 36, utilizando letras para los dígitos más allá de 9; A es diez, B es once y así sucesivamente.

Si base es 0, la base se determina automáticamente utilizando las siguientes reglas: Si la matriz de bytes empieza por "0x", se asume que es hexadecimal (base 16); en caso contrario, si empieza por "0b", se asume que es binaria (base 2); en caso contrario, si empieza por "0", se asume que es octal (base 8); en caso contrario, se asume que es decimal.

Devuelve 0 si la conversión falla.

Si ok no es nullptr, se informa del fallo estableciendo *ok en false, y del éxito estableciendo *ok en true.

Véase también number().

qulonglong QByteArray::toULongLong(bool *ok = nullptr, int base = 10) const

Devuelve la matriz de bytes convertida a unsigned long long utilizando la base base, que es diez por defecto. Se admiten las bases 0 y 2 hasta 36, utilizando letras para los dígitos más allá de 9; A es diez, B es once y así sucesivamente.

Si base es 0, la base se determina automáticamente utilizando las siguientes reglas: Si la matriz de bytes empieza por "0x", se asume que es hexadecimal (base 16); en caso contrario, si empieza por "0b", se asume que es binaria (base 2); en caso contrario, si empieza por "0", se asume que es octal (base 8); en caso contrario, se asume que es decimal.

Devuelve 0 si la conversión falla.

Si ok no es nullptr, se informa del fallo estableciendo *ok en false, y del éxito estableciendo *ok en true.

Véase también number().

ushort QByteArray::toUShort(bool *ok = nullptr, int base = 10) const

Devuelve la matriz de bytes convertida a unsigned short utilizando la base base, que es diez por defecto. Se admiten las bases 0 y 2 hasta 36, utilizando letras para los dígitos más allá de 9; A es diez, B es once y así sucesivamente.

Si base es 0, la base se determina automáticamente utilizando las siguientes reglas: Si la matriz de bytes empieza por "0x", se asume que es hexadecimal (base 16); en caso contrario, si empieza por "0b", se asume que es binaria (base 2); en caso contrario, si empieza por "0", se asume que es octal (base 8); en caso contrario, se asume que es decimal.

Devuelve 0 si la conversión falla.

Si ok no es nullptr, se informa del fallo estableciendo *ok en false, y del éxito estableciendo *ok en true.

Véase también number().

QByteArray QByteArray::toUpper() const

Devuelve una copia de la matriz de bytes en la que cada letra ASCII minúscula convertida a mayúscula.

Ejemplo:

QByteArray x("Qt by THE QT COMPANY");
QByteArray y = x.toUpper();
// y == "QT BY THE QT COMPANY"

Véase también isUpper(), toLower(), y Character Case.

QByteArray QByteArray::trimmed() const

Devuelve una copia de esta matriz de bytes con los caracteres de espaciado eliminados del inicio y del final.

Los caracteres de espaciado son aquellos para los que la función estándar de C++ isspace() devuelve true en la configuración regional de C; se trata de los caracteres ASCII tabulación '\t', avance de línea '\n', retorno de carro '\r', tabulación vertical '\v', avance de forma '\f', y espacio ' '.

Ejemplo:

QByteArray ba("  lots\t of\nwhitespace\r\n ");
ba = ba.trimmed();
// ba == "lots\t of\nwhitespace";

A diferencia de simplified(), trimmed() no modifica el espaciado interno.

Véase también simplified(), QChar::SpecialCharacter, y Spacing Characters.

void QByteArray::truncate(qsizetype pos)

Trunca la matriz de bytes en la posición de índice pos.

Si pos está más allá del final de la matriz, no ocurre nada.

Ejemplo:

QByteArray ba("Stockholm");
ba.truncate(5);             // ba == "Stock"

Véase también chop(), resize(), y first().

Devuelve un puntero a los datos almacenados en la matriz de bytes. El puntero puede utilizarse para acceder a los bytes que componen la matriz. Los datos se '\0'-terminan.

El puntero seguirá siendo válido mientras no se produzca una separación y no se modifique QByteArray.

Este operador es útil sobre todo para pasar una matriz de bytes a una función que acepte un const char *.

Puede desactivar este operador definiendo QT_NO_CAST_FROM_BYTEARRAY cuando compile sus aplicaciones.

Nota: Un QByteArray puede almacenar cualquier valor de byte incluyendo '\0's, pero la mayoría de las funciones que toman argumentos char * asumen que los datos terminan en el primer '\0' que encuentran.

Véase también constData().

[noexcept, since 6.10] QByteArray::operator std::string_view() const

Convierte este objeto QByteArray en un objeto std::string_view. La vista de cadena devuelta abarcará la totalidad de la matriz de bytes.

Esta función se introdujo en Qt 6.10.

QByteArray &QByteArray::operator+=(const QByteArray &ba)

Añade la matriz de bytes ba al final de esta matriz de bytes y devuelve una referencia a esta matriz de bytes.

Ejemplo:

QByteArray x("free");
QByteArray y("dom");
x += y;
// x == "freedom"

Nota: QByteArray es una clase implícitamente compartida. En consecuencia, si se añade a una matriz de bytes vacía, la matriz de bytes compartirá los datos contenidos en ba. En este caso, no se realiza ninguna copia de datos, por lo que se tarda un tiempo constante. Si se modifica una instancia compartida, se copiará (copy-on-write), tardando un tiempo lineal.

Si la matriz de bytes a la que se añade no está vacía, se realiza una copia profunda de los datos, que tarda un tiempo lineal.

Esta operación normalmente no sufre de sobrecarga de asignación, porque QByteArray preasigna espacio extra al final de los datos para que pueda crecer sin reasignar para cada operación de anexión.

Véase también append() y prepend().

QByteArray &QByteArray::operator+=(char ch)

Añade el byte ch al final de esta matriz de bytes y devuelve una referencia a esta matriz de bytes.

QByteArray &QByteArray::operator+=(const char *str)

Añade la cadena '\0'-terminada str al final de esta matriz de bytes y devuelve una referencia a esta matriz de bytes.

[noexcept] QByteArray &QByteArray::operator=(QByteArray &&other)

Mover-asigna other a esta instancia QByteArray.

[noexcept] QByteArray &QByteArray::operator=(const QByteArray &other)

Asigna other a esta matriz de bytes y devuelve una referencia a esta matriz de bytes.

QByteArray &QByteArray::operator=(const char *str)

Asigna str a esta matriz de bytes.

str se supone que apunta a una cadena terminada en cero, y su longitud se determina dinámicamente.

char &QByteArray::operator[](qsizetype i)

Devuelve el byte en la posición de índice i como una referencia modificable.

i debe ser una posición de índice válida en la matriz de bytes (es decir, 0 <= i < size()).

Ejemplo:

QByteArray ba("Hello, world");
cout << ba[0]; // prints H
ba[7] = 'W';
// ba == "Hello, World"

Véase también at().

char QByteArray::operator[](qsizetype i) const

Igual que at(i).