En esta página

QStringList Class

La clase QStringList proporciona una lista de cadenas. Más información...

Encabezado: #include <QStringList>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

QStringList(const QList<QString> &other)
QStringList(const QString &str)
QStringList(QList<QString> &&other)
bool contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
bool contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
(since 6.9) QStringList filter(const QLatin1StringMatcher &matcher) const
QStringList filter(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QStringList filter(const QRegularExpression &re) const
(since 6.7) QStringList filter(const QStringMatcher &matcher) const
(since 6.7) QStringList filter(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
QStringList filter(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
qsizetype indexOf(QLatin1StringView str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
qsizetype indexOf(QStringView str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
qsizetype indexOf(const QString &str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
qsizetype indexOf(const QRegularExpression &re, qsizetype from = 0) const
QString join(const QString &separator) const
QString join(QChar separator) const
QString join(QLatin1StringView separator) const
QString join(QStringView separator) const
qsizetype lastIndexOf(QLatin1StringView str, qsizetype from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
qsizetype lastIndexOf(QStringView str, qsizetype from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
qsizetype lastIndexOf(const QString &str, qsizetype from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const
qsizetype lastIndexOf(const QRegularExpression &re, qsizetype from = -1) const
qsizetype removeDuplicates()
QStringList &replaceInStrings(const QString &before, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)
QStringList &replaceInStrings(const QRegularExpression &re, const QString &after)
QStringList &replaceInStrings(QStringView before, QStringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)
QStringList &replaceInStrings(QStringView before, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)
QStringList &replaceInStrings(const QString &before, QStringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)
void sort(Qt::CaseSensitivity cs = Qt::CaseSensitive)
QStringList operator+(const QStringList &other) const
QStringList &operator<<(const QString &str)
QStringList &operator<<(const QList<QString> &other)
QStringList &operator<<(const QStringList &other)
QStringList &operator=(const QList<QString> &other)
QStringList &operator=(QList<QString> &&other)

Descripción detallada

QStringList es una clase de tipo « QList » con algunas funciones adicionales que facilitan el manejo de listas de cadenas. Al igual que QList, QStringList es implícitamente compartida. Proporciona un acceso rápido basado en índices, así como inserciones y eliminaciones rápidas. Pasar listas de cadenas como parámetros de valor es rápido y seguro.

Toda la funcionalidad de ` QList` también se aplica a `QStringList`. Por ejemplo, se puede utilizar ` isEmpty()` para comprobar si la lista está vacía, y se pueden llamar a funciones como ` append()`, ` prepend()`, ` insert()`, ` replace()`, ` removeAll()`, ` removeAt()`, ` removeFirst()`, ` removeLast()` y ` removeOne()` para modificar una `QStringList`.

Inicialización

El constructor por defecto crea una lista vacía. Puedes utilizar el constructor con lista de inicialización para crear una lista con elementos:

    QStringList fonts = { "Arial", "Helvetica", "Times" };

Añadir cadenas

Se pueden añadir cadenas a una lista utilizando las funciones insert(), append(), operator+=() y operator<<().

operator<<() se puede utilizar para añadir cómodamente varios elementos a una lista:

    fonts << "Courier" << "Verdana";

Iteración sobre las cadenas

Véase «Iteración sobre contenedores».

Manipulación de las cadenas

QStringList proporciona varias funciones que permiten manipular el contenido de una lista. Se pueden concatenar todas las cadenas de una lista de cadenas en una sola cadena (con un separador opcional) utilizando la función ` join()` (). Por ejemplo:

    QString str = fonts.join(", ");
     // str == "Arial, Helvetica, Times, Courier"

El argumento de `join` puede ser un solo carácter o una cadena.

Para dividir una cadena en una lista de cadenas, utiliza la función ` QString::split()`:

    QStringList list;
    list = str.split(',');
     // list: ["Arial", "Helvetica", "Times", "Courier"]

El argumento de la función split puede ser un único carácter, una cadena o un ` QRegularExpression`.

Además, la función « operator+()» permite concatenar dos listas de cadenas en una sola. Para ordenar una lista de cadenas, utiliza la función « sort()».

QString La clase `list` también proporciona la función ` filter()`, que permite extraer una nueva lista que contenga únicamente aquellas cadenas que incluyan una subcadena concreta (o que coincidan con una expresión regular determinada):

    QStringList monospacedFonts = fonts.filter(QRegularExpression("Courier|Fixed"));

La función ` contains()` indica si la lista contiene una cadena determinada, mientras que la función ` indexOf()` devuelve el índice de la primera aparición de dicha cadena. Por su parte, la función ` lastIndexOf()` devuelve el índice de la última aparición de la cadena.

Por último, la función replaceInStrings() llama a QString::replace() sobre cada cadena de la lista de cadenas, una tras otra. Por ejemplo:

    QStringList files;
    files << "$QTDIR/src/moc/moc.y"
          << "$QTDIR/src/moc/moc.l"
          << "$QTDIR/include/qconfig.h";

    files.replaceInStrings("$QTDIR", "/usr/lib/qt");
    // files: [ "/usr/lib/qt/src/moc/moc.y", ...]

Véase también QString.

Documentación de funciones de miembro

QStringList::QStringList(const QList<QString> &other)

Crea una copia de ` other`.

Esta operación tarda un tiempo constante, ya que QStringList se comparte implícitamente. Esto hace que devolver un QStringList desde una función sea muy rápido. Si se modifica una instancia compartida, se copiará (copia al escribir), lo que lleva un tiempo lineal.

Véase también operator=().

QStringList::QStringList(const QString &str)

Crea una lista de cadenas que contiene la cadena dada: ` str`. Las listas más largas se crean fácilmente de esta manera:

    QStringList longerList = (QStringList() << str1 << str2 << str3);

Véase también append().

QStringList::QStringList(QList<QString> &&other)

Construcciones «move» extraídas de QList<QString>.

Tras una construcción correcta, other quedará vacío.

Esta es una función sobrecargada.

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

Devuelve « true » si la lista contiene la cadena « str »; en caso contrario, devuelve « false ».

Si cs es Qt::CaseSensitive (el valor por defecto), la comparación de cadenas distingue entre mayúsculas y minúsculas; en caso contrario, la comparación no distingue entre mayúsculas y minúsculas.

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

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

Devuelve « true » si la lista contiene la cadena en Latin-1 tal y como la interpreta « str »; en caso contrario, devuelve « false ».

Si cs es Qt::CaseSensitive (el valor por defecto), la comparación de cadenas distingue entre mayúsculas y minúsculas; en caso contrario, la comparación no distingue entre mayúsculas y minúsculas.

Esta es una función sobrecargada.

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

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

Devuelve « true » si la lista contiene la cadena « str »; en caso contrario, devuelve « false ».

Si cs es Qt::CaseSensitive (el valor por defecto), la comparación de cadenas distingue entre mayúsculas y minúsculas; en caso contrario, la comparación no distingue entre mayúsculas y minúsculas.

Se trata de una función sobrecargada.

[since 6.9] QStringList QStringList::filter(const QLatin1StringMatcher &matcher) const

Devuelve una lista con todas las cadenas que coinciden con matcher (es decir, aquellas para las que matcher.indexIn() devuelve un índice >= 0).

El uso de ` QLatin1StringMatcher ` puede resultar más rápido al realizar búsquedas en listas grandes o en listas con cadenas largas (la mejor forma de averiguarlo es realizar pruebas de rendimiento).

Por ejemplo:

    QStringList veryLargeList;
    QLatin1StringMatcher matcher("Street"_L1, Qt::CaseInsensitive);
    QStringList filtered = veryLargeList.filter(matcher);

Esta función se introdujo en Qt 6.9.

Véase también contains() y filter(const QStringMatcher &).

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

Devuelve una lista con todas las cadenas que contienen la subcadena « str ».

Si cs es Qt::CaseSensitive (el valor por defecto), la comparación de cadenas distingue entre mayúsculas y minúsculas; en caso contrario, la comparación no distingue entre mayúsculas y minúsculas.

    QStringList list;
    list << "Bill Murray" << "John Doe" << "Bill Clinton";

    QStringList result;
    result = list.filter("Bill");
    // result: ["Bill Murray", "Bill Clinton"]

Esto equivale a

    QStringList result;
    for (const auto &str : std::as_const(list)) {
        if (str.contains("Bill"))
            result += str;
    }

Véase también contains().

QStringList QStringList::filter(const QRegularExpression &re) const

Devuelve una lista con todas las cadenas que coinciden con la expresión regular re.

Esta es una función sobrecargada.

[since 6.7] QStringList QStringList::filter(const QStringMatcher &matcher) const

Devuelve una lista con todas las cadenas que coinciden con matcher (es decir, aquellas para las que matcher.indexIn() devuelve un índice >= 0).

El uso de un ` QStringMatcher ` puede resultar más rápido a la hora de buscar en listas grandes o en listas con cadenas largas (la mejor forma de averiguarlo es realizar pruebas de rendimiento).

Por ejemplo:

    QStringList veryLongList;
    QStringMatcher matcher(u"Straße", Qt::CaseInsensitive);
    QStringList filtered = veryLongList.filter(matcher);

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.7.

Véase también contains() y filter(const QLatin1StringMatcher &).

[since 6.7] QStringList QStringList::filter(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.7.

QStringList QStringList::filter(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Esta es una función sobrecargada.

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

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

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

Devuelve la posición en la lista de la primera coincidencia de ` str `, buscando hacia adelante a partir de la posición ` from`. Devuelve -1 si no se encuentra ningún elemento que coincida.

Si cs es Qt::CaseSensitive (el valor por defecto), la comparación de cadenas distingue entre mayúsculas y minúsculas; en caso contrario, la comparación no distingue entre mayúsculas y minúsculas.

Nota: El parámetro cs se añadió en Qt 6.7, es decir, estos métodos ahora sobrecargan los métodos heredados de la clase base. Antes de eso, estos métodos solo tenían dos parámetros. Este cambio es compatible con el código fuente y el código existente debería seguir funcionando.

Véase también lastIndexOf().

qsizetype QStringList::indexOf(const QRegularExpression &re, qsizetype from = 0) const

Devuelve la posición en el índice de la primera coincidencia exacta de ` re ` en la lista, buscando hacia adelante a partir de la posición from. Devuelve -1 si no se encuentra ningún elemento que coincida.

Esta es una función sobrecargada.

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

QString QStringList::join(const QString &separator) const

Une todas las cadenas de la lista en una sola cadena, separando cada elemento por el separador dado separator (que puede ser una cadena vacía).

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

QString QStringList::join(QChar separator) const

Esta función sobrecarga la función « QStringList::join()».

QString QStringList::join(QLatin1StringView separator) const

Esta función sobrecarga la función « QStringList::join()».

QString QStringList::join(QStringView separator) const

Esta es una función sobrecargada.

[noexcept] qsizetype QStringList::lastIndexOf(QLatin1StringView str, qsizetype from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

[noexcept] qsizetype QStringList::lastIndexOf(const QString &str, qsizetype from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

Devuelve la posición en la lista de la última coincidencia de str, buscando hacia atrás a partir de la posición from. Si from es -1 (valor por defecto), la búsqueda comienza en el último elemento. Devuelve -1 si no se encuentra ningún elemento que coincida.

Si cs es Qt::CaseSensitive (valor por defecto), la comparación de cadenas distingue entre mayúsculas y minúsculas; en caso contrario, no distingue entre mayúsculas y minúsculas.

Nota: El parámetro cs se añadió en Qt 6.7, es decir, estos métodos ahora sobrecargan los métodos heredados de la clase base. Antes de eso, estos métodos solo tenían dos parámetros. Este cambio es compatible con el código fuente y el código existente debería seguir funcionando.

Véase también indexOf().

qsizetype QStringList::lastIndexOf(const QRegularExpression &re, qsizetype from = -1) const

Devuelve la posición en la lista de la última coincidencia exacta de ` re `, buscando hacia atrás a partir de la posición ` from`. Si ` from ` es -1 (valor por defecto), la búsqueda comienza en el último elemento. Devuelve -1 si no se encuentra ningún elemento que coincida.

Esta es una función sobrecargada.

Véase también indexOf().

qsizetype QStringList::removeDuplicates()

Esta función elimina las entradas duplicadas de una lista. No es necesario que las entradas estén ordenadas; conservarán su orden original.

Devuelve el número de entradas eliminadas.

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

Devuelve una lista de cadenas en la que, en cada una de ellas, el texto « before » se ha sustituido por « after » cada vez que aparece el texto « before ».

Nota: Si se utiliza un argumento « before » vacío, el argumento « after » se insertará antes y después de cada carácter de la cadena.

Si cs es Qt::CaseSensitive (el valor predeterminado), la comparación de cadenas distingue entre mayúsculas y minúsculas; en caso contrario, la comparación no distingue entre mayúsculas y minúsculas.

Por ejemplo:

    QStringList list;
    list << "alpha" << "beta" << "gamma" << "epsilon";
    list.replaceInStrings("a", "o");
    // list == ["olpho", "beto", "gommo", "epsilon"]

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

QStringList &QStringList::replaceInStrings(const QRegularExpression &re, const QString &after)

Sustituye cada aparición de la expresión regular « re » en cada una de las cadenas de la lista de cadenas por « after ». Devuelve una referencia a la lista de cadenas.

Por ejemplo:

    QStringList list;
    list << "alpha" << "beta" << "gamma" << "epsilon";
    list.replaceInStrings(QRegularExpression("^a"), "o");
    // list == ["olpha", "beta", "gamma", "epsilon"]

En el caso de expresiones regulares que contengan grupos de captura, las apariciones de \1, \2, ..., en « after » se sustituyen por la cadena capturada por el grupo de captura correspondiente.

Por ejemplo:

    QStringList list;
    list << "Bill Clinton" << "Murray, Bill";
    list.replaceInStrings(QRegularExpression("^(.*), (.*)$"), "\\2 \\1");
    // list == ["Bill Clinton", "Bill Murray"]

Esta es una función sobrecargada.

QStringList &QStringList::replaceInStrings(QStringView before, QStringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Esta es una función sobrecargada.

QStringList &QStringList::replaceInStrings(QStringView before, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Esta es una función sobrecargada.

QStringList &QStringList::replaceInStrings(const QString &before, QStringView after, Qt::CaseSensitivity cs = Qt::CaseSensitive)

Esta es una función sobrecargada.

void QStringList::sort(Qt::CaseSensitivity cs = Qt::CaseSensitive)

Ordena la lista de cadenas en orden ascendente.

Si ` cs ` es ` Qt::CaseSensitive ` (el valor por defecto), la comparación de cadenas distingue entre mayúsculas y minúsculas; en caso contrario, la comparación no distingue entre mayúsculas y minúsculas.

La ordenación se realiza mediante el algoritmo std::sort() de la STL, que tiene una complejidad temporal lineal-logarítmica, es decir, O(n log n).

Si deseas ordenar tus cadenas en un orden arbitrario, plantéate utilizar la clase ` QMap `. Por ejemplo, podrías utilizar un ` QMap` <`QString`, ` QString`> para crear un orden que no distinga entre mayúsculas y minúsculas (p. ej., con las claves como versiones en minúsculas de las cadenas y los valores como las cadenas), o un ` QMap` <`int`, ` QString`> para ordenar las cadenas según un índice entero.

QStringList QStringList::operator+(const QStringList &other) const

Devuelve una lista de cadenas que es la concatenación de esta lista de cadenas con la lista de cadenas other.

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

QStringList &QStringList::operator<<(const QString &str)

Añade la cadena indicada, str, a esta lista de cadenas y devuelve una referencia a dicha lista.

Véase también append().

QStringList &QStringList::operator<<(const QList<QString> &other)

Añade la lista de cadenas « other » a la lista de cadenas y devuelve una referencia a esta última.

Esta es una función sobrecargada.

QStringList &QStringList::operator<<(const QStringList &other)

Añade la lista de cadenas « other » a la lista de cadenas y devuelve una referencia a esta última.

Esta es una función sobrecargada.

QStringList &QStringList::operator=(const QList<QString> &other)

Copia el operador de asignación de QList<QString>. Asigna la lista de cadenas other a esta lista de cadenas.

Tras la operación, other y *this serán iguales.

QStringList &QStringList::operator=(QList<QString> &&other)

Mueve el operador de asignación de QList<QString>. Mueve la lista de cadenas other a esta lista de cadenas.

Tras la operación, other quedará vacía.

Se trata de una función sobrecargada.

Elementos no miembros relacionados

[alias] QMutableStringListIterator

La definición de tipo ` QStringListIterator ` proporciona un iterador no constante al estilo Java para ` QStringList`.

QStringList Proporciona tanto iteradores al estilo Java como iteradores al estilo STL. El iterador no constante al estilo Java es simplemente una definición de tipo para ` QMutableListIterator<QString>`.

Véase también QStringListIterator y QStringList::iterator.

[alias] QStringListIterator

La definición del tipo `QStringListIterator` proporciona un iterador `const` al estilo de Java para ` QStringList`.

QStringList Proporciona tanto iteradores al estilo de Java como iteradores al estilo de la STL. El iterador const al estilo de Java es simplemente una definición de tipo para QListIterator<QString>.

Véase también QMutableStringListIterator y QStringList::const_iterator.

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