QMutableMultiMapIterator Class

template <typename Key, typename T> class QMutableMultiMapIterator

QMutableMultiMapIterator 클래스는 QMultiMap 에 대한 Java 스타일의 논-컨스트 이터레이터를 제공합니다. 더 보기...

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

공용 함수

QMutableMultiMapIterator(QMultiMap<Key, T> &map)
bool findNext(const T &value)
bool findPrevious(const T &value)
bool hasNext() const
bool hasPrevious() const
const Key &key() const
QMutableMultiMapIterator<Key, T>::Item next()
QMutableMultiMapIterator<Key, T>::Item peekNext() const
QMutableMultiMapIterator<Key, T>::Item peekPrevious() const
QMutableMultiMapIterator<Key, T>::Item previous()
void remove()
void setValue(const T &value)
void toBack()
void toFront()
const T &value() const
T &value()
QMutableMultiMapIterator<Key, T> &operator=(QMultiMap<Key, T> &map)

상세 설명

QMultiMap 에는 Java 스타일 이터레이터와 STL 스타일 이터레이터가 모두 있습니다. STL 스타일 이터레이터가 더 효율적이며 선호됩니다.

QMutableMultiMapIterator<Key, T>를 사용하면 QMultiMap 을 반복하고 맵을 수정할 수 있습니다. 맵을 수정하고 싶지 않다면(또는 QMultiMap), 약간 더 빠른 QMultiMapIterator 을 대신 사용하세요.

QMutableMultiMapIterator 생성자는 QMultiMap 을 인수로 받습니다. 생성 후 이터레이터는 맵의 맨 처음(첫 번째 항목 앞)에 위치합니다. 모든 요소를 순차적으로 반복하는 방법은 다음과 같습니다:

QMultiMap<int, QWidget*> 멀티맵;...QMutableMultiMapIterator<int, QWidget*> i(multimap);while (i.hasNext()) { i.next();    qDebug() << i.key() << ": " << i.value();
}

next() 함수는 맵의 다음 항목을 반환하고 반복기를 진행시킵니다. key () 및 value() 함수는 마지막으로 건너뛴 항목의 키와 값을 반환합니다.

STL 스타일 이터레이터와 달리 Java 스타일 이터레이터는 항목을 직접 가리키지 않고 항목 사이를 가리킵니다. next ()를 처음 호출하면 이터레이터가 첫 번째 항목과 두 번째 항목 사이의 위치로 이동하여 첫 번째 항목을 반환하고, next()를 두 번째로 호출하면 이터레이터가 두 번째 항목과 세 번째 항목 사이의 위치로 이동하는 식으로 진행됩니다.

요소를 역순으로 반복하는 방법은 다음과 같습니다:

QMutableMultiMapIterator<int, QWidget*> i(multimap); i.toBack();while (i.hasPrevious()) { i.previous();    qDebug() << i.key() << ": " << i.value();

특정 값의 모든 항목을 찾으려면 findNext() 또는 findPrevious()를 반복해서 사용합니다. 예를 들어

QMutableMultiMapIterator<int, QWidget*> i(multimap);while (i.findNext(widget)) {...    qDebug() << "Found widget " << widget << " under key "
            << i.key(); }

맵을 반복하면서 항목을 제거하려면 remove()를 사용합니다. 항목의 값을 수정하려면 setValue()를 사용합니다.

예시:

QMutableMultiMapIterator<QString, QString> i(multimap);
while (i.hasNext()) {
    i.next();
    if (i.key() == i.value())
        i.remove();
}

이 예는 키와 값이 동일한 모든 (키, 값) 쌍을 제거합니다.

지정된 맵에서는 한 번에 하나의 변경 가능한 반복자만 활성화할 수 있습니다. 또한 반복기가 활성화되어 있는 동안에는 반복기를 통하지 않고 맵을 직접 변경하면 반복기가 무효화되고 정의되지 않은 동작이 발생할 수 있으므로 맵을 직접 변경해서는 안 됩니다.

QMultiMapIteratorQMultiMap::iterator참조하세요 .

멤버 함수 문서

QMutableMultiMapIterator::QMutableMultiMapIterator(QMultiMap<Key, T> &map)

map 을 트래버스하기 위한 이터레이터를 생성합니다. 이터레이터는 맵의 앞쪽(첫 번째 항목 앞)에 위치하도록 설정됩니다.

operator=()도 참조하세요 .

QMutableMultiMapIterator<Key, T> &QMutableMultiMapIterator::operator=(QMultiMap<Key, T> &map)

반복자를 map 에서 작동하게 합니다. 이터레이터는 맵의 앞쪽(첫 번째 항목 앞)에 위치하도록 설정됩니다.

toFront() 및 toBack()도 참조하세요 .

void QMutableMultiMapIterator::toFront()

반복기를 컨테이너의 앞쪽(첫 번째 항목 앞)으로 이동합니다.

toBack() 및 next()도 참조하세요 .

void QMutableMultiMapIterator::toBack()

반복기를 컨테이너의 뒤쪽(마지막 항목 뒤)으로 이동합니다.

toFront() 및 previous()도 참조하세요 .

bool QMutableMultiMapIterator::hasNext() const

반복자 앞에 항목이 하나 이상 있는 경우, 즉 반복자가 컨테이너 뒤에 있지 않으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

hasPrevious() 및 next()도 참조하세요 .

QMutableMultiMapIterator<Key, T>::Item QMutableMultiMapIterator::next()

다음 항목을 반환하고 이터레이터를 한 위치 전진시킵니다.

반환 값에서 key()를 호출하여 항목의 키를 가져오고 value()를 호출하여 값을 가져옵니다.

컨테이너 뒤쪽에 있는 이터레이터에서 이 함수를 호출하면 정의되지 않은 결과가 나타납니다.

hasNext(), peekNext() 및 previous()도 참조하세요 .

QMutableMultiMapIterator<Key, T>::Item QMutableMultiMapIterator::peekNext() const

이터레이터를 이동하지 않고 다음 항목에 대한 참조를 반환합니다.

반환 값에서 key()를 호출하여 항목의 키를 가져오고 value()를 호출하여 값을 가져옵니다.

컨테이너 뒤쪽에 있는 이터레이터에서 이 함수를 호출하면 정의되지 않은 결과가 나타납니다.

hasNext(), next() 및 peekPrevious()도 참조하세요 .

bool QMutableMultiMapIterator::hasPrevious() const

반복자 뒤에 항목이 하나 이상 있는 경우, 즉 반복자가 컨테이너의 앞에 있지 않으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

hasNext() 및 previous()도 참조하세요 .

QMutableMultiMapIterator<Key, T>::Item QMutableMultiMapIterator::previous()

이전 항목을 반환하고 이터레이터를 한 위치 뒤로 이동합니다.

반환 값에서 key()를 호출하여 항목의 키를 가져오고 value()를 호출하여 값을 가져옵니다.

컨테이너 앞쪽에 있는 이터레이터에서 이 함수를 호출하면 정의되지 않은 결과가 나타납니다.

hasPrevious(), peekPrevious() 및 next()도 참조하세요 .

QMutableMultiMapIterator<Key, T>::Item QMutableMultiMapIterator::peekPrevious() const

이터레이터를 이동하지 않고 이전 항목을 반환합니다.

반환 값에서 key()를 호출하여 항목의 키를 가져오고 value()를 호출하여 값을 가져옵니다.

컨테이너 앞쪽에 있는 이터레이터에서 이 함수를 호출하면 정의되지 않은 결과가 나타납니다.

hasPrevious(), previous() 및 peekNext()도 참조하세요 .

const T &QMutableMultiMapIterator::value() const

트래버스 함수(next(), previous(), findNext(), findPrevious()) 중 하나를 사용하여 마지막으로 건너뛴 항목의 값을 반환합니다.

next() 또는 findNext() 호출 후 value()는 peekPrevious()와 동일합니다.value(). previous () 또는 findPrevious()로 전화한 후 value()는 peekNext()와 동일합니다.value().

key() 및 setValue()도 참조하세요 .

T &QMutableMultiMapIterator::value()

이 함수는 오버로드된 함수입니다.

트래버스 함수 중 하나를 사용하여 점프한 마지막 항목의 값에 대한 생성되지 않은 참조를 반환합니다.

const Key &QMutableMultiMapIterator::key() const

트래버스 함수(next(), previous(), findNext(), findPrevious()) 중 하나를 사용하여 마지막으로 뛰어넘은 항목의 키를 반환합니다.

next() 또는 findNext() 호출 후 key()는 peekPrevious()와 동일합니다.key(). previous () 또는 findPrevious()로 전화한 후 key()는 peekNext()와 동일합니다.key().

value()도 참조하세요 .

bool QMutableMultiMapIterator::findNext(const T &value)

현재 이터레이터 위치에서 앞으로 value 를 검색합니다. value 값을 가진 (키, 값) 쌍이 발견되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

호출 후 value 이 발견되면 반복기는 일치하는 항목 바로 뒤에 위치하며, 그렇지 않으면 반복기는 컨테이너의 뒤쪽에 위치합니다.

findPrevious()도 참조하세요 .

bool QMutableMultiMapIterator::findPrevious(const T &value)

현재 이터레이터 위치에서 거꾸로 시작하여 value 를 검색합니다. value 값을 가진 (키, 값) 쌍이 발견되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

호출 후 value 이 발견되면 일치하는 항목 바로 앞에 반복기가 배치되고, 그렇지 않으면 컨테이너 앞쪽에 반복기가 배치됩니다.

findNext()도 참조하세요 .

void QMutableMultiMapIterator::remove()

트래버스 함수(next(), previous(), findNext(), findPrevious()) 중 하나를 사용하여 마지막으로 건너뛴 항목을 제거합니다.

setValue()도 참조하세요 .

void QMutableMultiMapIterator::setValue(const T &value)

트래버스 함수 중 하나를 사용하여 마지막으로 건너뛴 항목의 값을 value 로 바꿉니다.

트래버스 함수는 next(), previous(), findNext() 및 findPrevious()입니다.

key(), value() 및 remove()도 참조하세요 .

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