QLatin1StringView Class

Documentación de funciones miembro

[constexpr noexcept] QLatin1StringView::QLatin1StringView()

Construye un objeto QLatin1StringView que almacena un nullptr.

Ver también data(), isEmpty(), isNull(), y Distinction Between Null and Empty Strings.

[explicit constexpr noexcept, since 6.3] QLatin1StringView::QLatin1StringView(QByteArrayView str)

Construye un objeto QLatin1StringView como vista en str.

Los datos de la cadena no se copian. Quien llama debe poder garantizar que los datos a los que apunta str no se borrarán ni modificarán mientras exista el objeto QLatin1StringView. El tamaño se obtiene de str tal cual, sin comprobar si hay un terminador nulo.

Esta función se introdujo en Qt 6.3.

Véase también latin1().

[explicit noexcept] QLatin1StringView::QLatin1StringView(const QByteArray &str)

Construye un objeto QLatin1StringView como vista en str.

Los datos de la cadena no se copian. El invocador debe ser capaz de garantizar que str no será borrado o modificado mientras exista el objeto QLatin1StringView.

Véase también latin1().

[explicit constexpr noexcept] QLatin1StringView::QLatin1StringView(const char *str)

Construye un objeto QLatin1StringView que almacena str.

Los datos de la cadena no se copian. El invocador debe ser capaz de garantizar que str no será borrado o modificado mientras exista el objeto QLatin1StringView.

Véase también latin1().

[constexpr noexcept, since 6.4] QLatin1StringView::QLatin1StringView(std::nullptr_t)

Construye un objeto QLatin1StringView que almacena un nullptr.

Esta función se introdujo en Qt 6.4.

Ver también data(), isEmpty(), isNull(), y Distinction Between Null and Empty Strings.

[constexpr] QLatin1StringView::QLatin1StringView(const char *first, const char *last)

Construye un objeto QLatin1StringView que almacena first con longitud (last - first).

El rango [first,last) debe permanecer válido durante la vida de este objeto Latin-1 string.

Pasar nullptr como first es seguro si last es nullptr, también, y resulta en una cadena Latin-1 nula.

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

[constexpr noexcept] QLatin1StringView::QLatin1StringView(const char *str, qsizetype size)

Construye un objeto QLatin1StringView que almacena str con size.

Los datos de la cadena no se copian. El invocador debe ser capaz de garantizar que str no será borrado o modificado mientras exista el objeto QLatin1StringView.

Véase también latin1().

template <typename... Args> QString QLatin1StringView::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] QLatin1Char QLatin1StringView::at(qsizetype pos) const

Devuelve el carácter en la posición pos de este objeto.

Véase también operator[]().

[constexpr] QLatin1Char QLatin1StringView::back() const

Devuelve el último carácter de la cadena. Igual que at(size() - 1).

Esta función se proporciona por compatibilidad con STL.

Véase también front(), at(), y operator[]().

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::begin() const

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

Esta función se proporciona por compatibilidad con STL.

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

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::cbegin() const

Igual que begin().

Esta función se proporciona por compatibilidad con STL.

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

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::cend() const

Igual que end().

Esta función se proporciona por compatibilidad con STL.

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

[constexpr] void QLatin1StringView::chop(qsizetype length)

Trunca esta cadena en length caracteres.

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

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

[constexpr] QLatin1StringView QLatin1StringView::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(), first(), last(), chop(), truncate(), y slice().

Compara esta vista de cadena con la vista de cadena UTF-16 str, la vista de cadena Latin-1 l1, o el carácter ch, respectivamente. Devuelve un entero negativo si esta cadena es menor que str, l1 o ch, devuelve un entero positivo si es mayor que str, l1 o ch, y cero si son iguales.

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 operator==(), operator<() y operator>().

[noexcept, since 6.5] int QLatin1StringView::compare(QUtf8StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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.

Esta función se introdujo en Qt 6.5.

Véase también operator==(), operator<() y operator>().

[constexpr noexcept, since 6.4] const char *QLatin1StringView::constBegin() const

Igual que begin().

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

Esta función se introdujo en Qt 6.4.

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

[constexpr noexcept, since 6.4] const char *QLatin1StringView::constData() const

Devuelve el inicio de la cadena Latin-1 referenciada por este objeto.

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

Esta función se introdujo en Qt 6.4.

Véase también data().

[constexpr noexcept, since 6.4] const char *QLatin1StringView::constEnd() const

Igual que end().

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

Esta función se introdujo en Qt 6.4.

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

Devuelve true si esta vista de cadena Latin-1 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(), QStringView::contains(), QStringView::indexOf() y QString::indexOf().

Devuelve el número de apariciones (potencialmente solapadas) 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.

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

Véase también contains() y indexOf().

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

Igual que rbegin().

Esta función se proporciona por compatibilidad con STL.

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

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

Igual que rend().

Esta función se proporciona por compatibilidad con STL.

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

[constexpr noexcept] const char *QLatin1StringView::data() const

Devuelve el inicio de la cadena Latin-1 referenciada por este objeto.

[constexpr noexcept, since 6.4] bool QLatin1StringView::empty() const

Devuelve si la cadena Latin-1 referenciada por este objeto está vacía (size() == 0) o no.

Esta función se proporciona por compatibilidad con STL.

Esta función se introdujo en Qt 6.4.

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

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::end() const

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

Esta función se proporciona por compatibilidad con STL.

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

Devuelve true si esta vista de cadena Latin-1 termina con la cadena UTF-16 vista 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, since 6.4] QLatin1Char QLatin1StringView::first() const

Devuelve el primer carácter de la cadena. Igual que at(0) o front().

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

Esta función se introdujo en Qt 6.4.

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

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::first(qsizetype n) const

Devuelve una vista de cadena Latin-1 que contiene los primeros n caracteres de esta vista de cadena.

Esta función se introdujo en Qt 6.0.

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

[constexpr] QLatin1Char QLatin1StringView::front() const

Devuelve el primer carácter de la cadena. Igual que at(0).

Esta función se proporciona por compatibilidad con STL.

Véase también back(), at(), y operator[]().

Devuelve la posición de índice en esta vista de cadena Latin-1 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, buscando hacia adelante desde la posición de índice from. Devuelve -1 si no se encuentra str, l1 o c, 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().

[constexpr noexcept] bool QLatin1StringView::isEmpty() const

Devuelve si la cadena Latin-1 referenciada por este objeto está vacía (size() == 0) o no.

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

[constexpr noexcept] bool QLatin1StringView::isNull() const

Devuelve si la cadena Latin-1 referenciada por este objeto es nula (data() == nullptr) o no.

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

[constexpr, since 6.4] QLatin1Char QLatin1StringView::last() const

Devuelve el último carácter de la cadena. Igual que at(size() - 1) o back().

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

Esta función se introdujo en Qt 6.4.

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

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::last(qsizetype n) const

Devuelve una vista de cadena Latin-1 que contiene los últimos n caracteres de esta vista de cadena.

Esta función se introdujo en Qt 6.0.

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

Devuelve la posición de índice en esta vista de cadena Latin-1 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, buscando hacia atrás desde la posición de índice from; devuelve -1 si no se encuentra str, l1 o ch, respectivamente.

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.

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(), QStringView::lastIndexOf(), QStringView::indexOf() y QString::indexOf().

Devuelve la posición del índice en esta vista de cadena Latin-1 de la última aparición de la cadena UTF-16 vista por str o la cadena Latin-1 vista por l1, respectivamente. 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.

[constexpr noexcept] const char *QLatin1StringView::latin1() const

Devuelve el inicio de la cadena Latin-1 referenciada por este objeto.

[constexpr] QLatin1StringView QLatin1StringView::left(qsizetype length) const

Si sabe que length no puede estar fuera de los límites, utilice first() en su lugar en el código nuevo, porque es más rápido.

Devuelve la subcadena de longitud length que comienza en la posición 0 de esta vista de cadena Latin-1.

Se devuelve toda la vista de cadena Latin-1 si length es mayor o igual que size(), o menor que cero.

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

[constexpr noexcept, since 6.4] qsizetype QLatin1StringView::length() const

Igual que size().

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

Esta función se introdujo en Qt 6.4.

[static constexpr noexcept, since 6.8] qsizetype QLatin1StringView::maxSize()

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

Esta función se proporciona por compatibilidad con STL.

Devuelve maxSize().

Esta función se introdujo en Qt 6.8.

[constexpr] QLatin1StringView QLatin1StringView::mid(qsizetype start, qsizetype length = -1) const

Devuelve la subcadena de longitud length que comienza en la posición start en esta vista de cadena Latin-1.

Si sabe que start y length no pueden estar fuera de los límites, utilice sliced() en su lugar en código nuevo, porque es más rápido.

Devuelve una vista de cadena Latin-1 vacía si start excede la longitud de esta vista de cadena. Si hay menos de length caracteres disponibles en esta vista de cadena a partir de start, o si length es negativo (por defecto), la función devuelve todos los caracteres disponibles a partir de start.

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

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

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

Esta función se proporciona por compatibilidad con STL.

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

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

Devuelve un iterador inverso estilo STL que apunta justo después del último carácter de la cadena, en orden inverso.

Esta función se proporciona por compatibilidad con STL.

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

[constexpr] QLatin1StringView QLatin1StringView::right(qsizetype length) const

Si sabe que length no puede estar fuera de los límites, utilice last() en su lugar en el código nuevo, porque es más rápido.

Devuelve la subcadena de longitud length que comienza en la posición size() - length en esta vista de cadena Latin-1.

Se devuelve toda la vista de cadena Latin-1 si length es mayor o igual que size(), o menor que cero.

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

[constexpr noexcept] qsizetype QLatin1StringView::size() const

Devuelve el tamaño de la cadena Latin-1 referenciada por este objeto.

[constexpr, since 6.8] QLatin1StringView &QLatin1StringView::slice(qsizetype pos)

Modifica esta vista de cadena Latin-1 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, since 6.8] QLatin1StringView &QLatin1StringView::slice(qsizetype pos, qsizetype n)

Modifica esta vista de cadena Latin-1 para que comience en la posición pos, extendiéndose para los caracteres n.

Esta función se introdujo en Qt 6.8.

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

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::sliced(qsizetype pos) const

Devuelve una vista de cadena Latin-1 comenzando en la posición pos en esta vista de cadena, y extendiéndose hasta su final.

Esta función se introdujo en Qt 6.0.

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

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::sliced(qsizetype pos, qsizetype n) const

Devuelve una vista de cadena Latin-1 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().

Devuelve true si esta vista de cadena Latin-1 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().

Devuelve este QLatin1StringView convertido a un valor de coma flotante correspondiente.

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.

Esta función ignora los caracteres de espaciado inicial y final.

Estas funciones se introdujeron en Qt 6.4.

Devuelve este QLatin1StringView convertido a un valor numérico correspondiente utilizando la base base, que es diez por defecto. Se admiten las bases 0 y 2 hasta 36, utilizando letras para los dígitos más allá de 9; A es diez, B es once y así sucesivamente.

Si base es 0, la base se determina automáticamente usando las siguientes reglas (en este orden), si la vista de la cadena Latin-1 empieza por:

• "0x", el resto se lee como hexadecimal (base 16)
• "0b"el resto se lee en binario (base 2)
• "0"el resto se lee en octal (base 8)
• en caso contrario se lee como decimal

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.

Esta función ignora los caracteres de espaciado inicial y final.

Estas funciones se introdujeron en Qt 6.4.

[since 6.0] QString QLatin1StringView::toString() const

Convierte esta cadena Latin-1 en QString. Equivalente a

return QString(*this);

Esta función se introdujo en Qt 6.0.

Véase también toUtf8().

[since 6.9] QByteArray QLatin1StringView::toUtf8() const

Devuelve una representación UTF-8 de la cadena como QByteArray. Esta función es más eficiente que convertir primero a QString.

Esta función se introdujo en Qt 6.9.

Véase también toString() y QString::toUtf8().

[constexpr noexcept(...), since 6.0] template <typename Needle, typename... Flags> auto QLatin1StringView::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] QLatin1StringView QLatin1StringView::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] void QLatin1StringView::truncate(qsizetype length)

Trunca esta cadena a la longitud length.

Igual que *this = left(length).

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

[constexpr] QLatin1Char QLatin1StringView::operator[](qsizetype pos) const

Devuelve el carácter en la posición pos de este objeto.

Véase también at().