Класс QAssociativeIterable

Класс QAssociativeIterable — это интерфейс итерирования для ассоциативного контейнера в QVariant. Подробнее...

• Список всех членов, включая унаследованные

Типы публичного интерфейса

Функции публичного интерфейса

Подробное описание

Этот класс предоставляет несколько способов доступа к элементам ассоциативного контейнера, содержащегося в QVariant. Экземпляр QAssociativeIterable может быть извлечён из QVariant, если он может быть преобразован в QVariantHash или QVariantMap, или если был зарегистрирован пользовательский изменяемый вид.

QHash<int, QString> mapping;
mapping.insert(7, "Seven");
mapping.insert(11, "Eleven");
mapping.insert(42, "Forty-two");

QVariant variant = QVariant::fromValue(mapping);
if (variant.canConvert<QVariantHash>()) {
    QAssociativeIterable iterable = variant.value<QAssociativeIterable>();
    // Can use foreach over the values:
    foreach (const QVariant &v, iterable) {
        qDebug() << v;
    }
    // Can use C++11 range-for over the values:
    for (const QVariant &v : iterable) {
        qDebug() << v;
    }
    // Can use iterators:
    QAssociativeIterable::const_iterator it = iterable.begin();
    const QAssociativeIterable::const_iterator end = iterable.end();
    for ( ; it != end; ++it) {
        qDebug() << *it; // The current value
        qDebug() << it.key();
        qDebug() << it.value();
    }
}

Сам контейнер не копируется перед итерацией по нему.

См. также QVariant.

Документация по типам членов

[alias] QAssociativeIterable::BidirectionalConstIterator

Предоставляет const_iterator с использованием std::bidirectional_iterator_tag.

[alias] QAssociativeIterable::BidirectionalIterator

Предоставляет итератор с использованием std::bidirectional_iterator_tag.

[alias] QAssociativeIterable::ForwardConstIterator

Предоставляет const_iterator с использованием std::forward_iterator_tag.

[alias] QAssociativeIterable::ForwardIterator

Предоставляет итератор с использованием std::forward_iterator_tag.

[alias] QAssociativeIterable::InputConstIterator

Предоставляет const_iterator с использованием std::input_iterator_tag.

[alias] QAssociativeIterable::InputIterator

Предоставляет итератор с использованием std::input_iterator_tag.

[alias] QAssociativeIterable::RandomAccessConstIterator

Предоставляет const_iterator с использованием std::random_access_iterator_tag.

[alias] QAssociativeIterable::RandomAccessIterator

Предоставляет итератор с использованием std::random_access_iterator_tag.

[alias] QAssociativeIterable::const_iterator

QAssociativeIterable::const_iterator позволяет итерировать по контейнеру в QVariant.

QAssociativeIterable::const_iterator может быть создан только экземпляром QAssociativeIterable и используется аналогично другим итераторам в стиле STL.

QHash<int, QString> mapping;
mapping.insert(7, "Seven");
mapping.insert(11, "Eleven");
mapping.insert(42, "Forty-two");

QVariant variant = QVariant::fromValue(mapping);
if (variant.canConvert<QVariantHash>()) {
    QAssociativeIterable iterable = variant.value<QAssociativeIterable>();
    // Can use foreach over the values:
    foreach (const QVariant &v, iterable) {
        qDebug() << v;
    }
    // Can use C++11 range-for over the values:
    for (const QVariant &v : iterable) {
        qDebug() << v;
    }
    // Can use iterators:
    QAssociativeIterable::const_iterator it = iterable.begin();
    const QAssociativeIterable::const_iterator end = iterable.end();
    for ( ; it != end; ++it) {
        qDebug() << *it; // The current value
        qDebug() << it.key();
        qDebug() << it.value();
    }
}

См. также QAssociativeIterable.

[alias, since 6.0] QAssociativeIterable::iterator

QAssociativeIterable::iterator позволяет итерировать по контейнеру в QVariant.

QAssociativeIterable::iterator может быть создан только экземпляром QAssociativeIterable и используется аналогично другим итераторам в стиле STL.

Этот typedef был добавлен в Qt 6.0.

См. также QAssociativeIterable.

Документация по функциям-членам

bool QAssociativeIterable::containsKey(const QVariant &key)

Возвращает true , если в контейнере есть запись с заданным ключом key, или false в противном случае. Если key нельзя преобразовать в ожидаемый тип, возвращается false.

QAssociativeIterable::const_iterator QAssociativeIterable::find(const QVariant &key) const

Возвращает const_iterator, указывающий на элемент с заданным ключом key, или конец контейнера, если такого ключа нет. Если key нельзя преобразовать в ожидаемый тип, возвращается конец контейнера.

void QAssociativeIterable::insertKey(const QVariant &key)

Вставляет новую запись с заданным ключом key или сбрасывает сопоставленное значение любой существующей записи с данным ключом до значения по умолчанию. Ключ key приводится к ожидаемому типу: если он не преобразуется, вставляется значение по умолчанию.

QAssociativeIterable::iterator QAssociativeIterable::mutableFind(const QVariant &key)

Возвращает итератор, указывающий на элемент с заданным ключом key, или конец контейнера, если такого ключа нет. Если key нельзя преобразовать в ожидаемый тип, возвращается конец контейнера.

void QAssociativeIterable::removeKey(const QVariant &key)

Удаляет запись с данным ключом key из контейнера. Ключ key приводится к ожидаемому типу: если он не преобразуется, удаляется значение по умолчанию.

void QAssociativeIterable::setValue(const QVariant &key, const QVariant &mapped)

Устанавливает сопоставленное значение, связанное с ключом key, на mapped, если это возможно. Вставляет новую запись, если она ещё не существует, для данного ключа. Если ключ key не преобразуется в тип ключа, значение для ключа по умолчанию перезаписывается.

См. также value().

QVariant QAssociativeIterable::value(const QVariant &key) const

Извлекает сопоставленное значение по заданному ключу или значение по умолчанию QVariant соответствующего типа, если ключ не существует. Если ключ не может быть преобразован в тип ключа, возвращается сопоставленное значение, связанное с ключом по умолчанию.

См. также setValue().