En esta página

QStringRef Class

La clase QStringRef proporciona una capa de abstracción ligera para las subcadenas de « QString ». Más información...

Encabezado: #include <QStringRef>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core5Compat)
target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)
qmake: QT += core5compat

Nota: Todas las funciones de esta clase son reentrantes.

Tipos públicos

Funciones públicas

QStringRef()
QStringRef(const QString *string)
QStringRef(const QString *string, qsizetype position, qsizetype length)
QStringRef(const QStringRef &other)
~QStringRef()
QStringRef appendTo(QString *string) const
const QChar at(int position) const
QChar back() const
QStringRef::const_iterator begin() const
QStringRef::const_iterator cbegin() const
QStringRef::const_iterator cend() const
void chop(int n)
QStringRef chopped(int len) const
void clear()
int compare(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int compare(QLatin1String other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int compare(const QByteArray &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int compare(const QString &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int compare(const QStringRef &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QStringRef::const_iterator constBegin() const
const QChar *constData() const
QStringRef::const_iterator constEnd() const
bool contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int count() const
int count(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int count(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QStringRef::const_reverse_iterator crbegin() const
QStringRef::const_reverse_iterator crend() const
const QChar *data() const
QStringRef::const_iterator end() const
bool endsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool endsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool endsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool endsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool endsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QChar front() const
int indexOf(QLatin1String str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int indexOf(const QString &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int indexOf(QChar ch, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int indexOf(QStringView str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int indexOf(const QStringRef &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool isEmpty() const
bool isNull() const
bool isRightToLeft() const
int lastIndexOf(const QString &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int lastIndexOf(QChar ch, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int lastIndexOf(QLatin1String str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int lastIndexOf(QStringView str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
int lastIndexOf(const QStringRef &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QStringRef left(int n) const
int length() const
int localeAwareCompare(const QString &other) const
int localeAwareCompare(const QStringRef &other) const
QStringRef mid(int position, int n = -1) const
int position() const
QStringRef::const_reverse_iterator rbegin() const
QStringRef::const_reverse_iterator rend() const
QStringRef right(int n) const
int size() const
QList<QStringRef> split(const QString &sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QList<QStringRef> split(QChar sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool startsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
const QString *string() const
double toDouble(bool *ok = nullptr) const
float toFloat(bool *ok = nullptr) const
int toInt(bool *ok = nullptr, int base = 10) const
QByteArray toLatin1() const
QByteArray toLocal8Bit() const
long toLong(bool *ok = nullptr, int base = 10) const
qlonglong toLongLong(bool *ok = nullptr, int base = 10) const
short toShort(bool *ok = nullptr, int base = 10) const
QString toString() const
uint toUInt(bool *ok = nullptr, int base = 10) const
ulong toULong(bool *ok = nullptr, int base = 10) const
qulonglong toULongLong(bool *ok = nullptr, int base = 10) const
ushort toUShort(bool *ok = nullptr, int base = 10) const
QList<uint> toUcs4() const
QByteArray toUtf8() const
QStringRef trimmed() const
void truncate(int position)
const QChar *unicode() const
bool operator!=(const char *s) const
bool operator<(const char *s) const
bool operator<=(const char *s) const
QStringRef &operator=(const QString *string)
QStringRef &operator=(const QStringRef &other)
bool operator==(const char *s) const
bool operator>(const char *s) const
bool operator>=(const char *s) const
QChar operator[](int position) const

Miembros públicos estáticos

int compare(const QStringRef &s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
int compare(const QStringRef &s1, QLatin1String s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
int compare(const QStringRef &s1, const QStringRef &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
int localeAwareCompare(const QStringRef &s1, const QString &s2)
int localeAwareCompare(const QStringRef &s1, const QStringRef &s2)
bool operator<(const QStringRef &s1, const QStringRef &s2)
bool operator<=(const QStringRef &s1, const QStringRef &s2)
bool operator==(QLatin1String s1, const QStringRef &s2)
bool operator==(const QString &s1, const QStringRef &s2)
bool operator==(const QStringRef &s1, const QStringRef &s2)
bool operator>(const QStringRef &s1, const QStringRef &s2)
bool operator>=(const QStringRef &s1, const QStringRef &s2)

Descripción detallada

QStringRef proporciona un subconjunto de solo lectura de la API de QString.

Una referencia de cadena hace referencia explícita a una parte de un objeto ` string()` con un ` size()` dado, que comienza en un ` position()` específico. Al llamar a ` toString()`, se devuelve una copia de los datos como una instancia real de ` QString `.

Esta clase está diseñada para mejorar el rendimiento del manejo de subcadenas al manipular subcadenas obtenidas a partir de instancias existentes de QString. QStringRef evita la sobrecarga que suponen la asignación de memoria y el recuento de referencias de una QString estándar, al limitarse a hacer referencia a una parte de la cadena original. Esto puede resultar ventajoso en código de bajo nivel, como el que se utiliza en un analizador sintáctico, a costa de un código potencialmente más complejo.

Para la mayoría de los usuarios, no hay ventajas semánticas en utilizar QStringRef en lugar de QString, ya que QStringRef requiere prestar atención a cuestiones de gestión de memoria, lo que puede hacer que el código sea más complejo de escribir y mantener.

Advertencia: un QStringRef solo es válido mientras exista la cadena a la que hace referencia. Si se elimina la cadena original, la referencia apunta a una ubicación de memoria no válida.

Recomendamos utilizar esta clase únicamente en código estable, en el que el análisis de rendimiento haya identificado claramente que se pueden obtener mejoras de rendimiento sustituyendo las operaciones estándar con cadenas por el manejo optimizado de subcadenas que ofrece esta clase.

Consideraciones de seguridad

Esta clase utiliza int para almacenar los valores de size() y position(). Como resultado, no puede representar partes de cadenas que superen los INT_MAX o que comiencen en un desplazamiento mayor. Intentar hacer referencia a dichas partes da lugar a un comportamiento indefinido. Ten en cuenta que la construcción de QStringRef a partir de QString también se ve afectada si el tamaño de QString supera INT_MAX, aunque no se pasen tamaños explícitos.

Utiliza en su lugar QStringView, teniendo en cuenta que su modelo de propiedad es más flexible que el de QStringRef. Consulta la guía de portabilidad para obtener más detalles.

Véase también «Clases compartidas implícitamente».

Documentación sobre tipos de miembros

QStringRef::const_iterator

Véase también QStringRef::const_reverse_iterator.

QStringRef::const_reverse_iterator

Véase también QStringRef::const_iterator.

Documentación de funciones de miembro

[constexpr noexcept] QStringRef::QStringRef()

Crea una referencia a una cadena vacía.

QStringRef::QStringRef(const QString *string)

Crea una referencia de cadena al objeto ` string` indicado.

Advertencia: QStringRef utiliza int (32 bits) para representar su size(). En Qt 6, el tamaño de QString se representa como qsizetype, que es de 64 bits para compilaciones de 64 bits. Asegúrate de que el tamaño de la entrada quepa en 32 bits; de lo contrario, the behavior is undefined.

QStringRef::QStringRef(const QString *string, qsizetype position, qsizetype length)

Crea una referencia de cadena al rango de caracteres del archivo ` string ` especificado, delimitado por los caracteres ` position ` y ` length `.

Advertencia: Esta función se ha diseñado para mejorar el rendimiento en la medida de lo posible y no realiza comprobaciones de límites. Para garantizar la corrección del programa, position y length deben describir una subcadena válida de string y poder representarse en int.

Esto significa que el inicio position debe ser positivo o 0 y menor que la longitud de string, y que length debe ser positivo o 0, pero menor que la longitud de la cadena menos el inicio position; es decir, deben cumplirse ambas condiciones: 0 <= position < string->length() y 0 <= length <= string->length() - position.

Advertencia: A partir de Qt 6.12, este constructor admite ` qsizetype `, ` position ` y ` length ` en lugar de ` int`. Esto evita el estrechamiento silencioso en el punto de llamada. Sin embargo, al pasar valores que no pueden representarse en ` int `, el resultado sigue siendo ` undefined behavior`.

[implicit] QStringRef::QStringRef(const QStringRef &other)

Crea una copia de la referencia de cadena « other ».

[noexcept implicit] QStringRef::~QStringRef()

Elimina la referencia a la cadena.

Dado que esta clase solo se utiliza para hacer referencia a datos de cadena y no asume la propiedad de los mismos, no se libera memoria cuando se destruyen las instancias.

QStringRef QStringRef::appendTo(QString *string) const

Añade la referencia a la cadena a ` string` y devuelve una nueva referencia a los datos de la cadena combinada.

const QChar QStringRef::at(int position) const

Devuelve el carácter situado en el índice dado position en la referencia de cadena.

El position debe ser una posición de índice válida en la cadena (es decir, 0 <= position < size()).

QChar QStringRef::back() const

Devuelve el último carácter de la cadena. Es lo mismo que « at(size() - 1) ».

Esta función se proporciona para garantizar la compatibilidad con STL.

Advertencia: llamar a esta función sobre una cadena vacía da lugar a un comportamiento indefinido.

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

QStringRef::const_iterator QStringRef::begin() const

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

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

QStringRef::const_iterator QStringRef::cbegin() const

Igual que begin().

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

QStringRef::const_iterator QStringRef::cend() const

Igual que end().

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

[noexcept] void QStringRef::chop(int n)

Elimina los caracteres « n » del final de la cadena.

Si n es mayor o igual que size(), el resultado es una cadena vacía; si n es negativo, equivale a pasar cero.

Véanse también QString::chop() y truncate().

QStringRef QStringRef::chopped(int len) const

Devuelve una referencia a la subcadena que contiene los caracteres situados más a la izquierda de esta cadena, según la función size() - len.

Nota: El comportamiento es indefinido si len es negativo o mayor que size().

Véase también endsWith(), left(), right(), mid(), chop() y truncate().

void QStringRef::clear()

Borra el contenido de la referencia de cadena, dejándola nula y vacía.

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

[static noexcept] int QStringRef::compare(const QStringRef &s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Compara s1 con s2 y devuelve un entero negativo si s1 es menor que s2, un entero positivo si es mayor que s2, y cero si son iguales.

Si cs es Qt::CaseSensitive, la comparación distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.

[noexcept] int QStringRef::compare(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Compara *this con ch y devuelve un entero negativo si *this es menor que ch, un entero positivo si es mayor que ch, y cero si son iguales. En este caso, ch se interpreta como una cadena de longitud uno.

Si cs es Qt::CaseSensitive, la comparación distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.

Esta es una función sobrecargada.

[noexcept] int QStringRef::compare(QLatin1String other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Compara *this con other y devuelve un entero negativo si *this es menor que other, un entero positivo si es mayor que other, y cero si son iguales.

Si cs es Qt::CaseSensitive, la comparación distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.

Equivalente a compare(*this, other, cs).

Esta es una función sobrecargada.

[noexcept] int QStringRef::compare(const QByteArray &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Compara *this con other y devuelve un entero negativo si *this es menor que other, un entero positivo si es mayor que other, y cero si son iguales. El contenido de other se interpreta como UTF-8.

Si cs es Qt::CaseSensitive, la comparación distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.

Equivalente a ` compare(*this, other, cs)`.

Esta es una función sobrecargada.

[noexcept] int QStringRef::compare(const QString &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Compara *this con other y devuelve un entero negativo si *this es menor que other, un entero positivo si es mayor que other, y cero si son iguales.

Si cs es Qt::CaseSensitive, la comparación distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.

Equivalente a compare(*this, other, cs).

Esta es una función sobrecargada.

[noexcept] int QStringRef::compare(const QStringRef &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Compara *this con other y devuelve un entero negativo si *this es menor que other, un entero positivo si es mayor que other, y cero si son iguales.

Si cs es Qt::CaseSensitive, la comparación distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.

Equivalente a compare(*this, other, cs).

Esta es una función sobrecargada.

[static noexcept] int QStringRef::compare(const QStringRef &s1, QLatin1String s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Compara s1 con s2 y devuelve un entero negativo si s1 es menor que s2, un entero positivo si es mayor que s2, y cero si son iguales.

Si cs es Qt::CaseSensitive, la comparación distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.

Se trata de una función sobrecargada.

[static noexcept] int QStringRef::compare(const QStringRef &s1, const QStringRef &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Compara s1 con s2 y devuelve un entero negativo si s1 es menor que s2, un entero positivo si es mayor que s2, y cero si son iguales.

Si cs es Qt::CaseSensitive, la comparación distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.

Esta es una función sobrecargada.

QStringRef::const_iterator QStringRef::constBegin() const

Igual que begin().

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

const QChar *QStringRef::constData() const

Es lo mismo que « unicode()».

QStringRef::const_iterator QStringRef::constEnd() const

Igual que end().

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

bool QStringRef::contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve « true » si esta referencia de cadena contiene alguna aparición de la cadena « str »; en caso contrario, devuelve « false ».

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.

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

bool QStringRef::contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve « true » si esta cadena contiene alguna aparición del carácter « ch »; 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.

Esta función sobrescribe la función QStringRef::contains().

bool QStringRef::contains(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve « true » si esta referencia de cadena contiene alguna aparición de la cadena « str »; 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.

Esta función sobrecarga QStringRef::contains().

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

[noexcept] bool QStringRef::contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve « true » si esta referencia de cadena contiene alguna aparición de la cadena « str »; 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.

Esta función sobrescribe QStringRef::contains().

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

bool QStringRef::contains(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve « true » si esta referencia de cadena contiene alguna aparición de la referencia de cadena « str »; 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.

Esta función sobrecarga QStringRef::contains().

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

int QStringRef::count() const

Devuelve el número de caracteres a los que hace referencia la referencia de cadena. Equivalente a size() y length().

Véanse también position() y string().

int QStringRef::count(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve el número de apariciones (que pueden solaparse) de la cadena « str » en esta referencia de cadena.

Si cs es Qt::CaseSensitive (valor predeterminado), 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 QString::count(), contains() y indexOf().

int QStringRef::count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve el número de veces que aparece el carácter ch en la referencia 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 QStringRef::count().

Véase también QString::count(), contains() y indexOf().

int QStringRef::count(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve el número de apariciones (que pueden solaparse) de la referencia de cadena str en esta referencia de cadena.

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.

Esta función sobrecarga QStringRef::count().

Véanse también QString::count(), contains() y indexOf().

QStringRef::const_reverse_iterator QStringRef::crbegin() const

Igual que rbegin().

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

QStringRef::const_reverse_iterator QStringRef::crend() const

Igual que rend().

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

const QChar *QStringRef::data() const

Es lo mismo que « unicode()».

QStringRef::const_iterator QStringRef::end() const

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

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

bool QStringRef::endsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve « true » si la referencia de cadena termina en « str »; 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 QString::endsWith() y startsWith().

bool QStringRef::endsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve « true » si la referencia a la cadena termina en « ch »; 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.

Esta función sobrecarga QStringRef::endsWith().

Véase también QString::endsWith() y endsWith().

bool QStringRef::endsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Esta función sobrescribe la función ` QStringRef::endsWith()`.

Véanse también QString::endsWith() y endsWith().

[noexcept] bool QStringRef::endsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Esta función sobrescribe la función ` QStringRef::endsWith()`.

Véanse también QString::endsWith() y startsWith().

bool QStringRef::endsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Esta función sobrescribe la función QStringRef::endsWith().

Véanse también QString::endsWith() y endsWith().

QChar QStringRef::front() const

Devuelve el primer carácter de la cadena. Es lo mismo que « at(0) ».

Esta función se proporciona para garantizar la compatibilidad con STL.

Advertencia: llamar a esta función con una cadena vacía da lugar a un comportamiento indefinido.

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

int QStringRef::indexOf(QLatin1String str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición en el índice de la primera aparición de la cadena « str » en esta referencia de cadena, buscando hacia adelante a partir de la posición de índice « from ». Devuelve -1 si no se encuentra « str ».

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.

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éanse también QString::indexOf(), lastIndexOf(), contains() y count().

int QStringRef::indexOf(const QString &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición en el índice de la primera aparición de la cadena « str » en esta referencia de cadena, buscando hacia adelante a partir de la posición de índice « from ». Devuelve -1 si no se encuentra « str ».

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.

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éanse también QString::indexOf(), lastIndexOf(), contains() y count().

int QStringRef::indexOf(QChar ch, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición en el índice de la primera aparición del carácter ch en la referencia de cadena, buscando hacia adelante a partir de la posición de índice from. Devuelve -1 si no se ha podido encontrar ch.

Esta función sobrecarga QStringRef::indexOf().

Véase también QString::indexOf(), lastIndexOf(), contains() y count().

[noexcept] int QStringRef::indexOf(QStringView str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición en el índice de la primera aparición de la cadena « str » en esta referencia de cadena, buscando hacia adelante a partir de la posición de índice « from ». Devuelve -1 si no se encuentra « str ».

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.

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.

Esta función sobrescribe QStringRef::indexOf().

Véase también QString::indexOf(), QStringView::indexOf(), lastIndexOf(), contains() y count().

int QStringRef::indexOf(const QStringRef &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición en el índice de la primera aparición de la referencia de cadena str en esta referencia de cadena, buscando hacia adelante a partir de la posición de índice from. Devuelve -1 si no se encuentra str.

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.

Esta función sobrecarga QStringRef::indexOf().

Véase también QString::indexOf(), lastIndexOf(), contains() y count().

bool QStringRef::isEmpty() const

Devuelve « true » si la referencia de cadena no contiene caracteres; en caso contrario, devuelve « false ».

Una referencia de cadena está vacía si su tamaño es cero.

Véase también size().

bool QStringRef::isNull() const

Devuelve ` true ` si esta referencia a una cadena no hace referencia a ninguna cadena o si la cadena a la que hace referencia es nula (es decir, si ` QString::isNull()` es verdadero).

Véase también size().

bool QStringRef::isRightToLeft() const

Devuelve « true » si la cadena se lee de derecha a izquierda.

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

int QStringRef::lastIndexOf(const QString &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición en el índice de la última aparición de la cadena « str » en esta referencia de cadena, buscando hacia atrás a partir de la posición de índice « from ». Si « from » es -1 (por defecto), la búsqueda comienza en el último carácter; si « from » es -2, en el penúltimo carácter, y así sucesivamente. Devuelve -1 si no se encuentra « str ».

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éanse también QString::lastIndexOf(), indexOf(), contains() y count().

int QStringRef::lastIndexOf(QChar ch, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición en el índice de la última aparición del carácter ch, realizando la búsqueda hacia atrás a partir de la posición from.

Esta función sobrecarga la función QStringRef::lastIndexOf().

Véase también QString::lastIndexOf(), indexOf(), contains() y count().

int QStringRef::lastIndexOf(QLatin1String str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición en el índice de la última aparición de la cadena str en esta referencia de cadena, buscando hacia atrás a partir de la posición en el índice from. Si from es -1 (valor por defecto), la búsqueda comienza en el último carácter; si from es -2, en el penúltimo carácter, y así sucesivamente. Devuelve -1 si no se encuentra str.

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.

Esta función sobrescribe a QStringRef::lastIndexOf().

Véase también QString::lastIndexOf(), indexOf(), contains() y count().

[noexcept] int QStringRef::lastIndexOf(QStringView str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición en el índice de la última aparición de la cadena « str » en esta cadena, buscando hacia atrás a partir de la posición del índice « from ». Si « from » es -1 (valor por defecto), la búsqueda comienza en el último carácter; si « from » es -2, en el penúltimo carácter, y así sucesivamente. Devuelve -1 si no se encuentra « str ».

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.

Esta función sobrescribe a QStringRef::lastIndexOf().

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

int QStringRef::lastIndexOf(const QStringRef &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición en el índice de la última aparición de la referencia de cadena str en esta referencia de cadena, buscando hacia atrás a partir de la posición del índice from. Si from es -1 (valor por defecto), la búsqueda comienza en el último carácter; si from es -2, en el penúltimo carácter, y así sucesivamente. Devuelve -1 si no se encuentra str.

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.

Esta función sobrescribe a QStringRef::lastIndexOf().

Véase también QString::lastIndexOf(), indexOf(), contains() y count().

QStringRef QStringRef::left(int n) const

Devuelve una referencia a la subcadena que contiene los n caracteres situados más a la izquierda de la cadena.

Si n es mayor o igual que size(), o menor que cero, se devuelve una referencia a toda la cadena.

Véase también right(), mid(), startsWith(), chopped(), chop() y truncate().

int QStringRef::length() const

Devuelve el número de caracteres a los que hace referencia la referencia de cadena. Equivalente a size() y count().

Véanse también position() y string().

[static] int QStringRef::localeAwareCompare(const QStringRef &s1, const QString &s2)

Compara s1 con s2 y devuelve un entero negativo si s1 es menor que s2, un entero positivo si es mayor que s2, y cero si son iguales.

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.

Véase también compare(), QLocale y Comparing Strings.

int QStringRef::localeAwareCompare(const QString &other) const

Compara *this con other y devuelve un entero negativo si *this es menor que other, un entero positivo si es mayor que other, y cero si son iguales.

La comparación se realiza en función de la configuración regional y también de la plataforma. Utilice esta función para presentar al usuario listas ordenadas de cadenas.

Se trata de una función sobrecargada.

Véase también Comparing Strings.

int QStringRef::localeAwareCompare(const QStringRef &other) const

Compara *this con other y devuelve un entero negativo si *this es menor que other, un entero positivo si es mayor que other, y cero si son iguales.

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.

Se trata de una función sobrecargada.

Véase también Comparing Strings.

[static] int QStringRef::localeAwareCompare(const QStringRef &s1, const QStringRef &s2)

Compara s1 con s2 y devuelve un entero negativo si s1 es menor que s2, un entero positivo si es mayor que s2, y cero si son iguales.

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.

Se trata de una función sobrecargada.

Véase también Comparing Strings.

QStringRef QStringRef::mid(int position, int n = -1) const

Devuelve una referencia a una subcadena de n caracteres de esta cadena, comenzando en el position especificado.

Si el position supera la longitud de la cadena, se devuelve una referencia nula.

Si el position() resultante no se puede representar en int, se devuelve una QStringRef nula.

Si hay menos de n caracteres disponibles en la cadena, a partir del position dado, o si n es -1 (por defecto), la función devuelve todos los caracteres a partir del position especificado.

Véanse también left(), right(), chopped(), chop() y truncate().

int QStringRef::position() const

Devuelve la posición inicial en la cadena a la que hace referencia la referencia de cadena.

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

QStringRef::const_reverse_iterator QStringRef::rbegin() const

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

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

QStringRef::const_reverse_iterator QStringRef::rend() const

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

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

Devuelve una referencia a la subcadena que contiene los n caracteres situados más a la derecha de la cadena.

Si ` n ` es mayor o igual que ` size()`, o menor que cero, se devuelve una referencia a la cadena completa.

Si el nuevo position() no se puede representar en int, se devuelve una referencia a la cadena completa.

Véase también left(), mid(), endsWith(), chopped(), chop() y truncate().

int QStringRef::size() const

Devuelve el número de caracteres a los que hace referencia la referencia de cadena. Equivalente a ` length()` y ` count()`.

Véanse también position() y string().

QList<QStringRef> QStringRef::split(const QString &sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Divide la cadena en subcadenas que hagan referencia a cualquier aparición de « sep » y devuelve la lista de dichas cadenas.

Consulte QString::split() para ver cómo interactúan sep, behavior y cs para formar el resultado.

Nota: Todas las referencias son válidas mientras esta cadena siga existiendo. La destrucción de esta cadena provocará que todas las referencias se conviertan en punteros colgantes.

QList<QStringRef> QStringRef::split(QChar sep, Qt::SplitBehavior behavior = Qt::KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Esta es una función sobrecargada.

bool QStringRef::startsWith(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve « true » si la referencia de cadena comienza por « str »; 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éanse también QString::startsWith() y endsWith().

bool QStringRef::startsWith(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve « true » si la referencia de cadena comienza por « ch »; 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.

Esta función sobrescribe QStringRef::startsWith().

Véase también QString::startsWith() y endsWith().

bool QStringRef::startsWith(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Esta función sobrescribe la función ` QStringRef::startsWith()`.

Véanse también QString::startsWith() y endsWith().

[noexcept] bool QStringRef::startsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Esta función sobrescribe la función ` QStringRef::startsWith()`.

Véanse también QString::startsWith() y endsWith().

bool QStringRef::startsWith(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Esta función sobrescribe la función ` QStringRef::startsWith()`.

Véanse también QString::startsWith() y endsWith().

const QString *QStringRef::string() const

Devuelve un puntero a la cadena a la que hace referencia la referencia de cadena, o 0 si no hace referencia a ninguna cadena.

Véase también ` unicode()`.

double QStringRef::toDouble(bool *ok = nullptr) const

Devuelve la 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 error 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().

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

float QStringRef::toFloat(bool *ok = nullptr) const

Devuelve la cadena convertida a un valor de tipo « float ».

Devuelve infinito si se produce un desbordamiento en 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 error 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()

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

int QStringRef::toInt(bool *ok = nullptr, int base = 10) const

Devuelve la cadena convertida a un ` int ` utilizando la base ` base`, que es 10 por defecto y debe estar comprendida 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 cadena comienza por «0x», se utiliza la base 16; si 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::toInt().

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

QByteArray QStringRef::toLatin1() const

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

La matriz de bytes devuelta no está definida si la cadena contiene caracteres que no sean de Latin-1. Dichos caracteres pueden suprimirse o sustituirse por un signo de interrogación.

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

QByteArray QStringRef::toLocal8Bit() const

Devuelve la representación local de 8 bits de la cadena como un ` QByteArray`. La matriz de bytes devuelta es indefinida si la cadena contiene caracteres no compatibles con la codificación local de 8 bits.

En sistemas Unix, esto equivale a ` toUtf8()`, mientras que en Windows se utiliza la página de códigos actual del sistema.

Si esta cadena contiene algún carácter que no pueda codificarse en la configuración regional, la matriz de bytes devuelta es indefinida. Esos caracteres pueden suprimirse o sustituirse por otros.

Véanse también toLatin1(), toUtf8() y QStringEncoder.

long QStringRef::toLong(bool *ok = nullptr, int base = 10) const

Devuelve la cadena convertida a un ` long ` utilizando la base ` base`, que es 10 por defecto y debe estar comprendida 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 cadena comienza por «0x», se utiliza la base 16; si 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::toLong().

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

qlonglong QStringRef::toLongLong(bool *ok = nullptr, int base = 10) const

Devuelve la cadena convertida a un « long long » utilizando la base « base », que es 10 por defecto y debe estar comprendida entre 2 y 36, o bien 0. Devuelve 0 si la conversión falla.

Si « ok » no es « nullptr », el fallo se notifica 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; si 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::toLongLong().

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

short QStringRef::toShort(bool *ok = nullptr, int base = 10) const

Devuelve la cadena convertida a un ` short ` utilizando la base ` base`, que es 10 por defecto y debe estar comprendida entre 2 y 36, o 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; si 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, utiliza QLocale::toShort().

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

QString QStringRef::toString() const

Devuelve una copia de la referencia de cadena como un objeto ` QString `.

Si la referencia a la cadena no es una referencia completa de la misma (es decir, si position() es 0 y size() es igual a string()->size()), esta función asignará una nueva cadena para devolverla.

Véase también string().

uint QStringRef::toUInt(bool *ok = nullptr, int base = 10) const

Devuelve la cadena convertida a un ` unsigned int ` utilizando la base ` base`, que es 10 por defecto y debe estar comprendida 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 cadena comienza por «0x», se utiliza la base 16; si 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, utiliza QLocale::toUInt().

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

ulong QStringRef::toULong(bool *ok = nullptr, int base = 10) const

Devuelve la cadena convertida a un ` unsigned long ` utilizando la base ` base`, que es 10 por defecto y debe estar comprendida 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 cadena comienza por «0x», se utiliza la base 16; si 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().

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

qulonglong QStringRef::toULongLong(bool *ok = nullptr, int base = 10) const

Devuelve la cadena convertida a un ` unsigned long long ` utilizando la base ` base`, que es 10 por defecto y debe estar comprendida 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 cadena comienza por «0x», se utiliza la base 16; si la cadena comienza por «0», se utiliza la base 8; en caso contrario, se utiliza la base 10.

La conversión de la cadena se realizará siempre en la configuración regional «C». Para una conversión dependiente de la configuración regional, utilice QLocale::toULongLong()

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

ushort QStringRef::toUShort(bool *ok = nullptr, int base = 10) const

Devuelve la cadena convertida a un ` unsigned short ` utilizando la base ` base`, que es 10 por defecto y debe estar comprendida 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 cadena comienza por «0x», se utiliza la base 16; si 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().

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

QList<uint> QStringRef::toUcs4() const

Devuelve una representación UCS-4/UTF-32 de la cadena como un valor de tipo « QList » <uint>.

UCS-4 es un códec Unicode y, por lo tanto, no presenta pérdidas. Todos los caracteres de esta cadena se codificarán en UCS-4. Cualquier secuencia inválida de unidades de código en esta cadena se sustituye por el carácter de sustitución de Unicode (QChar::ReplacementCharacter, que corresponde a U+FFFD).

La lista devuelta no está terminada por « \0 ».

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

QByteArray QStringRef::toUtf8() const

Devuelve una representación UTF-8 de la cadena como un ` 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.

QStringRef QStringRef::trimmed() const

Devuelve una cadena a la que se le han eliminado los espacios en blanco al principio y al final.

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 « ».

A diferencia de ` QString::simplified()`, la función `trimmed()` no modifica los espacios en blanco internos.

Si, tras eliminar los espacios en blanco, el nuevo ` position()` no puede representarse en ` int`, el comportamiento es indefinido.

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

[noexcept] void QStringRef::truncate(int position)

Trunca la cadena en el índice position especificado.

Si el índice position especificado se encuentra más allá del final de la cadena, no ocurre nada.

Si position es negativo, equivale a pasar el valor cero.

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

const QChar *QStringRef::unicode() const

Devuelve una representación Unicode de la referencia de cadena. Dado que los datos proceden directamente de la cadena a la que se hace referencia, no están terminados c \0, a menos que la referencia de cadena incluya el terminador nulo de la cadena.

Véase también string().

[noexcept] bool QStringRef::operator!=(const char *s) const

El puntero ` s const char` se convierte en un ` QStringRef ` mediante la función `fromUtf8()`.

Puedes desactivar este operador definiendo ` QT_NO_CAST_FROM_ASCII ` al compilar tus aplicaciones. Esto puede resultar útil si, por ejemplo, quieres asegurarte de que todas las cadenas visibles para el usuario pasen por ` QObject::tr()`.

Devuelve ` true ` si esta cadena no es léxicamente igual a la cadena ` s` pasada como parámetro. En caso contrario, devuelve ` false`.

Esta función sobrecarga QStringRef::operator!=().

Véase también QT_NO_CAST_FROM_ASCII.

[noexcept] bool QStringRef::operator<(const char *s) const

El puntero ` s const char` se convierte en un ` QStringRef ` mediante la función `fromUtf8()`.

Puedes desactivar este operador definiendo ` QT_NO_CAST_FROM_ASCII ` al compilar tus aplicaciones. Esto puede resultar útil si, por ejemplo, quieres asegurarte de que todas las cadenas visibles para el usuario pasen por ` QObject::tr()`.

Devuelve ` true ` si esta cadena es léxicamente más corta que la cadena ` s` pasada como parámetro. En caso contrario, devuelve ` false`.

Esta función sobrecarga ` QStringRef::operator<()`.

Véase también QT_NO_CAST_FROM_ASCII.

[noexcept] bool QStringRef::operator<=(const char *s) const

El puntero ` s const char` se convierte a un ` QStringRef ` mediante la función `fromUtf8()`.

Puedes desactivar este operador definiendo ` QT_NO_CAST_FROM_ASCII ` al compilar tus aplicaciones. Esto puede resultar útil si, por ejemplo, quieres asegurarte de que todas las cadenas visibles para el usuario pasen por ` QObject::tr()`.

Devuelve ` true ` si esta cadena es léxicamente menor o igual que la cadena ` s` del parámetro. En caso contrario, devuelve ` false`.

Esta función sobrecarga QStringRef::operator<=().

Véase también QT_NO_CAST_FROM_ASCII.

QStringRef &QStringRef::operator=(const QString *string)

Crea una referencia de cadena al archivo « string » especificado y la asigna a esta referencia de cadena, devolviendo el resultado.

Advertencia: « QStringRef » utiliza« int » (32 bits) para representar su « size()». En Qt 6, el tamaño de « QString » se representa como « qsizetype », que es de 64 bits para compilaciones de 64 bits. Asegúrate de que el tamaño de la entrada quepa en 32 bits; de lo contrario, « the behavior is undefined ».

[implicit] QStringRef &QStringRef::operator=(const QStringRef &other)

Asigna la referencia de cadena « other » a esta referencia de cadena y devuelve el resultado.

[noexcept] bool QStringRef::operator==(const char *s) const

La matriz de bytes « s » se convierte en un « QStringRef » mediante la función «fromUtf8()». Esta función detiene la conversión al encontrar el primer carácter NUL o al llegar al final de la matriz de bytes.

Puedes desactivar este operador definiendo ` QT_NO_CAST_FROM_ASCII ` al compilar tus aplicaciones. Esto puede resultar útil si, por ejemplo, quieres asegurarte de que todas las cadenas visibles para el usuario pasen por ` QObject::tr()`.

Devuelve ` true ` si esta cadena es léxicamente igual a la cadena del parámetro ` s`. En caso contrario, devuelve ` false`.

Esta función sobrecarga ` QStringRef::operator==()`.

Véase también QT_NO_CAST_FROM_ASCII.

[noexcept] bool QStringRef::operator>(const char *s) const

El puntero ` s const char` se convierte en un ` QStringRef ` mediante la función `fromUtf8()`.

Puedes desactivar este operador definiendo ` QT_NO_CAST_FROM_ASCII ` al compilar tus aplicaciones. Esto puede resultar útil si quieres asegurarte de que todas las cadenas visibles para el usuario pasen por ` QObject::tr()`, por ejemplo.

Devuelve ` true ` si esta cadena es léxicamente mayor que la cadena ` s` pasada como parámetro. En caso contrario, devuelve ` false`.

Esta función sobrecarga QStringRef::operator>().

Véase también QT_NO_CAST_FROM_ASCII.

[noexcept] bool QStringRef::operator>=(const char *s) const

El puntero « s const char» se convierte en un « QStringRef » mediante la función «fromUtf8()».

Puedes desactivar este operador definiendo ` QT_NO_CAST_FROM_ASCII ` al compilar tus aplicaciones. Esto puede resultar útil si, por ejemplo, quieres asegurarte de que todas las cadenas visibles para el usuario pasen por ` QObject::tr()`.

Devuelve ` true ` si esta cadena es léxicamente mayor o igual que la cadena paramétrica ` s`. En caso contrario, devuelve ` false`.

Esta función sobrecarga ` QStringRef::operator>=()`.

Véase también QT_NO_CAST_FROM_ASCII.

QChar QStringRef::operator[](int position) const

Devuelve el carácter situado en el índice indicado position en la referencia de cadena.

El position debe ser una posición de índice válida en la referencia de cadena (es decir, 0 <= position < size()).

Véase también at().

Elementos no miembros relacionados

[noexcept] bool operator<(const QStringRef &s1, const QStringRef &s2)

Devuelve « true » si la referencia de cadena s1 es léxicamente menor que la referencia de cadena s2; en caso contrario, devuelve « false ».

Véase también Comparing Strings.

[noexcept] bool operator<=(const QStringRef &s1, const QStringRef &s2)

Devuelve « true » si la referencia de cadena « s1 » es léxicamente menor o igual que la referencia de cadena « s2 »; en caso contrario, devuelve « false ».

Véase también Comparing Strings.

[noexcept] bool operator==(QLatin1String s1, const QStringRef &s2)

Devuelve « true » si la cadena « s1 » es léxicamente igual a la referencia de cadena « s2 »; en caso contrario, devuelve « false ».

[noexcept] bool operator==(const QString &s1, const QStringRef &s2)

Devuelve « true » si la cadena « s1 » es léxicamente igual a la referencia de cadena « s2 »; en caso contrario, devuelve « false ».

[noexcept] bool operator==(const QStringRef &s1, const QStringRef &s2)

Devuelve « true » si la referencia a la cadena « s1 » es léxicamente igual a la referencia a la cadena « s2 »; en caso contrario, devuelve « false ».

[noexcept] bool operator>(const QStringRef &s1, const QStringRef &s2)

Devuelve « true » si la referencia a la cadena « s1 » es léxicamente mayor que la referencia a la cadena « s2 »; en caso contrario, devuelve « false ».

Véase también Comparing Strings.

[noexcept] bool operator>=(const QStringRef &s1, const QStringRef &s2)

Devuelve « true » si la referencia a la cadena « s1 » es léxicamente mayor o igual que la referencia a la cadena « s2 »; en caso contrario, devuelve « false ».

Véase también Comparing Strings.

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