QString Class

Documentación de las funciones miembro

[constexpr noexcept] QString::QString()

Construye una cadena nula. Las cadenas nulas también se consideran vacías.

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

QString::QString(QChar ch)

Construye una cadena de tamaño 1 que contiene el carácter ch.

QString::QString(QLatin1StringView str)

Construye una copia de la cadena Latin-1 vista por str.

Véase también fromLatin1().

[explicit, since 6.8] QString::QString(QStringView sv)

Construye una cadena inicializada con los datos de la vista string.

El QString será null si y sólo si sv es null.

Esta función se introdujo en Qt 6.8.

Véase también fromUtf16().

QString::QString(const QByteArray &ba)

Construye una cadena inicializada con la matriz de bytes ba. La matriz de bytes dada se convierte a Unicode utilizando fromUtf8().

Puede desactivar este constructor definiendo QT_NO_CAST_FROM_ASCII cuando compile sus aplicaciones. Esto puede ser útil si desea asegurarse de que todas las cadenas visibles para el usuario pasen por QObject::tr(), por ejemplo.

Véase también fromLatin1(), fromLocal8Bit(), y fromUtf8().

QString::QString(const char *str)

Construye una cadena inicializada con la cadena de 8 bits str. El puntero const char dado se convierte a Unicode utilizando la función fromUtf8().

Puede desactivar este constructor definiendo QT_NO_CAST_FROM_ASCII cuando compile sus aplicaciones. Esto puede ser útil si desea asegurarse de que todas las cadenas visibles para el usuario pasen por QObject::tr(), por ejemplo.

Véase también fromLatin1(), fromLocal8Bit(), y fromUtf8().

[since 6.1] QString::QString(const char8_t *str)

Construye una cadena inicializada con la cadena UTF-8 str. El puntero const char8_t dado se convierte a Unicode utilizando la función fromUtf8().

Esta función se introdujo en Qt 6.1.

Véase también fromLatin1(), fromLocal8Bit() y fromUtf8().

[explicit] QString::QString(const QChar *unicode, qsizetype size = -1)

Construye una cadena inicializada con los primeros size caracteres de la matriz QChar unicode .

Si unicode es 0, se construye una cadena nula.

Si size es negativo, se supone que unicode apunta a una matriz '\0'terminada y su longitud se determina dinámicamente. El carácter nulo de terminación no se considera parte de la cadena.

QString realiza una copia profunda de los datos de la cadena. Los datos unicode se copian tal cual y la marca de orden de bytes se conserva si está presente.

Véase también fromRawData().

QString::QString(qsizetype size, QChar ch)

Construye una cadena del tipo size con todos los caracteres ajustados a ch.

Véase también fill().

[noexcept] QString::QString(const QString &other)

Construye una copia de other.

Esta operación toma un tiempo constante, porque QString es implícitamente compartido. Esto hace que devolver un QString desde una función sea muy rápido. Si una instancia compartida es modificada, será copiada (copy-on-write), y eso toma tiempo lineal.

Véase también operator=().

[noexcept] QString::QString(QString &&other)

Move-construye una instancia de QString, haciendo que apunte al mismo objeto al que apuntaba other.

[noexcept] QString::~QString()

Destruye la cadena.

QString &QString::append(const QString &str)

Añade la cadena str al final de esta cadena.

Ejemplo:

QString x = "free";
QString y = "dom";

x.append(y);
// x == "freedom"

Esto es lo mismo que usar la función insert():

x.insert(x.size(), y);

La función append() es típicamente muy rápida(tiempo constante), porque QString preasigna espacio extra al final de los datos de la cadena para que pueda crecer sin reasignar toda la cadena cada vez.

Véase también operator+=(), prepend(), y insert().

QString &QString::append(QChar ch)

Añade el carácter ch a esta cadena.

QString &QString::append(QLatin1StringView str)

Añade la cadena Latin-1 vista por str a esta cadena.

[since 6.0] QString &QString::append(QStringView v)

Añade la vista de cadena v a esta cadena y devuelve el resultado.

Esta función se introdujo en Qt 6.0.

[since 6.5] QString &QString::append(QUtf8StringView str)

Añade la vista de cadena UTF-8 str a esta cadena.

Esta función se introdujo en Qt 6.5.

QString &QString::append(const QByteArray &ba)

Añade la matriz de bytes ba a esta cadena. La matriz de bytes dada se convierte a Unicode utilizando la función fromUtf8().

Puedes desactivar esta función definiendo QT_NO_CAST_FROM_ASCII cuando compiles tus aplicaciones. Esto puede ser útil si desea asegurarse de que todas las cadenas visibles para el usuario pasen por QObject::tr(), por ejemplo.

QString &QString::append(const char *str)

Añade la cadena str a esta cadena. El puntero const char dado se convierte a Unicode utilizando la función fromUtf8().

Puede desactivar esta función definiendo QT_NO_CAST_FROM_ASCII cuando compile sus aplicaciones. Esto puede ser útil si desea asegurarse de que todas las cadenas visibles para el usuario pasen por QObject::tr(), por ejemplo.

QString &QString::append(const QChar *str, qsizetype len)

Añade len caracteres de la matriz QChar str a esta cadena.

template <typename... Args> QString QString::arg(Args &&... args) const

Sustituye las apariciones de %N en esta cadena por el argumento correspondiente de args. Los argumentos no son posicionales: el primero de los args sustituye al %N por el N más bajo (todos ellos), el segundo de los args al %N por el N inmediatamente inferior, etc.

Args puede consistir en cualquier cosa que implícitamente se convierta a QAnyStringView.

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

template <typename T, QString::if_string_like<T> = true> QString QString::arg(const T &a, int fieldWidth = 0, QChar fillChar = u' ') const

Devuelve una copia de esta cadena con el marcador de posición de menor número sustituido por la cadena a, es decir, %1, %2, ..., %99.

fieldWidth especifica la cantidad mínima de espacio que debe ocupar a. Si a requiere menos espacio que fieldWidth, se rellena hasta fieldWidth con el carácter fillChar. Un fieldWidth positivo produce texto alineado a la derecha. Un fieldWidth negativo produce texto alineado a la izquierda.

Este ejemplo muestra cómo podríamos crear una cadena status para informar del progreso mientras se procesa una lista de archivos:

int i;                // current file's number
int total;            // number of files to process
QStringView fileName; // current file's name

QString status = QString("Processing file %1 of %2: %3")
                .arg(i).arg(total).arg(fileName);

En primer lugar, arg(i) sustituye a %1. A continuación, arg(total) sustituye a %2. Por último, arg(fileName) sustituye a %3.

Una ventaja de usar arg() sobre asprintf() es que el orden de los marcadores de posición numerados puede cambiar, si las cadenas de la aplicación se traducen a otros idiomas, pero cada arg() seguirá reemplazando al marcador de posición no reemplazado de menor número, sin importar dónde aparezca. Además, si el marcador de posición %i aparece más de una vez en la cadena, arg() los sustituye todos.

Si no queda ningún marcador de posición sin sustituir, se imprime un mensaje de advertencia y el resultado es indefinido. Los números de los marcadores de posición deben estar comprendidos entre 1 y 99.

template <typename T, QString::if_integral_non_char<T> = true> QString QString::arg(T a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

El argumento a se expresa en base base, que es 10 por defecto y debe estar comprendido entre 2 y 36. Para bases distintas de 10, a se trata como un entero sin signo.

fieldWidth especifica la cantidad mínima de espacio que a se rellena con el carácter fillChar. Un valor positivo produce texto alineado a la derecha; un valor negativo produce texto alineado a la izquierda.

El '%' puede ir seguido de una 'L', en cuyo caso la secuencia se sustituye por una representación localizada de a. La conversión utiliza la configuración regional por defecto, establecida por QLocale::setDefault(). Si no se especifica ninguna configuración regional por defecto, se utiliza la configuración regional del sistema. La bandera 'L' se ignora si base no es 10.

QString str;
str = QString("Decimal 63 is %1 in hexadecimal")
        .arg(63, 0, 16);
// str == "Decimal 63 is 3f in hexadecimal"

QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
str = QString("%1 %L2 %L3")
        .arg(12345)
        .arg(12345)
        .arg(12345, 0, 16);
// str == "12345 12,345 3039"

Véase también Number formats.

template <typename T, QString::if_floating_point<T> = true> QString QString::arg(T a, int fieldWidth = 0, char format = 'g', int precision = -1, QChar fillChar = u' ') const

El argumento a se formatea de acuerdo con lo especificado en format y precision. Véase Floating-point Formats para más detalles.

fieldWidth especifica la cantidad mínima de espacio que a se rellena con el carácter fillChar. Un valor positivo produce texto alineado a la derecha; un valor negativo produce texto alineado a la izquierda.

double d = 12.34;
QString str = QString("delta: %1").arg(d, 0, 'E', 3);
// str == "delta: 1.234E+01"

Véase también QLocale::toString(), QLocale::FloatingPointPrecisionOption, y Number formats.

[static] QString QString::asprintf(const char *cformat, ...)

Construye de forma segura una cadena formateada a partir de la cadena de formato cformat y una lista arbitraria de argumentos.

La cadena de formato admite los especificadores de conversión, los modificadores de longitud y los indicadores proporcionados por printf() en la biblioteca estándar de C++. La cadena cformat y los argumentos %s deben estar codificados en UTF-8.

QString result;
QTextStream(&result) << "pi = " << 3.14;
// result == "pi = 3.14"

Para translations, especialmente si las cadenas contienen más de una secuencia de escape, debería considerar el uso de la función arg() en su lugar. Esto permite que el traductor controle el orden de las sustituciones.

Véase también arg().

[since 6.6] QString &QString::assign(QAnyStringView v)

Sustituye el contenido de esta cadena por una copia de v y devuelve una referencia a esta cadena.

El tamaño de esta cadena será igual al tamaño de v, convertido a UTF-16 como por v.toString(). Sin embargo, a diferencia de QAnyStringView::toString(), esta función sólo asigna memoria si el tamaño estimado excede la capacidad de esta cadena o si esta cadena es compartida.

Esta función se introdujo en Qt 6.6.

Véase también QAnyStringView::toString().

[since 6.6] template <typename InputIterator, QString::if_compatible_iterator<InputIterator> = true> QString &QString::assign(InputIterator first, InputIterator last)

Sustituye el contenido de esta cadena por una copia de los elementos del rango del iterador [first, last) y devuelve una referencia a esta cadena.

El tamaño de esta cadena será igual a la longitud decodificada de los elementos del rango [first, last), que no tiene por qué ser la misma que la longitud del propio rango, ya que esta función recodifica de forma transparente el conjunto de caracteres de entrada a UTF-16.

Esta función sólo asignará memoria si el número de elementos en el rango, o, para entrada no codificada a UTF-16, el tamaño máximo posible de la cadena resultante, excede la capacidad de esta cadena, o si esta cadena es compartida.

Restricciones

Participa en la resolución de sobrecargas sólo si InputIterator cumple los requisitos de un LegacyInputIterator y el value_type de InputIterator es uno de los siguientes tipos de caracteres:

• QChar
• QLatin1Char
• char
• unsigned char
• signed char
• char8_t
• char16_t
• (en plataformas, como Windows, donde es un tipo de 16 bits) wchar_t
• char32_t

Esta función se introdujo en Qt 6.6.

[since 6.6] QString &QString::assign(qsizetype n, QChar c)

Sustituye el contenido de esta cadena por n copias de c y devuelve una referencia a esta cadena.

El tamaño de esta cadena será igual a n, que tiene que ser no negativo.

Esta función sólo asignará memoria si n excede la capacidad de esta cadena o si esta cadena es compartida.

Esta función se introdujo en Qt 6.6.

Véase también fill().

const QChar QString::at(qsizetype position) const

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

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

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

QChar &QString::back()

Devuelve una referencia al último carácter de la cadena. Igual que operator[](size() - 1).

Esta función se proporciona por compatibilidad con STL.

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

QChar QString::back() const

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

Esta función se proporciona por compatibilidad con STL.

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

QString::iterator QString::begin()

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

Véase también constBegin() y end().

QString::const_iterator QString::begin() const

qsizetype QString::capacity() const

Devuelve el número máximo de caracteres que se pueden almacenar en la cadena sin forzar una reasignación.

El único propósito de esta función es proporcionar un medio para ajustar el uso de memoria de QString. En general, rara vez necesitará llamar a esta función. Si desea saber cuántos caracteres hay en la cadena, llame a size().

Véase también reserve() y squeeze().

QString::const_iterator QString::cbegin() const

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

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

QString::const_iterator QString::cend() const

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

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

void QString::chop(qsizetype n)

Elimina n caracteres 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.

Ejemplo:

QString str("LOGOUT\r\n");
str.chop(2);
// str == "LOGOUT"

Si desea eliminar caracteres del principio de la cadena, utilice remove() en su lugar.

Véase también truncate(), resize(), remove() y QStringView::chop().

Devuelve una cadena que contiene los size() - len caracteres más a la izquierda de esta cadena.

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

void QString::clear()

Borra el contenido de la cadena y la hace nula.

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

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

Compara la cadena s1 con la cadena 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 (por defecto), la comparación distingue entre mayúsculas y minúsculas; en caso contrario, la comparación no distingue entre mayúsculas y minúsculas.

La comparación entre mayúsculas y minúsculas se basa exclusivamente en los valores numéricos Unicode de los caracteres y es muy rápida, pero no es lo que esperaría un humano. Considere la posibilidad de ordenar cadenas visibles para el usuario con localeAwareCompare().

int x = QString::compare("aUtO", "AuTo", Qt::CaseInsensitive);  // x == 0
int y = QString::compare("auto", "Car", Qt::CaseSensitive);     // y > 0
int z = QString::compare("auto", "Car", Qt::CaseInsensitive);   // z < 0

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

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

Realiza una comparación de esto con ch, utilizando la configuración de sensibilidad a mayúsculas y minúsculas cs.

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

Igual que compare(*this, other, cs).

[noexcept] int QString::compare(QStringView s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Realiza una comparación de esto con s, utilizando la configuración de sensibilidad a mayúsculas y minúsculas cs.

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

Compara léxicamente esta cadena con la cadena other y devuelve un entero negativo si esta cadena es menor que other, un entero positivo si es mayor que other, y cero si son iguales.

Igual que compare(*this, other, cs).

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

Realiza una comparación de s1 y s2, utilizando la configuración de mayúsculas y minúsculas cs.

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

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

Realiza una comparación de s1 y s2, utilizando la configuración de mayúsculas y minúsculas cs.

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

QString::const_iterator QString::constBegin() const

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

Véase también begin() y constEnd().

const QChar *QString::constData() const

Devuelve un puntero a los datos almacenados en QString. El puntero puede utilizarse para acceder a los caracteres que componen la cadena.

Tenga en cuenta que el puntero sólo será válido mientras no se modifique la cadena.

Véase también data(), operator[]() y fromRawData().

QString::const_iterator QString::constEnd() const

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

Véase también constBegin() y end().

bool QString::contains(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const

Devuelve true si la expresión regular re coincide en algún lugar de esta cadena; en caso contrario devuelve false.

Si la coincidencia es correcta y rmatch no es nullptr, también escribe los resultados de la coincidencia en el objeto QRegularExpressionMatch apuntado por rmatch.

Véase también QRegularExpression::match().

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

Devuelve true si esta cadena contiene una ocurrencia 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.

Ejemplo:

QString str = "Peter Pan";
str.contains("peter", Qt::CaseInsensitive);    // returns true

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

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

Devuelve true si esta cadena contiene una ocurrencia del carácter ch; en caso contrario devuelve false.

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

Devuelve true si esta cadena contiene una ocurrencia de la cadena latina-1 str; en caso contrario devuelve false.

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

Devuelve true si esta cadena contiene una ocurrencia de la vista 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, la búsqueda no distingue entre mayúsculas y minúsculas.

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

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

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

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

qsizetype QString::count(const QRegularExpression &re) const

Devuelve el número de veces que la expresión regular re coincide en la cadena.

Por razones históricas, esta función cuenta las coincidencias que se solapan, por lo que en el ejemplo siguiente, hay cuatro instancias de "ana" o "ama":

QString str = "banana and panama";
str.count(QRegularExpression("a[nm]a"));    // returns 4

Este comportamiento es diferente al de simplemente iterar sobre las coincidencias en la cadena utilizando QRegularExpressionMatchIterator.

Véase también QRegularExpression::globalMatch().

qsizetype QString::count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve el número de apariciones del carácter ch en la cadena.

Si cs es Qt::CaseSensitive (por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, la búsqueda no distingue entre mayúsculas y minúsculas.

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

[since 6.0] qsizetype QString::count(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve el número de apariciones (potencialmente solapadas) de la vista de cadena str en esta cadena.

Si cs es Qt::CaseSensitive (por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, la búsqueda no distingue entre mayúsculas y minúsculas.

Esta función se introdujo en Qt 6.0.

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

QString::const_reverse_iterator QString::crbegin() const

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

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

QString::const_reverse_iterator QString::crend() const

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

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

QChar *QString::data()

Devuelve un puntero a los datos almacenados en QString. El puntero puede utilizarse para acceder a los caracteres que componen la cadena y modificarlos.

A diferencia de constData() y unicode(), los datos devueltos siempre terminan en '\0'.

Ejemplo:

QString str = "Hola mundo";QChar *data = str.data();while (!data->isNull()) {    qDebug() << data->unicode();
   ++data; }

Tenga en cuenta que el puntero sólo es válido mientras la cadena no se modifique por otros medios. Para el acceso de sólo lectura, constData() es más rápido porque nunca provoca una copia profunda.

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

const QChar *QString::data() const

Véase también fromRawData().

QString::iterator QString::end()

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

Véase también begin() y constEnd().

QString::const_iterator QString::end() const

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

Devuelve true si la cadena termina en s; en caso contrario devuelve false.

Si cs es Qt::CaseSensitive (por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, la búsqueda no distingue entre mayúsculas y minúsculas.

QString str = "Bananas";
str.endsWith("anas");         // returns true
str.endsWith("pple");         // returns false

Véase también startsWith().

bool QString::endsWith(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve true si la cadena termina en c; en caso contrario devuelve false.

bool QString::endsWith(QLatin1StringView s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

Devuelve true si la cadena termina con la vista 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, la búsqueda no distingue entre mayúsculas y minúsculas.

Véase también startsWith().

[since 6.1] QString::iterator QString::erase(QString::const_iterator first, QString::const_iterator last)

Borra de la cadena los caracteres del rango semiabierto [ first, last ). Devuelve un iterador al carácter inmediatamente posterior al último carácter borrado (es decir, el carácter referido por last antes del borrado).

Esta función se introdujo en Qt 6.1.

[since 6.5] QString::iterator QString::erase(QString::const_iterator it)

Elimina de la cadena el carácter indicado por it. Devuelve un iterador al carácter inmediatamente posterior al carácter borrado.

QString c = "abcdefg";
auto it = c.erase(c.cbegin()); // c is now "bcdefg"; "it" points to "b"

Esta función se introdujo en Qt 6.5.

QString &QString::fill(QChar ch, qsizetype size = -1)

Establece cada carácter de la cadena al carácter ch. Si size es distinto de -1 (por defecto), la cadena se redimensiona previamente a size.

Ejemplo:

QString str = "Berlin";
str.fill('z');
// str == "zzzzzz"

str.fill('A', 2);
// str == "AA"

Véase también resize().

Devuelve una cadena que contiene los primeros n caracteres de esta cadena, (es decir, desde el principio de esta cadena hasta, pero sin incluir, el elemento en la posición de índice n).

QString x = "Pineapple";
QString y = x.first(4);      // y == "Pine"

Estas funciones se introdujeron en Qt 6.0.

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

[static] QString QString::fromCFString(CFStringRef string)

Construye un nuevo QString que contiene una copia de string CFString.

[static, since 6.6] QString QString::fromEcmaString(emscripten::val jsString)

Convierte la cadena ECMAScript jsString a QString. El comportamiento es indefinido si el parámetro proporcionado no es una cadena.

Esta función se introdujo en Qt 6.6.

Véase también toEcmaString().

[static] QString QString::fromLatin1(const char *str, qsizetype size)

Devuelve un QString inicializado con los primeros size caracteres de la cadena Latin-1 str.

Si size es -1, se utiliza strlen(str) en su lugar.

Véase también toLatin1(), fromUtf8() y fromLocal8Bit().

[static, since 6.0] QString QString::fromLatin1(QByteArrayView str)

Devuelve un QString inicializado con la cadena Latin-1 str.

Esta función se introdujo en Qt 6.0.

[static] QString QString::fromLatin1(const QByteArray &str)

Devuelve un QString inicializado con la cadena Latin-1 str.

[static] QString QString::fromLocal8Bit(const char *str, qsizetype size)

Devuelve un QString inicializado con los primeros size caracteres de la cadena de 8 bits str.

Si size es -1, se utiliza strlen(str) en su lugar.

En sistemas Unix es equivalente a fromUtf8(). Tenga en cuenta que en los sistemas Apple esta función no tiene en cuenta NSString.defaultCStringEncoding o CFStringGetSystemEncoding(), ya que estas funciones suelen devolver la codificación heredada "Western (Mac OS Roman)", que no debería utilizarse en los sistemas operativos Apple modernos. En Windows se utiliza la página de códigos actual del sistema.

Véase también toLocal8Bit(), fromLatin1(), y fromUtf8().

[static, since 6.0] QString QString::fromLocal8Bit(QByteArrayView str)

Devuelve un QString inicializado con la cadena de 8 bits str.

En sistemas Unix esto es equivalente a fromUtf8(). Tenga en cuenta que en los sistemas Apple esta función no tiene en cuenta NSString.defaultCStringEncoding o CFStringGetSystemEncoding(), ya que estas funciones suelen devolver la codificación heredada "Western (Mac OS Roman)", que no debería utilizarse en los sistemas operativos Apple modernos. En Windows se utiliza la página de códigos actual del sistema.

Esta función se introdujo en Qt 6.0.

[static] QString QString::fromLocal8Bit(const QByteArray &str)

Devuelve un QString inicializado con la cadena de 8 bits str.

En sistemas Unix esto es equivalente a fromUtf8(). Tenga en cuenta que en los sistemas Apple esta función no tiene en cuenta NSString.defaultCStringEncoding o CFStringGetSystemEncoding(), ya que estas funciones suelen devolver la codificación heredada "Western (Mac OS Roman)", que no debería utilizarse en los sistemas operativos Apple modernos. En Windows se utiliza la página de códigos actual del sistema.

[static] QString QString::fromNSString(const NSString *string)

Construye un nuevo QString que contiene una copia de string NSString.

[static, since 6.10] QString QString::fromRawData(const char16_t *unicode, qsizetype size)

Construye un QString que utiliza los primeros size caracteres Unicode de la matriz unicode. Los datos de unicode no se copian. El invocador debe poder garantizar que unicode no se borrará ni modificará mientras exista QString (o una copia no modificada del mismo).

Cualquier intento de modificar QString o copias del mismo hará que se cree una copia profunda de los datos, asegurando que los datos en bruto no se modifican.

He aquí un ejemplo de cómo podemos utilizar un QRegularExpression sobre datos brutos en memoria sin necesidad de copiar los datos en un QString:

QRegularExpression pattern("\u00A4");
static const char16_t unicode[] = {
        0x005A, 0x007F, 0x00A4, 0x0060,
        0x1009, 0x0020, 0x0020};

QString str = QString::fromRawData(unicode, std::size(unicode));
if (str.contains(pattern)) {
    // ...
}

Esta función se introdujo en Qt 6.10.

Véase también fromUtf16(), setRawData(), data(), constData(), nullTerminate(), y nullTerminated().

[static] QString QString::fromRawData(const QChar *unicode, qsizetype size)

[static] QString QString::fromStdString(const std::string &str)

Devuelve una copia de la cadena str. Se supone que la cadena dada está codificada en UTF-8, y se convierte a QString utilizando la función fromUtf8().

Véase también fromLatin1(), fromLocal8Bit(), fromUtf8() y QByteArray::fromStdString().

[static] QString QString::fromStdU16String(const std::u16string &str)

Devuelve una copia de la cadena str. Se supone que la cadena dada está codificada en UTF-16, y se convierte a QString utilizando la función fromUtf16().

Véase también fromUtf16(), fromStdWString() y fromStdU32String().

[static] QString QString::fromStdU32String(const std::u32string &str)

Devuelve una copia de la cadena str. Se supone que la cadena dada está codificada en UTF-32, y se convierte a QString utilizando la función fromUcs4().

Véase también fromUcs4(), fromStdWString() y fromStdU16String().

[static] QString QString::fromStdWString(const std::wstring &str)

Devuelve una copia de la cadena str. Se supone que la cadena dada está codificada en utf16 si el tamaño de wchar_t es de 2 bytes (por ejemplo, en windows) y en ucs4 si el tamaño de wchar_t es de 4 bytes (la mayoría de los sistemas Unix).

Véase también fromUtf16(), fromLatin1(), fromLocal8Bit(), fromUtf8(), fromUcs4(), fromStdU16String() y fromStdU32String().

[static] QString QString::fromUcs4(const char32_t *unicode, qsizetype size = -1)

Devuelve un QString inicializado con los primeros size caracteres de la cadena Unicode unicode (codificada como UTF-32).

Si size es -1 (por defecto), unicode debe estar '\0'-terminado.

Véase también toUcs4(), fromUtf16(), utf16(), setUtf16(), fromWCharArray() y fromStdU32String().

[static] QString QString::fromUtf8(const char *str, qsizetype size)

Devuelve un QString inicializado con los primeros size bytes de la cadena UTF-8 str.

Si size es -1, se utiliza strlen(str) en su lugar.

UTF-8 es un códec Unicode y puede representar todos los caracteres de una cadena Unicode como QString. Sin embargo, con UTF-8 es posible que se produzcan secuencias no válidas y, si se encuentra alguna, se sustituirá por uno o varios "caracteres de sustitución", o se suprimirá. Entre ellas se incluyen las secuencias no Unicode, los no caracteres, las secuencias demasiado largas o los puntos de código sustitutivos codificados en UTF-8.

Esta función puede utilizarse para procesar datos entrantes de forma incremental siempre que todos los caracteres UTF-8 terminen en los datos entrantes. Cualquier carácter no terminado al final de la cadena será reemplazado o suprimido. Para realizar una descodificación con estado, utilice QStringDecoder.

Véase también toUtf8(), fromLatin1() y fromLocal8Bit().

[static, since 6.0] QString QString::fromUtf8(QByteArrayView str)

Devuelve un QString inicializado con la cadena UTF-8 str.

Esta función se introdujo en Qt 6.0.

[static] QString QString::fromUtf8(const QByteArray &str)

Devuelve un QString inicializado con la cadena UTF-8 str.

[static, since 6.1] QString QString::fromUtf8(const char8_t *str)

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

Esta función se introdujo en Qt 6.1.

[static, since 6.0] QString QString::fromUtf8(const char8_t *str, qsizetype size)

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

Esta función se introdujo en Qt 6.0.

[static] QString QString::fromUtf16(const char16_t *unicode, qsizetype size = -1)

Devuelve un QString inicializado con los primeros size caracteres de la cadena Unicode unicode (codificada ISO-10646-UTF-16).

Si size es -1 (por defecto), unicode debe ser '\0'-terminado.

Esta función comprueba si existe una marca de orden de bytes (BOM). Si falta, se asume el orden de bytes del host.

Esta función es lenta en comparación con otras conversiones Unicode. Utilice QString(const QChar *, qsizetype) o QString(const QChar *) si es posible.

QString hace una copia profunda de los datos Unicode.

Véase también utf16(), setUtf16(), y fromStdU16String().

[static] QString QString::fromWCharArray(const wchar_t *string, qsizetype size = -1)

Lee las primeras unidades de código size de la matriz wchar_t a cuyo inicio apunta string, convirtiéndolas a Unicode y devolviendo el resultado como QString. Se asume que la codificación utilizada por wchar_t es UTF-32 si el tamaño del tipo es de cuatro bytes o UTF-16 si su tamaño es de dos bytes.

Si size es -1 (por defecto), string debe ser '\0'-terminado.

Véase también fromUtf16(), fromLatin1(), fromLocal8Bit(), fromUtf8(), fromUcs4() y fromStdWString().

QChar &QString::front()

Devuelve una referencia al primer carácter de la cadena. Igual que operator[](0).

Esta función se proporciona por compatibilidad con STL.

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

QChar QString::front() const

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

Esta función se proporciona por compatibilidad con STL.

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

qsizetype QString::indexOf(QLatin1StringView str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición del índice de la primera aparición de la cadena Latin-1 vista por str en esta cadena, buscando hacia adelante desde la posición del í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, la búsqueda no distingue entre mayúsculas y minúsculas.

Ejemplo:

QString x = "sticky question";
QString y = "sti";
x.indexOf(y);               // returns 0
x.indexOf(y, 1);            // returns 10
x.indexOf(y, 10);           // returns 10
x.indexOf(y, 11);           // returns -1

Si from es -1, la búsqueda comienza en el último carácter; si es -2, en el penúltimo carácter y así sucesivamente.

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

qsizetype QString::indexOf(const QRegularExpression &re, qsizetype from = 0, QRegularExpressionMatch *rmatch = nullptr) const

Devuelve la posición del índice de la primera coincidencia de la expresión regular re en la cadena, buscando hacia adelante desde la posición del índice from. Devuelve -1 si re no coincide en ninguna parte.

Si la coincidencia es correcta y rmatch no es nullptr, también escribe los resultados de la coincidencia en el objeto QRegularExpressionMatch apuntado por rmatch.

Ejemplo:

QString str = "the minimum";
str.indexOf(QRegularExpression("m[aeiou]"), 0);       // returns 4

QRegularExpressionMatch match;
str.indexOf(QRegularExpression("m[aeiou]"), 0, &match);       // returns 4
// match.captured() == mi

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

Devuelve la posición del índice de la primera aparición de la cadena str en esta cadena, buscando hacia adelante desde la posición del í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, la búsqueda no distingue entre mayúsculas y minúsculas.

Ejemplo:

QString x = "sticky question";
QString y = "sti";
x.indexOf(y);               // returns 0
x.indexOf(y, 1);            // returns 10
x.indexOf(y, 10);           // returns 10
x.indexOf(y, 11);           // returns -1

Si from es -1, la búsqueda comienza en el último carácter; si es -2, en el penúltimo carácter y así sucesivamente.

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

qsizetype QString::indexOf(QChar ch, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición del índice de la primera aparición del carácter ch en esta cadena, buscando hacia adelante desde la posición del índice from. Devuelve -1 si no se encuentra ch.

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

Devuelve la posición del índice de la primera aparición de la vista de cadena str en esta cadena, buscando hacia adelante desde la posición del í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, la búsqueda no distingue entre mayúsculas y minúsculas.

Si from es -1, la búsqueda comienza en el último carácter; si es -2, en el penúltimo carácter y así sucesivamente.

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

QString &QString::insert(qsizetype position, const QString &str)

Inserta la cadena str en el índice dado position y devuelve una referencia a esta cadena.

Ejemplo:

QString str = "Meal";
str.insert(1, QString("ontr"));
// str == "Montreal"

Esta cadena crece para acomodar la inserción. Si position está más allá del final de la cadena, se añaden caracteres de espacio a la cadena hasta llegar a este position, seguido de str.

Véase también append(), prepend(), replace(), y remove().

QString &QString::insert(qsizetype position, QChar ch)

Inserta ch en el índice dado position en la cadena.

Esta cadena crece para acomodar la inserción. Si position está más allá del final de la cadena, se añaden caracteres de espacio a la cadena hasta llegar a este position, seguido de ch.

QString &QString::insert(qsizetype position, QLatin1StringView str)

Inserta la cadena Latin-1 vista por str en el índice dado position.

Esta cadena crece para acomodar la inserción. Si position está más allá del final de la cadena, se añaden caracteres de espacio a la cadena hasta llegar a este position, seguido de str.

[since 6.0] QString &QString::insert(qsizetype position, QStringView str)

Inserta la cadena vista str en el índice dado position y devuelve una referencia a esta cadena.

Esta cadena crece para acomodar la inserción. Si position está más allá del final de la cadena, se añaden caracteres de espacio a la cadena hasta llegar a este position, seguido de str.

Esta función se introdujo en Qt 6.0.

[since 6.5] QString &QString::insert(qsizetype position, QUtf8StringView str)

Inserta la vista de cadena UTF-8 str en el índice dado position.

Esta cadena crece para acomodar la inserción. Si position está más allá del final de la cadena, se añaden caracteres de espacio a la cadena hasta llegar a este position, seguido de str.

Esta función se introdujo en Qt 6.5.

QString &QString::insert(qsizetype position, const QByteArray &str)

Interpreta el contenido de str como UTF-8, inserta la cadena Unicode que codifica en el índice dado position y devuelve una referencia a esta cadena.

Esta cadena crece para acomodar la inserción. Si position está más allá del final de la cadena, se añaden caracteres de espacio a la cadena hasta llegar a este position, seguido de str.

Esta función no está disponible cuando QT_NO_CAST_FROM_ASCII está definido.

QString &QString::insert(qsizetype position, const char *str)

Inserta la cadena C str en el índice dado position y devuelve una referencia a esta cadena.

Esta cadena crece para acomodar la inserción. Si position está más allá del final de la cadena, se añaden caracteres de espacio a la cadena hasta llegar a este position, seguido de str.

Esta función no está disponible cuando QT_NO_CAST_FROM_ASCII está definido.

QString &QString::insert(qsizetype position, const QChar *unicode, qsizetype size)

Inserta los primeros caracteres size de la matriz QChar unicode en el índice position dado en la cadena.

Esta cadena crece para acomodar la inserción. Si position está más allá del final de la cadena, se añaden caracteres de espacio a la cadena hasta llegar a este position, seguidos de size caracteres de la matriz QChar unicode .

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

Devuelve true si la cadena no tiene caracteres; en caso contrario devuelve false.

Ejemplo:

QString().isEmpty();            // returns true
QString("").isEmpty();          // returns true
QString("x").isEmpty();         // returns false
QString("abc").isEmpty();       // returns false

Véase también size().

bool QString::isLower() const

Devuelve true si la cadena está en minúsculas, es decir, es idéntica a su plegado toLower().

Tenga en cuenta que esto no significa que la cadena no contenga letras mayúsculas (algunas letras mayúsculas no tienen un plegado en minúsculas; toLower() no las modifica). Para más información, consulte el estándar Unicode, sección 3.13.

Véase también QChar::toLower() y isUpper().

[constexpr] bool QString::isNull() const

Devuelve true si esta cadena es nula; en caso contrario devuelve false.

Ejemplo:

QString().isNull();             // returns true
QString("").isNull();           // returns false
QString("abc").isNull();        // returns false

Qt hace una distinción entre cadenas nulas y cadenas vacías por razones históricas. Para la mayoría de las aplicaciones, lo que importa es si una cadena contiene o no algún dato, y esto puede determinarse utilizando la función isEmpty().

Véase también isEmpty().

bool QString::isRightToLeft() const

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

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

bool QString::isUpper() const

Devuelve true si la cadena está en mayúsculas, es decir, es idéntica a su plegado toUpper().

Tenga en cuenta que esto no significa que la cadena no contenga letras minúsculas (algunas letras minúsculas no tienen un plegado en mayúsculas; toUpper() no las modifica). Para más información, consulte el estándar Unicode, sección 3.13.

Véase también QChar::toUpper() y isLower().

[noexcept] bool QString::isValidUtf16() const

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

Tenga en cuenta que esta función no realiza ninguna validación especial de los datos; simplemente comprueba si se pueden descodificar correctamente a partir de UTF-16. Se asume que los datos están en el orden de bytes del host; la presencia de un BOM no tiene sentido.

Véase también QStringView::isValidUtf16().

Devuelve la cadena que contiene los últimos n caracteres de esta cadena.

QString x = "Pineapple";
QString y = x.last(5);      // y == "apple"

Estas funciones se introdujeron en Qt 6.0.

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

qsizetype QString::lastIndexOf(const QRegularExpression &re, qsizetype from, QRegularExpressionMatch *rmatch = nullptr) const

Devuelve la posición del índice de la última coincidencia de la expresión regular re en la cadena, que comienza antes de la posición del índice from.

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.

Devuelve -1 si re no coincide en ninguna parte.

Si la coincidencia tiene éxito y rmatch no es nullptr, también escribe los resultados de la coincidencia en el objeto QRegularExpressionMatch apuntado por rmatch.

Ejemplo:

QString str = "the minimum";
str.lastIndexOf(QRegularExpression("m[aeiou]"));      // returns 8

QRegularExpressionMatch match;
str.lastIndexOf(QRegularExpression("m[aeiou]"), -1, &match);      // returns 8
// match.captured() == mu

qsizetype QString::lastIndexOf(const QString &str, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición del índice de la última aparición de la cadena str en esta cadena, buscando hacia atrás desde la posición del índice from.

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.

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, la búsqueda no distingue entre mayúsculas y minúsculas.

Ejemplo:

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

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

[noexcept, since 6.3] qsizetype QString::lastIndexOf(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Esta función se introdujo en Qt 6.3.

[since 6.2] qsizetype QString::lastIndexOf(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición del índice de la última aparición de la cadena str en esta cadena. 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, la búsqueda no distingue entre mayúsculas y minúsculas.

Ejemplo:

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

Esta función se introdujo en Qt 6.2.

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

[noexcept, since 6.2] qsizetype QString::lastIndexOf(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición del índice de la última aparición de la vista de cadena str en esta cadena. 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, la búsqueda no distingue entre mayúsculas y minúsculas.

Esta función se introdujo en Qt 6.2.

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

[since 6.2] qsizetype QString::lastIndexOf(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const

Devuelve la posición del índice de la última coincidencia de la expresión regular re en la cadena. Devuelve -1 si re no coincide en ninguna parte.

Si la coincidencia es correcta y rmatch no es nullptr, también escribe los resultados de la coincidencia en el objeto QRegularExpressionMatch apuntado por rmatch.

Ejemplo:

QString str = "the minimum";
str.lastIndexOf(QRegularExpression("m[aeiou]"));      // returns 8

QRegularExpressionMatch match;
str.lastIndexOf(QRegularExpression("m[aeiou]"), -1, &match);      // returns 8
// match.captured() == mu

Esta función se introdujo en Qt 6.2.

[since 6.2] qsizetype QString::lastIndexOf(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición del índice de la última aparición de la cadena str en esta cadena. 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, la búsqueda no distingue entre mayúsculas y minúsculas.

Ejemplo:

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

Esta función se introdujo en Qt 6.2.

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

qsizetype QString::lastIndexOf(QChar ch, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición del índice de la última aparición del carácter ch en esta cadena, buscando hacia atrás desde la posición del índice from.

qsizetype QString::lastIndexOf(QLatin1StringView str, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición del índice de la última aparición de la cadena Latin-1 vista por str en esta cadena, buscando hacia atrás desde la posición del índice from.

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.

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, la búsqueda no distingue entre mayúsculas y minúsculas.

Ejemplo:

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // returns 6
x.lastIndexOf(y, 6);        // returns 6
x.lastIndexOf(y, 5);        // returns 2
x.lastIndexOf(y, 1);        // returns -1

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

[noexcept] qsizetype QString::lastIndexOf(QStringView str, qsizetype from, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición del índice de la última aparición de la vista de cadena str en esta cadena, buscando hacia atrás desde la posición del índice from.

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.

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, la búsqueda no distingue entre mayúsculas y minúsculas.

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

Devuelve una subcadena que contiene los n caracteres más a la izquierda de esta cadena (es decir, desde el principio de esta cadena hasta, pero sin incluir, el elemento en la posición de índice n).

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

Se devuelve la cadena completa si n es mayor o igual que size(), o menor que cero.

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

QString QString::leftJustified(qsizetype width, QChar fill = u' ', bool truncate = false) const

Devuelve una cadena de tamaño width que contiene esta cadena rellenada por el carácter fill.

Si truncate es false y size() de la cadena es mayor que width, entonces la cadena devuelta es una copia de la cadena.

QString s = "apple";
QString t = s.leftJustified(8, '.');    // t == "apple..."

Si truncate es true y size() de la cadena es mayor que width, entonces cualquier carácter en una copia de la cadena después de la posición width se elimina, y se devuelve la copia.

QString str = "Pineapple";
str = str.leftJustified(5, '.', true);    // str == "Pinea"

Véase también rightJustified().

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

Devuelve el número de caracteres de esta cadena. Equivale a size().

Véase también resize().

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

Compara s1 con s2 y devuelve un entero menor, igual o mayor que cero si s1 es menor, igual o mayor que s2.

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

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

[since 6.0] int QString::localeAwareCompare(QStringView other) const

Compara esta cadena con la cadena other y devuelve un entero menor, igual o mayor que cero si esta cadena es menor, igual o mayor que la cadena other.

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

Igual que localeAwareCompare(*this, other).

Esta función se introdujo en Qt 6.0.

Véase también Comparing Strings.

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

Compara esta cadena con la cadena other y devuelve un entero menor, igual o mayor que cero si esta cadena es menor, igual o mayor que la cadena other.

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

Igual que localeAwareCompare(*this, other).

Véase también Comparing Strings.

[static, since 6.0] int QString::localeAwareCompare(QStringView s1, QStringView s2)

Compara s1 con s2 y devuelve un entero menor, igual o mayor que cero si s1 es menor, igual o mayor que s2.

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

Esta función se introdujo en Qt 6.0.

Véase también Comparing Strings.

Devuelve el número máximo de elementos que teóricamente puede contener la cadena. En la práctica, el número puede ser mucho menor, limitado por la cantidad de memoria disponible en el sistema.

Estas funciones se introdujeron en Qt 6.8.

Devuelve una cadena que contiene n caracteres de esta cadena, comenzando en el índice especificado position hasta, pero sin incluir, el elemento en la posición del índice \a position + n.

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

Devuelve una cadena nula si el índice position excede la longitud de la cadena. 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 disponibles a partir del position especificado.

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

QString QString::normalized(QString::NormalizationForm mode, QChar::UnicodeVersion version = QChar::Unicode_Unassigned) const

Devuelve la cadena en la normalización Unicode dada mode, según la version dada del estándar Unicode.

[since 6.10] QString &QString::nullTerminate()

Si estos datos de cadena no están terminados en cero, este método hará una copia profunda de los datos y los terminará en cero.

Un QString está terminado en cero por defecto, sin embargo, en algunos casos (por ejemplo, cuando se utiliza fromRawData()), los datos de la cadena no terminan necesariamente con un carácter \0, lo que podría ser un problema al llamar a métodos que esperan una cadena terminada en cero.

Esta función se introdujo en Qt 6.10.

Véase también nullTerminated(), fromRawData() y setRawData().

Devuelve una copia de esta cadena que siempre está terminada en cero.

Estas funciones se introdujeron en Qt 6.10.

Véase también nullTerminate(), fromRawData() y setRawData().

[static] QString QString::number(long n, int base = 10)

Devuelve una cadena equivalente al número n según la base especificada base.

La base es 10 por defecto y debe estar entre 2 y 36. Para bases distintas de 10, n se trata como un entero sin signo.

El formato siempre utiliza QLocale::C, es decir, English/UnitedStates. Para obtener una representación de cadena localizada de un número, utilice QLocale::toString() con la configuración regional adecuada.

long a = 63;
QString s = QString::number(a, 16);             // s == "3f"
QString t = QString::number(a, 16).toUpper();     // t == "3F"

Véase también setNum().

[static] QString QString::number(double n, char format = 'g', int precision = 6)

Devuelve una cadena que representa el número de punto flotante n.

Devuelve una cadena que representa n, formateada según los formatos especificados format y precision.

Para formatos con exponente, el exponente mostrará su signo y tendrá al menos dos dígitos, rellenando el exponente con cero a la izquierda si es necesario.

Véase también setNum(), QLocale::toString(), QLocale::FloatingPointPrecisionOption, y Number formats.

[static] QString QString::number(int n, int base = 10)

[static] QString QString::number(qlonglong n, int base = 10)

[static] QString QString::number(qulonglong n, int base = 10)

[static] QString QString::number(uint n, int base = 10)

[static] QString QString::number(ulong n, int base = 10)

QString &QString::prepend(const QString &str)

Antepone la cadena str al principio de esta cadena y devuelve una referencia a esta cadena.

Esta operación suele ser muy rápida(tiempo constante), ya que QString preasigna espacio extra al principio de los datos de la cadena, por lo que puede crecer sin reasignar toda la cadena cada vez.

Ejemplo:

QString x = "ship";
QString y = "air";
x.prepend(y);
// x == "airship"

Véase también append() y insert().

QString &QString::prepend(QChar ch)

Añade el carácter ch a esta cadena.

QString &QString::prepend(QLatin1StringView str)

Antepone la cadena Latin-1 vista por str a esta cadena.

[since 6.0] QString &QString::prepend(QStringView str)

Añade la vista de cadena str al principio de esta cadena y devuelve una referencia a esta cadena.

Esta función se introdujo en Qt 6.0.

[since 6.5] QString &QString::prepend(QUtf8StringView str)

Añade la vista de cadena UTF-8 str a esta cadena.

Esta función se introdujo en Qt 6.5.

QString &QString::prepend(const QByteArray &ba)

Añade la matriz de bytes ba a esta cadena. La matriz de bytes se convierte a Unicode mediante la función fromUtf8().

Puedes desactivar esta función definiendo QT_NO_CAST_FROM_ASCII cuando compiles tus aplicaciones. Esto puede ser útil si quieres asegurarte de que todas las cadenas visibles para el usuario pasan por QObject::tr(), por ejemplo.

QString &QString::prepend(const char *str)

Añade la cadena str a esta cadena. El puntero const char se convierte a Unicode mediante la función fromUtf8().

Puedes desactivar esta función definiendo QT_NO_CAST_FROM_ASCII cuando compiles tus aplicaciones. Esto puede ser útil si desea asegurarse de que todas las cadenas visibles para el usuario pasen por QObject::tr(), por ejemplo.

QString &QString::prepend(const QChar *str, qsizetype len)

Añade len caracteres de la matriz QChar str a esta cadena y devuelve una referencia a esta cadena.

void QString::push_back(const QString &other)

Esta función se proporciona por compatibilidad con STL, añadiendo la cadena other dada al final de esta cadena. Es equivalente a append(other).

Véase también append().

void QString::push_back(QChar ch)

Añade el carácter ch al final de la cadena.

void QString::push_front(const QString &other)

Esta función se proporciona por compatibilidad con STL, anteponiendo la cadena other dada al principio de esta cadena. Es equivalente a prepend(other).

Véase también prepend().

void QString::push_front(QChar ch)

Añade el carácter ch al principio de la cadena.

QString::reverse_iterator QString::rbegin()

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

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

QString::const_reverse_iterator QString::rbegin() const

QString &QString::remove(const QRegularExpression &re)

Elimina todas las apariciones de la expresión regular re en la cadena y devuelve una referencia a la cadena. Por ejemplo:

QString r = "Telephone";
r.remove(QRegularExpression("[aeiou]."));
// r == "The"

La eliminación de elementos preservará la capacidad de la cadena y no reducirá la cantidad de memoria asignada. Para eliminar la capacidad extra y liberar tanta memoria como sea posible, llame a squeeze() después del último cambio en el tamaño de la cadena.

Véase también indexOf(), lastIndexOf() y replace().

QString &QString::remove(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Elimina todas las apariciones del carácter ch en esta cadena, y devuelve una referencia a esta 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.

Ejemplo:

QString t = "Ali Baba";
t.remove(QChar('a'), Qt::CaseInsensitive);
// t == "li Bb"

Es lo mismo que replace(ch, "", cs).

La eliminación de elementos preservará la capacidad de la cadena y no reducirá la cantidad de memoria asignada. Para deshacerse de la capacidad extra y liberar tanta memoria como sea posible, llame a squeeze() después del último cambio en el tamaño de la cadena.

Véase también replace().

QString &QString::remove(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Elimina todas las apariciones de la cadena str dada en esta cadena, y devuelve una referencia a esta 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.

Esto es lo mismo que replace(str, "", cs).

La eliminación de elementos preservará la capacidad de la cadena y no reducirá la cantidad de memoria asignada. Para deshacerse de la capacidad extra y liberar tanta memoria como sea posible, llame a squeeze() después del último cambio en el tamaño de la cadena.

Véase también replace().

QString &QString::remove(qsizetype position, qsizetype n)

Elimina n caracteres de la cadena, comenzando en el índice position dado, y devuelve una referencia a la cadena.

Si el índice position especificado está dentro de la cadena, pero position + n está más allá del final de la cadena, la cadena se trunca en el índice position especificado.

Si n es <= 0 no se modifica nada.

QString s = "Montreal";
s.remove(1, 4);
// s == "Meal"

La eliminación de elementos preservará la capacidad de la cadena y no reducirá la cantidad de memoria asignada. Para deshacerse de la capacidad extra y liberar tanta memoria como sea posible, llame a squeeze() después del último cambio en el tamaño de la cadena.

Véase también insert() y replace().

QString &QString::remove(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Elimina cada ocurrencia de la cadena Latin-1 dada vista por str de esta cadena, y devuelve una referencia a esta cadena.

Si cs es Qt::CaseSensitive (el valor predeterminado), la búsqueda distingue entre mayúsculas y minúsculas; de lo contrario, la búsqueda no distingue entre mayúsculas y minúsculas.

Esto es lo mismo que replace(str, "", cs).

La eliminación de elementos preservará la capacidad de la cadena y no reducirá la cantidad de memoria asignada. Para deshacerse de la capacidad extra y liberar tanta memoria como sea posible, llame a squeeze() después del último cambio en el tamaño de la cadena.

Véase también replace().

[since 6.5] QString &QString::removeAt(qsizetype pos)

Elimina el carácter en el índice pos. Si pos está fuera de los límites (es decir, pos >= size()), esta función no hace nada.

Esta función se introdujo en Qt 6.5.

Véase también remove().

[since 6.5] QString &QString::removeFirst()

Elimina el primer carácter de esta cadena. Si la cadena está vacía, esta función no hace nada.

Esta función se introdujo en Qt 6.5.

Véase también remove().

[since 6.1] template <typename Predicate> QString &QString::removeIf(Predicate pred)

Elimina de la cadena todos los elementos para los que el predicado pred devuelve verdadero. Devuelve una referencia a la cadena.

Esta función se introdujo en Qt 6.1.

Véase también remove().

[since 6.5] QString &QString::removeLast()

Elimina el último carácter de esta cadena. Si la cadena está vacía, esta función no hace nada.

Esta función se introdujo en Qt 6.5.

Véase también remove().

QString::reverse_iterator QString::rend()

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

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

QString::const_reverse_iterator QString::rend() const

QString QString::repeated(qsizetype times) const

Devuelve una copia de esta cadena repetida el número especificado de times.

Si times es menor que 1, se devuelve una cadena vacía.

Ejemplo:

QString str("ab");
str.repeated(4);            // returns "abababab"

QString &QString::replace(qsizetype position, qsizetype n, const QString &after)

Sustituye los caracteres de n que comienzan en el índice position por la cadena after y devuelve una referencia a esta cadena.

Ejemplo:

QString x = "Say yes!";
QString y = "no";
x.replace(4, 3, y);
// x == "Say no!"

Véase también insert() y remove().

QString &QString::replace(const QRegularExpression &re, const QString &after)

Sustituye cada aparición de la expresión regular re en la cadena por after. Devuelve una referencia a la cadena. Por ejemplo:

QString s = "Banana";
s.replace(QRegularExpression("a[mn]"), "ox");
// s == "Boxoxa"

Para las expresiones regulares que contienen grupos de captura, las apariciones de \1, \2..., en after se sustituyen por la cadena capturada por el grupo de captura correspondiente.

QString t = "A <i>bon mot</i>.";
t.replace(QRegularExpression("<i>([^<]*)</i>"), "\\emph{\\1}");
// t == "A \\emph{bon mot}."

Véase también indexOf(), lastIndexOf(), remove(), QRegularExpression, y QRegularExpressionMatch.

QString &QString::replace(QChar before, QChar after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Sustituye cada aparición del carácter before por el carácter after y devuelve una referencia a esta cadena.

Si cs es Qt::CaseSensitive (por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, la búsqueda no distingue entre mayúsculas y minúsculas.

QString &QString::replace(QChar c, QLatin1StringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Sustituye cada aparición del carácter c por la cadena after y devuelve una referencia a esta cadena.

Si cs es Qt::CaseSensitive (por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, la búsqueda no distingue entre mayúsculas y minúsculas.

QString &QString::replace(QChar ch, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Sustituye cada aparición del carácter ch en la cadena por after y devuelve una referencia a esta cadena.

Si cs es Qt::CaseSensitive (por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, la búsqueda no distingue entre mayúsculas y minúsculas.

QString &QString::replace(QLatin1StringView before, QLatin1StringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Sustituye cada aparición en esta cadena de la cadena Latin-1 vista por before por la cadena Latin-1 vista por after, y devuelve una referencia a esta cadena.

Si cs es Qt::CaseSensitive (por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, la búsqueda no distingue entre mayúsculas y minúsculas.

QString &QString::replace(QLatin1StringView before, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Sustituye cada aparición en esta cadena de la cadena Latin-1 vista por before por la cadena after, y devuelve una referencia a esta cadena.

Si cs es Qt::CaseSensitive (por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, la búsqueda no distingue entre mayúsculas y minúsculas.

QString &QString::replace(const QString &before, QLatin1StringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Sustituye cada aparición de la cadena before por la cadena after y devuelve una referencia a esta cadena.

Si cs es Qt::CaseSensitive (por defecto), la búsqueda distingue entre mayúsculas y minúsculas; en caso contrario, la búsqueda no distingue entre mayúsculas y minúsculas.

QString &QString::replace(const QString &before, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Sustituye cada aparición de la cadena before por la cadena after y devuelve una referencia a esta 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.

Ejemplo:

QString str = "colour behaviour flavour neighbour";
str.replace(QString("ou"), QString("o"));
// str == "color behavior flavor neighbor"

Ejemplo:

QString equis = "xxxxxx";
equis.replace("xx", "x");
// equis == "xxx"

QString &QString::replace(qsizetype position, qsizetype n, QChar after)

Sustituye los caracteres de n que comienzan en el índice position por el carácter after y devuelve una referencia a esta cadena.

QString &QString::replace(qsizetype position, qsizetype n, const QChar *after, qsizetype alen)

Sustituye los caracteres de n que comienzan en el índice position por los primeros caracteres de alen de la matriz QChar after y devuelve una referencia a esta cadena.

n no debe ser negativo.

QString &QString::replace(const QChar *before, qsizetype blen, const QChar *after, qsizetype alen, Qt::CaseSensitivity cs = Qt::CaseSensitive)