QMap Class

멤버 함수 문서

[default] 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()도 참조하십시오 .

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

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

QMap은 암시적으로 공유되므로 이 작업은 상수 시간 내에 수행됩니다. 이로 인해 함수에서 QMap을 반환하는 작업이 매우 빠르게 이루어집니다. 공유된 인스턴스가 수정되면 복사(쓰기 시 복사)되며, 이 작업에는 선형 시간이 소요됩니다.

operator=도 참조하십시오 .

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

QMap 인스턴스를 생성합니다.

[implicit] QMap::~QMap()

맵을 삭제합니다. 맵의 값에 대한 참조와 이 맵을 순회하는 모든 반복자는 더 이상 유효하지 않게 됩니다.

이 맵을 키/값 쌍으로 반복 처리할 수 있는 범위 객체를 반환합니다. 예를 들어, 이 범위 객체는 구조화된 바인딩 선언과 함께 범위 기반 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<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 스타일의 const 이터레이터를 반환합니다.

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

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

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

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

void QMap::clear()

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

remove()도 참조하십시오 .

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

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

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

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

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

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 스타일의 const 이터레이터를 반환합니다.

keyValueBegin()도 참조하십시오 .

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

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

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()`와 동일하며, 맵이 비어 있으면 `true`를 반환하고, 그렇지 않으면 `false`를 반환합니다.

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 <= pos.key(). 힌트 pos 가 잘못된 경우, 이는 무시되고 일반적인 삽입이 수행됩니다.

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

힌트가 올바르고 맵이 공유되지 않은 경우, 삽입은 상수 시간(amortized constant time) 내에 실행됩니다.

정렬된 데이터로 맵을 생성할 때, 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

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

keyEnd() 및 firstKey()도 참조하십시오 .

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

맵의 마지막 키 뒤에 있는 가상의 항목을 가리키는 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 스타일의 const 이터레이터를 반환합니다.

keyValueEnd()도 참조하십시오 .

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

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

keyValueBegin()도 참조하십시오 .

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

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

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 &

QMap 와 동등한 STL 맵을 반환합니다.

[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()도 참조하십시오 .

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

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

[implicit] 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()와 동일합니다.