QStringView Class

Documentación de funciones miembro

[constexpr noexcept] QStringView::QStringView()

Construye una vista de cadena nula.

Véase también isNull().

[constexpr noexcept] template <typename Char, size_t N> QStringView::QStringView(const Char (&)[N] string)

Construye una vista de cadena sobre la cadena de caracteres literal string. La vista cubre el array hasta que se encuentra el primer Char(0), o N, lo que ocurra primero. Si necesita el array completo, utilice fromArray() en su lugar.

string debe permanecer válida durante el tiempo de vida de este objeto vista de cadena.

Restricciones

Participa en la resolución de sobrecargas sólo si Char es un tipo de carácter compatible. Los tipos de caracteres 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)

Construye una vista de cadena en str. La longitud se determina buscando la primera Char(0).

str debe permanecer válida durante el tiempo de vida de este objeto string view.

Pasar nullptr como str es seguro y da como resultado una vista de cadena nula.

Restricciones

Participa en la resolución de sobrecargas sólo si Char es un tipo de carácter compatible. Los tipos de caracteres 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)

Construye una vista de cadena en str. La longitud se toma de std::size(str).

std::data(str) debe permanecer válida durante el tiempo de vida de este objeto string view.

La vista de cadena estará vacía si y sólo si std::size(str) == 0. No se ha especificado si este constructor puede dar como resultado una vista de cadena nula (std::data(str) tendría que devolver nullptr para ello).

Restricciones

Participa en la resolución de sobrecargas sólo si Container es un contenedor con un tipo de carácter compatible como value_type. Los tipos de caracteres 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)

Construye una vista de cadena en str.

str.data() debe permanecer válida durante el tiempo de vida de este objeto string view.

La vista de cadena será nula si y sólo si str.isNull().

[constexpr noexcept] QStringView::QStringView(std::nullptr_t)

Construye 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)

Construye una vista de cadena en first con longitud (last - first).

El rango [first,last) debe permanecer válido durante el tiempo de vida de este objeto string view.

Pasar \nullptr como first es seguro si last es nullptr, también, y resulta en una vista de cadena nula.

El comportamiento es indefinido si last precede a first, o first es nullptr y last no lo es.

Restricciones

Participa en la resolución de sobrecargas sólo si Char es un tipo de carácter compatible. Los tipos de caracteres 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)

Construye una vista de cadena en str con la longitud len.

El rango [str,len) debe permanecer válido durante el tiempo de vida de este objeto string view.

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 sobrecargas sólo si Char es un tipo de carácter compatible. Los tipos de caracteres 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 los args sustituye al %N por el N más bajo (todos ellos), el segundo de los args al %N por el N inmediatamente inferior, etc.

Args puede consistir en cualquier cosa que implícitamente se convierta a QAnyStringView.

Véase también QString::arg().

[constexpr noexcept] QChar QStringView::at(qsizetype n) const

Devuelve el carácter en la posición n en esta vista de cadena.

El comportamiento es indefinido si n es negativo o no 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. Igual que last().

Esta función se proporciona por compatibilidad con STL.

Véase también front(), first(), y last().

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

Devuelve un iterador const de estilo STL que apunta al primer carácter de la vista de cadena.

Esta función se proporciona por compatibilidad con STL.

Véase también end(), constBegin(), cbegin(), rbegin() y data().

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

Igual que begin().

Esta función se proporciona por compatibilidad con STL.

Véase también cend(), begin(), constBegin(), crbegin() y data().

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

Igual que end().

Esta función se proporciona por compatibilidad con STL.

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

[constexpr noexcept] void QStringView::chop(qsizetype length)

Trunca esta vista de cadena en length caracteres.

Igual que *this = left(size() - length).

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 que comienza al principio de este objeto.

Igual que left(size() - length).

Véase también sliced(), left(), right(), chop(), truncate(), y slice().

Compara esta vista de cadena con la vista de cadena Latin-1 l1, o 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 (por defecto), la comparación distingue entre mayúsculas y minúsculas; en caso contrario, la comparación no distingue entre mayúsculas y minúsculas.

Véase 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, la comparación 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 (por defecto), la comparación distingue entre mayúsculas y minúsculas; en caso contrario, la comparación 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

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 constante al primer carácter de la vista de cadena.

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

Igual que end().

Esta función se introdujo en Qt 6.1.

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

Devuelve true si esta vista de cadena contiene una ocurrencia de la cadena UTF-16 vista por str, la cadena Latin-1 vista por l1, o el carácter ch respectivamente; en caso contrario devuelve false.

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.

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 lugar de esta vista de cadena; en caso contrario devuelve false.

Si la coincidencia es correcta y rmatch no es nullptr, también escribe los resultados de la coincidencia en el objeto QRegularExpressionMatch apuntado por 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 razones históricas, esta función cuenta las coincidencias solapadas. Este comportamiento es diferente de simplemente iterar sobre las coincidencias en la vista de cadena usando 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 apariciones del carácter ch en la vista de cadena.

Si cs es Qt::CaseSensitive (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.

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 ocurrencias (potencialmente solapadas) de la cadena Latin-1 vista por l1 en esta vista de cadena.

Si cs es Qt::CaseSensitive (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.

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 (potencialmente solapadas) de la vista de cadena str en esta vista de cadena.

Si cs es Qt::CaseSensitive (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.

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

Igual que rbegin().

Esta función se proporciona por compatibilidad con STL.

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

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

Igual que rend().

Esta función se proporciona por compatibilidad con STL.

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

[noexcept] QStringView::const_pointer QStringView::data() const

Devuelve un puntero constante al primer carácter de la vista de cadena.

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 por compatibilidad con STL.

Véase también isEmpty(), isNull(), size() y length().

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

Devuelve un iterador const de estilo STL que apunta al carácter imaginario después del último carácter de la lista.

Esta función se proporciona por compatibilidad con STL.

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

Devuelve true si esta vista de cadena termina con la cadena UTF-16 vista por str, la cadena Latin-1 vista por l1, o el carácter ch respectivamente; en caso contrario devuelve false.

Si cs es Qt::CaseSensitive (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 startsWith().

[constexpr] QChar QStringView::first() const

Devuelve el primer carácter de la cadena vista. Igual que front().

Esta función se proporciona por compatibilidad con otros contenedores Qt.

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.

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 (&)[Size] string)

Construye una vista de cadena en la cadena de caracteres completa literal string, incluyendo cualquier final Char(0). Si no desea incluir el terminador nulo en la vista, puede eliminarlo en chop() cuando esté seguro de que se encuentra al final. Alternativamente, puede utilizar la sobrecarga del constructor tomando un literal de matriz que creará una vista hasta, pero sin incluir, el primer terminador nulo de los datos.

string debe permanecer válido durante el tiempo de vida 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 caracteres 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 cadena vista. Igual que first().

Esta función se proporciona por compatibilidad con STL.

Véase también back(), first(), y last().

Devuelve la posición del í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 desde la posición del índice from. Devuelve -1 si no se encuentra str, l1 o ch, respectivamente.

Si cs es Qt::CaseSensitive (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.

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 del índice de la primera coincidencia de la expresión regular re en la vista de cadena, buscando hacia adelante desde la posición del índice from. Devuelve -1 si re no coincide en ninguna parte.

Si la coincidencia tiene éxito y rmatch no es nullptr, también escribe los resultados de la coincidencia en el objeto QRegularExpressionMatch apuntado por rmatch.

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 por compatibilidad con otros contenedores 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 plegado en minúsculas.

Tenga en cuenta que esto no significa que la vista de cadena no contenga letras mayúsculas (algunas letras mayúsculas no tienen un plegado en minúsculas; son dejadas sin cambios por toString().toLower()). Para más información, consulte el estándar Unicode, sección 3.13.

Esta función se introdujo en Qt 6.7.

Véase 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 por compatibilidad con otros contenedores 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 plegado en mayúsculas.

Tenga en cuenta que esto no significa que la vista de cadena no contenga letras minúsculas (algunas letras minúsculas no tienen un plegado en mayúsculas; toString().toUpper() las deja sin cambios). Para más información, consulte el estándar Unicode, sección 3.13.

Esta función se introdujo en Qt 6.7.

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

[noexcept] bool QStringView::isValidUtf16() const

Devuelve true si la vista de cadena contiene datos codificados en UTF-16 válidos, o false en caso contrario.

Tenga 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 asume que los datos están en el orden de bytes del host; la presencia de un BOM no tiene sentido.

Véase también QString::isValidUtf16().

[constexpr] QChar QStringView::last() const

Devuelve el último carácter de la vista de cadena. Igual que back().

Esta función se proporciona por compatibilidad con otros contenedores Qt.

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.

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 del índice de la última coincidencia de la expresión regular re en la vista de cadena. Devuelve -1 si re no coincide en ninguna parte.

Si la coincidencia es correcta y rmatch no es nullptr, también escribe los resultados de la coincidencia en el objeto QRegularExpressionMatch apuntado por rmatch.

Esta función se introdujo en Qt 6.2.

Devuelve la posición del índice de la última 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 atrás desde la posición del índice from.

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

Devuelve -1 si no se encuentra str, l1 o ch, respectivamente.

Si cs es Qt::CaseSensitive (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 QString::lastIndexOf().

[since 6.1] qsizetype QStringView::lastIndexOf(const QRegularExpression &re, qsizetype from, QRegularExpressionMatch *rmatch = nullptr) const

Devuelve la posición del índice de la última coincidencia de la expresión regular re en la vista de cadena, que comienza antes de la posición del índice from.

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

Devuelve -1 si re no coincide en ninguna parte.

Si la coincidencia tiene éxito y rmatch no es nullptr, también escribe los resultados de la coincidencia en el objeto QRegularExpressionMatch apuntado por rmatch.

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 se introdujo en Qt 6.3.

Devuelve la posición del índice de la última aparición de la cadena UTF-16 vista por str o la cadena Latin-1 vista por l1 respectivamente, en esta vista de cadena buscando hacia atrás desde el último carácter de esta vista de cadena. Devuelve -1 si no se encuentra str o l1, respectivamente.

Si cs es Qt::CaseSensitive (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.

Estas funciones se introdujeron en Qt 6.2.

Véase también QString::lastIndexOf().

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

Igual que size().

Esta función se proporciona por compatibilidad con otros contenedores Qt.

Véase 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 localización y de la plataforma. Utilice esta función para presentar listas ordenadas de cadenas al usuario.

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 teóricamente puede representar la vista. En la práctica, el número puede ser mucho menor, 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 por compatibilidad con STL.

Devuelve maxSize().

Esta función se introdujo en Qt 6.8.

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

Devuelve un iterador inverso de estilo STL que apunta al primer carácter de la vista de cadena, en orden inverso.

Esta función se proporciona por compatibilidad con STL.

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

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

Devuelve un iterador inverso estilo STL que apunta al último carácter de la vista de cadena, en orden inverso.

Esta función se proporciona por compatibilidad con 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, igual que en QString).

Véase 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, extendiéndose para los puntos de código n.

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, extendiéndose hasta su final.

Esta función se introdujo en Qt 6.8.

Ver 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, comenzando en la posición pos.

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 en este objeto, y se extiende hasta su final.

Esta función se introdujo en Qt 6.0.

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

Divide la vista en vistas de subcadenas dondequiera que aparezca sep, y devuelve la lista de esas vistas de cadenas.

Véase QString::split() para saber cómo interactúan sep, behavior y cs para formar el resultado.

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 vistas de subcadenas dondequiera que coincida la expresión regular re, y devuelve la lista de esas cadenas. Si re no coincide en ninguna parte de la cadena, split() devuelve una lista de un solo elemento que contiene esta cadena como vista.

Esta función se introdujo en Qt 6.0.

Devuelve true si esta vista de cadena comienza con la cadena UTF-16 vista por str, la cadena Latin-1 vista por l1, o el carácter ch respectivamente; en caso contrario devuelve false.

Si cs es Qt::CaseSensitive (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 llamante es el propietario de la CFString y es responsable de liberarla.

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 double.

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

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

Por razones históricas, esta función no maneja separadores de grupos de miles. Si necesita convertir tales números, utilice 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 float.

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

Si ok no es nullptr, se informa del fallo estableciendo *ok en false, y del é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 localización 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 usando la base base, que es 10 por defecto y debe estar entre 2 y 36, o 0. Devuelve 0 si la conversión falla.

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

Si base es 0, se utiliza la convención del lenguaje C: si la vista de cadena empieza por "0x", se utiliza base 16; en caso contrario, si la vista de cadena empieza por "0", se utiliza base 8; en caso contrario, se utiliza base 10.

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::toInt()

Esta función se introdujo en Qt 6.0.

Véase también QString::toInt().

QByteArray QStringView::toLatin1() const

Devuelve una representación Latin-1 de la cadena como QByteArray.

El comportamiento es indefinido si la cadena contiene caracteres no latinos1.

Véase también toUtf8(), toLocal8Bit() y QStringEncoder.

QByteArray QStringView::toLocal8Bit() const

Devuelve una representación local de 8 bits de la cadena como QByteArray.

En sistemas Unix equivale a toUtf8(), en Windows se utiliza la página de código 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 long usando la base base, que es 10 por defecto y debe estar entre 2 y 36, o 0. Devuelve 0 si la conversión falla.

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

Si base es 0, se utiliza la convención del lenguaje C: si la vista de cadena empieza por "0x", se utiliza base 16; en caso contrario, si la vista de cadena empieza por "0", se utiliza base 8; en caso contrario, se utiliza base 10.

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::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 long long usando la base base, que es 10 por defecto y debe estar entre 2 y 36, o 0. Devuelve 0 si la conversión falla.

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

Si base es 0, se utiliza la convención del lenguaje C: si la vista de cadena empieza por "0x", se utiliza base 16; en caso contrario, si la vista de cadena empieza por "0", se utiliza base 8; en caso contrario, se utiliza base 10.

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::toLongLong()

Esta función se introdujo en Qt 6.0.

Véase también QString::toLongLong().

[since 6.0] NSString *QStringView::toNSString() const

Crea una cadena NSString a partir de este QStringView.

La cadena NSString se libera automáticamente.

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 short usando la base base, que es 10 por defecto y debe estar entre 2 y 36, o 0. Devuelve 0 si la conversión falla.

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

Si base es 0, se utiliza la convención del lenguaje C: si la vista de cadena empieza por "0x", se utiliza base 16; en caso contrario, si la vista de cadena empieza por "0", se utiliza base 8; en caso contrario, se utiliza base 10.

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::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 QString.

El valor devuelto será null QString si y sólo si esta vista de cadena es null.

[since 6.0] uint QStringView::toUInt(bool *ok = nullptr, int base = 10) const

Devuelve la vista de cadena convertida a un unsigned int usando la base base, que es 10 por defecto y debe estar entre 2 y 36, o 0. Devuelve 0 si la conversión falla.

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

Si base es 0, se utiliza la convención del lenguaje C: si la vista de cadena empieza por "0x", se utiliza base 16; en caso contrario, si la vista de cadena empieza por "0", se utiliza base 8; en caso contrario, se utiliza base 10.

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::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 usando la base base, que es 10 por defecto y debe estar entre 2 y 36, o 0. Devuelve 0 si la conversión falla.

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

Si base es 0, se utiliza la convención del lenguaje C: si la vista de cadena empieza por "0x", se utiliza base 16; en caso contrario, si la vista de cadena empieza por "0", se utiliza base 8; en caso contrario, se utiliza base 10.

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::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 usando la base base, que es 10 por defecto y debe estar entre 2 y 36, o 0. Devuelve 0 si la conversión falla.

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

Si base es 0, se utiliza la convención del lenguaje C: si la vista de cadena empieza por "0x", se utiliza base 16; en caso contrario, si la vista de cadena empieza por "0", se utiliza base 8; en caso contrario, se utiliza base 10.

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::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 usando la base base, que es 10 por defecto y debe estar entre 2 y 36, o 0. Devuelve 0 si la conversión falla.

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

Si base es 0, se utiliza la convención del lenguaje C: si la vista de cadena empieza por "0x", se utiliza base 16; en caso contrario, si la vista de cadena empieza por "0", se utiliza base 8; en caso contrario, se utiliza base 10.

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::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 QList<uint>.

UCS-4 es un códec Unicode y, por lo tanto, no tiene 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 Unicode (QChar::ReplacementCharacter, que corresponde a U+FFFD).

La lista devuelta no está terminada 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 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 dado.

La persona que llama es responsable de asegurarse de que array es lo suficientemente grande como para contener la codificación wchar_t de esta vista de cadena (asignar la matriz con la misma longitud que la vista de cadena es siempre suficiente). La matriz se codifica en UTF-16 en plataformas en las que wchar_t tiene 2 bytes de ancho (por ejemplo, Windows); en caso contrario (sistemas Unix), se asume que wchar_t tiene 4 bytes de ancho y los datos se escriben en UCS-4.

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 allí donde aparece sep y devuelve una secuencia perezosa de esas cadenas.

Equivalente a

return QStringTokenizer{std::forward<Needle>(sep), flags...};

excepto que funciona sin C++17 Class Template Argument Deduction (CTAD) habilitado en el compilador.

Véase QStringTokenizer para saber cómo interactúan sep y flags para formar el resultado.

QStringTokenizer result = sv.tokenize(sep);

(sin argumentos de plantilla). Si no puedes usar C++17 CTAD, debes almacenar el valor de retorno sólo en variables auto:

auto result = sv.tokenize(sep);

Esto se debe a que los argumentos de plantilla de QStringTokenizer tienen una dependencia muy sutil de la sobrecarga específica tokenize() desde la que se devuelven, y no suelen corresponderse con el tipo utilizado para el separador.

Esta función se introdujo en Qt 6.0.

Véase también QStringTokenizer y qTokenize().

[noexcept] QStringView QStringView::trimmed() const

Elimina los espacios en blanco iniciales y finales y devuelve el resultado.

Por espacio en blanco se entiende cualquier carácter para el que 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 la longitud length.

Igual que *this = left(length).

Véase también sliced(), left(), right(), chopped() y chop().

[constexpr noexcept] const QStringView::storage_type *QStringView::utf16() const

Devuelve un puntero constante al primer carácter de la vista de cadena.

storage_type es 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 longitud de esta vista.

Esta función se introdujo en Qt 6.7.

[constexpr] QChar QStringView::operator[](qsizetype n) const

Devuelve el carácter en la posición n en esta vista de cadena.

El comportamiento es indefinido si n es negativo o no menor que size().

Véase también at(), front(), y back().