QStringView Class
La clase QStringView ofrece una vista unificada de las cadenas UTF-16 mediante un subconjunto de solo lectura de la API de « QString ». Más información...
| Encabezado: | #include <QStringView> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los miembros heredados
- Miembros obsoletos
- QStringView forma parte de las clases para datos de cadena.
Nota: Todas las funciones de esta clase son reentrantes.
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
| QStringView() | |
| QStringView(const Char (&string)[N]) | |
| QStringView(const Char *str) | |
| QStringView(const Container &str) | |
| QStringView(const QString &str) | |
| QStringView(std::nullptr_t) | |
| QStringView(const Char *first, const Char *last) | |
| QStringView(const Char *str, qsizetype len) | |
| QString | arg(Args &&... args) const |
| QChar | at(qsizetype n) const |
| QChar | back() const |
| QStringView::const_iterator | begin() const |
| QStringView::const_iterator | cbegin() const |
| QStringView::const_iterator | cend() const |
| void | chop(qsizetype length) |
| QStringView | chopped(qsizetype length) const |
| int | compare(QChar ch) const |
| int | compare(QChar ch, Qt::CaseSensitivity cs) const |
| int | compare(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
| int | compare(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
(since 6.5) int | compare(QUtf8StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
(since 6.1) QStringView::const_iterator | constBegin() const |
(since 6.0) QStringView::const_pointer | constData() const |
(since 6.1) QStringView::const_iterator | constEnd() const |
| bool | contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
| bool | contains(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
| bool | contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
(since 6.1) bool | contains(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const |
(since 6.1) qsizetype | count(const QRegularExpression &re) const |
(since 6.0) qsizetype | count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
(since 6.4) qsizetype | count(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
(since 6.0) qsizetype | count(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
| QStringView::const_reverse_iterator | crbegin() const |
| QStringView::const_reverse_iterator | crend() const |
| QStringView::const_pointer | data() const |
| bool | empty() const |
| QStringView::const_iterator | end() const |
| bool | endsWith(QChar ch) const |
| bool | endsWith(QChar ch, Qt::CaseSensitivity cs) const |
| bool | endsWith(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
| bool | endsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
| QChar | first() const |
(since 6.0) QStringView | first(qsizetype n) const |
| QChar | front() const |
| qsizetype | indexOf(QChar ch, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
| qsizetype | indexOf(QLatin1StringView l1, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
| qsizetype | indexOf(QStringView str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
(since 6.1) qsizetype | indexOf(const QRegularExpression &re, qsizetype from = 0, QRegularExpressionMatch *rmatch = nullptr) const |
| bool | isEmpty() const |
(since 6.7) bool | isLower() const |
| bool | isNull() const |
| bool | isRightToLeft() const |
(since 6.7) bool | isUpper() const |
| bool | isValidUtf16() const |
| QChar | last() const |
(since 6.0) QStringView | last(qsizetype n) const |
(since 6.2) qsizetype | lastIndexOf(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const |
| qsizetype | lastIndexOf(QChar ch, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
| qsizetype | lastIndexOf(QLatin1StringView l1, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
| qsizetype | lastIndexOf(QStringView str, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
(since 6.1) qsizetype | lastIndexOf(const QRegularExpression &re, qsizetype from, QRegularExpressionMatch *rmatch = nullptr) const |
(since 6.3) qsizetype | lastIndexOf(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
(since 6.2) qsizetype | lastIndexOf(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
(since 6.2) qsizetype | lastIndexOf(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
| qsizetype | length() const |
(since 6.4) int | localeAwareCompare(QStringView other) const |
(since 6.8) qsizetype | max_size() const |
| QStringView::const_reverse_iterator | rbegin() const |
| QStringView::const_reverse_iterator | rend() const |
| qsizetype | size() const |
(since 6.8) QStringView & | slice(qsizetype pos, qsizetype n) |
(since 6.8) QStringView & | slice(qsizetype pos) |
(since 6.0) QStringView | sliced(qsizetype pos, qsizetype n) const |
(since 6.0) QStringView | sliced(qsizetype pos) const |
(since 6.0) QList<QStringView> | split(QChar sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
(since 6.0) QList<QStringView> | split(QStringView sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
(since 6.0) QList<QStringView> | split(const QRegularExpression &re, Qt::SplitBehavior behavior = Qt::KeepEmptyParts) const |
| bool | startsWith(QChar ch) const |
| bool | startsWith(QChar ch, Qt::CaseSensitivity cs) const |
| bool | startsWith(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
| bool | startsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const |
(since 6.0) CFStringRef | toCFString() const |
(since 6.0) double | toDouble(bool *ok = nullptr) const |
(since 6.0) float | toFloat(bool *ok = nullptr) const |
(since 6.0) int | toInt(bool *ok = nullptr, int base = 10) const |
| QByteArray | toLatin1() const |
| QByteArray | toLocal8Bit() const |
(since 6.0) long | toLong(bool *ok = nullptr, int base = 10) const |
(since 6.0) qlonglong | toLongLong(bool *ok = nullptr, int base = 10) const |
(since 6.0) NSString * | toNSString() const |
(since 6.0) short | toShort(bool *ok = nullptr, int base = 10) const |
| QString | toString() const |
(since 6.0) uint | toUInt(bool *ok = nullptr, int base = 10) const |
(since 6.0) ulong | toULong(bool *ok = nullptr, int base = 10) const |
(since 6.0) qulonglong | toULongLong(bool *ok = nullptr, int base = 10) const |
(since 6.0) ushort | toUShort(bool *ok = nullptr, int base = 10) const |
| QList<uint> | toUcs4() const |
| QByteArray | toUtf8() const |
| qsizetype | toWCharArray(wchar_t *array) const |
(since 6.0) auto | tokenize(Needle &&sep, Flags... flags) const |
| QStringView | trimmed() const |
| void | truncate(qsizetype length) |
| const QStringView::storage_type * | utf16() const |
(since 6.7) | operator std::u16string_view() const |
| QChar | operator[](qsizetype n) const |
Miembros públicos estáticos
Elementos no miembros relacionados
| size_t | qHash(QStringView key, size_t seed = 0) |
| bool | operator!=(const QStringView &lhs, const QStringView &rhs) |
| bool | operator<(const QStringView &lhs, const QStringView &rhs) |
| bool | operator<=(const QStringView &lhs, const QStringView &rhs) |
| bool | operator==(const QStringView &lhs, const QStringView &rhs) |
| bool | operator>(const QStringView &lhs, const QStringView &rhs) |
| bool | operator>=(const QStringView &lhs, const QStringView &rhs) |
Descripción detallada
Un QStringView hace referencia a una parte contigua de una cadena UTF-16 de la que no es propietario. Actúa como un tipo de interfaz para todo tipo de cadenas UTF-16, sin necesidad de construir primero un ` QString `.
La cadena UTF-16 puede representarse como una matriz (o una estructura de datos compatible con matrices, como QString, std::basic_string, etc.) de QChar, ushort, char16_t o (en plataformas como Windows, donde es un tipo de 16 bits) wchar_t.
QStringView 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 QStringViews como variables automáticas o miembros de datos, hay que asegurarse de que los datos de cadena a los que se hace referencia (por ejemplo, los que pertenecen a un ` QString`) perduren más que el QStringView en todas las rutas de código, para evitar que la vista de cadena acabe haciendo referencia a datos eliminados.
Cuando se utiliza como tipo de interfaz, QStringView permite que una sola función acepte una amplia variedad de fuentes de datos de cadenas UTF-16. Así, una función que acepte QStringView sustituye a tres sobrecargas de función (que toman QString y (const QChar*, qsizetype)), al tiempo que permite pasar a la función aún más fuentes de datos de cadenas, como u"Hello World", un literal de cadena char16_t.
Los QStringView deben pasarse por valor, no por referencia a const:
void myfun1(QStringView sv); // preferred
void myfun2(const QStringView &sv); // compiles and works, but slowerSi quieres ofrecer a tus usuarios la máxima libertad a la hora de elegir qué cadenas pueden pasar a tu función, acompaña la sobrecarga de QStringView con sobrecargas para
- QChar: esta sobrecarga puede delegar en la versión de QStringView:
void fun(QChar ch) { myfun1(QStringView(&ch, 1)); }aunque, por razones técnicas, QStringView no pueda proporcionar por sí mismo un constructor « QChar ».
- QString: si almacenas una copia sin modificar de la cadena y, por lo tanto, te gustaría aprovechar el uso compartido implícito de ` QString`.
- QLatin1StringView: si puedes implementar la función sin convertir primero el ` QLatin1StringView ` a UTF-16; los usuarios esperan que una función sobrecargada en ` QLatin1StringView ` realice estrictamente menos asignaciones de memoria que la llamada semánticamente equivalente de la versión de `QStringView`, que implica la construcción de un ` QString ` a partir del ` QLatin1StringView`.
QStringView también puede utilizarse como valor de retorno de una función. Si se llama a una función que devuelve un QStringView, hay que tener especial cuidado de no mantener el QStringView más tiempo del que la función promete mantener activos los datos de la cadena a la que hace referencia. En caso de duda, se debe obtener una referencia fuerte a los datos llamando a ` toString()` para convertir el QStringView en un ` QString`.
QStringView es un tipo literal, pero, dado que almacena los datos como char16_t, la iteración no es constexpr (se realizan conversiones de const char16_t* a const QChar*, lo cual no está permitido en las funciones constexpr ). En su lugar, puedes utilizar un bucle indexado y/o utf16() en contextos constexpr.
Véase también «¿Qué clase de cadena utilizar?» y « QString ».
Documentación sobre tipos de miembros
QStringView::const_iterator
Este `typedef` proporciona un iterador `const` al estilo STL para ` QStringView`.
Véase también iterator y const_reverse_iterator.
QStringView::const_pointer
Alias de ` value_type *`. Se proporciona para garantizar la compatibilidad con la STL.
QStringView::const_reference
Alias de ` value_type &`. Se proporciona para garantizar la compatibilidad con la STL.
QStringView::const_reverse_iterator
Este `typedef` proporciona un iterador inverso constante al estilo de la STL para ` QStringView`.
Véase también reverse_iterator y const_iterator.
QStringView::difference_type
Alias de ` std::ptrdiff_t`. Se proporciona para garantizar la compatibilidad con la STL.
QStringView::iterator
Este `typedef` proporciona un iterador `const` al estilo de la STL para ` QStringView`.
QStringView No admite iteradores mutables, por lo que es equivalente a const_iterator.
Véanse también const_iterator y reverse_iterator.
QStringView::pointer
Alias de value_type *. Se proporciona para garantizar la compatibilidad con la STL.
QStringView No admite punteros mutables, por lo que equivale a const_pointer.
QStringView::reference
Alias de value_type &. Se proporciona para garantizar la compatibilidad con la STL.
QStringView No admite referencias mutables, por lo que es equivalente a ` const_reference`.
QStringView::reverse_iterator
Este `typedef` proporciona un iterador inverso constante al estilo STL para ` QStringView`.
QStringView No admite iteradores inversos mutables, por lo que es equivalente a const_reverse_iterator.
Véase también const_reverse_iterator y iterator.
QStringView::size_type
Alias de «qsizetype». Se proporciona para garantizar la compatibilidad con la STL.
QStringView::storage_type
Alias de char16_t.
QStringView::value_type
Alias de const QChar. Se proporciona para garantizar la compatibilidad con la STL.
Documentación de funciones miembro
[constexpr noexcept] QStringView::QStringView()
Crea una vista de cadena nula.
Véase también ` isNull()`.
[constexpr noexcept] template <typename Char, size_t N> QStringView::QStringView(const Char (&string)[N])
Crea una vista de cadena a partir del literal de cadena « string ». La vista abarca la matriz hasta que se encuentra el primer « Char(0) » o « N », lo que ocurra primero. Si necesitas la matriz completa, utiliza en su lugar « fromArray()».
string debe seguir siendo válida durante toda la vida útil de este objeto de vista de cadena.
Restricciones
Participa en la resolución de sobrecargas solo si Char es un tipo de carácter compatible. Los tipos de carácter compatibles son: QChar, ushort, char16_t y (en plataformas, como Windows, donde es un tipo de 16 bits) wchar_t.
Véase también fromArray.
[constexpr noexcept] template <typename Char> QStringView::QStringView(const Char *str)
Crea una vista de cadena en str. La longitud se determina buscando el primer Char(0).
str debe seguir siendo válido durante toda la vida útil de este objeto de vista de cadena.
Pasar nullptr como str es seguro y da como resultado una vista de cadena nula.
Restricciones
Participa en la resolución de sobrecarga solo si Char es un tipo de carácter compatible. Los tipos de carácter compatibles son: QChar, ushort, char16_t y (en plataformas, como Windows, donde es un tipo de 16 bits) wchar_t.
[constexpr noexcept] template <typename Container, QStringView::if_compatible_container<Container> = true> QStringView::QStringView(const Container &str)
Crea una vista de cadena en str. La longitud se obtiene de std::size(str).
std::data(str) debe seguir siendo válida durante todo el tiempo de vida de este objeto de vista de cadena.
La vista de cadena estará vacía si y solo si std::size(str) == 0. No se especifica si este constructor puede dar lugar a una vista de cadena nula (para ello,std::data(str) tendría que devolver nullptr ).
Restricciones
Participa en la resolución de sobrecargas únicamente si ` Container ` es un contenedor con un tipo de carácter compatible con ` value_type`. Los tipos de carácter compatibles son: ` QChar`, ` ushort`, ` char16_t ` y (en plataformas, como Windows, donde es un tipo de 16 bits) ` wchar_t`.
Véase también isNull() y isEmpty().
[noexcept] QStringView::QStringView(const QString &str)
Crea una vista de cadena en str.
str.data() debe seguir siendo válida durante todo el tiempo de vida de este objeto de vista de cadena.
La vista de cadena será nula si y solo si str.isNull().
[constexpr noexcept] QStringView::QStringView(std::nullptr_t)
Crea una vista de cadena nula.
Véase también isNull().
[constexpr] template <typename Char, QStringView::if_compatible_char<Char> = true> QStringView::QStringView(const Char *first, const Char *last)
Crea una vista de cadena en first con una longitud de (last - first).
El rango [first,last) debe seguir siendo válido durante toda la vida útil de este objeto de vista de cadena.
Pasar \nullptr como first es seguro si last también es nullptr, y da como resultado una vista de cadena 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 sobrecarga solo si Char es un tipo de carácter compatible. Los tipos de carácter compatibles son: QChar, ushort, char16_t y (en plataformas, como Windows, donde es un tipo de 16 bits) wchar_t.
[constexpr] template <typename Char, QStringView::if_compatible_char<Char> = true> QStringView::QStringView(const Char *str, qsizetype len)
Crea una vista de cadena en str con una longitud de len.
El rango [str,len) debe seguir siendo válido durante toda la vida útil de este objeto de vista de cadena.
Pasar nullptr como str es seguro si len también es 0, y da como resultado una vista de cadena nula.
El comportamiento es indefinido si ` len ` es negativo o, cuando es positivo, si ` str ` es ` nullptr`.
Restricciones
Participa en la resolución de sobrecarga solo si Char es un tipo de carácter compatible. Los tipos de carácter compatibles son: QChar, ushort, char16_t y (en plataformas, como Windows, donde es un tipo de 16 bits) wchar_t.
template <typename... Args> QString QStringView::arg(Args &&... args) const
Sustituye las apariciones de « %N » en esta cadena por el argumento correspondiente de « args ». Los argumentos no son posicionales: el primero de « args » sustituye « %N » por el « N » más bajo (todos ellos); el segundo de « args », « %N » por el « N » inmediatamente inferior, y así sucesivamente.
Args puede consistir en cualquier cosa que se convierta implícitamente en QAnyStringView.
Nota: En las versiones de Qt anteriores a la 6.9, las cadenas de « QAnyStringView » y UTF-8 (QUtf8StringView, QByteArray, QByteArrayView, const char8_t*, etc.) no eran compatibles como « args ».
Véase también QString::arg().
[constexpr noexcept] QChar QStringView::at(qsizetype n) const
Devuelve el carácter situado en la posición n en esta vista de cadena.
El comportamiento es indefinido si n es negativo o no es menor que size().
Véase también operator[](), front() y back().
[constexpr] QChar QStringView::back() const
Devuelve el último carácter de la vista de cadena. Equivalente a ` last()`.
Esta función se proporciona por motivos de compatibilidad con la STL.
Advertencia: llamar a esta función sobre una vista de cadena vacía da lugar a un comportamiento indefinido.
Véase también front(), first() y last().
[noexcept] QStringView::const_iterator QStringView::begin() const
Devuelve un iterador const al estilo STL que apunta al primer carácter de la vista de cadena.
Esta función se proporciona para garantizar la compatibilidad con la STL.
Véanse también end(), constBegin(), cbegin(), rbegin() y data().
[noexcept] QStringView::const_iterator QStringView::cbegin() const
Es igual que ` begin()`.
Esta función se proporciona por motivos de compatibilidad con la STL.
Véanse también cend(), begin(), constBegin(), crbegin() y data().
[noexcept] QStringView::const_iterator QStringView::cend() const
Es igual que ` end()`.
Esta función se proporciona para garantizar la compatibilidad con la STL.
Véanse también cbegin(), end(), constEnd() y crend().
[constexpr noexcept] void QStringView::chop(qsizetype length)
Trunca esta vista de cadena en length caracteres.
Es lo mismo que ` *this = left(size() - length)`.
Nota: El comportamiento es indefinido cuando ` length ` < 0 o ` length ` > ` size`().
Véase también sliced(), left(), right(), chopped(), truncate() y slice().
[constexpr noexcept] QStringView QStringView::chopped(qsizetype length) const
Devuelve la subcadena de longitud size() - length a partir del principio de este objeto.
Es lo mismo que left(size() - length).
Nota: El comportamiento es indefinido cuando length < 0 o length > size().
Véase también sliced(), left(), right(), chop(), truncate() y slice().
[constexpr noexcept] int QStringView::compare(QChar ch) const
[noexcept] int QStringView::compare(QChar ch, Qt::CaseSensitivity cs) const
[noexcept] int QStringView::compare(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Compara esta vista de cadena con la vista de cadena Latin-1 l1 o con el carácter ch. Devuelve un entero negativo si esta vista de cadena es menor que l1 o ch, un entero positivo si es mayor que l1 o ch, y cero si son iguales.
Si cs es Qt::CaseSensitive (el valor por defecto), la comparación distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.
Véanse también operator==(), operator<() y operator>().
[noexcept] int QStringView::compare(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Compara esta vista de cadena con la vista de cadena str y devuelve un entero negativo si esta vista de cadena es menor que str, un entero positivo si es mayor que str, y cero si son iguales.
Si cs es Qt::CaseSensitive (por defecto), la comparación distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.
Véase también operator==(), operator<() y operator>().
[noexcept, since 6.5] int QStringView::compare(QUtf8StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Compara esta vista de cadena con QUtf8StringView str y devuelve un entero negativo si esta vista de cadena es menor que str, un entero positivo si es mayor que str, y cero si son iguales.
Si cs es Qt::CaseSensitive (el valor por defecto), la comparación distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.
Esta función se introdujo en Qt 6.5.
Véase también operator==(), operator<() y operator>().
[noexcept, since 6.1] QStringView::const_iterator QStringView::constBegin() const
Es igual que ` begin()`.
Esta función se introdujo en Qt 6.1.
Véase también constEnd(), begin(), cbegin(), crbegin() y data().
[noexcept, since 6.0] QStringView::const_pointer QStringView::constData() const
Devuelve un puntero const al primer carácter de la vista de cadena.
Nota: La matriz de caracteres representada por el valor de retorno no está terminada en nulo.
Esta función se introdujo en Qt 6.0.
Véase también data(), begin(), end() y utf16().
[noexcept, since 6.1] QStringView::const_iterator QStringView::constEnd() const
Es igual que ` end()`.
Esta función se introdujo en Qt 6.1.
Véase también constBegin(), end(), cend() y crend().
[noexcept] bool QStringView::contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
[noexcept] bool QStringView::contains(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
[noexcept] bool QStringView::contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Devuelve « true » si esta vista de cadena contiene alguna aparición de la cadena UTF-16 representada por « str », la cadena Latin-1 representada por « l1 » o el carácter « ch », respectivamente; en caso contrario, devuelve « false ».
Si cs es Qt::CaseSensitive (el valor por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.
Véase también indexOf().
[since 6.1] bool QStringView::contains(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const
Devuelve ` true ` si la expresión regular ` re ` coincide en algún punto de esta vista de cadena; en caso contrario, devuelve ` false`.
Si la coincidencia se produce con éxito y rmatch no es nullptr, también escribe los resultados de la coincidencia en el objeto QRegularExpressionMatch al que apunta rmatch.
Esta función se introdujo en Qt 6.1.
Véase también QRegularExpression::match().
[since 6.1] qsizetype QStringView::count(const QRegularExpression &re) const
Devuelve el número de veces que la expresión regular re coincide en la vista de cadena.
Por motivos históricos, esta función cuenta las coincidencias superpuestas. Este comportamiento difiere del que se obtiene al simplemente recorrer las coincidencias en la vista de cadena utilizando ` QRegularExpressionMatchIterator`.
Esta función se introdujo en Qt 6.1.
Véase también ` QRegularExpression::globalMatch()`.
[noexcept, since 6.0] qsizetype QStringView::count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Devuelve el número de veces que aparece el carácter ch en la vista de cadena.
Si cs es Qt::CaseSensitive (valor por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.
Esta función sobrecarga QStringView::count().
Esta función se introdujo en Qt 6.0.
Véase también QString::count(), contains() y indexOf().
[since 6.4] qsizetype QStringView::count(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Devuelve el número de apariciones (que pueden solaparse) de la cadena Latin-1 que l1 detecta en esta vista de cadena.
Si cs es Qt::CaseSensitive (el valor por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.
Esta función sobrescribe ` QStringView::count()`.
Esta función se introdujo en Qt 6.4.
Véase también ` QString::count()`, ` contains()` y ` indexOf()`.
[noexcept, since 6.0] qsizetype QStringView::count(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Devuelve el número de apariciones (que pueden solaparse) de la vista de cadena str en esta vista de cadena.
Si cs es Qt::CaseSensitive (valor por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.
Esta función sobrescribe la función QStringView::count().
Esta función se introdujo en Qt 6.0.
Véase también QString::count(), contains() y indexOf().
[noexcept] QStringView::const_reverse_iterator QStringView::crbegin() const
Es igual que ` rbegin()`.
Esta función se proporciona para garantizar la compatibilidad con STL.
Véanse también crend(), rbegin() y cbegin().
[noexcept] QStringView::const_reverse_iterator QStringView::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().
[noexcept] QStringView::const_pointer QStringView::data() const
Devuelve un puntero const al primer carácter de la vista de cadena.
Nota: La matriz de caracteres representada por el valor de retorno no está terminada en nulo.
Véase también begin(), end() y utf16().
[constexpr noexcept] bool QStringView::empty() const
Devuelve si esta vista de cadena está vacía; es decir, si size() == 0.
Esta función se proporciona para garantizar la compatibilidad con la STL.
Véanse también isEmpty(), isNull(), size() y length().
[noexcept] QStringView::const_iterator QStringView::end() const
Devuelve un iterador const al estilo STL que apunta al carácter imaginario situado después del último carácter de la lista.
Esta función se proporciona para garantizar la compatibilidad con la STL.
Véase también begin(), constEnd(), cend() y rend().
[noexcept] bool QStringView::endsWith(QChar ch) const
[noexcept] bool QStringView::endsWith(QChar ch, Qt::CaseSensitivity cs) const
[noexcept] bool QStringView::endsWith(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
[noexcept] bool QStringView::endsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Devuelve « true » si esta vista de cadena termina con la cadena UTF-16 que se ve en str, la cadena Latin-1 que se ve en l1 o el carácter ch, respectivamente; en caso contrario, devuelve « false ».
Si cs es Qt::CaseSensitive (el valor por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.
Véase también startsWith().
[constexpr] QChar QStringView::first() const
Devuelve el primer carácter de la vista de cadena. Es lo mismo que ` front()`.
Esta función se proporciona para garantizar la compatibilidad con otros contenedores de Qt.
Advertencia: Llamar a esta función sobre una vista de cadena vacía da lugar a un comportamiento indefinido.
Véase también front(), back() y last().
[constexpr noexcept, since 6.0] QStringView QStringView::first(qsizetype n) const
Devuelve una vista de cadena que apunta a los primeros n caracteres de esta vista de cadena.
Nota: El comportamiento es indefinido cuando n < 0 o n > size().
Esta función se introdujo en Qt 6.0.
Véase también last(), sliced(), startsWith(), chopped(), chop(), truncate() y slice().
[static constexpr noexcept] template <
typename Char,
size_t Size,
QStringView::if_compatible_char<Char> = true
>
QStringView QStringView::fromArray(const Char (&string)[Size])
Crea una vista de cadena a partir del literal de cadena completo string, compuesto por Size elementos, incluyendo cualquier Char(0) final. Si no deseas que el terminador nulo se incluya en la vista, puedes eliminarlo mediante chop() cuando estés seguro de que se encuentra al final. Como alternativa, puedes utilizar la sobrecarga del constructor que admite un literal de matriz, lo que creará una vista hasta el primer terminador nulo de los datos, sin incluirlo.
string debe seguir siendo válido durante toda la vida útil de este objeto de vista de cadena.
Esta función funcionará con cualquier literal de matriz si Char es un tipo de carácter compatible. Los tipos de carácter compatibles son: QChar, ushort, char16_t y (en plataformas, como Windows, donde es un tipo de 16 bits) wchar_t.
[constexpr] QChar QStringView::front() const
Devuelve el primer carácter de la vista de cadena. Equivalente a ` first()`.
Esta función se proporciona por motivos de compatibilidad con STL.
Advertencia: Llamar a esta función sobre una vista de cadena vacía da lugar a un comportamiento indefinido.
Véase también back(), first() y last().
[noexcept] qsizetype QStringView::indexOf(QChar ch, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
[noexcept] qsizetype QStringView::indexOf(QLatin1StringView l1, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
[noexcept] qsizetype QStringView::indexOf(QStringView str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Devuelve la posición en el índice de la primera aparición de la cadena UTF-16 vista por str, la cadena Latin-1 vista por l1 o el carácter ch, respectivamente, en esta vista de cadena, buscando hacia adelante a partir de la posición del índice from. Devuelve -1 si no se encuentra str, l1 o ch, respectivamente.
Si cs es Qt::CaseSensitive (el valor por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.
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éase también QString::indexOf().
[since 6.1] qsizetype QStringView::indexOf(const QRegularExpression &re, qsizetype from = 0, QRegularExpressionMatch *rmatch = nullptr) const
Devuelve la posición en el índice de la primera coincidencia de la expresión regular re en la vista de cadena, buscando hacia adelante a partir de la posición de índice from. Devuelve -1 si re no ha coincidido en ningún sitio.
Si la coincidencia es correcta y rmatch no es nullptr, también escribe los resultados de la coincidencia en el objeto QRegularExpressionMatch al que apunta rmatch.
Nota: Debido al funcionamiento del algoritmo de coincidencia de expresiones regulares, esta función realizará coincidencias repetidamente desde el principio de la vista de cadena hasta que se alcance la posición from.
Esta función se introdujo en Qt 6.1.
[constexpr noexcept] bool QStringView::isEmpty() const
Devuelve si esta vista de cadena está vacía; es decir, si « size() == 0 ».
Esta función se proporciona para garantizar la compatibilidad con otros contenedores de Qt.
Véase también empty(), isNull(), size() y length().
[noexcept, since 6.7] bool QStringView::isLower() const
Devuelve « true » si esta vista es idéntica a su versión en minúsculas.
Ten en cuenta que esto no significa que la vista de cadena no contenga letras mayúsculas (algunas letras mayúsculas no tienen una forma en minúscula correspondiente; toString().toLower() no las modifica). Para obtener más información, consulta el estándar Unicode, sección 3.13.
Esta función se introdujo en Qt 6.7.
Véanse también ` QChar::toLower()` y ` isUpper()`.
[constexpr noexcept] bool QStringView::isNull() const
Devuelve si esta vista de cadena es nula; es decir, si ` data() == nullptr`.
Esta función se proporciona para garantizar la compatibilidad con otros contenedores de Qt.
Véase también empty(), isEmpty(), size() y length().
[noexcept] bool QStringView::isRightToLeft() const
Devuelve « true » si la vista de cadena se lee de derecha a izquierda.
Véase también QString::isRightToLeft().
[noexcept, since 6.7] bool QStringView::isUpper() const
Devuelve ` true ` si esta vista es idéntica a su versión en mayúsculas.
Ten en cuenta que esto no significa que la vista de cadena no contenga letras minúsculas (algunas letras minúsculas no tienen una versión en mayúscula correspondiente; toString().toUpper() no las modifica). Para obtener más información, consulta el estándar Unicode, sección 3.13.
Esta función se introdujo en Qt 6.7.
Véanse también QChar::toUpper() y isLower().
[noexcept] bool QStringView::isValidUtf16() const
Devuelve « true » si la vista de cadena contiene datos válidos codificados en UTF-16, o « false » en caso contrario.
Ten en cuenta que esta función no realiza ninguna validación especial de los datos; simplemente comprueba si se pueden decodificar correctamente desde UTF-16. Se supone que los datos están en el orden de bytes del host; la presencia de un BOM no tiene importancia.
Véase también QString::isValidUtf16().
[constexpr] QChar QStringView::last() const
Devuelve el último carácter de la vista de cadena. Es lo mismo que ` back()`.
Esta función se proporciona para garantizar la compatibilidad con otros contenedores de Qt.
Advertencia: Llamar a esta función sobre una vista de cadena vacía da lugar a un comportamiento indefinido.
Véase también back(), front() y first().
[constexpr noexcept, since 6.0] QStringView QStringView::last(qsizetype n) const
Devuelve una vista de cadena que apunta a los últimos n caracteres de esta vista de cadena.
Nota: El comportamiento es indefinido cuando n < 0 o n > size().
Esta función se introdujo en Qt 6.0.
Véase también first(), sliced(), endsWith(), chopped(), chop(), truncate() y slice().
[since 6.2] qsizetype QStringView::lastIndexOf(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const
Devuelve la posición en el índice de la última coincidencia de la expresión regular re en la vista de cadena. Devuelve -1 si re no ha coincidido en ningún sitio.
Si la coincidencia se produce con éxito y rmatch no es nullptr, también escribe los resultados de la coincidencia en el objeto QRegularExpressionMatch al que apunta rmatch.
Nota: Debido al funcionamiento del algoritmo de coincidencia de expresiones regulares, esta función realizará coincidencias repetidamente desde el principio de la vista de cadena hasta llegar al final de la misma.
Esta función se introdujo en Qt 6.2.
[noexcept] qsizetype QStringView::lastIndexOf(QChar ch, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
[noexcept] qsizetype QStringView::lastIndexOf(QLatin1StringView l1, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
[noexcept] qsizetype QStringView::lastIndexOf(QStringView str, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Devuelve la posición en el índice de la última aparición de la cadena UTF-16 a la que hace referencia str, de la cadena Latin-1 a la que hace referencia l1 o del carácter ch, respectivamente, en esta vista de cadena, 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, respectivamente, str, l1 o ch.
Si cs es Qt::CaseSensitive (por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.
Nota: Al buscar un str o l1 de longitud 0, la coincidencia al final de los datos se excluye de la búsqueda mediante un from negativo, aunque normalmente se considere que -1 busca desde el final de la vista de la cadena: la coincidencia al final se encuentra después del último carácter, por lo que se excluye. Para incluir dicha coincidencia final vacía, se debe proporcionar un valor positivo para from u omitir por completo el parámetro from.
Véase también QString::lastIndexOf().
[since 6.1] qsizetype QStringView::lastIndexOf(const QRegularExpression &re, qsizetype from, QRegularExpressionMatch *rmatch = nullptr) const
Devuelve la posición en el índice de la última coincidencia de la expresión regular re en la vista de cadena, que comienza antes 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 re no ha coincidido en ningún sitio.
Si la coincidencia tiene éxito y rmatch no es nullptr, también escribe los resultados de la coincidencia en el objeto QRegularExpressionMatch al que apunta rmatch.
Nota: Debido al funcionamiento del algoritmo de coincidencia de expresiones regulares, esta función realizará coincidencias repetidamente desde el principio de la vista de cadena hasta alcanzar la posición from.
Nota: Al buscar una expresión regular re que pueda coincidir con 0 caracteres, la coincidencia al final de los datos se excluye de la búsqueda mediante un valor negativo de from, aunque normalmente se considere que -1 busca desde el final de la vista de cadena: la coincidencia al final se encuentra después del último carácter, por lo que se excluye. Para incluir dicha coincidencia final vacía, se debe proporcionar un valor positivo para from u omitir por completo el parámetro from.
Esta función se introdujo en Qt 6.1.
[noexcept, since 6.3] qsizetype QStringView::lastIndexOf(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Esta función sobrescribe la función ` QStringView::lastIndexOf()`.
Esta función se introdujo en Qt 6.3.
[noexcept, since 6.2] qsizetype QStringView::lastIndexOf(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
[noexcept, since 6.2] qsizetype QStringView::lastIndexOf(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Devuelve la posición en el índice de la última aparición de la cadena UTF-16 vista por str o de la cadena Latin-1 vista por l1, respectivamente, en esta vista de cadena, buscando hacia atrás desde el último carácter de dicha vista. Devuelve -1 si no se encuentra str o l1, respectivamente.
Si cs es Qt::CaseSensitive (el valor por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.
Estas funciones se introdujeron en Qt 6.2.
Véase también QString::lastIndexOf().
[constexpr noexcept] qsizetype QStringView::length() const
Es igual que ` size()`.
Esta función se proporciona para garantizar la compatibilidad con otros contenedores de Qt.
Véanse también empty(), isEmpty(), isNull() y size().
[since 6.4] int QStringView::localeAwareCompare(QStringView other) const
Compara esta vista de cadena con la vista de cadena other y devuelve un número entero menor, igual o mayor que cero si esta vista de cadena es menor, igual o mayor que la vista de cadena other.
La comparación se realiza en función de la configuración regional y también de la plataforma. Utiliza esta función para presentar al usuario listas ordenadas de cadenas.
Esta función se introdujo en Qt 6.4.
Véase también Comparing Strings.
[static constexpr noexcept, since 6.8] qsizetype QStringView::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 QStringView::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.
[noexcept] QStringView::const_reverse_iterator QStringView::rbegin() const
Devuelve un iterador inverso constante al estilo STL que apunta al primer carácter de la vista de cadena, en orden inverso.
Esta función se proporciona para garantizar la compatibilidad con la STL.
Véanse también rend(), crbegin() y begin().
[noexcept] QStringView::const_reverse_iterator QStringView::rend() const
Devuelve un iterador inverso al estilo STL que apunta al carácter situado justo después del último carácter de la vista de cadena, en orden inverso.
Esta función se proporciona para garantizar la compatibilidad con la STL.
Véase también rbegin(), crend() y end().
[constexpr noexcept] qsizetype QStringView::size() const
Devuelve el tamaño de esta vista de cadena, en unidades de código UTF-16 (es decir, los pares sustitutos cuentan como dos a efectos de esta función, al igual que en QString).
Véanse también empty(), isEmpty(), isNull() y length().
[constexpr, since 6.8] QStringView &QStringView::slice(qsizetype pos, qsizetype n)
Modifica esta vista de cadena para que comience en la posición pos y se extienda a lo largo de n puntos de código.
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] QStringView &QStringView::slice(qsizetype pos)
Modifica esta vista de cadena 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 noexcept, since 6.0] QStringView QStringView::sliced(qsizetype pos, qsizetype n) const
Devuelve una vista de cadena que apunta a n caracteres de esta vista de cadena, a partir de la posición pos.
Nota: El comportamiento es indefinido cuando pos < 0, n < 0 o pos + n > size().
Esta función se introdujo en Qt 6.0.
Véase también first(), last(), chopped(), chop(), truncate() y slice().
[constexpr noexcept, since 6.0] QStringView QStringView::sliced(qsizetype pos) const
Devuelve una vista de cadena 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().
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.0.
Véase también first(), last(), chopped(), chop(), truncate() y slice().
[since 6.0] QList<QStringView> QStringView::split(QChar sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
[since 6.0] QList<QStringView> QStringView::split(QStringView sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Divide la vista en subvistas de cadena siempre que aparezca « sep » y devuelve la lista de dichas subvistas de cadena.
Consulte QString::split() para saber cómo interactúan sep, behavior y cs para formar el resultado.
Nota: Todas las vistas devueltas son válidas siempre y cuando los datos a los que hace referencia esta vista de cadena sean válidos. La destrucción de los datos provocará que todas las vistas queden en estado «dangling».
Estas funciones se introdujeron en Qt 6.0.
[since 6.0] QList<QStringView> QStringView::split(const QRegularExpression &re, Qt::SplitBehavior behavior = Qt::KeepEmptyParts) const
Divide la cadena en subcadenas siempre que coincida la expresión regular re y devuelve la lista de dichas cadenas. Si re no coincide en ningún punto de la cadena, split() devuelve una lista de un solo elemento que contiene esta cadena como vista.
Nota: Las vistas de la lista devuelta son subvistas de esta vista; como tales, hacen referencia a los mismos datos que ella y solo siguen siendo válidas mientras dichos datos permanezcan activos.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.0.
[noexcept] bool QStringView::startsWith(QChar ch) const
[noexcept] bool QStringView::startsWith(QChar ch, Qt::CaseSensitivity cs) const
[noexcept] bool QStringView::startsWith(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
[noexcept] bool QStringView::startsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
Devuelve « true » si esta vista de cadena comienza con la cadena UTF-16 representada por « str », la cadena Latin-1 representada por « l1 » o el carácter « ch », respectivamente; en caso contrario, devuelve « false ».
Si cs es Qt::CaseSensitive (el valor por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, la búsqueda no distingue entre mayúsculas y minúsculas.
Véase también endsWith().
[since 6.0] CFStringRef QStringView::toCFString() const
Crea un CFString a partir de este QStringView.
El autor de la llamada es el propietario del CFString y es responsable de liberarlo.
Nota: esta función solo está disponible en macOS e iOS.
Esta función se introdujo en Qt 6.0.
[since 6.0] double QStringView::toDouble(bool *ok = nullptr) const
Devuelve la vista de cadena convertida a un valor de tipo « double ».
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 fallo se notifica estableciendo *`ok ` en ` false`, y el éxito estableciendo *`ok ` en ` true`.
La conversión de cadenas siempre se realizará en la configuración regional «C». Para una conversión dependiente de la configuración regional, utilice QLocale::toDouble().
Por motivos históricos, esta función no gestiona los separadores de miles. Si necesitas convertir este tipo de números, utiliza QLocale::toDouble().
Esta función se introdujo en Qt 6.0.
Véase también QString::toDouble().
[since 6.0] float QStringView::toFloat(bool *ok = nullptr) const
Devuelve la vista de cadena convertida a un valor de tipo « float ».
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 nullptr, el fallo se notifica estableciendo *ok en false, y el éxito estableciendo *ok en true.
La conversión de cadenas se realizará siempre en la configuración regional «C». Para una conversión dependiente de la configuración regional, utilice ` QLocale::toFloat()`
Esta función se introdujo en Qt 6.0.
Véase también QString::toFloat().
[since 6.0] int QStringView::toInt(bool *ok = nullptr, int base = 10) const
Devuelve la vista de cadena convertida a un ` int ` utilizando el valor base ` base`, que es 10 por defecto y debe estar comprendido entre 2 y 36, o ser 0. 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`.
Si base es 0, se utiliza la convención del lenguaje C: si la vista de la cadena comienza por «0x», se utiliza la base 16; en caso contrario, si la vista de la cadena comienza por «0», se utiliza la base 8; de lo contrario, se utiliza la base 10.
La conversión de la cadena siempre se realizará en la configuración regional «C». Para una conversión dependiente de la configuración regional, utiliza QLocale::toInt()
Esta función se introdujo en Qt 6.0.
Véase también QString::toInt().
QByteArray QStringView::toLatin1() const
Devuelve una representación en Latin-1 de la cadena como un ` QByteArray`.
El comportamiento es indefinido si la cadena contiene caracteres que no sean de Latin-1.
Véase también toUtf8(), toLocal8Bit() y QStringEncoder.
QByteArray QStringView::toLocal8Bit() const
Devuelve una representación local de 8 bits de la cadena como un ` QByteArray`.
En sistemas Unix, esto equivale a toUtf8(), mientras que en Windows se utiliza la página de códigos actual del sistema.
El comportamiento es indefinido si la cadena contiene caracteres no admitidos por la codificación de 8 bits de la configuración regional.
Véase también toLatin1(), toUtf8() y QStringEncoder.
[since 6.0] long QStringView::toLong(bool *ok = nullptr, int base = 10) const
Devuelve la vista de cadena convertida a un ` long ` utilizando el valor base ` base`, que es 10 por defecto y debe estar comprendido entre 2 y 36, o bien 0. 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`.
Si base es 0, se utiliza la convención del lenguaje C: si la vista de la cadena comienza por «0x», se utiliza la base 16; en caso contrario, si la vista de la cadena comienza por «0», se utiliza la base 8; de lo contrario, se utiliza la base 10.
La conversión de la cadena siempre se realizará en la configuración regional «C». Para una conversión dependiente de la configuración regional, utilice QLocale::toLong()
Esta función se introdujo en Qt 6.0.
Véase también QString::toLong().
[since 6.0] qlonglong QStringView::toLongLong(bool *ok = nullptr, int base = 10) const
Devuelve la vista de cadena convertida a un ` long long ` utilizando el ` base` base, que es 10 por defecto y debe estar comprendido entre 2 y 36, o ser 0. 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`.
Si base es 0, se utiliza la convención del lenguaje C: si la vista de la cadena comienza por «0x», se utiliza la base 16; en caso contrario, si la vista de la cadena comienza por «0», se utiliza la base 8; de lo contrario, se utiliza la base 10.
La conversión de la cadena siempre se realizará en la configuración regional «C». Para una conversión dependiente de la configuración regional, utilice QLocale::toLongLong()
Esta función se introdujo en Qt 6.0.
Véase también QString::toLongLong().
[since 6.0] NSString *QStringView::toNSString() const
Crea un objeto NSString a partir de este ` QStringView`.
El NSString se libera automáticamente.
Nota: esta función solo está disponible en macOS e iOS.
Esta función se introdujo en Qt 6.0.
[since 6.0] short QStringView::toShort(bool *ok = nullptr, int base = 10) const
Devuelve la vista de cadena convertida a un ` short ` utilizando el valor base ` base`, que es 10 por defecto y debe estar comprendido entre 2 y 36, o ser 0. Devuelve 0 si la conversión falla.
Si ok no es nullptr, se notifica el fallo estableciendo *ok en false, y el éxito estableciendo *ok en true.
Si base es 0, se utiliza la convención del lenguaje C: si la vista de la cadena comienza por «0x», se utiliza la base 16; en caso contrario, si la vista de la cadena comienza por «0», se utiliza la base 8; en caso contrario, se utiliza la base 10.
La conversión de la cadena siempre se realizará en la configuración regional «C». Para una conversión dependiente de la configuración regional, utilice QLocale::toShort()
Esta función se introdujo en Qt 6.0.
Véase también QString::toShort().
QString QStringView::toString() const
Devuelve una copia profunda de los datos de esta vista de cadena como un ` QString`.
El valor devuelto será el objeto ` QString ` nulo si y solo si esta vista de cadena es nula.
[since 6.0] uint QStringView::toUInt(bool *ok = nullptr, int base = 10) const
Devuelve la vista de cadena convertida a un ` unsigned int ` utilizando el valor base ` base`, que es 10 por defecto y debe estar comprendido entre 2 y 36, o ser 0. 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`.
Si base es 0, se utiliza la convención del lenguaje C: si la vista de la cadena comienza por «0x», se utiliza la base 16; en caso contrario, si la vista de la cadena comienza por «0», se utiliza la base 8; en caso contrario, se utiliza la base 10.
La conversión de la cadena siempre se realizará en la configuración regional «C». Para una conversión que dependa de la configuración regional, utilice QLocale::toUInt()
Esta función se introdujo en Qt 6.0.
Véase también QString::toUInt().
[since 6.0] ulong QStringView::toULong(bool *ok = nullptr, int base = 10) const
Devuelve la vista de cadena convertida a un ` unsigned long ` utilizando la base ` base`, que es 10 por defecto y debe estar comprendida entre 2 y 36, o ser 0. 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`.
Si base es 0, se utiliza la convención del lenguaje C: si la vista de la cadena comienza por «0x», se utiliza la base 16; en caso contrario, si la vista de la cadena comienza por «0», se utiliza la base 8; en caso contrario, se utiliza la base 10.
La conversión de la cadena siempre se realizará en la configuración regional «C». Para una conversión dependiente de la configuración regional, utilice QLocale::toULongLong().
Esta función se introdujo en Qt 6.0.
Véase también QString::toULong().
[since 6.0] qulonglong QStringView::toULongLong(bool *ok = nullptr, int base = 10) const
Devuelve la vista de cadena convertida a un ` unsigned long long ` utilizando el valor base ` base`, que es 10 por defecto y debe estar comprendido entre 2 y 36, o ser 0. 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`.
Si base es 0, se utiliza la convención del lenguaje C: si la cadena comienza por «0x», se utiliza la base 16; en caso contrario, si la cadena comienza por «0», se utiliza la base 8; en cualquier otro caso, se utiliza la base 10.
La conversión de la cadena siempre se realizará en la configuración regional «C». Para una conversión dependiente de la configuración regional, utilice QLocale::toULongLong()
Esta función se introdujo en Qt 6.0.
Véase también QString::toULongLong().
[since 6.0] ushort QStringView::toUShort(bool *ok = nullptr, int base = 10) const
Devuelve la vista de cadena convertida a un ` unsigned short ` utilizando el valor base ` base`, que es 10 por defecto y debe estar comprendido entre 2 y 36, o ser 0. 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`.
Si base es 0, se utiliza la convención del lenguaje C: si la vista de la cadena comienza por «0x», se utiliza la base 16; en caso contrario, si la vista de la cadena comienza por «0», se utiliza la base 8; en caso contrario, se utiliza la base 10.
La conversión de la cadena siempre se realizará en la configuración regional «C». Para una conversión dependiente de la configuración regional, utilice QLocale::toUShort()
Esta función se introdujo en Qt 6.0.
Véase también QString::toUShort().
QList<uint> QStringView::toUcs4() const
Devuelve una representación UCS-4/UTF-32 de la vista de cadena como un valor <uint> de tipo « QList ».
UCS-4 es un códec Unicode y, por lo tanto, no presenta pérdidas. Todos los caracteres de esta vista de cadena se codificarán en UCS-4. Cualquier secuencia no válida de unidades de código en esta vista de cadena se sustituye por el carácter de sustitución de Unicode (QChar::ReplacementCharacter, que corresponde a U+FFFD).
La lista devuelta no termina en 0.
Véase también toUtf8(), toLatin1(), toLocal8Bit() y QStringEncoder.
QByteArray QStringView::toUtf8() const
Devuelve una representación UTF-8 de la vista de cadena como un objeto ` QByteArray`.
UTF-8 es un códec Unicode y puede representar todos los caracteres de una cadena Unicode, como QString.
Véase también toLatin1(), toLocal8Bit() y QStringEncoder.
qsizetype QStringView::toWCharArray(wchar_t *array) const
Transcribe esta vista de cadena en el ` array` indicado.
El autor de la llamada es responsable de garantizar que ` array ` tenga capacidad suficiente para almacenar la codificación ` wchar_t ` de esta vista de cadena (siempre basta con asignar una matriz con la misma longitud que la vista de cadena). El array se codifica en UTF-16 en plataformas donde wchar_t tiene una anchura de 2 bytes (por ejemplo, Windows); en caso contrario (sistemas Unix), se supone que wchar_t tiene una anchura de 4 bytes y los datos se escriben en UCS-4.
Nota: Esta función no escribe ningún carácter nulo al final de array.
Devuelve el número de entradas de ` wchar_t ` escritas en ` array`.
Véase también ` QString::toWCharArray()`.
[constexpr noexcept(...), since 6.0] template <typename Needle, typename... Flags> auto QStringView::tokenize(Needle &&sep, Flags... flags) const
Divide la cadena en subcadenas cada vez que aparece « sep » y devuelve una secuencia diferida de dichas cadenas.
Equivalente a
return QStringTokenizer{std::forward<Needle>(sep), flags...};, salvo que funciona sin que esté habilitada en el compilador la deducción de argumentos de plantillas de clase (CTAD) de C++17.
Consulta QStringTokenizer para ver cómo interactúan « sep » y « flags » para formar el resultado.
Nota: Aunque esta función devuelve QStringTokenizer, nunca, bajo ningún concepto, debes nombrar explícitamente sus argumentos de plantilla. Si puedes utilizar la deducción de argumentos de plantillas de clase (CTAD) de C++17, puedes escribir
QStringTokenizer result = sv.tokenize(sep);(sin argumentos de plantilla). Si no puedes utilizar la CTAD de C++17, debes almacenar el valor de retorno únicamente en variables de tipo auto:
auto result = sv.tokenize(sep);Esto se debe a que los argumentos de plantilla de ` QStringTokenizer ` tienen una dependencia muy sutil con respecto a la sobrecarga específica de ` tokenize()` desde la que se devuelven, y no suelen corresponder al tipo utilizado para el separador.
Estas funciones se introdujeron en Qt 6.0.
Nota: Esta función es «noexcept» cuando ` noexcept(qTokenize(std::declval<const QStringView&>(), std::forward<Needle>(needle), flags...)) ` es ` true`.
Véanse también QStringTokenizer y qTokenize().
[noexcept] QStringView QStringView::trimmed() const
Elimina los espacios en blanco iniciales y finales y devuelve el resultado.
Por «espacios en blanco» se entiende cualquier carácter para el que la función QChar::isSpace() devuelva true. Esto incluye los caracteres ASCII «'\t », «\n », «\v », «\f », «\r » y « ' ».
[constexpr noexcept] void QStringView::truncate(qsizetype length)
Trunca esta vista de cadena a una longitud de length.
Es lo mismo que *this = left(length).
Nota: El comportamiento es indefinido cuando length < 0 o length > size().
Véase también sliced(), left(), right(), chopped() y chop().
[constexpr noexcept] const QStringView::storage_type *QStringView::utf16() const
Devuelve un puntero const al primer carácter de la vista de cadena.
Nota: La matriz de caracteres representada por el valor devuelto no está terminada en nulo.
storage_type char16_t.
Véase también begin(), end() y data().
[constexpr noexcept, since 6.7] QStringView::operator std::u16string_view() const
Convierte este objeto ` QStringView ` en un objeto ` std::u16string_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] QChar QStringView::operator[](qsizetype n) const
Devuelve el carácter situado en la posición n en esta vista de cadena.
El comportamiento es indefinido si n es negativo o no es menor que size().
Elementos no miembros relacionados
[noexcept] size_t qHash(QStringView key, size_t seed = 0)
Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.
[noexcept] bool operator!=(const QStringView &lhs, const QStringView &rhs)
[noexcept] bool operator<(const QStringView &lhs, const QStringView &rhs)
[noexcept] bool operator<=(const QStringView &lhs, const QStringView &rhs)
[noexcept] bool operator==(const QStringView &lhs, const QStringView &rhs)
[noexcept] bool operator>(const QStringView &lhs, const QStringView &rhs)
[noexcept] bool operator>=(const QStringView &lhs, const QStringView &rhs)
Operadores para comparar lhs con rhs.
Véase también compare().
© 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.