QUtf8StringView Class

    void myfun1(QUtf8StringView sv);        // preferred
    void myfun2(const QUtf8StringView &sv); // compiles and works, but slower

Documentación de funciones miembro

[constexpr noexcept] QUtf8StringView::QUtf8StringView()

Construye una vista de cadena nula.

Véase también isNull().

[constexpr noexcept] template <typename Char, size_t N> QUtf8StringView::QUtf8StringView(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 string es un array real y si Char es un tipo de carácter compatible. Los tipos de caracteres compatibles son: char8_t, char, signed char y unsigned char.

Véase también fromArray().

[constexpr noexcept] template <typename Char> QUtf8StringView::QUtf8StringView(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 str no es una matriz y si Char es un tipo de carácter compatible. Los tipos de caracteres compatibles son: char8_t, char, signed char y unsigned char.

[constexpr noexcept] template <typename Container, QUtf8StringView::if_compatible_container<Container> = true> QUtf8StringView::QUtf8StringView(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 está 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: char8_t, char, signed char y unsigned char.

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

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

Construye una vista de cadena nula.

Véase también isNull().

[constexpr] template <typename Char, QUtf8StringView::if_compatible_char<Char> = true> QUtf8StringView::QUtf8StringView(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: char8_t, char, signed char y unsigned char.

[constexpr] template <typename Char, QUtf8StringView::if_compatible_char<Char> = true> QUtf8StringView::QUtf8StringView(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: char8_t, char, signed char y unsigned char.

[since 6.9] template <typename... Args> QString QUtf8StringView::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.

Esta función se introdujo en Qt 6.9.

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

[constexpr] QUtf8StringView::storage_type QUtf8StringView::at(qsizetype n) const

Devuelve el punto de código 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] QUtf8StringView::storage_type QUtf8StringView::back() const

Devuelve el último punto de código en la vista de cadena. Igual que last().

Esta función se proporciona por compatibilidad con STL.

Véase también front().

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

Devuelve un iterador const de estilo STL que apunta al primer punto de código en la vista de cadena.

Esta función se proporciona por compatibilidad con STL.

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

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

Igual que begin().

Esta función se proporciona por compatibilidad con STL.

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

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

Igual que end().

Esta función se proporciona por compatibilidad con STL.

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

[constexpr] void QUtf8StringView::chop(qsizetype n)

Trunca esta vista de cadena en n puntos de código.

Igual que *this = first(size() - n).

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

[constexpr] QUtf8StringView QUtf8StringView::chopped(qsizetype n) const

Devuelve la subcadena de longitud size() - n que comienza al principio de este objeto.

Igual que first(size() - n).

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

Compara esta vista de cadena con 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.

Estas funciones se introdujeron en Qt 6.5.

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

Igual que rbegin().

Esta función se proporciona por compatibilidad con STL.

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

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

Igual que rend().

Esta función se proporciona por compatibilidad con STL.

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

[constexpr noexcept] QUtf8StringView::const_pointer QUtf8StringView::data() const

Devuelve un puntero constante al primer punto de código de la vista de cadena.

Véase también begin(), end() y utf8().

[constexpr noexcept] bool QUtf8StringView::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] QUtf8StringView::const_iterator QUtf8StringView::end() const

Devuelve un iterador constante de estilo STL que apunta al punto de código imaginario después del último punto de código de la lista.

Esta función se proporciona por compatibilidad con STL.

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

[constexpr] QUtf8StringView QUtf8StringView::first(qsizetype n) const

Devuelve una vista de cadena que contiene los primeros puntos de código n de esta vista de cadena.

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

[static constexpr noexcept] template < typename Char, size_t Size, QUtf8StringView::if_compatible_char<Char> = true > QUtf8StringView QUtf8StringView::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: char8_t, char, signed char y unsigned char.

[constexpr] QUtf8StringView::storage_type QUtf8StringView::front() const

Devuelve el primer punto de código en la vista de cadena. Igual que first().

Esta función se proporciona por compatibilidad con STL.

Véase también back().

[constexpr noexcept] bool QUtf8StringView::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().

[constexpr noexcept] bool QUtf8StringView::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, since 6.3] bool QUtf8StringView::isValidUtf8() const

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

Esta función se introdujo en Qt 6.3.

[constexpr] QUtf8StringView QUtf8StringView::last(qsizetype n) const

Devuelve una vista de cadena que contiene los últimos puntos de código n de esta vista de cadena.

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

[constexpr noexcept] qsizetype QUtf8StringView::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().

[static constexpr noexcept, since 6.8] qsizetype QUtf8StringView::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 QUtf8StringView::max_size() const

Esta función se proporciona por compatibilidad con STL.

Devuelve maxSize().

Esta función se introdujo en Qt 6.8.

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

Devuelve un iterador inverso de estilo STL que apunta al primer punto de código en 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] QUtf8StringView::const_reverse_iterator QUtf8StringView::rend() const

Devuelve un iterador inverso estilo STL que apunta a uno pasado el último punto de código en 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 QUtf8StringView::size() const

Devuelve el tamaño de esta vista de cadena, en puntos de código UTF-8 (es decir, las secuencias multibyte cuentan como más de una a efectos de esta función, igual que los pares sustitutos en QString y QStringView).

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

[constexpr, since 6.8] QUtf8StringView &QUtf8StringView::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] QUtf8StringView &QUtf8StringView::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] QUtf8StringView QUtf8StringView::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.

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

[constexpr] QUtf8StringView QUtf8StringView::sliced(qsizetype pos, qsizetype n) const

Devuelve una vista de cadena que contiene n puntos de código de esta vista de cadena, comenzando en la posición pos.

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

QString QUtf8StringView::toString() const

Devuelve una copia profunda de los datos de esta vista de cadena como QString.

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

[constexpr] void QUtf8StringView::truncate(qsizetype n)

Trunca esta vista de cadena a n puntos de código.

Igual que *this = first(n).

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

[noexcept] const char8_t *QUtf8StringView::utf8() const

Devuelve un puntero constante al primer punto de código de la vista de cadena.

El resultado se devuelve como const char8_t*, por lo que esta función sólo está disponible cuando se compila en modo C++20.

Véase también begin(), end(), y data().

[noexcept, since 6.7] QUtf8StringView::operator std::string_view() const

Convierte este objeto QUtf8StringView en un objeto std::string_view. La vista devuelta tendrá el mismo puntero de datos y longitud que esta vista.

Esta función se introdujo en Qt 6.7.

[noexcept, since 6.10] QUtf8StringView::operator std::u8string_view() const

Convierte este objeto QUtf8StringView en un objeto std::u8string_view. La vista devuelta tendrá el mismo puntero de datos y longitud que esta vista.

Esta función sólo está disponible cuando se compila en modo C++20.

Esta función se introdujo en Qt 6.10.

[constexpr] QUtf8StringView::storage_type QUtf8StringView::operator[](qsizetype n) const

Devuelve el punto de código 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().