QStringList Class

Documentación de las funciones miembro

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

Construye una copia de other.

Esta operación tarda un tiempo constante, porque QStringList se comparte implícitamente. Esto hace que devolver un QStringList 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=().

QStringList::QStringList(const QString &str)

Construye una lista de cadenas que contiene la cadena dada, str. Las listas más largas se crean fácilmente así:

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

Véase también append().

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

Mueve-construye desde QList<QString>.

Después de una construcción exitosa, other estará vacío.

[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 (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éase 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 Latin-1 vista por str; en caso contrario devuelve false.

Si cs es Qt::CaseSensitive (por defecto), la comparación de cadenas es sensible a mayúsculas y minúsculas; en caso contrario, la comparación es insensible a mayúsculas y minúsculas.

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

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

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

El uso de QLatin1StringMatcher puede ser más rápido cuando se busca en listas grandes y/o en listas con cadenas largas (la mejor forma de averiguarlo es mediante benchmarking).

Por ejemplo:

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

Esta función se introdujo en Qt 6.9.

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

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

Devuelve una lista de todas las cadenas que contienen la subcadena str.

Si cs es Qt::CaseSensitive (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 de todas las cadenas que coinciden con la expresión regular re.

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

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

El uso de QStringMatcher puede ser más rápido cuando la búsqueda se realiza en listas grandes y/o en listas con cadenas largas (la mejor forma de averiguarlo es mediante benchmarking).

Por ejemplo:

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

Esta función se introdujo en Qt 6.7.

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

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

Esta función se introdujo en Qt 6.7.

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

Devuelve la posición del índice de la primera coincidencia de str en la lista, buscando hacia adelante desde la posición del índice from. Devuelve -1 si no hay ninguna coincidencia.

Si cs es Qt::CaseSensitive (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éase también lastIndexOf().

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

Devuelve la posición del índice de la primera coincidencia exacta de re en la lista, buscando hacia adelante desde la posición del índice from. Devuelve -1 si no hay ninguna coincidencia.

Véase también lastIndexOf().

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

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

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

QString QStringList::join(QChar separator) const

QString QStringList::join(QLatin1StringView separator) const

QString QStringList::join(QStringView separator) const

Devuelve la posición del índice de la última coincidencia de str en la lista, buscando hacia atrás desde la posición del índice from. Si from es -1 (por defecto), la búsqueda comienza en el último elemento. Devuelve -1 si no hay ningún elemento coincidente.

Si cs es Qt::CaseSensitive (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éase también indexOf().

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

Devuelve la posición del índice de la última coincidencia exacta de re en la lista, buscando hacia atrás desde la posición del índice from. Si from es -1 (por defecto), la búsqueda comienza en el último elemento. Devuelve -1 si no hay coincidencias.

Véase también indexOf().

qsizetype QStringList::removeDuplicates()

Esta función elimina las entradas duplicadas de una lista. No es necesario ordenar las entradas. 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 se ha sustituido el texto before de cada cadena por el texto after siempre que se encuentre el texto before.

Si cs es Qt::CaseSensitive (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.

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"]

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

Por ejemplo:

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

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

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

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

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

Ordena la lista de cadenas en orden ascendente.

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

La ordenación se realiza utilizando el algoritmo std::sort() de la STL, que promedia un tiempo lineal-logarítmico, es decir, O(n log n).

Si desea ordenar sus cadenas en un orden arbitrario, considere el uso de la clase QMap. Por ejemplo, puede utilizar QMap<QString, QString> para crear una ordenación que no distinga entre mayúsculas y minúsculas (por ejemplo, con las claves en minúsculas y los valores en minúsculas), o QMap<int, QString> para ordenar las cadenas por algún í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 dada, str, a esta lista de cadenas y devuelve una referencia a la lista de cadenas.

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

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

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

Operador de asignación de copia de QList<QString>. Asigna la lista de cadenas other a esta lista de cadenas.

Después de 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.

Después de la operación, other estará vacía.