QByteArrayView Class
La clase QByteArrayView ofrece una vista de un matriz de bytes mediante un subconjunto de solo lectura de la API « QByteArray ». Más información...
| Encabezado: | #include <QByteArrayView> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Desde: | Qt 6.0 |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QByteArrayView forma parte de las clases compartidas implícitamente y de las clases para datos de cadena.
Nota: Todas las funciones de esta clase son reentrantes.
Comparaciones de QByteArrayView
| Categoría | Tipos comparables | Descripción |
|---|---|---|
| strong | QByteArrayView | |
| strong | QString, QStringView, QUtf8StringView, QLatin1StringView, QChar y char16_t. | Al compararlos con los tipos de cadena y de caracteres Unicode, el contenido se interpreta como UTF-8. |
Tipos públicos
| const_iterator | |
| const_pointer | |
| const_reference | |
| const_reverse_iterator | |
| difference_type | |
| iterator | |
| pointer | |
| reference | |
| reverse_iterator | |
| size_type | |
| storage_type | |
| value_type |
Funciones públicas
| QByteArrayView() | |
(since 6.9) | QByteArrayView(const Byte (&data)[]) |
| QByteArrayView(const Byte *data) | |
| QByteArrayView(const Container &c) | |
| QByteArrayView(const QByteArray &byteArray) | |
| QByteArrayView(const char (&data)[Size]) | |
| QByteArrayView(std::nullptr_t) | |
| QByteArrayView(const Byte *first, const Byte *last) | |
| QByteArrayView(const Byte *data, qsizetype len) | |
| char | at(qsizetype n) const |
| char | back() const |
| QByteArrayView::const_iterator | begin() const |
| QByteArrayView::const_iterator | cbegin() const |
| QByteArrayView::const_iterator | cend() const |
| void | chop(qsizetype length) |
| QByteArrayView | chopped(qsizetype length) const |
(since 6.2) int | compare(QByteArrayView bv, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
| QByteArrayView::const_pointer | constData() const |
| bool | contains(QByteArrayView bv) const |
| bool | contains(char ch) const |
| qsizetype | count(QByteArrayView bv) const |
| qsizetype | count(char ch) const |
| QByteArrayView::const_reverse_iterator | crbegin() const |
| QByteArrayView::const_reverse_iterator | crend() const |
| QByteArrayView::const_pointer | data() const |
| bool | empty() const |
| QByteArrayView::const_iterator | end() const |
| bool | endsWith(QByteArrayView bv) const |
| bool | endsWith(char ch) const |
| QByteArrayView | first(qsizetype n) const |
| char | front() const |
| qsizetype | indexOf(QByteArrayView bv, qsizetype from = 0) const |
| qsizetype | indexOf(char ch, qsizetype from = 0) const |
| bool | isEmpty() const |
| bool | isNull() const |
(since 6.3) bool | isValidUtf8() const |
| QByteArrayView | last(qsizetype n) const |
| qsizetype | lastIndexOf(QByteArrayView bv, qsizetype from) const |
| qsizetype | lastIndexOf(char ch, qsizetype from = -1) const |
(since 6.2) qsizetype | lastIndexOf(QByteArrayView bv) const |
| qsizetype | length() const |
(since 6.8) qsizetype | max_size() const |
| QByteArrayView::const_reverse_iterator | rbegin() const |
| QByteArrayView::const_reverse_iterator | rend() const |
| qsizetype | size() const |
(since 6.8) QByteArrayView & | slice(qsizetype pos, qsizetype n) |
(since 6.8) QByteArrayView & | slice(qsizetype pos) |
| QByteArrayView | sliced(qsizetype pos) const |
| QByteArrayView | sliced(qsizetype pos, qsizetype n) const |
| bool | startsWith(QByteArrayView bv) const |
| bool | startsWith(char ch) const |
| QByteArray | toByteArray() const |
(since 6.3) double | toDouble(bool *ok = nullptr) const |
(since 6.3) float | toFloat(bool *ok = nullptr) const |
(since 6.3) int | toInt(bool *ok = nullptr, int base = 10) const |
(since 6.3) long | toLong(bool *ok = nullptr, int base = 10) const |
(since 6.3) qlonglong | toLongLong(bool *ok = nullptr, int base = 10) const |
(since 6.3) short | toShort(bool *ok = nullptr, int base = 10) const |
(since 6.3) uint | toUInt(bool *ok = nullptr, int base = 10) const |
(since 6.3) ulong | toULong(bool *ok = nullptr, int base = 10) const |
(since 6.3) qulonglong | toULongLong(bool *ok = nullptr, int base = 10) const |
(since 6.3) ushort | toUShort(bool *ok = nullptr, int base = 10) const |
(since 6.3) QByteArrayView | trimmed() const |
| void | truncate(qsizetype length) |
(since 6.7) | operator std::string_view() const |
| char | operator[](qsizetype n) const |
Miembros públicos estáticos
Elementos no miembros relacionados
| bool | operator!=(const QByteArrayView &lhs, const QByteArrayView &rhs) |
| bool | operator<(const QByteArrayView &lhs, const QByteArrayView &rhs) |
| bool | operator<=(const QByteArrayView &lhs, const QByteArrayView &rhs) |
| bool | operator==(const QByteArrayView &lhs, const QByteArrayView &rhs) |
| bool | operator>(const QByteArrayView &lhs, const QByteArrayView &rhs) |
| bool | operator>=(const QByteArrayView &lhs, const QByteArrayView &rhs) |
Descripción detallada
Un QByteArrayView hace referencia a una porción contigua de bytes sin procesar de la que no es propietario. Actúa como un tipo de interfaz para todo tipo de datos similares a matrices de bytes, sin necesidad de construir primero un ` QByteArray `.
Los datos de la matriz de bytes pueden representarse como una matriz (o una estructura de datos compatible con matrices, como ` QByteArray`, `std::basic_string`, etc.) de ` char`, ` signed char`, ` unsigned char ` o ` std::byte`.
QByteArrayView está diseñado como un tipo de interfaz; su principal caso de uso es como tipo de parámetro de función. Cuando se utilizan QByteArrayViews como variables automáticas o miembros de datos, hay que asegurarse de que los datos a los que se hace referencia (por ejemplo, los que pertenecen a un ` QByteArray`) perduren más que el QByteArrayView en todas las rutas de código, para evitar que la vista de la matriz de bytes acabe haciendo referencia a datos eliminados.
Cuando se utiliza como tipo de interfaz, QByteArrayView permite que una sola función acepte una amplia variedad de fuentes de datos similares a matrices de bytes. Así, una función que acepte QByteArrayView sustituye a varias sobrecargas de función (que aceptan, por ejemplo, QByteArray, const char *, etc.), al tiempo que permite pasar a la función un número aún mayor de fuentes de datos en forma de matriz de bytes.
QByteArrayView debe pasarse por valor, no por referencia a const:
void myfun1(QByteArrayView bv); // preferred
void myfun2(const QByteArrayView &bv); // compiles and works, but slowerSi quieres ofrecer a tus usuarios la máxima libertad a la hora de elegir qué tipo de datos pueden pasar a tu función, acompaña la sobrecarga de `QByteArrayView` con sobrecargas para
- char: esta sobrecarga puede delegar en la versión de QByteArrayView:
void fun(QByteArrayView bv); void fun(char ch) { fun(QByteArrayView(&ch, 1)); }aunque, por razones técnicas, QByteArrayView no pueda proporcionar por sí misma un constructor de tipo char.
- QByteArray: si almacenas una copia sin modificar de la matriz de bytes y, por lo tanto, deseas aprovechar el uso compartido implícito de QByteArray.
QByteArrayView también se puede utilizar como valor de retorno de una función. Si llamas a una función que devuelve un `QByteArrayView`, presta especial atención a no mantener el `QByteArrayView` más tiempo del que la función promete mantener activos los datos a los que hace referencia. En caso de duda, obtén una referencia fuerte a los datos llamando a ` toByteArray()` para convertir el `QByteArrayView` en un ` QByteArray`.
Los métodos admitidos por `QByteArrayView` son los mismos que los de ` QByteArray`. En concreto, en la medida limitada en que atribuye semántica (como mayúsculas y minúsculas, espacios y dígitos de los números) a los datos de caracteres visualizados, utiliza la configuración regional de C y la codificación ASCII. Consulte ` C locale and ASCII functions ` para obtener más detalles y conocer las limitaciones de estos métodos.
Tipos de bytes compatibles
QByteArrayView se puede crear a partir de cualquier contenedor de bytes, siempre que el tipo de byte sea uno de los siguientes:
char(tanto con signo como sin signo)std::byte
Véase también QByteArray y QStringView.
Documentación sobre los tipos de miembros
QByteArrayView::const_iterator
Este `typedef` proporciona un iterador `const` al estilo STL para ` QByteArrayView`.
Véase también iterator y const_reverse_iterator.
QByteArrayView::const_pointer
Alias de value_type *. Se proporciona para garantizar la compatibilidad con la STL.
QByteArrayView::const_reference
Alias de ` value_type &`. Se proporciona para garantizar la compatibilidad con la STL.
QByteArrayView::const_reverse_iterator
Este `typedef` proporciona un iterador inverso constante al estilo STL para ` QByteArrayView`.
Véase también reverse_iterator y const_iterator.
QByteArrayView::difference_type
Alias de ` std::ptrdiff_t`. Se proporciona para garantizar la compatibilidad con la STL.
QByteArrayView::iterator
Este `typedef` proporciona un iterador `const` al estilo de la STL para ` QByteArrayView`.
QByteArrayView No admite iteradores mutables, por lo que es equivalente a const_iterator.
Véase también const_iterator y reverse_iterator.
QByteArrayView::pointer
Alias de value_type *. Se proporciona para garantizar la compatibilidad con la STL.
QByteArrayView No admite punteros mutables, por lo que es equivalente a ` const_pointer`.
QByteArrayView::reference
Alias de value_type &. Se proporciona para garantizar la compatibilidad con la STL.
QByteArrayView No admite referencias mutables, por lo que es equivalente a ` const_reference`.
QByteArrayView::reverse_iterator
Este `typedef` proporciona un iterador inverso constante al estilo de la STL para ` QByteArrayView`.
QByteArrayView No admite iteradores inversos mutables, por lo que es equivalente a const_reverse_iterator.
Véase también const_reverse_iterator y iterator.
QByteArrayView::size_type
Alias de «qsizetype». Se proporciona para garantizar la compatibilidad con la STL.
QByteArrayView::storage_type
Alias de char.
QByteArrayView::value_type
Alias de ` const char`. Se proporciona para garantizar la compatibilidad con la STL.
Documentación de las funciones miembro
[constexpr noexcept default] QByteArrayView::QByteArrayView()
Crea una vista de matriz de bytes nulos.
Véase también ` isNull()`.
[constexpr noexcept, since 6.9] template <typename Byte> requires if_compatible_byte<Byte> QByteArrayView::QByteArrayView(const Byte (&data)[])
Crea una vista de matriz de bytes sobre ` data`, una matriz de tamaño desconocido. La longitud se determina buscando el primer ` Byte(0)`.
data debe seguir siendo válida durante toda la vida útil de este objeto de vista de matriz de bytes.
Restricciones
Participa en la resolución de sobrecargas solo si ` Byte ` es un tipo de byte compatible.
Esta función se introdujo en Qt 6.9.
Véase también Compatible Byte Types.
[constexpr noexcept] template <typename Byte> QByteArrayView::QByteArrayView(const Byte *data)
Crea una vista de matriz de bytes sobre data. La longitud se determina buscando el primer Byte(0).
data debe seguir siendo válido durante toda la vida útil de este objeto de vista de matriz de bytes.
Pasar nullptr como data es seguro y da como resultado una vista de matriz de bytes nula.
Restricciones
Participa en la resolución de sobrecargas solo si data no es una matriz y Byte es un tipo de byte compatible.
Véase también ` Compatible Byte Types`.
[constexpr noexcept] template <typename Container> requires if_compatible_container<Container> QByteArrayView::QByteArrayView(const Container &c)
Crea una vista de matriz de bytes sobre el contenedor de tipo matriz c. La longitud y los datos se establecen mediante std::size(c) y std::data(c), respectivamente.
Los datos del contenedor deben seguir siendo válidos durante toda la vida útil de este objeto de vista de matriz de bytes.
Restricciones
Participa en la resolución de sobrecargas únicamente si c es cualquier contenedor contiguo con elementos de un tipo de byte compatible.
Véase también Compatible Byte Types.
[noexcept] QByteArrayView::QByteArrayView(const QByteArray &byteArray)
Crea una vista de matriz de bytes en byteArray.
byteArray.data() debe seguir siendo válido durante toda la vida útil de este objeto de vista de matriz de bytes.
La vista de matriz de bytes será nula si y solo si byteArray.isNull().
[constexpr noexcept] template <size_t Size> QByteArrayView::QByteArrayView(const char (&data)[Size])
Crea una vista de matriz de bytes sobre la matriz de caracteres data. La vista abarca la matriz hasta que se encuentra el primer '\0' o Size, lo que ocurra primero. Si necesitas la matriz completa, utiliza en su lugar fromArray().
data debe seguir siendo válido durante toda la vida útil de este objeto de vista de matriz de bytes.
Nota: Este constructor solo está disponible para literales de matriz de caracteres. El motivo es la compatibilidad con las bibliotecas C que predefinen matrices «suficientemente grandes», pero solo utilizan parte del espacio preasignado. Para admitir esto de forma intuitiva en una sobrecarga implícita del constructor, debemos detenernos en el primer char(0). Esto es lógico para una matriz de caracteres (char), pero no para una matriz de enteros ( std::byte ). Sin embargo, es inconsistente con los constructores correspondientes de puntero (Byte*) y de matriz de longitud desconocida (Byte[]), por lo que podría cambiar en una futura versión de Qt.
Véase también fromArray.
[constexpr noexcept] QByteArrayView::QByteArrayView(std::nullptr_t)
Crea una vista de matriz de bytes nulos.
Véase también isNull().
[constexpr] template <typename Byte> requires if_compatible_byte<Byte> QByteArrayView::QByteArrayView(const Byte *first, const Byte *last)
Crea una vista de matriz de bytes en first con la longitud (last - first).
El rango [first,last) debe seguir siendo válido durante toda la vida útil de este QByteArrayView.
Pasar \nullptr como first es seguro si last también es nullptr, y da como resultado una vista de matriz de bytes nula.
El comportamiento es indefinido si last precede a first, o si first es nullptr y last no lo es.
Restricciones
Participa en la resolución de sobrecargas solo si Byte es un tipo de byte compatible.
Véase también Compatible Byte Types.
[constexpr] template <typename Byte> requires if_compatible_byte<Byte> QByteArrayView::QByteArrayView(const Byte *data, qsizetype len)
Crea una vista de matriz de bytes en data con una longitud de len.
El rango [data,len) debe seguir siendo válido durante todo el tiempo de vida de este QByteArrayView.
Pasar ` nullptr ` como ` data ` es seguro si ` len ` también es 0, y da como resultado una vista de matriz de bytes nula.
El comportamiento es indefinido si len es negativo o, cuando es positivo, si data es nullptr.
Restricciones
Participa en la resolución de sobrecarga solo si ` Byte ` es un tipo de byte compatible.
Véase también ` Compatible Byte Types`.
[constexpr] char QByteArrayView::at(qsizetype n) const
Devuelve el carácter situado en la posición n en esta vista de matriz de bytes.
El comportamiento es indefinido si n es negativo o no es menor que size().
Véase también operator[](), front() y back().
[constexpr] char QByteArrayView::back() const
Devuelve el último byte de la vista de la matriz de bytes.
Esta función se proporciona para garantizar la compatibilidad con STL.
Advertencia: llamar a esta función sobre una vista de matriz de bytes vacía da lugar a un comportamiento indefinido.
Véase también ` front()`.
[constexpr noexcept] QByteArrayView::const_iterator QByteArrayView::begin() const
Devuelve un iterador const al estilo STL que apunta al primer byte de la vista de la matriz de bytes.
Esta función se proporciona para garantizar la compatibilidad con la STL.
Véanse también end(), cbegin(), rbegin() y data().
[constexpr noexcept] QByteArrayView::const_iterator QByteArrayView::cbegin() const
Es igual que ` begin()`.
Esta función se proporciona para garantizar la compatibilidad con la STL.
Véanse también cend(), begin(), crbegin() y data().
[constexpr noexcept] QByteArrayView::const_iterator QByteArrayView::cend() const
Es igual que « end()».
Esta función se proporciona para garantizar la compatibilidad con STL.
Véanse también cbegin(), end() y crend().
[constexpr] void QByteArrayView::chop(qsizetype length)
Trunca esta vista de matriz de bytes en length caracteres.
Es lo mismo que « *this = first(size() - length) ».
Nota: El comportamiento es indefinido cuando ` length < 0` o ` length > size().
Véase también sliced(), first(), last(), chopped(), truncate() y slice().
[constexpr] QByteArrayView QByteArrayView::chopped(qsizetype length) const
Devuelve una copia de esta vista de matriz de bytes que omite sus últimos length bytes. En otras palabras, devuelve una vista de matriz de bytes de longitud size() - length a partir del principio de este objeto.
Es lo mismo que first(size() - length).
Nota: El comportamiento es indefinido cuando length < 0 o length > size().
Véase también first(), last(), sliced(), chop(), truncate() y slice().
[noexcept, since 6.2] int QByteArrayView::compare(QByteArrayView bv, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Devuelve un número entero menor, igual o mayor que cero, dependiendo de si este QByteArrayView se ordena antes, en la misma posición o después de QByteArrayView bv . La comparación se realiza teniendo en cuenta las mayúsculas y minúsculas cs.
Esta función se introdujo en Qt 6.2.
Véase también operator==().
[constexpr noexcept] QByteArrayView::const_pointer QByteArrayView::constData() const
Devuelve un puntero const de tipo ` char ` al primer byte de la vista de matriz de bytes.
Nota: No se garantiza quela matriz de caracteres representada por el valor de retorno esté terminada en nulo. El puntero devuelto solo es seguro para acceder a bytes en índices menores que el valor devuelto por la función ` size()` de esta vista de matriz de bytes.
Véase también ` data()`, ` begin()` y ` end()`.
[noexcept] bool QByteArrayView::contains(QByteArrayView bv) const
[noexcept] bool QByteArrayView::contains(char ch) const
Devuelve « true » si esta vista de matriz de bytes contiene una aparición de la secuencia de bytes vista por « bv » o del carácter « ch », respectivamente; en caso contrario, devuelve « false ».
Véase también indexOf() y lastIndexOf().
[noexcept] qsizetype QByteArrayView::count(QByteArrayView bv) const
Devuelve el número de apariciones (que pueden solaparse) de la secuencia de bytes analizada por « bv » en esta vista de matriz de bytes.
Véase también contains() y indexOf().
[noexcept] qsizetype QByteArrayView::count(char ch) const
Devuelve el número de veces que aparece el byte ch en esta vista de matriz de bytes.
Esta es una función sobrecargada.
Véanse también « contains()» y « indexOf()».
[constexpr noexcept] QByteArrayView::const_reverse_iterator QByteArrayView::crbegin() const
Es igual que « rbegin()».
Esta función se proporciona para garantizar la compatibilidad con STL.
Véase también crend(), rbegin() y cbegin().
[constexpr noexcept] QByteArrayView::const_reverse_iterator QByteArrayView::crend() const
Es igual que rend().
Esta función se proporciona para garantizar la compatibilidad con STL.
Véanse también crbegin(), rend() y cend().
[constexpr noexcept] QByteArrayView::const_pointer QByteArrayView::data() const
Devuelve un puntero const char al primer byte de la vista de matriz de bytes.
Nota: No se garantiza quela matriz de caracteres representada por el valor devuelto termine en nulo. El puntero devuelto solo es seguro para acceder a bytes en índices menores que el valor devuelto por la función ` size()` de esta vista de matriz de bytes.
Véanse también ` begin()` y ` end()`.
[constexpr noexcept] bool QByteArrayView::empty() const
Devuelve ` true ` si esta vista de matriz de bytes está vacía; es decir, ` size() == 0`.
Esta función se proporciona por motivos de compatibilidad con la STL.
Véanse también isEmpty(), isNull() y size().
[constexpr noexcept] QByteArrayView::const_iterator QByteArrayView::end() const
Devuelve un iterador const al estilo STL que apunta justo después del último byte de la vista de la matriz de bytes.
Esta función se proporciona para garantizar la compatibilidad con la STL.
Véase también begin(), cend() y rend().
[noexcept] bool QByteArrayView::endsWith(QByteArrayView bv) const
[constexpr noexcept] bool QByteArrayView::endsWith(char ch) const
Devuelve ` true ` si esta vista de matriz de bytes termina con una vista de matriz de bytes ` bv ` o con un carácter ` ch`, respectivamente; en caso contrario, devuelve ` false`.
Véase también startsWith().
[constexpr] QByteArrayView QByteArrayView::first(qsizetype n) const
Devuelve una vista de matriz de bytes que apunta a los primeros n bytes de esta vista de matriz de bytes. Equivalente a sliced(0, n).
Nota: El comportamiento es indefinido cuando n < 0 o n > size().
Véase también last(), startsWith(), chopped(), chop(), truncate(), sliced() y slice().
[static constexpr noexcept] template <typename Byte, size_t Size> QByteArrayView QByteArrayView::fromArray(const Byte (&data)[Size])
Crea una vista de matriz de bytes sobre el literal de matriz data de Size bytes. La vista abarca toda la matriz. Esto incluye el terminador nulo final de los literales de matriz char. Si no deseas que el terminador nulo se incluya en la vista, puedes eliminarlo con chop() cuando estés seguro de que se encuentra al final. Como alternativa, puedes utilizar la sobrecarga del constructor que toma un literal de matriz de caracteres, lo que creará una vista hasta el primer terminador nulo de los datos, sin incluirlo.
Esta función funcionará con cualquier literal de matriz de un tipo de byte compatible.
Véase también Compatible Byte Types y QByteArrayView.
[constexpr] char QByteArrayView::front() const
Devuelve el primer byte de la vista de matriz de bytes.
Esta función se proporciona para garantizar la compatibilidad con STL.
Advertencia: llamar a esta función sobre una vista de matriz de bytes vacía da lugar a un comportamiento indefinido.
Véase también ` back()`.
[noexcept] qsizetype QByteArrayView::indexOf(QByteArrayView bv, qsizetype from = 0) const
[noexcept] qsizetype QByteArrayView::indexOf(char ch, qsizetype from = 0) const
Devuelve la posición de índice del inicio de la primera aparición de la secuencia de bytes a la que da acceso bv o de la primera aparición del byte ch, respectivamente, en esta vista de matriz de bytes, buscando hacia adelante a partir de la posición de índice from.Returns -1 si no se encuentra ninguna coincidencia.
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.
Véanse también lastIndexOf() y contains().
[constexpr noexcept] bool QByteArrayView::isEmpty() const
Devuelve ` true ` si esta vista de matriz de bytes está vacía, es decir, ` size() == 0`.
Véanse también empty(), isNull() y size().
[constexpr noexcept] bool QByteArrayView::isNull() const
Devuelve ` true ` si esta vista de matriz de bytes es nula; es decir, ` data() == nullptr`.
Véase también empty(), isEmpty() y size().
[noexcept, since 6.3] bool QByteArrayView::isValidUtf8() const
Devuelve ` true ` si esta vista de matriz de bytes contiene datos válidos codificados en UTF-8; en caso contrario, devuelve ` false `.
Esta función se introdujo en Qt 6.3.
[constexpr] QByteArrayView QByteArrayView::last(qsizetype n) const
Devuelve una vista de matriz de bytes que apunta a los últimos n bytes de esta vista de matriz de bytes.
Nota: El comportamiento es indefinido cuando n < 0 o n > size().
Véase también first(), endsWith(), chopped(), chop(), truncate(), sliced() y slice().
[noexcept] qsizetype QByteArrayView::lastIndexOf(QByteArrayView bv, qsizetype from) const
[noexcept] qsizetype QByteArrayView::lastIndexOf(char ch, qsizetype from = -1) const
Devuelve la posición en el índice del inicio de la última aparición de la secuencia de bytes vista por ` bv ` o de la última aparición de ` ch`, respectivamente, en esta vista de la matriz de bytes, buscando hacia atrás a partir de la posición en el í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.
Nota: Al buscar un ` bv` de longitud 0, la coincidencia al final de los datos queda excluida de la búsqueda por un ` from` negativo, aunque normalmente se considere que ` -1 ` busca desde el final de la vista: la coincidencia al final está después del último carácter, por lo que queda excluida. Para incluir dicha coincidencia vacía final, se debe proporcionar un valor positivo para from u omitir por completo el parámetro from.
Véase también indexOf() y contains().
[noexcept, since 6.2] qsizetype QByteArrayView::lastIndexOf(QByteArrayView bv) const
Devuelve la posición en el índice del inicio de la última aparición de la secuencia de bytes analizada por ` bv ` en esta vista de matriz de bytes, buscando hacia atrás desde el final de dicha vista. Devuelve -1 si no se encuentra ninguna coincidencia.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.2.
Véase también ` indexOf()` y ` contains()`.
[constexpr noexcept] qsizetype QByteArrayView::length() const
Igual que size().
Véanse también empty(), isEmpty(), isNull() y size().
[static constexpr noexcept, since 6.8] qsizetype QByteArrayView::maxSize()
Devuelve el número máximo de elementos que la vista puede representar teóricamente. En la práctica, este número puede ser mucho menor, ya que está limitado por la cantidad de memoria disponible en el sistema.
Esta función se introdujo en Qt 6.8.
[constexpr noexcept, since 6.8] qsizetype QByteArrayView::max_size() const
Esta función se proporciona para garantizar la compatibilidad con la STL.
Devuelve maxSize().
Esta función se introdujo en Qt 6.8.
[constexpr noexcept] QByteArrayView::const_reverse_iterator QByteArrayView::rbegin() const
Devuelve un iterador inverso constante al estilo STL que apunta al primer byte de la vista de matriz de bytes, en orden inverso.
Esta función se proporciona para garantizar la compatibilidad con la STL.
Véanse también rend(), crbegin() y begin().
[constexpr noexcept] QByteArrayView::const_reverse_iterator QByteArrayView::rend() const
Devuelve un iterador inverso al estilo STL que apunta al byte situado justo después del último byte de la vista de la matriz de bytes, en orden inverso.
Esta función se proporciona para garantizar la compatibilidad con la STL.
Véanse también rbegin(), crend() y end().
[constexpr noexcept] qsizetype QByteArrayView::size() const
Devuelve el número de bytes de esta vista de matriz de bytes.
Véase también empty(), isEmpty() y isNull().
[constexpr, since 6.8] QByteArrayView &QByteArrayView::slice(qsizetype pos, qsizetype n)
Modifica esta vista de matriz de bytes para que comience en la posición pos y se extienda a lo largo de n bytes.
Nota: El comportamiento es indefinido cuando pos < 0, n < 0 o pos + n > size().
Esta función se introdujo en Qt 6.8.
Véase también sliced(), first(), last(), chopped(), chop() y truncate().
[constexpr, since 6.8] QByteArrayView &QByteArrayView::slice(qsizetype pos)
Modifica esta vista de matriz de bytes para que comience en la posición pos y se extienda hasta su final.
Nota: El comportamiento es indefinido cuando pos < 0 o pos > size().
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.8.
Véase también sliced(), first(), last(), chopped(), chop() y truncate().
[constexpr] QByteArrayView QByteArrayView::sliced(qsizetype pos) const
Devuelve una vista de matriz de bytes que comienza en la posición pos de este objeto y se extiende hasta su final.
Nota: El comportamiento es indefinido cuando pos < 0 o pos > size().
Véase también first(), last(), chopped(), chop(), truncate() y slice().
[constexpr] QByteArrayView QByteArrayView::sliced(qsizetype pos, qsizetype n) const
Devuelve una vista de matriz de bytes que apunta a n bytes de esta vista de matriz de bytes, a partir de la posición pos.
Nota: El comportamiento es indefinido cuando pos < 0, n < 0 o pos + n > size().
Véanse también first(), last(), chopped(), chop(), truncate() y slice().
[noexcept] bool QByteArrayView::startsWith(QByteArrayView bv) const
[constexpr noexcept] bool QByteArrayView::startsWith(char ch) const
Devuelve « true » si esta vista de matriz de bytes comienza con una vista de matriz de bytes « bv » o un carácter « ch », respectivamente; en caso contrario, devuelve « false ».
Véase también endsWith().
QByteArray QByteArrayView::toByteArray() const
Devuelve una copia profunda de los datos de esta vista de matriz de bytes como un ` QByteArray`.
El valor devuelto será un ` QByteArray ` nulo si y solo si esta vista de matriz de bytes es nula.
[since 6.3] double QByteArrayView::toDouble(bool *ok = nullptr) const
Devuelve esta vista de matriz de bytes convertida a un valor de tipo « double ».
Devuelve infinito si la conversión produce un desbordamiento por exceso o 0,0 si la conversión falla por otros motivos (por ejemplo, desbordamiento por defecto).
Si ok no es un « nullptr », se notifica el error estableciendo *ok en false, y el éxito estableciendo *ok en true.
Advertencia: El contenido de « QByteArrayView » solo puede contener caracteres numéricos válidos, lo que incluye el signo más/menos, la letra «e» utilizada en notación científica y el punto decimal. La inclusión de la unidad o de caracteres adicionales provoca un error de conversión.
Nota: La conversión del número se realiza en la configuración regional predeterminada de C, independientemente de la configuración regional del usuario. Utilice QLocale para realizar conversiones que tengan en cuenta la configuración regional entre números y cadenas.
Esta función ignora los caracteres de espaciado iniciales y finales.
Esta función se introdujo en Qt 6.3.
[since 6.3] float QByteArrayView::toFloat(bool *ok = nullptr) const
Devuelve esta vista de matriz de bytes convertida a un valor de tipo « float ».
Devuelve infinito si se produce un desbordamiento durante la conversión, o 0,0 si la conversión falla por otros motivos (por ejemplo, un desbordamiento por debajo del rango).
Si ok no es nullptr, el error se notifica estableciendo *ok en false, y el éxito estableciendo *ok en true.
QByteArrayView string("1234.56 Volt");
bool ok;
float a = string.toFloat(&ok); // a == 0, ok == false
a = string.first(7).toFloat(&ok); // a == 1234.56, ok == trueAdvertencia: El contenido de « QByteArrayView » solo puede contener caracteres numéricos válidos, lo que incluye el signo más/menos, la letra «e» utilizada en notación científica y el punto decimal. La inclusión de la unidad o de caracteres adicionales provoca un error de conversión.
Nota: La conversión del número se realiza en la configuración regional predeterminada de C, independientemente de la configuración regional del usuario. Utilice QLocale para realizar conversiones entre números y cadenas que tengan en cuenta la configuración regional.
Esta función ignora los espacios en blanco al principio y al final.
Esta función se introdujo en Qt 6.3.
[since 6.3] int QByteArrayView::toInt(bool *ok = nullptr, int base = 10) const
Devuelve esta vista de matriz de bytes convertida a un objeto ` int ` utilizando la base ` base`, que por defecto es diez. Se admiten las bases 0 y del 2 al 36, utilizando letras para los dígitos superiores a 9; A es diez, B es once, y así sucesivamente.
Si base es 0, la base se determina automáticamente siguiendo estas reglas: si la vista de la matriz de bytes comienza por «0x», el resto se lee como hexadecimal (base 16); en caso contrario, si comienza por «0», el resto se lee como octal (base 8); de lo contrario, se lee como decimal.
Devuelve 0 si la conversión falla.
Si ` ok ` no es ` nullptr`, el fallo se notifica estableciendo *`ok ` en ` false`, y el éxito estableciendo *`ok ` en ` true`.
QByteArrayView str("FF");
bool ok;
int hex = str.toInt(&ok, 16); // hex == 255, ok == true
int dec = str.toInt(&ok, 10); // dec == 0, ok == falseNota: La conversión del número se realiza en la configuración regional predeterminada de C, independientemente de la configuración regional del usuario. Utiliza ` QLocale ` para realizar conversiones entre números y cadenas que tengan en cuenta la configuración regional.
Esta función se introdujo en Qt 6.3.
[since 6.3] long QByteArrayView::toLong(bool *ok = nullptr, int base = 10) const
Devuelve esta vista de matriz de bytes convertida a un entero de tipo « long » utilizando la base base, que por defecto es diez. Se admiten las bases 0 y del 2 al 36, utilizando letras para los dígitos superiores a 9; A es diez, B es once, y así sucesivamente.
Si base es 0, la base se determina automáticamente siguiendo estas reglas: si la vista de la matriz de bytes comienza por «0x», el resto se lee como hexadecimal (base 16); en caso contrario, si comienza por «0», el resto se interpreta como octal (base 8); de lo contrario, se interpreta como decimal.
Devuelve 0 si la conversión falla.
Si ok no es « nullptr », el fallo se notifica estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».
QByteArrayView str("FF");
bool ok;
long hex = str.toLong(&ok, 16); // hex == 255, ok == true
long dec = str.toLong(&ok, 10); // dec == 0, ok == falseNota: La conversión del número se realiza en la configuración regional predeterminada de C, independientemente de la configuración regional del usuario. Utiliza QLocale para realizar conversiones entre números y cadenas que tengan en cuenta la configuración regional.
Esta función se introdujo en Qt 6.3.
[since 6.3] qlonglong QByteArrayView::toLongLong(bool *ok = nullptr, int base = 10) const
Devuelve esta vista de matriz de bytes convertida a un objeto ` long long ` utilizando la base ` base`, que por defecto es diez. Se admiten las bases 0 y del 2 al 36, utilizando letras para los dígitos superiores a 9; A es diez, B es once, y así sucesivamente.
Si ` base ` es 0, la base se determina automáticamente siguiendo estas reglas: si la vista de la matriz de bytes comienza por «0x», el resto se lee como hexadecimal (base 16); en caso contrario, si comienza por «0», el resto se lee como octal (base 8); de lo contrario, se lee como decimal.
Devuelve 0 si la conversión falla.
Si ` ok ` no es ` nullptr`, el error se notifica estableciendo `*ok ` en ` false`, y el éxito estableciendo `*ok ` en ` true`.
Nota: La conversión del número se realiza en la configuración regional predeterminada de C, independientemente de la configuración regional del usuario. Utiliza QLocale para realizar conversiones entre números y cadenas que tengan en cuenta la configuración regional.
Esta función se introdujo en Qt 6.3.
[since 6.3] short QByteArrayView::toShort(bool *ok = nullptr, int base = 10) const
Devuelve esta vista de matriz de bytes convertida a un objeto ` short ` utilizando la base ` base`, que por defecto es diez. Se admiten las bases 0 y del 2 al 36, utilizando letras para los dígitos superiores a 9; A es diez, B es once y así sucesivamente.
Si ` base ` es 0, la base se determina automáticamente según las siguientes reglas: si la vista de la matriz de bytes comienza por «0x», el resto se lee como hexadecimal (base 16); en caso contrario, si comienza por «0», el resto se lee como octal (base 8); de lo contrario, se lee como decimal.
Devuelve 0 si la conversión falla.
Si ` ok ` no es ` nullptr`, se notifica el error estableciendo `*ok ` en ` false`, y el éxito estableciendo `*ok ` en ` true`.
Nota: La conversión del número se realiza en la configuración regional predeterminada de C, independientemente de la configuración regional del usuario. Utiliza QLocale para realizar conversiones entre números y cadenas que tengan en cuenta la configuración regional.
Esta función se introdujo en Qt 6.3.
[since 6.3] uint QByteArrayView::toUInt(bool *ok = nullptr, int base = 10) const
Devuelve esta vista de matriz de bytes convertida a un objeto ` unsigned int ` utilizando la base base, que por defecto es diez. Se admiten las bases 0 y del 2 al 36, utilizando letras para los dígitos superiores a 9; A es diez, B es once, y así sucesivamente.
Si base es 0, la base se determina automáticamente siguiendo estas reglas: si la vista de la matriz de bytes comienza por «0x», el resto se lee como hexadecimal (base 16); en caso contrario, si comienza por «0», el resto se lee como octal (base 8); de lo contrario, se lee como decimal.
Devuelve 0 si la conversión falla.
Si ` ok ` no es ` nullptr`, se notifica el error estableciendo `*ok ` en ` false`, y el éxito estableciendo `*ok ` en ` true`.
Nota: La conversión del número se realiza en la configuración regional predeterminada de C, independientemente de la configuración regional del usuario. Utiliza QLocale para realizar conversiones entre números y cadenas que tengan en cuenta la configuración regional.
Esta función se introdujo en Qt 6.3.
[since 6.3] ulong QByteArrayView::toULong(bool *ok = nullptr, int base = 10) const
Devuelve esta vista de matriz de bytes convertida a un objeto ` unsigned long int ` utilizando la base base, que por defecto es diez. Se admiten las bases 0 y del 2 al 36, utilizando letras para los dígitos superiores a 9; A es diez, B es once y así sucesivamente.
Si base es 0, la base se determina automáticamente según las siguientes reglas: si la vista de la matriz de bytes comienza por «0x», el resto se lee como hexadecimal (base 16); en caso contrario, si comienza por «0», el resto se lee como octal (base 8); de lo contrario, se lee como decimal.
Devuelve 0 si la conversión falla.
Si ` ok ` no es ` nullptr`, el fallo se notifica estableciendo `*ok ` en ` false`, y el éxito estableciendo `*ok ` en ` true`.
Nota: La conversión del número se realiza en la configuración regional predeterminada de C, independientemente de la configuración regional del usuario. Utiliza QLocale para realizar conversiones entre números y cadenas que tengan en cuenta la configuración regional.
Esta función se introdujo en Qt 6.3.
[since 6.3] qulonglong QByteArrayView::toULongLong(bool *ok = nullptr, int base = 10) const
Devuelve esta vista de matriz de bytes convertida a un objeto ` unsigned long long ` utilizando la base ` base`, que por defecto es diez. Se admiten las bases 0 y del 2 al 36, utilizando letras para los dígitos superiores a 9; A es diez, B es once, y así sucesivamente.
Si base es 0, la base se determina automáticamente siguiendo estas reglas: si la vista de la matriz de bytes comienza por «0x», el resto se lee como hexadecimal (base 16); en caso contrario, si comienza por «0», el resto se lee como octal (base 8); de lo contrario, se lee como decimal.
Devuelve 0 si la conversión falla.
Si ` ok ` no es ` nullptr`, se notifica el error estableciendo *`ok ` en ` false`, y el éxito estableciendo *`ok ` en ` true`.
Nota: La conversión del número se realiza en la configuración regional predeterminada de C, independientemente de la configuración regional del usuario. Utiliza QLocale para realizar conversiones entre números y cadenas que tengan en cuenta la configuración regional.
Esta función se introdujo en Qt 6.3.
[since 6.3] ushort QByteArrayView::toUShort(bool *ok = nullptr, int base = 10) const
Devuelve esta vista de matriz de bytes convertida a un objeto ` unsigned short ` utilizando la base base, que por defecto es diez. Se admiten las bases 0 y del 2 al 36, utilizando letras para los dígitos superiores a 9; A es diez, B es once, y así sucesivamente.
Si base es 0, la base se determina automáticamente siguiendo estas reglas: si la vista de la matriz de bytes comienza por «0x», el resto se lee como hexadecimal (base 16); en caso contrario, si comienza por «0», el resto se lee como octal (base 8); de lo contrario, se lee como decimal.
Devuelve 0 si la conversión falla.
Si ` ok ` no es ` nullptr`, el fallo se notifica estableciendo *`ok ` en ` false`, y el éxito estableciendo *`ok ` en ` true`.
Nota: La conversión del número se realiza en la configuración regional predeterminada de C, independientemente de la configuración regional del usuario. Utiliza QLocale para realizar conversiones entre números y cadenas que tengan en cuenta la configuración regional.
Esta función se introdujo en Qt 6.3.
[noexcept, since 6.3] QByteArrayView QByteArrayView::trimmed() const
Devuelve una copia de esta vista de matriz de bytes con los caracteres de espaciado eliminados al principio y al 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 C; se trata de los caracteres ASCII de tabulación «\t », salto de línea «\n », retorno de carro «\r », tabulación vertical «\v », salto de página «\f » y espacio « ».
Esta función se introdujo en Qt 6.3.
Véase también QChar::SpecialCharacter y Spacing Characters.
[constexpr] void QByteArrayView::truncate(qsizetype length)
Trunca esta vista de matriz de bytes a una longitud de length.
Es lo mismo que ` *this = first(length)`.
Nota: El comportamiento es indefinido cuando ` length ` < 0 o ` length ` > ` size`().
Véase también ` first()`, ` last()`, ` sliced()`, ` chopped()` y ` chop()`.
[constexpr noexcept, since 6.7] QByteArrayView::operator std::string_view() const
Convierte este objeto ` QByteArrayView ` en un objeto ` std::string_view `. La vista devuelta tendrá el mismo puntero de datos y la misma longitud que esta vista.
Esta función se introdujo en Qt 6.7.
[constexpr] char QByteArrayView::operator[](qsizetype n) const
Devuelve el carácter situado en la posición n en esta vista de matriz de bytes.
El comportamiento es indefinido si n es negativo o no es menor que size().
Elementos no miembros relacionados
[noexcept] bool operator!=(const QByteArrayView &lhs, const QByteArrayView &rhs)
[noexcept] bool operator<(const QByteArrayView &lhs, const QByteArrayView &rhs)
[noexcept] bool operator<=(const QByteArrayView &lhs, const QByteArrayView &rhs)
[noexcept] bool operator==(const QByteArrayView &lhs, const QByteArrayView &rhs)
[noexcept] bool operator>(const QByteArrayView &lhs, const QByteArrayView &rhs)
[noexcept] bool operator>=(const QByteArrayView &lhs, const QByteArrayView &rhs)
Operadores de comparación para QByteArrayView.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.