QKeyValueIterator Class
template <typename Key, typename T, typename Iterator, typename Traits> class QKeyValueIterator연관 컨테이너의 키/값 쌍을 순회하는 이터레이터. 더 보기...
| 헤더: | #include <QKeyValueIterator> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
공개 함수
| QKeyValueIterator() | |
| QKeyValueIterator(Iterator o) | |
| Iterator | base() const |
| std::pair<Key, T> | operator*() const |
| QKeyValueIterator<Key, T, Iterator, Traits> & | operator++() |
| QKeyValueIterator<Key, T, Iterator, Traits> | operator++(int) |
| QKeyValueIterator<Key, T, Iterator, Traits> & | operator--() |
| QKeyValueIterator<Key, T, Iterator, Traits> | operator--(int) |
| QKeyValueIterator<Key, T, Iterator, Traits>::pointer | operator->() const |
관련 비멤버
| bool | operator!=(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs) |
| bool | operator==(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs) |
상세 설명
QKeyValueIterator 클래스는 QHash 및 QMap 와 같은 연관 컨테이너에서 키/값 쌍을 반환하기 위한 STL 스타일의 이터레이터를 제공합니다. 템플릿 매개변수 Key 는 키 유형을, T 는 값 유형을, Iterator 는 기본 이터레이터 유형을, Traits 는 이터레이터 트레이트를 지정합니다. 이 컨테이너는 STL 연관 컨테이너와 동일한 API를 지원하며, 즉 컨테이너를 반복 처리할 때 키/값 쌍을 가져올 수 있습니다.
이를 통해 QMap, QHash 및 관련 컨테이너와 STL 스타일 알고리즘 간의 상호 운용성이 향상됩니다.
경고: 암시적으로 공유되는 컨테이너의이터레이터는 STL 이터레이터와 정확히 동일하게 작동하지 않습니다. 해당 컨테이너에서 이터레이터가 활성화된 상태에서는 컨테이너를 복사하지 않도록 해야 합니다. 자세한 내용은 ‘암시적 공유 이터레이터 문제’를 참조하십시오.
멤버 함수 문서
[default] QKeyValueIterator::QKeyValueIterator()
기본 QKeyValueIterator를 생성합니다.
[explicit constexpr noexcept(...)] QKeyValueIterator::QKeyValueIterator(Iterator o)
o 를 기반으로 QKeyValueIterator를 생성합니다.
참고: std::is_nothrow_move_constructible<Iterator>::value 가 true 인 경우,이 함수는 noexcept입니다.
Iterator QKeyValueIterator::base() const
QKeyValueIterator 가 기반으로 하는 기본 이터레이터를 반환합니다.
std::pair<Key, T> QKeyValueIterator::operator*() const
현재 항목을 튜플로 반환합니다.
QKeyValueIterator<Key, T, Iterator, Traits> &QKeyValueIterator::operator++()
++ 연산자(++i)는 이터레이터를 컨테이너의 다음 항목으로 이동시킨 후, 해당 이터레이터를 반환합니다.
참고: 이터레이터를 컨테이너의 end() 를 넘어이동시키는 것은 정의되지 않은 동작을 유발합니다.
operator--()도 참조하십시오 .
QKeyValueIterator<Key, T, Iterator, Traits> QKeyValueIterator::operator++(int)
후치 연산자 ` ++ `(i++)는 이터레이터를 컨테이너의 다음 항목으로 이동시키고, 이터레이터의 이전 값을 반환합니다.
참고: 이터레이터를 컨테이너의 end() 를 넘어이동시키는 것은 정의되지 않은 동작입니다.
이는 오버로드된 함수입니다.
QKeyValueIterator<Key, T, Iterator, Traits> &QKeyValueIterator::operator--()
접두사 c{–} 연산자(--i)는 이터레이터를 컨테이너의 이전 항목까지 되돌리고, 해당 이터레이터를 반환합니다.
참고: 이터레이터를 컨테이너의 begin() 위치 이전으로되돌리는 것은 정의되지 않은 동작을 유발합니다.
operator++()도 참조하십시오 .
QKeyValueIterator<Key, T, Iterator, Traits> QKeyValueIterator::operator--(int)
후치 연산자 c{–} (i--)는 이터레이터를 컨테이너의 이전 항목까지 되돌리고, 이터레이터의 이전 값을 반환합니다.
참고: 이터레이터를 컨테이너의 begin() 이전 위치로되돌리는 것은 정의되지 않은 동작을 유발합니다.
이는 오버로드된 함수입니다.
QKeyValueIterator<Key, T, Iterator, Traits>::pointer QKeyValueIterator::operator->() const
현재 항목을 쌍에 대한 포인터와 유사한 객체로 반환합니다.
operator*()도 참조하십시오 .
관련 비멤버 함수
[noexcept] bool operator!=(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs)
rhs 가 lhs 와 다른 항목을 가리키는 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.
operator==()도 참조하십시오 .
[noexcept] bool operator==(QKeyValueIterator<Key, T, Iterator, Traits> lhs, QKeyValueIterator<Key, T, Iterator, Traits> rhs)
rhs 가 lhs 와 동일한 항목을 가리키면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.
operator!=()도 참조하십시오 .
© 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.
