QMap Class

멤버 함수 문서

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

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

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

이렇게 얻은 키와 값은 모두 맵의 키와 값에 대한 참조라는 점에 유의하세요. 특히 값을 변경하면 맵 자체가 수정됩니다.

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

QKeyValueIterator 를참조하세요 .

QMap::QMap()

빈 맵을 생성합니다.

clear()도 참조하세요 .

[explicit] QMap::QMap(const std::map<Key, T> &other)

other 의 복사본을 생성합니다.

toStdMap()도 참조하세요 .

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

이니셜라이저 목록에 있는 각 요소의 복사본으로 맵을 구성합니다 list.

[explicit] QMap::QMap(std::map<Key, T> &&other)

other 에서 이동하여 지도를 구축합니다.

toStdMap()도 참조하세요 .

[default] QMap::QMap(const QMap<Key, T> &other)

other 의 복사본을 생성합니다.

이 작업은 QMap이 암시적으로 공유되기 때문에 상수 시간에 발생합니다. 따라서 함수에서 QMap을 반환하는 속도가 매우 빠릅니다. 공유 인스턴스가 수정되면 복사(쓰기 시 복사)되므로 시간이 선형적으로 소요됩니다.

operator= 를참조하세요 .

[default] QMap::QMap(QMap<Key, T> &&other)

이동 - QMap 인스턴스를 생성합니다.

[default] QMap::~QMap()

맵을 삭제합니다. 맵의 값에 대한 참조와 이 맵에 대한 모든 이터레이터가 무효화됩니다.

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

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

constBegin() 및 end()도 참조하세요 .

QMap<Key, T>::const_iterator QMap::begin() const

과부하가 걸린 기능입니다.

QMap<Key, T>::const_iterator QMap::cbegin() const

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

begin() 및 cend()도 참조하세요 .

QMap<Key, T>::const_iterator QMap::cend() const

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

cbegin() 및 end()도 참조하세요 .

void QMap::clear()

지도에서 모든 항목을 제거합니다.

remove()도 참조하세요 .

QMap<Key, T>::const_iterator QMap::constBegin() const

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

begin() 및 constEnd()도 참조하세요 .

QMap<Key, T>::const_iterator QMap::constEnd() const

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

constBegin() 및 end()도 참조하세요 .

QMap<Key, T>::const_iterator QMap::constFind(const Key &key) const

맵에서 key 키를 가진 항목을 가리키는 const 이터레이터를 반환합니다.

맵에 key 키가 있는 항목이 없는 경우 이 함수는 constEnd()을 반환합니다.

find()도 참조하세요 .

QMap<Key, T>::const_key_value_iterator QMap::constKeyValueBegin() const

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

keyValueBegin()도 참조하세요 .

QMap<Key, T>::const_key_value_iterator QMap::constKeyValueEnd() const

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

constKeyValueBegin()도 참조하세요 .

bool QMap::contains(const Key &key) const

맵에 키가 key 인 항목이 포함되어 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

count()도 참조하세요 .

QMap<Key, T>::size_type QMap::count(const Key &key) const

키와 연관된 항목 수를 반환합니다 key.

contains()도 참조하세요 .

QMap<Key, T>::size_type QMap::count() const

이 함수는 과부하된 함수입니다.

size()와 동일합니다.

bool QMap::empty() const

이 함수는 STL 호환성을 위해 제공됩니다. isEmpty ()와 동일하며, 맵이 비어 있으면 참을 반환하고 그렇지 않으면 거짓을 반환합니다.

QMap<Key, T>::iterator QMap::end()

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

begin() 및 constEnd()도 참조하세요 .

QMap<Key, T>::const_iterator QMap::end() const

과부하가 걸린 기능입니다.

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

key 에 저장된 값의 범위를 구분하는 한 쌍의 이터레이터( [first, second))를 반환합니다.

std::pair<QMap<Key, T>::const_iterator, QMap<Key, T>::const_iterator> QMap::equal_range(const Key &key) const

과부하가 걸린 기능입니다.

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

반복자 pos 가 가리키는 (키, 값) 쌍을 맵에서 제거하고 반복자를 맵의 다음 항목으로 반환합니다.

remove()도 참조하세요 .

[since 6.0] QMap<Key, T>::iterator QMap::erase(QMap<Key, T>::const_iterator first, QMap<Key, T>::const_iterator last)

반복자 범위 [first, last)가 가리키는 (키, 값) 쌍을 맵에서 제거합니다. 마지막으로 제거된 요소 다음에 있는 맵의 항목에 대한 이터레이터를 반환합니다.

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

remove()도 참조하세요 .

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

맵에서 key 키를 가진 항목을 가리키는 이터레이터를 반환합니다.

맵에 key 키가 있는 항목이 없는 경우 이 함수는 end()을 반환합니다.

constFind(), value(), values(), lowerBound() 및 upperBound()도 참조하세요 .

QMap<Key, T>::const_iterator QMap::find(const Key &key) const

과부하가 걸린 기능입니다.

T &QMap::first()

맵의 첫 번째 값, 즉 가장 작은 키에 매핑된 값에 대한 참조를 반환합니다. 이 함수는 맵이 비어 있지 않다고 가정합니다.

공유되지 않은 경우(또는 const 버전이 호출된 경우) 상수 시간에 실행됩니다.

last(), firstKey() 및 isEmpty()도 참조하세요 .

const T &QMap::first() const

과부하가 걸린 기능입니다.

const Key &QMap::firstKey() const

맵에서 가장 작은 키에 대한 참조를 반환합니다. 이 함수는 맵이 비어 있지 않다고 가정합니다.

이 함수는 상수 시간에 실행됩니다.

lastKey(), first(), keyBegin() 및 isEmpty()도 참조하세요 .

void QMap::insert(QMap<Key, T> &&map)

map 의 모든 항목을 이 맵으로 이동합니다.

키가 두 맵에 공통인 경우 해당 값은 map 에 저장된 값으로 바뀝니다.

map 을 공유하면 항목이 대신 복사됩니다.

void QMap::insert(const QMap<Key, T> &map)

map 의 모든 항목을 이 맵에 삽입합니다.

키가 두 맵에 공통인 경우 해당 값은 map 에 저장된 값으로 바뀝니다.

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

키가 key 이고 값이 value 인 새 항목을 삽입합니다.

키가 key 인 항목이 이미 있는 경우 해당 항목의 값은 value 으로 바뀝니다.

새/업데이트된 엘리먼트를 가리키는 이터레이터를 반환합니다.

QMap<Key, T>::iterator QMap::insert(QMap<Key, T>::const_iterator pos, const Key &key, const T &value)

이 함수는 과부하된 함수입니다.

키 key 및 값 value, 힌트 pos 를 사용하여 삽입할 위치를 제안하는 새 항목을 삽입합니다.

constBegin()가 힌트로 사용되는 경우 key 이 맵의 어떤 키보다 작다는 것을 나타내며 constEnd()는 key 이 맵의 어떤 키보다 (엄격하게) 크다는 것을 나타냅니다. 그렇지 않으면 힌트가 조건(pos - 1)을 충족해야 합니다.key() < key <= 위치.key(). pos 힌트가 잘못되면 무시되고 일반 삽입이 수행됩니다.

키가 key 인 항목이 이미 있는 경우 해당 항목의 값은 value 으로 바뀝니다.

힌트가 맞고 맵이 공유되지 않은 경우 삽입은 상각된 상수 시간으로 실행됩니다.

정렬된 데이터로 맵을 만들 때 가장 큰 키를 먼저 constBegin()로 삽입하는 것이 constEnd()로 정렬된 순서대로 삽입하는 것보다 빠릅니다. constEnd() - 1(힌트가 유효한지 확인하는 데 필요한)은 로그 시간이 필요하기 때문입니다.

참고: 힌트에 주의하세요. 이전 공유 인스턴스에서 이터레이터를 제공하면 충돌이 발생할 수 있으며 맵과 pos 맵이 모두 자동으로 손상될 위험도 있습니다.

새/업데이트된 요소를 가리키는 이터레이터를 반환합니다.

bool QMap::isEmpty() const

맵에 항목이 없는 경우 true 을 반환하고, 그렇지 않으면 false를 반환합니다.

size()도 참조하세요 .

Key QMap::key(const T &value, const Key &defaultKey = Key()) const

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

값이 value 인 첫 번째 키를 반환하거나 맵에 값이 value 인 항목이 없는 경우 defaultKey 을 반환합니다. defaultKey 이 제공되지 않으면 이 함수는 기본적으로 구성된 키를 반환합니다.

QMap 의 내부 데이터 구조는 값이 아닌 키별로 빠르게 조회하도록 최적화되어 있기 때문에 이 함수는 느릴 수 있습니다(선형 시간).

value() 및 keys()도 참조하세요 .

QMap<Key, T>::key_iterator QMap::keyBegin() const

맵의 첫 번째 키를 가리키는 상수 STL 스타일 이터레이터를 반환합니다.

keyEnd() 및 firstKey()도 참조하세요 .

QMap<Key, T>::key_iterator QMap::keyEnd() const

맵의 마지막 키 뒤에 있는 가상의 아이템을 가리키는 상수 STL 스타일 이터레이터를 반환합니다.

keyBegin() 및 lastKey()도 참조하세요 .

QMap<Key, T>::key_value_iterator QMap::keyValueBegin()

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

keyValueEnd()도 참조하세요 .

QMap<Key, T>::const_key_value_iterator QMap::keyValueBegin() const

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

keyValueEnd()도 참조하세요 .

QMap<Key, T>::key_value_iterator QMap::keyValueEnd()

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

keyValueBegin()도 참조하세요 .

QMap<Key, T>::const_key_value_iterator QMap::keyValueEnd() const

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

keyValueBegin()도 참조하세요 .

QList<Key> QMap::keys() const

맵의 모든 키가 오름차순으로 포함된 목록을 반환합니다.

이 순서는 values()에서 사용하는 순서와 동일하게 보장됩니다.

이 함수는 선형 시간으로 새 목록을 생성합니다. keyBegin ()에서 keyEnd()로 반복하면 시간과 메모리 사용을 피할 수 있습니다.

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

QList<Key> QMap::keys(const T &value) const

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

value 값과 관련된 모든 키가 오름차순으로 포함된 목록을 반환합니다.

QMap 의 내부 데이터 구조는 값이 아닌 키별로 빠르게 조회하도록 최적화되어 있기 때문에 이 함수는 느릴 수 있습니다(선형 시간).

T &QMap::last()

맵의 마지막 값, 즉 가장 큰 키에 매핑된 값에 대한 참조를 반환합니다. 이 함수는 맵이 비어 있지 않다고 가정합니다.

공유되지 않은 경우(또는 const 버전이 호출된 경우) 로그 시간으로 실행됩니다.

first(), lastKey() 및 isEmpty()도 참조하세요 .

const T &QMap::last() const

과부하가 걸린 기능입니다.

const Key &QMap::lastKey() const

맵에서 가장 큰 키에 대한 참조를 반환합니다. 이 함수는 맵이 비어 있지 않다고 가정합니다.

이 함수는 로그 시간으로 실행됩니다.

firstKey(), last(), keyEnd() 및 isEmpty()도 참조하세요 .

QMap<Key, T>::iterator QMap::lowerBound(const Key &key)

지도에서 key 키를 가진 첫 번째 항목을 가리키는 이터레이터를 반환합니다. 맵에 key 키가 있는 항목이 없는 경우 이 함수는 더 큰 키를 가진 가장 가까운 항목에 대한 반복자를 반환합니다.

upperBound() 및 find()도 참조하세요 .

QMap<Key, T>::const_iterator QMap::lowerBound(const Key &key) const

과부하가 걸린 기능입니다.

QMap<Key, T>::size_type QMap::remove(const Key &key)

맵에서 key 키를 가진 모든 아이템을 제거합니다. 제거된 항목 수를 반환하며, 키가 맵에 존재하면 1, 그렇지 않으면 0이 됩니다.

clear() 및 take()도 참조하세요 .

[since 6.1] template <typename Predicate> QMap<Key, T>::size_type QMap::removeIf(Predicate pred)

pred 술어가 참을 반환하는 모든 요소를 맵에서 제거합니다.

이 함수는 QMap<Key, T>::iterator 타입의 인수를 받거나 std::pair<const Key &, T &> 타입의 인수를 받는 술어를 지원합니다.

제거된 요소가 있으면 그 수를 반환합니다.

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

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

QMap<Key, T>::size_type QMap::size() const

맵에 있는 (키, 값) 쌍의 수를 반환합니다.

isEmpty() 및 count()도 참조하세요 .

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

이 지도를 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

T QMap::take(const Key &key)

맵에서 key 키가 있는 항목을 제거하고 해당 항목과 연관된 값을 반환합니다.

항목이 맵에 존재하지 않으면 이 함수는 기본적으로 구성된 값을 반환합니다.

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

remove()도 참조하세요 .

std::map<Key, T> QMap::toStdMap() const &

이에 해당하는 STL 맵을 반환합니다 QMap.

[since 6.0] std::map<Key, T> QMap::toStdMap() &&

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

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

QMap<Key, T>::iterator QMap::upperBound(const Key &key)

맵에서 키가 key 인 마지막 항목 바로 뒤에 있는 항목을 가리키는 이터레이터를 반환합니다. 맵에 key 키가 있는 항목이 없는 경우 이 함수는 더 큰 키를 가진 가장 가까운 항목에 대한 반복자를 반환합니다.

예시:

QMap<int, QString> map;
map.insert(1, "one");
map.insert(5, "five");
map.insert(10, "ten");

map.upperBound(0);      // returns iterator to (1, "one")
map.upperBound(1);      // returns iterator to (5, "five")
map.upperBound(2);      // returns iterator to (5, "five")
map.upperBound(10);     // returns end()
map.upperBound(999);    // returns end()

lowerBound() 및 find()도 참조하세요 .

QMap<Key, T>::const_iterator QMap::upperBound(const Key &key) const

과부하가 걸린 기능입니다.

T QMap::value(const Key &key, const T &defaultValue = T()) const

key 키와 연관된 값을 반환합니다.

맵에 key 키가 있는 항목이 없는 경우 함수는 defaultValue 을 반환합니다. defaultValue 을 지정하지 않으면 함수는 기본적으로 구성된 값을 반환합니다.

key(), values(), contains() 및 operator[]()도 참조하세요 .

QList<T> QMap::values() const

맵의 모든 값이 포함된 목록을 키의 오름차순으로 반환합니다.

이 함수는 선형 시간으로 새 목록을 생성합니다. keyValueBegin ()에서 keyValueEnd()로 반복하면 시간과 메모리 사용을 피할 수 있습니다.

keys() 및 value()도 참조하세요 .

[default] QMap<Key, T> &QMap::operator=(QMap<Key, T> &&other)

이동-이 other 인스턴스를 QMap 인스턴스에 할당합니다.

[default] QMap<Key, T> &QMap::operator=(const QMap<Key, T> &other)

이 맵에 other 을 할당하고 이 맵에 대한 참조를 반환합니다.

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

key 키와 연관된 값을 수정 가능한 참조로 반환합니다.

맵에 key 키가 있는 항목이 없는 경우 이 함수는 key 키를 사용하여 맵에 기본 구성 값을 삽입하고 이에 대한 참조를 반환합니다.

insert() 및 value()도 참조하세요 .

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

이 함수는 과부하된 함수입니다.

value()와 동일합니다.