QMultiHash Class

멤버 함수 설명서

[noexcept default] QMultiHash::QMultiHash()

빈 해시를 생성합니다.

[explicit] QMultiHash::QMultiHash(const QHash<Key, T> &other)

other 의 복사본을 생성합니다( 는 QHash 이거나 QMultiHash일 수 있습니다).

QMultiHash::QMultiHash(std::initializer_list<std::pair<Key, T>> list)

초기화 목록 list 에 포함된 각 요소의 복사본을 사용하여 멀티 해시를 생성합니다.

template <typename InputIterator> QMultiHash::QMultiHash(InputIterator begin, InputIterator end)

이테레이터 범위 [begin, end) 내의 각 요소를 복사하여 멀티 해시를 생성합니다. 범위를 통해 반복되는 요소들은 first 및 second 데이터 멤버(예: std::pair)를 갖는 객체여야 하며, 각각 Key 및 T 로 변환 가능해야 합니다. 또는 이터레이터는 key() 및 value() 멤버 함수를 가져야 하며, 각각 Key 로 변환 가능한 키와 T 로 변환 가능한 값을 반환해야 합니다.

이 해시를 키/값 쌍으로 반복 처리할 수 있는 범위 객체를 반환합니다. 예를 들어, 이 범위 객체는 구조화된 바인딩 선언과 함께 범위 기반 for 루프에서 사용할 수 있습니다:

QMultiHash<QString, int> hash;
hash.insert("January", 1);
hash.insert("February", 2);
// ...
hash.insert("December", 12);

for (auto [key, value] : hash.asKeyValueRange()) {
    cout << qPrintable(key) << ": " << value << endl;
    --value; // convert to JS month indexing
}

이 방법으로 얻은 키와 값은 모두 해시 내의 해당 항목에 대한 참조라는 점에 유의하십시오. 특히, 값을 변경하면 해시 자체가 수정됩니다.

이 함수들은 Qt 6.4에서 도입되었습니다.

QKeyValueIterator도 참조하십시오 .

QMultiHash<Key, T>::iterator QMultiHash::begin()

해시의 첫 번째 항목을 가리키는 STL 스타일의 이터레이터를 반환합니다.

constBegin() 및 end()도 참조하십시오 .

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::begin() const

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::cbegin() const

해시의 첫 번째 항목을 가리키는 const STL 스타일의 이터레이터를 반환합니다.

begin() 및 cend()도 참조하십시오 .

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::cend() const

해시의 마지막 항목 다음에 있는 가상의 항목을 가리키는 const STL 스타일의 이터레이터를 반환합니다.

cbegin() 및 end()도 참조하십시오 .

[noexcept(...)] void QMultiHash::clear()

해시에서 모든 항목을 제거하고 해시가 사용하던 메모리를 모두 해제합니다.

remove()도 참조하십시오 .

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::constBegin() const

해시의 첫 번째 항목을 가리키는 const STL 스타일의 이터레이터를 반환합니다.

begin() 및 constEnd()도 참조하십시오 .

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::constEnd() const

해시의 마지막 항목 다음에 있는 가상의 항목을 가리키는 const STL 스타일의 이터레이터를 반환합니다.

constBegin() 및 end()도 참조하십시오 .

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::constFind(const Key &key, const T &value) const

해시에서 ` key `와 ` value `를 가진 항목을 가리키는 이터레이터를 반환합니다.

해시에 해당 항목이 없는 경우, 이 함수는 ` constEnd()`를 반환합니다.

[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::constKeyValueBegin() const

해시의 첫 번째 항목을 가리키는 const STL 스타일의 이터레이터를 반환합니다.

keyValueBegin()도 참조하십시오 .

[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::constKeyValueEnd() const

해시의 마지막 항목 다음에 있는 가상의 항목을 가리키는 const STL 스타일의 이터레이터를 반환합니다.

constKeyValueBegin()도 참조하십시오 .

[noexcept] bool QMultiHash::contains(const Key &key, const T &value) const

해시 내에 key 및 value 값을 가진 항목이 포함되어 있으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

count()도 참조하십시오 .

[noexcept] qsizetype QMultiHash::count(const Key &key, const T &value) const

key 및 value 조건을 충족하는 항목의 개수를 반환합니다.

contains()도 참조하십시오 .

컨테이너에 새로운 요소를 삽입합니다. 이 새로운 요소는 ` args `를 생성 인수로 사용하여 제자리에서 생성됩니다.

해시에 동일한 키를 가진 항목이 이미 있는 경우, 이 함수는 단순히 새로운 항목을 생성합니다. (이 동작은 기존 항목의 값을 덮어쓰는 ` replace()`와는 다릅니다.)

새로운 요소를 가리키는 이터레이터를 반환합니다.

insert도 참조하십시오 .

컨테이너에 새로운 요소를 삽입합니다. 이 새로운 요소는 args 를 생성 인자로 사용하여 제자리에서 생성됩니다.

해시에 동일한 키를 가진 항목이 이미 존재하는 경우, 해당 항목의 값은 ` args`을 사용하여 생성된 값으로 대체됩니다.

새로운 요소를 가리키는 이터레이터를 반환합니다.

replace 및 emplace도 참조하십시오 .

[noexcept] QMultiHash<Key, T>::iterator QMultiHash::end()

해시의 마지막 항목 다음에 있는 가상의 항목을 가리키는 STL 스타일의 이터레이터를 반환합니다.

begin() 및 constEnd()도 참조하십시오 .

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::end() const

std::pair<QMultiHash<Key, T>::iterator, QMultiHash<Key, T>::iterator> QMultiHash::equal_range(const Key &key)

key 에 저장된 값의 범위 [first, second) 를 구분하는 이터레이터 쌍을 반환합니다. 범위가 비어 있는 경우 두 이터레이터 모두 end()와 동일해집니다.

[noexcept] std::pair<QMultiHash<Key, T>::const_iterator, QMultiHash<Key, T>::const_iterator> QMultiHash::equal_range(const Key &key) const

QMultiHash<Key, T>::iterator QMultiHash::erase(QMultiHash<Key, T>::const_iterator pos)

이터레이터 ` pos `와 연관된 (키, 값) 쌍을 해시에서 제거하고, 해시의 다음 항목을 가리키는 이터레이터를 반환합니다.

이 함수는 QMultiHash 가 내부 데이터 구조를 재해시하도록 유발하지 않습니다. 즉, 반복 처리 중에 안전하게 호출할 수 있으며, 해시 내 항목의 순서에 영향을 미치지 않습니다. 예를 들어:

QMultiHash<QObject *, int> objectHash;
//...
QMultiHash<QObject *, int>::iterator i = objectHash.find(obj);
while (i != objectHash.end() && i.key() == obj) {
    if (i.value() == 0) {
        i = objectHash.erase(i);
    } else {
        ++i;
    }
}

remove(), take(), find()도 참조하십시오 .

QMultiHash<Key, T>::iterator QMultiHash::find(const Key &key, const T &value)

key 및 value 값을 가진 항목을 가리키는 반복자를 반환합니다. 해시에 해당 항목이 없는 경우, 이 함수는 end()을 반환합니다.

해시에 key 및 value 을 가진 항목이 여러 개 포함된 경우, 반환된 이터레이터는 가장 최근에 삽입된 항목을 가리킵니다.

[noexcept] QMultiHash<Key, T>::const_iterator QMultiHash::find(const Key &key, const T &value) const

QMultiHash<Key, T>::iterator QMultiHash::insert(const Key &key, const T &value)

key 를 키로, value 를 값으로 하는 새 항목을 삽입합니다.

해시에 동일한 키를 가진 항목이 이미 존재하는 경우, 이 함수는 단순히 새로운 항목을 생성합니다. (이 동작은 기존 항목의 값을 덮어쓰는 replace()와는 다릅니다.)

QMultiHash 중복 키를 허용합니다. 이미 존재하는 키를 삽입하면 기존 항목을 덮어쓰지 않고 새로운 항목을 추가합니다. QMultHash 내 항목의 순서는 보장되지 않습니다.

새로운 요소를 가리키는 이터레이터를 반환합니다.

replace()도 참조하십시오 .

이 함수들은 Qt 6.11에서 도입되었습니다.

value 에 매핑된 첫 번째 키를 반환합니다. 해시에 value 에 매핑된 항목이 없는 경우, defaultKey 를 반환하며, 이 매개변수가 제공되지 않은 경우에는 기본 생성된 키를 반환합니다.

QMultiHash 의 내부 데이터 구조는 값이 아닌 키를 통한 빠른 조회를 위해 최적화되어 있으므로, 이 함수는 처리 속도가 느릴 수 있습니다(선형 시간).

[noexcept] QMultiHash<Key, T>::key_iterator QMultiHash::keyBegin() const

해시의 첫 번째 키를 가리키는 const STL 스타일의 이터레이터를 반환합니다.

keyEnd()도 참조하십시오 .

[noexcept] QMultiHash<Key, T>::key_iterator QMultiHash::keyEnd() const

해시 내 마지막 키 다음에 있는 가상의 항목을 가리키는 const STL 스타일의 이터레이터를 반환합니다.

keyBegin()도 참조하십시오 .

[noexcept] QMultiHash<Key, T>::key_value_iterator QMultiHash::keyValueBegin()

해시의 첫 번째 항목을 가리키는 STL 스타일의 이터레이터를 반환합니다.

keyValueEnd()도 참조하십시오 .

[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::keyValueBegin() const

해시의 첫 번째 항목을 가리키는 const STL 스타일의 이터레이터를 반환합니다.

keyValueEnd()도 참조하십시오 .

[noexcept] QMultiHash<Key, T>::key_value_iterator QMultiHash::keyValueEnd()

해시의 마지막 항목 다음의 가상의 항목을 가리키는 STL 스타일의 이터레이터를 반환합니다.

keyValueBegin()도 참조하십시오 .

[noexcept] QMultiHash<Key, T>::const_key_value_iterator QMultiHash::keyValueEnd() const

해시의 마지막 항목 바로 뒤에 있는 가상의 항목을 가리키는 const STL 스타일의 이터레이터를 반환합니다.

keyValueBegin()도 참조하십시오 .

QList<Key> QMultiHash::keys() const

해시 내의 모든 키를 임의의 순서로 포함하는 리스트를 반환합니다. 해시 내에서 여러 번 나타나는 키는 리스트에서도 여러 번 나타납니다.

이 순서는 values()에서 사용하는 순서와 동일함을 보장합니다.

이 함수는 선형 시간 내에 새로운 리스트를 생성합니다. 이에 수반되는 시간 및 메모리 사용량은 keyBegin()에서 keyEnd()로 반복 처리를 수행함으로써 피할 수 있습니다.

values() 및 key()도 참조하십시오 .

qsizetype QMultiHash::remove(const Key &key)

key 를 가진 모든 항목을 해시에서 제거합니다. 제거된 항목의 개수를 반환합니다.

remove(const Key &key, const T &value)도 참조하십시오 .

qsizetype QMultiHash::remove(const Key &key, const T &value)

key 를 가지며 값이 value 인 모든 항목을 해시에서 제거합니다. 제거된 항목의 개수를 반환합니다.

remove()도 참조하십시오 .

[since 6.1] template <typename Predicate> qsizetype QMultiHash::removeIf(Predicate pred)

pred 조건식이 참을 반환하는 모든 요소를 멀티 해시에서 제거합니다.

이 함수는 QMultiHash<Key, T>::iterator 유형의 인자 또는 std::pair<const Key &, T &> 유형의 인자를 받는 술어를 지원합니다.

제거된 요소가 있는 경우, 그 개수를 반환합니다.

이 함수는 Qt 6.1에서 도입되었습니다.

clear() 및 take()도 참조하십시오 .

QMultiHash<Key, T>::iterator QMultiHash::replace(const Key &key, const T &value)

key 를 키로, value 를 값으로 하는 새 항목을 삽입합니다.

key 를 가진 항목이 이미 존재하는 경우, 해당 항목의 값이 value 로 대체됩니다.

key 를 가진 항목이 여러 개 있는 경우, 가장 최근에 삽입된 항목의 값이 value 로 대체됩니다.

새로 추가되거나 업데이트된 요소를 가리키는 이터레이터를 반환합니다.

insert()도 참조하십시오 .

[noexcept] void QMultiHash::swap(QMultiHash<Key, T> &other)

이 멀티 해시를 other 로 교체합니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

T QMultiHash::take(const Key &key)

key 를 가진 항목을 해시에서 제거하고, 해당 항목과 연관된 값을 반환합니다.

해당 항목이 해시에 존재하지 않으면, 이 함수는 기본 생성된 값을 반환합니다. 해시에 key 에 해당하는 항목이 여러 개 있는 경우, 가장 최근에 삽입된 항목만 제거됩니다.

반환 값을 사용하지 않는다면, remove()을 사용하는 것이 더 효율적입니다.

remove()도 참조하십시오 .

QList<Key> QMultiHash::uniqueKeys() const

맵에 포함된 모든 키를 포함하는 목록을 반환합니다. 맵에서 여러 번 나타나는 키는 반환된 목록에서는 한 번만 나타납니다.

keys() 및 values()도 참조하십시오 .

[since 6.0] QMultiHash<Key, T> &QMultiHash::unite(const QHash<Key, T> &other)

other 해시에 포함된 모든 항목을 이 해시에 삽입하고, 이 해시에 대한 참조를 반환합니다.

이 함수는 Qt 6.0에서 도입되었습니다.

insert()도 참조하십시오 .

QMultiHash<Key, T> &QMultiHash::unite(const QMultiHash<Key, T> &other)

other 해시에 포함된 모든 항목을 이 해시에 삽입하고, 이 해시에 대한 참조를 반환합니다.

insert()도 참조하십시오 .

key 에 연결된 값을 반환합니다.

해시에 ` key`을 가진 항목이 없는 경우, 이 함수는 ` defaultValue`을 반환하며, 이 매개변수가 제공되지 않은 경우에는 기본 생성된 값을 반환합니다.

해시에 ` key `에 해당하는 항목이 여러 개 있는 경우, 가장 최근에 삽입된 항목의 값이 반환됩니다.

QList<T> QMultiHash::values() const

해시에 포함된 모든 값을 임의의 순서로 담은 리스트를 반환합니다. 하나의 키에 여러 값이 연결되어 있는 경우, 가장 최근에 삽입된 값뿐만 아니라 해당 키의 모든 값이 리스트에 포함됩니다.

이 순서는 keys() 함수가 사용하는 순서와 동일함을 보장합니다.

이 함수는 선형 시간 내에 새로운 리스트를 생성합니다. 이에 수반되는 시간 및 메모리 사용량은 keyValueBegin()을 통해 keyValueEnd()으로 반복 처리함으로써 피할 수 있습니다.

keys() 및 value()도 참조하십시오 .

QList<T> QMultiHash::values(const Key &key) const

key 에 연결된 모든 값의 목록을, 가장 최근에 삽입된 것부터 가장 오래전에 삽입된 순서대로 반환합니다.

count() 및 insert()도 참조하십시오 .

QMultiHash<Key, T> QMultiHash::operator+(const QMultiHash<Key, T> &other) const

이 해시에 포함된 모든 항목과 other 에 포함된 모든 항목을 모두 포함하는 해시를 반환합니다. 두 해시에 공통된 키가 있는 경우, 반환되는 해시에는 해당 키가 여러 번 포함됩니다.

operator+=()도 참조하십시오 .

QMultiHash<Key, T> &QMultiHash::operator+=(const QMultiHash<Key, T> &other)

other 해시에 포함된 모든 항목을 이 해시에 삽입하고, 이 해시에 대한 참조를 반환합니다.

unite() 및 insert()도 참조하십시오 .

T &QMultiHash::operator[](const Key &key)

key 에 연결된 값을 수정 가능한 참조로 반환합니다.

해시에 ` key`를 가진 항목이 없는 경우, 이 함수는 ` key`를 사용하여 기본 생성된 값을 해시에 삽입하고, 해당 값에 대한 참조를 반환합니다.

해시에 key 을 가진 항목이 여러 개 포함된 경우, 이 함수는 가장 최근에 삽입된 값에 대한 참조를 반환합니다.

insert() 및 value()도 참조하십시오 .