QMetaAssociation::Iterable Class

QMetaAssociation::Iterable 는 QVariant. ..에서 연관 컨테이너에 대한 이터러블 인터페이스입니다....

이 클래스는 Qt 6.11에 도입되었습니다.

상속된 멤버를 포함한 모든 멤버의 목록

공용형

`(since 6.11)` class	ConstIterator
`(since 6.11)` class	Iterator
	BidirectionalConstIterator
	BidirectionalIterator
	ForwardConstIterator
	ForwardIterator
	InputConstIterator
	InputIterator
	RandomAccessConstIterator
	RandomAccessIterator

공용 함수

bool	containsKey(const QVariant &key) const
QMetaAssociation::Iterable::ConstIterator	find(const QVariant &key) const
void	insertKey(const QVariant &key)
QMetaAssociation::Iterable::Iterator	mutableFind(const QVariant &key)
void	removeKey(const QVariant &key)
void	setValue(const QVariant &key, const QVariant &mapped)
QVariant	value(const QVariant &key) const

상세 설명

이 클래스는 QVariant 안에 있는 연관 컨테이너의 요소에 액세스하는 여러 가지 메서드를 허용합니다. QMetaAssociation::Iterable 인스턴스는 QVariantHash 또는 QVariantMap 로 변환할 수 있거나 사용자 정의 변경 가능한 보기가 등록된 경우 QVariant 에서 추출할 수 있습니다.

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>()) { QMetaAssociation::이터러블 이터러블 = variant.value<QMetaAssociation::Iterable>(); // 값 위에 C++11 범위-포 사용 가능: for(const QVariant &v: 이터러블) {        qDebug() << v;
    } // 이터레이터를 사용할 수 있습니다:    QMetaAssociation::Iterable::const_iterator it = iterable.begin(); const QMetaAssociation::Iterable::const_iterator end = iterable.end(); for ( ; it != end; ++it) {        qDebug() << *it; // The current value
        qDebug() << it.key();
        qDebug() << it.value();
    } }

컨테이너 자체는 반복하기 전에 복사되지 않습니다.

QVariant 를참조하세요 .

멤버 유형 문서

`[alias]` Iterable::BidirectionalConstIterator

std::bidirectional_iterator_tag를 사용하여 const_iterator를 노출합니다.

`[alias]` Iterable::BidirectionalIterator

std::bidirectional_iterator_tag를 사용하여 이터레이터를 노출합니다.

`[alias]` Iterable::ForwardConstIterator

std::forward_iterator_tag를 사용하여 const_iterator를 노출합니다.

`[alias]` Iterable::ForwardIterator

std::forward_iterator_tag를 사용하여 이터레이터를 노출합니다.

`[alias]` Iterable::InputConstIterator

std::input_iterator_tag를 사용하여 const_iterator를 노출합니다.

`[alias]` Iterable::InputIterator

std::input_iterator_tag를 사용하여 이터레이터를 노출합니다.

`[alias]` Iterable::RandomAccessConstIterator

std::random_access_iterator_tag를 사용하여 const_iterator를 노출합니다.

`[alias]` Iterable::RandomAccessIterator

std::random_access_iterator_tag를 사용하여 이터레이터를 노출합니다.

멤버 함수 문서

bool Iterable::containsKey(const QVariant &key) const

컨테이너에 지정된 key 항목이 있는 경우 true, 그렇지 않으면 false 를 반환합니다. key 이 예상 유형으로 변환할 수 없는 경우 false 이 반환됩니다.

QMetaAssociation::Iterable::ConstIterator Iterable::find(const QVariant &key) const

지정된 key 의 요소를 가리키는 ConstIterator 또는 해당 키가 없는 경우 컨테이너의 끝을 검색합니다. key 을 예상 유형으로 변환할 수 없는 경우 컨테이너의 끝이 반환됩니다.

void Iterable::insertKey(const QVariant &key)

지정된 key 으로 새 항목을 삽입하거나 지정된 key 으로 기존 항목의 매핑된 값을 기본으로 구성된 매핑된 값으로 재설정합니다. key 은 예상 유형으로 강제로 변환됩니다: 변환할 수 없는 경우 기본값이 삽입됩니다.

QMetaAssociation::Iterable::Iterator Iterable::mutableFind(const QVariant &key)

지정된 key 또는 해당 키가 없는 경우 컨테이너의 끝에서 요소를 가리키는 이터레이터를 검색합니다. key 이 예상 유형으로 변환할 수 없는 경우 컨테이너의 끝이 반환됩니다.

void Iterable::removeKey(const QVariant &key)

컨테이너에서 key 으로 지정된 항목을 제거합니다. key 은 예상 유형으로 강제로 변환됩니다: 변환할 수 없는 경우 기본값이 제거됩니다.

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

key 에 연결된 매핑된 값을 mapped 로 설정합니다(가능하면). 주어진 key 에 대한 항목이 아직 없는 경우 새 항목을 삽입합니다. key 를 키 유형으로 변환할 수 없는 경우 기본으로 구성된 키 유형의 값을 덮어씁니다.

value()도 참조하세요 .

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

지정된 key 에서 매핑된 값을 가져오거나, 키가 존재하지 않는 경우 매핑된 유형의 기본 구성 인스턴스의 QVariant 을 가져옵니다. key 을 키 유형으로 변환할 수 없는 경우에는 기본적으로 구성된 키와 연결된 매핑된 값이 반환됩니다.

setValue()도 참조하세요 .

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