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 |
- Lista de todos los miembros, incluidos los miembros heredados
- QStringRef forma parte de las clases para datos de cadena.
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) |
Elementos no miembros relacionados
| 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().
QStringRef QStringRef::right(int n) const
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.