QAnyStringView Class

Documentación de las funciones miembro

[constexpr noexcept] QAnyStringView::QAnyStringView()

Construye una vista de cadena nula.

Véase también isNull().

[constexpr noexcept] template <typename Char, QAnyStringView::if_compatible_char<Char> = true> QAnyStringView::QAnyStringView(const Char &ch)

Construye una vista de cadena en el carácter único ch. La longitud suele ser 1 (pero véase más adelante).

En general, debes asumir que un QAnyStringView así creado empezará a referenciar datos obsoletos al final de la expresión completa, cuando se borren los temporales. Esto significa que usarlo para pasar un único caracter a una función QAnyStringView está bien y es seguro (siempre que la documentación de la función no pida un tiempo de vida mayor que el de la llamada inicial):

int to_int(QAnyStringView);
int res = to_int(u'9'); // OK, data stays around for the duration of the call

Pero mantener el objeto más tiempo es un comportamiento indefinido:

QAnyStringView ch = u'9';
int res = to_int(ch); // (silent) ERROR: ch references deleted data

Si necesita esto, prefiera

const auto nine = u'9';
QAnyStringView ch(nine); // ok, references `nine`, which outlives `ch`
int res = to_int(ch); // 9

Lo anterior es válido para todos los formatos directamente compatibles con Compatible Character Types.

Si ch no es uno de estos tipos, sino que simplemente convierte a QChar, por ejemplo QChar::SpecialCharacter o QLatin1Char, el QAnyStringView se enlazará a un objeto temporal que se habrá borrado al final de la expresión completa, igual que en el segundo ejemplo.

Si ch no puede representarse en una única unidad de código UTF-16 (por ejemplo, porque se trata de un valor char32_t ), este constructor descompone ch en dos unidades de código UFT-16. El QAnyStringView resultante tendrá un size() de 2 en ese caso, y el buffer temporal en el que se almacena la descomposición se elimina al final de la expresión completa, de forma similar a

[](char32_t ch, auto &&tmp = QChar::fromUcs4(ch)) {
    return QAnyStringView(tmp);
}

La versión segura equivalente en este caso sería

const auto decomposed = QChar::fromUcs4(ch);
QAnyStringView ch(decomposed);

Véase también QChar::fromUcs4() y Compatible Character Types.

[constexpr noexcept] template <typename Char, size_t N> QAnyStringView::QAnyStringView(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 Char es un tipo de carácter compatible.

Véase también Compatible Character Types.

[constexpr noexcept] template <typename Char> QAnyStringView::QAnyStringView(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 Char es un tipo de carácter compatible.

Véase también isNull() y Compatible Character Types.

[constexpr noexcept] template <typename Container, QAnyStringView::if_compatible_container<Container> = true> QAnyStringView::QAnyStringView(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.

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

[noexcept] QAnyStringView::QAnyStringView(const QByteArray &str)

Construye una vista de cadena en str. Los datos de str se interpretan como UTF-8.

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

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

[noexcept] QAnyStringView::QAnyStringView(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] QAnyStringView::QAnyStringView(std::nullptr_t)

Construye una vista de cadena nula.

Véase también isNull().

[constexpr] template <typename Char, QAnyStringView::if_compatible_char<Char> = true> QAnyStringView::QAnyStringView(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.

Véase también isNull() y Compatible Character Types.

[constexpr] template <typename Char, QAnyStringView::if_compatible_char<Char> = true> QAnyStringView::QAnyStringView(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.

Véase también isNull() y Compatible Character Types.

[since 6.9] template <typename... Args> QString QAnyStringView::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] QChar QAnyStringView::back() const

Devuelve el último carácter de la vista de cadena.

Esta función se proporciona por compatibilidad con STL.

Véase también front() y Sizes and Sub-Strings.

[constexpr, since 6.5] void QAnyStringView::chop(qsizetype n)

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

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

Esta función se introdujo en Qt 6.5.

Véase también sliced(), first(), last(), chopped(), truncate(), slice(), y Sizes and Sub-Strings.

[constexpr, since 6.5] QAnyStringView QAnyStringView::chopped(qsizetype n) const

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

Igual que first(size() - n).

Esta función se introdujo en Qt 6.5.

Ver también sliced(), first(), last(), chop(), truncate(), slice(), y Sizes and Sub-Strings.

[static noexcept] int QAnyStringView::compare(QAnyStringView lhs, QAnyStringView rhs, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Compara la vista de cadena lhs con la vista de cadena rhs y devuelve un entero negativo si lhs es menor que rhs, un entero positivo si es mayor que rhs, 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>().

[constexpr noexcept] const void *QAnyStringView::data() const

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

Véase también size_bytes().

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

[constexpr, since 6.5] QAnyStringView QAnyStringView::first(qsizetype n) const

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

Esta función se introdujo en Qt 6.5.

Véase también last(), sliced(), chopped(), chop(), truncate(), slice(), y Sizes and Sub-Strings.

[static constexpr noexcept] template < typename Char, size_t Size, QAnyStringView::if_compatible_char<Char> = true > QAnyStringView QAnyStringView::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 QAnyStringView::front() const

Devuelve el primer carácter de la vista de cadena.

Esta función se proporciona por compatibilidad con STL.

Véase también back() y Sizes and Sub-Strings.

[constexpr noexcept] bool QAnyStringView::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(), y size().

[constexpr noexcept] bool QAnyStringView::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(), y size().

[constexpr, since 6.5] QAnyStringView QAnyStringView::last(qsizetype n) const

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

Esta función se introdujo en Qt 6.5.

Véase también first(), sliced(), chopped(), chop(), truncate(), slice(), y Sizes and Sub-Strings.

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

Igual que size().

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

Véase también size().

[constexpr noexcept, since 6.8] qsizetype QAnyStringView::max_size() const

Esta función se proporciona por compatibilidad con STL.

Devuelve el número máximo de elementos que la vista de cadena puede representar teóricamente. 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] qsizetype QAnyStringView::size() const

Devuelve el tamaño de esta vista de cadena, en los puntos de código de la codificación.

Véase también empty(), isEmpty(), isNull(), size_bytes(), y Sizes and Sub-Strings.

[constexpr noexcept] qsizetype QAnyStringView::size_bytes() const

Devuelve el tamaño de esta vista de cadena, pero en bytes, no en puntos de código.

Puede utilizar esta función junto con data() para hash o serialización.

Esta función se proporciona por compatibilidad con STL.

Véase también size() y data().

[constexpr, since 6.8] QAnyStringView &QAnyStringView::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(), truncate(), y Sizes and Sub-Strings.

[constexpr, since 6.8] QAnyStringView &QAnyStringView::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(), truncate(), y Sizes and Sub-Strings.

[constexpr, since 6.5] QAnyStringView QAnyStringView::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.5.

Ver también first(), last(), chopped(), chop(), truncate(), slice(), y Sizes and Sub-Strings.

[constexpr, since 6.5] QAnyStringView QAnyStringView::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.

Esta función se introdujo en Qt 6.5.

Véase también first(), last(), chopped(), chop(), truncate(), slice(), y Sizes and Sub-Strings.

QString QAnyStringView::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, since 6.5] void QAnyStringView::truncate(qsizetype n)

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

Igual que *this = first(n).

Esta función se introdujo en Qt 6.5.

Véase también sliced(), first(), last(), chopped(), chop(), y Sizes and Sub-Strings.

[constexpr] template <typename Visitor> decltype(auto) QAnyStringView::visit(Visitor &&v) const

Llama a v con un QUtf8StringView, QLatin1String, o QStringView, dependiendo de la codificación de los datos de cadena a los que hace referencia esta vista de cadena.

Así es como la mayoría de las funciones que toman QAnyStringView se bifurcan en funciones por codificación:

void processImpl(QLatin1String s) { ~~~ }
void processImpl(QUtf8StringView s) { ~~~ }
void processImpl(QStringView s) { ~~~ }

void process(QAnyStringView s)
{
    s.visit([](auto s) { processImpl(s); });
}

Aquí, estamos reutilizando el mismo nombre, s, tanto para el objeto QAnyStringView, como para el parámetro de la lambda. Esto es código idiomático y ayuda a rastrear la identidad de los objetos a través de llamadas a visit(), por ejemplo en situaciones más complejas como

bool equal(QAnyStringView lhs, QAnyStringView rhs)
{
    // assuming operator==(QAnyStringView, QAnyStringView) didn't, yet, exist:
    return lhs.visit([rhs](auto lhs) {
        rhs.visit([lhs](auto rhs) {
            return lhs == rhs;
        });
    });
}

visit() requiere que todas las instancias de lambda tengan el mismo tipo de retorno. Si difieren, se obtiene un error de compilación, incluso si hay un tipo común. Para solucionarlo, puedes utilizar tipos de retorno explícitos en la lambda, o hacer cast en las sentencias return:

// wrong:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) {   // ERROR: lambdas return different types
        return input.sliced(0, input.size() / 2);
    });
}
// correct:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) -> QAnyStringView { // OK, explicit return type
        return input.sliced(0, input.size() / 2);
    });
}
// also correct:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) {
        return QAnyStringView(input.sliced(0, input.size() / 2)); // OK, cast to common type
    });
}