이 페이지에서

QCborMap Class

QCborMap 클래스는 CBOR로 표현 가능한 연관 컨테이너를 저장하는 데 사용됩니다. 더 보기...

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

참고: 이 클래스의 모든 함수는 재진입 가능합니다.

QCborMap 비교

범주비교 가능한 유형
strongQCborMap
strongQCborValue 및 QCborValueConstRef.

공개 유형

공개 함수

QCborMap()
QCborMap(std::initializer_list<QCborMap::value_type> args)
QCborMap(const QCborMap &other)
(since 6.10) QCborMap(QCborMap &&other)
~QCborMap()
(since 6.10) auto asKeyValueRange() &&
(since 6.10) auto asKeyValueRange() &
(since 6.10) auto asKeyValueRange() const &&
(since 6.10) auto asKeyValueRange() const &
QCborMap::iterator begin()
QCborMap::const_iterator begin() const
QCborMap::const_iterator cbegin() const
QCborMap::const_iterator cend() const
void clear()
int compare(const QCborMap &other) const
QCborMap::const_iterator constBegin() const
QCborMap::const_iterator constEnd() const
QCborMap::const_iterator constFind(qint64 key) const
QCborMap::const_iterator constFind(QLatin1StringView key) const
QCborMap::const_iterator constFind(const QCborValue &key) const
QCborMap::const_iterator constFind(const QString &key) const
(since 6.10) QCborMap::const_key_value_iterator constKeyValueBegin() const
(since 6.10) QCborMap::const_key_value_iterator constKeyValueEnd() const
bool contains(const QCborValue &key) const
bool contains(qint64 key) const
bool contains(QLatin1StringView key) const
bool contains(const QString &key) const
bool empty() const
QCborMap::iterator end()
QCborMap::const_iterator end() const
QCborMap::iterator erase(QCborMap::const_iterator it)
QCborMap::iterator erase(QCborMap::iterator it)
QCborValue extract(QCborMap::const_iterator it)
QCborValue extract(QCborMap::iterator it)
QCborMap::iterator find(qint64 key)
QCborMap::const_iterator find(qint64 key) const
QCborMap::iterator find(QLatin1StringView key)
QCborMap::iterator find(const QCborValue &key)
QCborMap::iterator find(const QString &key)
QCborMap::const_iterator find(QLatin1StringView key) const
QCborMap::const_iterator find(const QCborValue &key) const
QCborMap::const_iterator find(const QString &key) const
QCborMap::iterator insert(QCborMap::value_type v)
QCborMap::iterator insert(QLatin1StringView key, const QCborValue &value)
QCborMap::iterator insert(const QCborValue &key, const QCborValue &value)
QCborMap::iterator insert(const QString &key, const QCborValue &value)
QCborMap::iterator insert(qint64 key, const QCborValue &value)
bool isEmpty() const
(since 6.10) QCborMap::key_value_iterator keyValueBegin()
(since 6.10) QCborMap::const_key_value_iterator keyValueBegin() const
(since 6.10) QCborMap::key_value_iterator keyValueEnd()
(since 6.10) QCborMap::const_key_value_iterator keyValueEnd() const
QList<QCborValue> keys() const
void remove(const QCborValue &key)
void remove(qint64 key)
void remove(QLatin1StringView key)
void remove(const QString &key)
qsizetype size() const
void swap(QCborMap &other)
QCborValue take(QLatin1StringView key)
QCborValue take(const QCborValue &key)
QCborValue take(const QString &key)
QCborValue take(qint64 key)
QCborValue toCborValue() const
QJsonObject toJsonObject() const
QVariantHash toVariantHash() const
QVariantMap toVariantMap() const
QCborValue value(const QCborValue &key) const
QCborValue value(qint64 key) const
QCborValue value(QLatin1StringView key) const
QCborValue value(const QString &key) const
(since 6.10) QCborMap &operator=(QCborMap &&other)
QCborMap &operator=(const QCborMap &other)
QCborValueRef operator[](qint64 key)
const QCborValue operator[](const QCborValue &key) const
const QCborValue operator[](qint64 key) const
QCborValueRef operator[](QLatin1StringView key)
QCborValueRef operator[](const QCborValue &key)
QCborValueRef operator[](const QString &key)
const QCborValue operator[](QLatin1StringView key) const
const QCborValue operator[](const QString &key) const

정적 공용 멤버

QCborMap fromJsonObject(const QJsonObject &obj)
(since 6.3) QCborMap fromJsonObject(QJsonObject &&obj)
QCborMap fromVariantHash(const QVariantHash &hash)
QCborMap fromVariantMap(const QVariantMap &map)
bool operator!=(const QCborMap &lhs, const QCborMap &rhs)
bool operator<(const QCborMap &lhs, const QCborMap &rhs)
bool operator<=(const QCborMap &lhs, const QCborMap &rhs)
bool operator==(const QCborMap &lhs, const QCborMap &rhs)
bool operator>(const QCborMap &lhs, const QCborMap &rhs)
bool operator>=(const QCborMap &lhs, const QCborMap &rhs)

상세 설명

이 클래스는 CBOR 형식의 연관 컨테이너, 즉 키와 값 유형 간의 맵을 저장하는 데 사용할 수 있습니다. CBOR는 Concise Binary Object Representation의 약자로, JSON의 상위 집합인 매우 간결한 형태의 이진 데이터 인코딩 방식입니다. 이 형식은 IETF Constrained RESTful Environments(CoRE) WG에서 개발되었으며, 많은 새로운 RFC에서 사용되고 있습니다. CoAP 프로토콜과 함께 사용하도록 설계되었습니다.

JSON 및 QVariantMap 과 달리, CBOR 맵의 키는 문자열뿐만 아니라 어떤 유형이든 될 수 있습니다. 이러한 이유로, QCborMap은 실질적으로 QCborValue 키와 QCborValue 값 요소 간의 맵 역할을 합니다.

그러나 키 매개변수를 받는 모든 멤버 함수에 대해, QCborMap은 정수 및 문자열과 효율적으로 작동하는 오버로드를 제공합니다. 사실, 정수 키는 전송 시 차지하는 바이트 수가 적고 인코딩 및 디코딩이 더 간단하기 때문에 사용을 권장합니다. IETF CoRE WG에서 CBOR과 특별히 연동되도록 설계한 최신 프로토콜들은 이를 사용하는 것으로 알려져 있습니다.

QCborMap은 정렬되어 있지 않으므로, 키 검색의 시간 복잡도는 선형(O(n))입니다. QCborMap은 실제로 요소를 삽입된 순서대로 보관하므로, 요소를 정렬된 순서대로 신중하게 삽입함으로써 정렬된 QCborMap을 만들 수 있습니다. CBOR는 정렬을 필수로 요구하지는 않지만 권장합니다.

QCborMap은 QVariantMap 및 QJsonObject 형식과 상호 변환이 가능합니다. 그러나 변환을 수행할 때, 문자열이 아닌 키는 일방향 변환 방식을 사용하여 문자열로 변환되며, 이는 QCborMap으로 다시 변환하더라도 원래 상태로 되돌릴 수 없습니다.

QCborArray, QCborValue, QJsonDocument, QVariantMap, CBOR 데이터 구문 분석 및 표시, 직렬화 변환기, 게임 저장 및 불러오기도참조하십시오 .

멤버 유형 문서

QCborMap::const_iterator

~의 동의어 QCborMap::ConstIterator

[since 6.10] QCborMap::const_key_value_iterator

QCborMap::const_key_value_iterator 타입 정의는 QCborMap 에 대한 STL 스타일의 이터레이터를 제공합니다.

QCborMap::const_key_value_iterator는 본질적으로 QCborMap::const_iterator 와 동일하지만, QJsonObject 와 같은 다른 컨테이너와의 일관성을 위해 제공됩니다.

이 typedef는 Qt 6.10에서 도입되었습니다.

QKeyValueIterator도 참조하십시오 .

QCborMap::iterator

QCborMap::Iterator 의 동의어.

QCborMap::key_type

이 맵의 키 유형입니다. QCborMap 키는 어떤 CBOR 유형이든 될 수 있으므로, 이는 QCborValue 입니다.

[since 6.10] QCborMap::key_value_iterator

QCborMap::key_value_iterator typedef는 QCborMap 에 대한 STL 스타일의 이터레이터를 제공합니다.

QCborMap::key_value_iterator는 본질적으로 QCborMap::iterator 와 동일하지만, QJsonObject 와 같은 다른 컨테이너와의 대칭성을 위해 제공됩니다.

이 typedef는 Qt 6.10에서 도입되었습니다.

QKeyValueIterator도 참조하십시오 .

QCborMap::mapped_type

(값)에 매핑되는 유형, 즉 QCborValue 입니다.

QCborMap::size_type

QCborMap 가 크기를 나타내는 데 사용하는 유형입니다.

QCborMap::value_type

이 컨테이너에 저장된 값: QCborValues 한 쌍

멤버 함수 설명서

[noexcept] QCborMap::QCborMap()

빈 CBOR 맵 객체를 생성합니다.

isEmpty()도 참조하십시오 .

QCborMap::QCborMap(std::initializer_list<QCborMap::value_type> args)

다음 예제와 같이 args 에 있는 중괄호 초기화 목록의 항목을 사용하여 QCborMap을 생성합니다:

QCborMap map = {
    {0, "Hello"},
    {1, "World"},
    {"foo", nullptr},
    {"bar", QCborArray{0, 1, 2, 3, 4}}
};

[noexcept] QCborMap::QCborMap(const QCborMap &other)

other 의 복사본인 QCborMap 객체를 생성합니다.

[constexpr noexcept default, since 6.10] QCborMap::QCborMap(QCborMap &&other)

이동 생성자.

이동 원본 객체 other 는 기본 생성된 상태로 설정됩니다.

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

QCborMap::QCborMap()도 참조하십시오 .

[noexcept] QCborMap::~QCborMap()

이 QCborMap 객체를 삭제하고, 해당 객체가 소유한 관련 리소스를 모두 해제합니다.

[since 6.10] auto QCborMap::asKeyValueRange() &&

[since 6.10] auto QCborMap::asKeyValueRange() &

[since 6.10] auto QCborMap::asKeyValueRange() const &&

[since 6.10] auto QCborMap::asKeyValueRange() const &

이 맵을 키/값 쌍으로 반복 처리할 수 있는 범위 객체를 반환합니다.

이 방법으로 얻은 값은 맵에 있는 값에 대한 참조라는 점에 유의하십시오. 구체적으로, 값을 변경하면 맵 자체가 수정됩니다.

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

QKeyValueIterator도 참조하십시오 .

QCborMap::iterator QCborMap::begin()

이 맵의 첫 번째 키-값 쌍을 가리키는 맵 이터레이터를 반환합니다. 이 맵이 비어 있는 경우, 반환되는 이터레이터는 end()과 동일합니다.

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

QCborMap::const_iterator QCborMap::begin() const

이 맵의 첫 번째 키-값 쌍을 가리키는 맵 반복자를 반환합니다. 이 맵이 비어 있는 경우, 반환되는 반복자는 constEnd()과 동일합니다.

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

QCborMap::const_iterator QCborMap::cbegin() const

이 맵의 첫 번째 키-값 쌍을 가리키는 맵 반복자를 반환합니다. 이 맵이 비어 있는 경우, 반환되는 반복자는 constEnd()과 동일합니다.

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

QCborMap::const_iterator QCborMap::cend() const

맵의 마지막 요소 바로 다음 요소를 나타내는 맵 이터레이터를 반환합니다.

begin(), constBegin(), find(), constFind()도 참조하십시오 .

void QCborMap::clear()

이 맵을 비웁니다.

isEmpty()도 참조하십시오 .

[noexcept] int QCborMap::compare(const QCborMap &other) const

이 맵과 other 를 순서대로 각 요소를 비교하여, 이 맵이 (결과가 음수인 경우) other 이전에 정렬되어야 하는지, 아니면 (결과가 양수인 경우) 그 이후에 정렬되어야 하는지를 나타내는 정수를 반환합니다. 이 함수가 0을 반환하면 두 맵은 동일하며 같은 요소를 포함하고 있습니다.

CBOR 맵은 정렬되지 않은 구조이므로, 완전히 동일한 쌍을 포함하고 있지만 순서가 다른 두 맵은 비교 결과가 달라질 수 있습니다. 이를 방지하려면 키 값의 오름차순과 같이 예측 가능한 순서로 요소를 맵에 삽입하는 것이 좋습니다. 실제로, 표준 CBOR 표현을 위해서는 키가 정렬된 순서로 구성된 맵이 필요합니다.

CBOR 정렬 순서에 대한 자세한 내용은 QCborValue::compare()을 참조하십시오.

또한 QCborValue::compare(), QCborArray::compare(), operator==()도참조하십시오 .

QCborMap::const_iterator QCborMap::constBegin() const

이 맵의 첫 번째 키-값 쌍을 가리키는 맵 이터레이터를 반환합니다. 이 맵이 비어 있는 경우, 반환되는 이터레이터는 constEnd()과 동일합니다.

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

QCborMap::const_iterator QCborMap::constEnd() const

맵의 마지막 요소 바로 다음 요소를 나타내는 맵 이터레이터를 반환합니다.

begin(), constBegin(), find(), constFind()도 참조하십시오 .

QCborMap::const_iterator QCborMap::constFind(qint64 key) const

맵에 키가 ` key`인 키-값 쌍이 포함되어 있는 경우, 해당 쌍에 대한 맵 반복자를 반환합니다. 포함되어 있지 않은 경우, 이 함수는 ` constEnd()`를 반환합니다.

CBOR은 정수 키를 사용할 것을 권장합니다. 정수 키는 공간을 덜 차지하고 인코딩 및 디코딩이 더 간단하기 때문입니다.

맵에 key 과 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 찾아낼지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신자에 문제가 있음을 나타냅니다.

value(qint64), operator[](qint64), find(qint64), remove(qint64), contains(qint64), value(QLatin1StringView), value(const QString &), value(const QCborValue &)도 참조하십시오.

QCborMap::const_iterator QCborMap::constFind(QLatin1StringView key) const

맵에 ‘ key ’라는 키를 가진 키-값 쌍이 포함되어 있는 경우, 해당 쌍에 대한 맵 이터레이터를 반환합니다. 포함되어 있지 않은 경우, 이 함수는 constEnd()을 반환합니다.

맵에 key 와 동일한 키가 두 개 이상 포함되어 있는 경우, 이 함수가 어떤 키를 찾아낼지는 정의되지 않습니다. QCborMap 는 중복 키의 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성하는 것은 가능합니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재하는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

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

value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), remove(QLatin1StringView), contains(QLatin1StringView), value(qint64), value(const QString &), value(const QCborValue &)도 참조하십시오 .

QCborMap::const_iterator QCborMap::constFind(const QCborValue &key) const

맵에 key 인 키-값 쌍이 포함되어 있는 경우, 해당 쌍에 대한 맵 이터레이터를 반환합니다. 포함되어 있지 않은 경우, 이 함수는 constEnd()를 반환합니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 찾아낼지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신자 측에 문제가 있음을 나타냅니다.

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

value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), remove(const QCborValue &), contains(const QCborValue &), value(qint64), value(QLatin1StringView) 및 value(const QString &)도 참조하십시오 .

QCborMap::const_iterator QCborMap::constFind(const QString &key) const

맵에 key 인 키-값 쌍이 포함되어 있는 경우, 해당 쌍에 대한 맵 이터레이터를 반환합니다. 포함되어 있지 않은 경우, 이 함수는 constEnd()를 반환합니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 찾을지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

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

value(const QString &), operator[](const QString &), find(const QString &), remove(const QString &), contains(const QString &), value(qint64), value(QLatin1StringView), value(const QCborValue &)도 참조하십시오.

[since 6.10] QCborMap::const_key_value_iterator QCborMap::constKeyValueBegin() const

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

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

keyValueBegin()도 참조하십시오 .

[since 6.10] QCborMap::const_key_value_iterator QCborMap::constKeyValueEnd() const

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

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

constKeyValueBegin()도 참조하십시오 .

bool QCborMap::contains(const QCborValue &key) const

이 맵에 key key 로 식별되는 키-값 쌍이 포함되어 있으면 true를 반환합니다.

value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), remove(const QCborValue &), contains(qint64), remove(QLatin1StringView) 및 remove(const QString &)도 참조하십시오 .

bool QCborMap::contains(qint64 key) const

이 맵에 key key 로 식별되는 키-값 쌍이 포함되어 있으면 true를 반환합니다. CBOR는 정수 키를 사용할 것을 권장합니다. 정수 키는 차지하는 공간이 적고 인코딩 및 디코딩이 더 간단하기 때문입니다.

value(qint64), operator[](qint64), find(qint64), remove(qint64), contains(QLatin1StringView), remove(const QString &) 및 remove(const QCborValue &)도 참조하십시오 .

bool QCborMap::contains(QLatin1StringView key) const

이 맵에 key key 로 식별되는 키-값 쌍이 포함되어 있으면 true를 반환합니다.

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

value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), remove(QLatin1StringView), contains(qint64), remove(const QString &) 및 remove(const QCborValue &)도 참조하십시오 .

bool QCborMap::contains(const QString &key) const

이 맵에 key key 로 식별되는 키-값 쌍이 포함되어 있으면 true를 반환합니다.

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

value(const QString &), operator[](const QString &), find(const QString &), remove(const QString &), contains(qint64), remove(QLatin1StringView) 및 remove(const QCborValue &)도 참조하십시오 .

bool QCborMap::empty() const

isEmpty()의 동의어입니다. 이 함수는 표준 라이브러리 API를 사용하는 일반적인 코드와의 호환성을 위해 제공됩니다.

이 맵이 비어 있으면 true를 반환합니다 (size() == 0).

isEmpty() 및 size()도 참조하십시오 .

QCborMap::iterator QCborMap::end()

맵의 마지막 요소 바로 다음 요소를 나타내는 맵 반복자를 반환합니다.

begin(), constBegin(), find(), constFind()도 참조하십시오 .

QCborMap::const_iterator QCborMap::end() const

맵의 마지막 요소 바로 다음 요소를 나타내는 맵 반복자를 반환합니다.

begin(), constBegin(), find(), constFind()도 참조하십시오 .

QCborMap::iterator QCborMap::erase(QCborMap::const_iterator it)

맵 반복자 it 가 가리키는 키-값 쌍을 제거하고, 제거 후 다음 요소를 가리키는 포인터를 반환합니다.

remove(), begin(), end(), insert(), extract()도 참조하십시오 .

QCborMap::iterator QCborMap::erase(QCborMap::iterator it)

맵 반복자 it 가 가리키는 키-값 쌍을 제거하고, 제거 후 다음 요소에 대한 포인터를 반환합니다.

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

remove(), begin(), end(), insert()도 참조하십시오 .

QCborValue QCborMap::extract(QCborMap::const_iterator it)

QCborValue QCborMap::extract(QCborMap::iterator it)

이테레이터 it 가 가리키는 위치에서 맵의 값을 추출하고, 추출된 값을 반환합니다.

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

QCborMap::iterator QCborMap::find(qint64 key)

QCborMap::const_iterator QCborMap::find(qint64 key) const

맵에 키가 ` key`인 키-값 쌍이 포함되어 있는 경우, 해당 쌍에 대한 맵 이터레이터를 반환합니다. 포함되어 있지 않은 경우, 이 함수는 ` end()`를 반환합니다.

CBOR은 정수 키를 사용할 것을 권장합니다. 정수 키는 차지하는 공간이 적고 인코딩 및 디코딩이 더 간단하기 때문입니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 찾아낼지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 그러한 맵을 생성하는 것은 가능합니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

value(qint64), operator[](qint64), constFind(qint64), remove(qint64), contains(qint64), value(QLatin1StringView), value(const QString &), value(const QCborValue &)도 참조하십시오.

QCborMap::iterator QCborMap::find(QLatin1StringView key)

QCborMap::const_iterator QCborMap::find(QLatin1StringView key) const

맵에 ‘ key ’라는 키를 가진 키-값 쌍이 포함되어 있는 경우, 해당 쌍에 대한 맵 이터레이터를 반환합니다. 포함되어 있지 않은 경우, 이 함수는 ` end()`를 반환합니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 찾을지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 있는 것은 보통 송신 측에 문제가 있음을 나타냅니다.

value(QLatin1StringView), operator[](QLatin1StringView), constFind(QLatin1StringView), remove(QLatin1StringView), contains(QLatin1StringView), value(qint64), value(const QString &), value(const QCborValue &)도 참조하십시오 .

QCborMap::iterator QCborMap::find(const QCborValue &key)

QCborMap::const_iterator QCborMap::find(const QCborValue &key) const

맵에 키가 key 인 키-값 쌍이 포함되어 있는 경우, 해당 쌍에 대한 맵 이터레이터를 반환합니다. 포함되어 있지 않은 경우, 이 함수는 end()를 반환합니다.

맵에 key 과 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 찾을지는 정의되지 않습니다. QCborMap 은 중복 키 삽입을 허용하지 않지만, 해당 키들을 포함한 CBOR 스트림을 디코딩하여 그러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재하는 것은 대개 송신 측에 문제가 있음을 나타냅니다.

value(const QCborValue &), operator[](const QCborValue &), constFind(const QCborValue &), remove(const QCborValue &), contains(const QCborValue &), value(qint64), value(QLatin1StringView) 및 value(const QString &)도 참조하십시오 .

QCborMap::iterator QCborMap::find(const QString &key)

QCborMap::const_iterator QCborMap::find(const QString &key) const

맵에 key 인 키-값 쌍이 포함되어 있는 경우, 해당 쌍에 대한 맵 이터레이터를 반환합니다. 포함되어 있지 않은 경우, 이 함수는 end()를 반환합니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 찾아낼지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 송신자에 문제가 있음을 나타냅니다.

value(const QString &), operator[](const QString &), constFind(const QString &), remove(const QString &), contains(const QString &), value(qint64), value(QLatin1StringView) 및 value(const QCborValue &)도 참조하십시오 .

[static] QCborMap QCborMap::fromJsonObject(const QJsonObject &obj)

obj 객체에서 발견된 모든 JSON 항목을 QCborValue::fromJson()을 사용하여 CBOR로 변환하고, 해당 요소들로 구성된 맵을 반환합니다.

CBOR 유형 체계는 JSON의 상위 집합이므로, 이 변환은 손실 없이 이루어집니다. 또한, 이 함수가 반환하는 맵은 toJsonObject()를 사용하여 원래의 obj 로 다시 변환할 수 있습니다.

toJsonObject(), toVariantMap(), QCborValue::fromJsonValue(), QCborArray::fromJsonArray()도 참조하십시오 .

[static noexcept, since 6.3] QCborMap QCborMap::fromJsonObject(QJsonObject &&obj)

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

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

[static] QCborMap QCborMap::fromVariantHash(const QVariantHash &hash)

QCborValue::fromVariant()를 사용하여 hash 의 모든 항목을 CBOR로 변환하고, 해당 요소들로 구성된 맵을 반환합니다.

QVariant 에서의 변환은 완전히 무손실이 아닙니다. 자세한 내용은 QCborValue::fromVariant()의 문서를 참조하십시오.

toVariantHash(), fromVariantMap(), fromJsonObject(), QCborValue::fromVariant()도 참조하십시오 .

[static] QCborMap QCborMap::fromVariantMap(const QVariantMap &map)

QCborValue::fromVariant()를 사용하여 map 내의 모든 항목을 CBOR로 변환하고, 해당 요소들로 구성된 맵을 반환합니다.

QVariant 에서 변환하는 과정은 완전히 무손실이 아닙니다. 자세한 내용은 QCborValue::fromVariant()의 문서를 참조하십시오.

toVariantMap(), fromVariantHash(), fromJsonObject(), QCborValue::fromVariant()도 참조하십시오 .

QCborMap::iterator QCborMap::insert(QCborMap::value_type v)

v 에 있는 키-값 쌍을 이 맵에 삽입하고, 새로 삽입된 쌍을 가리키는 맵 이터레이터를 반환합니다.

맵에 이미 v.first 과 동일한 키가 존재하는 경우, 해당 키의 값은 v.second 로 덮어쓰게 됩니다.

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

operator[], erase() 및 extract()도 참조하십시오 .

QCborMap::iterator QCborMap::insert(QLatin1StringView key, const QCborValue &value)

이 맵에 키 key 와 값 value 를 삽입하고, 새로 삽입된 쌍을 가리키는 맵 이터레이터를 반환합니다.

맵에 이미 key 과 동일한 키가 존재하는 경우, 해당 값은 value 로 덮어쓰게 됩니다.

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

erase(), remove(QLatin1StringView), value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), take(QLatin1StringView) 및 extract()도 참조하십시오 .

QCborMap::iterator QCborMap::insert(const QCborValue &key, const QCborValue &value)

이 맵에 키 key 와 값 value 를 삽입하고, 새로 삽입된 쌍을 가리키는 맵 이터레이터를 반환합니다.

맵에 이미 key 와 동일한 키가 존재할 경우, 해당 키의 값은 value 로 덮어쓰게 됩니다.

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

erase(), remove(const QCborValue &), value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), contains(const QCborValue &), take(const QCborValue &) 및 extract()도 참조하십시오.

QCborMap::iterator QCborMap::insert(const QString &key, const QCborValue &value)

이 맵에 키 key 와 값 value 를 삽입하고, 새로 삽입된 쌍을 가리키는 맵 이터레이터를 반환합니다.

맵에 이미 key 과 동일한 키가 존재하는 경우, 해당 값은 value 로 덮어쓰게 됩니다.

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

erase(), remove(const QString &), value(const QString &), operator[](const QString &), find(const QString &), contains(const QString &), take(const QString &) 및 extract()도 참조하십시오 .

QCborMap::iterator QCborMap::insert(qint64 key, const QCborValue &value)

이 맵에 키 key 와 값 value 를 삽입하고, 새로 삽입된 쌍을 가리키는 맵 이터레이터를 반환합니다.

맵에 이미 key 와 동일한 키가 존재할 경우, 해당 값은 value 로 덮어쓰게 됩니다.

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

erase(), remove(qint64), value(qint64), operator[](qint64), find(qint64), contains(qint64), take(qint64) 및 extract()도 참조하십시오 .

bool QCborMap::isEmpty() const

이 맵이 비어 있는 경우(즉, ` size()`의 결과가 0인 경우) `true`를 반환합니다.

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

[since 6.10] QCborMap::key_value_iterator QCborMap::keyValueBegin()

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

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

keyValueEnd()도 참조하십시오 .

[since 6.10] QCborMap::const_key_value_iterator QCborMap::keyValueBegin() const

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

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

keyValueEnd()도 참조하십시오 .

[since 6.10] QCborMap::key_value_iterator QCborMap::keyValueEnd()

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

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

keyValueBegin()도 참조하십시오 .

[since 6.10] QCborMap::const_key_value_iterator QCborMap::keyValueEnd() const

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

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

keyValueBegin()도 참조하십시오 .

QList<QCborValue> QCborMap::keys() const

이 맵에 포함된 모든 키의 목록을 반환합니다.

QMap::keys() 및 QHash::keys()도 참조하십시오 .

void QCborMap::remove(const QCborValue &key)

맵에서 ‘ key ’ 키와 해당 값을 발견하면 이를 제거합니다. 맵에 해당 키가 없는 경우, 이 함수는 아무 작업도 수행하지 않습니다.

맵에 key 과 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어느 키를 제거할지는 정의되지 않습니다. ` QCborMap `는 중복 키의 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

remove(qint64), remove(QLatin1StringView), remove(const QString &)

value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), contains(const QCborValue &)도 참조하십시오.

void QCborMap::remove(qint64 key)

맵에서 ‘ key ’ 키와 해당 값을 찾으면 이를 제거합니다. 맵에 해당 키가 없는 경우, 이 함수는 아무 작업도 수행하지 않습니다.

맵에 key 과 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어느 키를 제거할지는 정의되지 않습니다. QCborMap 는 중복 키의 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

remove(QLatin1StringView), remove(const QString &), remove(const QCborValue &)

value(qint64), operator[](qint64), find(qint64) 및 contains(qint64)도 참조하십시오 .

void QCborMap::remove(QLatin1StringView key)

맵에서 ‘ key ’ 키와 해당 값을 발견하면 이를 제거합니다. 맵에 해당 키가 없는 경우, 이 함수는 아무 작업도 수행하지 않습니다.

맵에 ` key`과 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 제거할지는 정의되지 않습니다. ` QCborMap `은 중복 키의 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 보통 발신 측에 문제가 있음을 나타냅니다.

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

value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), remove(qint64), remove(const QString &), 및 remove(const QCborValue &)도 참조하십시오 .

void QCborMap::remove(const QString &key)

맵에서 ' key ' 키와 해당 값을 찾아 제거합니다. 맵에 해당 키가 없는 경우, 이 함수는 아무 작업도 수행하지 않습니다.

맵에 key 과 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 제거할지는 정의되지 않습니다. ` QCborMap `는 중복 키의 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 그러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 송신 측에 문제가 있음을 나타냅니다.

remove(qint64), remove(QLatin1StringView), remove(const QCborValue &)

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

value(const QString &), operator[](const QString &), find(const QString &), contains(const QString &)도 참조하십시오 .

[noexcept] qsizetype QCborMap::size() const

이 맵에 포함된 요소의 개수를 반환합니다.

isEmpty()도 참조하십시오 .

[noexcept] void QCborMap::swap(QCborMap &other)

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

QCborValue QCborMap::take(QLatin1StringView key)

맵에서 키 ` key `와 해당 값을 제거하고, 해당 값이 발견되면 그 값을 반환합니다. 맵에 해당 키가 없는 경우, 이 함수는 아무 작업도 수행하지 않습니다.

맵에 key 과 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어느 키를 제거할지는 정의되지 않습니다. QCborMap 는 중복 키의 삽입을 허용하지 않지만, 중복 키를 포함하는 CBOR 스트림을 디코딩하여 해당 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

value(QLatin1StringView), operator[](QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), take(qint64), take(const QString &), take(const QCborValue &), insert()도 참조하십시오 .

QCborValue QCborMap::take(const QCborValue &key)

맵에서 키 key 와 해당 값을 제거하고, 해당 값이 발견되면 그 값을 반환합니다. 맵에 해당 키가 없는 경우, 이 함수는 아무 작업도 수행하지 않습니다.

맵에 ` key`과 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어느 키를 제거할지는 정의되지 않습니다. ` QCborMap `는 중복 키의 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 송신 측에 문제가 있음을 나타냅니다.

value(const QCborValue &), operator[](const QCborValue &), find(const QCborValue &), contains(const QCborValue &), take(QLatin1StringView), take(const QString &), take(qint64) 및 insert()도 참조하십시오 .

QCborValue QCborMap::take(const QString &key)

맵에서 키 ` key `와 해당 값을 제거하고, 해당 값이 발견되면 그 값을 반환합니다. 맵에 해당 키가 없는 경우, 이 함수는 아무 작업도 수행하지 않습니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어느 키를 제거할지는 정의되지 않습니다. QCborMap 는 중복 키의 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 그러한 맵을 생성하는 것은 가능합니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 송신 측에 문제가 있음을 나타냅니다.

value(const QString &), operator[](const QString &), find(const QString &), contains(const QString &), take(QLatin1StringView), take(qint64), take(const QCborValue &), insert()도 참조하십시오.

QCborValue QCborMap::take(qint64 key)

맵에서 키 ` key `와 해당 값을 제거하고, 해당 값이 발견되면 그 값을 반환합니다. 맵에 해당 키가 없는 경우, 이 함수는 아무 작업도 수행하지 않습니다.

맵에 key 과 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어느 키를 제거할지는 정의되지 않습니다. QCborMap 는 중복 키의 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

value(qint64), operator[](qint64), find(qint64), contains(qint64), take(QLatin1StringView), take(const QString &), take(const QCborValue &) 및 insert()항목도 참조하십시오.

QCborValue QCborMap::toCborValue() const

이 맵을 나타내는 QCborValue 객체를 명시적으로 생성합니다. QCborValue 에는 QCborMap 용 생성자가 있으므로 변환이 암시적으로 이루어지기 때문에, 이 함수는 일반적으로 필요하지 않습니다.

QCborMap 를 QCborValue 로 변환하면, QCborMap 의 키나 매핑된 유형은 물론 QCborValue::toCbor()를 포함하여 QCborValues를 사용할 수 있는 모든 컨텍스트에서 이를 사용할 수 있습니다.

QCborValue::QCborValue(const QCborMap &)도 참조하십시오 .

QJsonObject QCborMap::toJsonObject() const

이 맵에 포함된 모든 ` QCborValue ` 값을 ` QCborValue::toJsonValue()`를 사용하여 재귀적으로 JSON으로 변환하고, 문자열이 아닌 모든 키에 대해 문자열 키를 생성한 다음, 이러한 연관 관계를 바탕으로 구성된 해당 ` QJsonObject `를 반환합니다.

CBOR은 JSON보다 더 풍부하고 광범위한 유형 집합을 포함하고 있으므로, 이 변환 과정에서 일부 정보가 손실될 수 있습니다. 적용되는 변환에 대한 자세한 내용은 QCborValue::toJsonValue()을 참조하십시오.

키를 문자열로 변환

JSON 객체는 CBOR과 달리 문자열 키를 갖도록 정의되어 있으므로, QCborMap 를 QJsonObject 로 변환하는 과정에는 키 값을 "문자열화"하는 단계가 포함됩니다. 이 변환은 앞서 설명한 태그 및 확장 유형에 대한 특수 처리를 사용하며, 나머지 유형들도 다음과 같이 변환합니다:

유형변환
Bool"true" 및 "false"
Null"null"
정의되지 않음"undefined"
정수숫자의 십진수 문자열 형식
실수숫자의 십진수 문자열 형식
바이트 배열별도로 태그가 지정되지 않은 경우(위 참조), Base64url로 인코딩됨
배열해당 값의 압축된 형태로 대체됨 Diagnostic notation
맵해당의 압축된 형태로 대체됩니다. Diagnostic notation
태그 및 확장형태그 번호가 제거되고 태그된 값은 문자열로 변환됩니다

fromJsonObject(), QCborValue::toJsonValue(), QCborArray::toJsonArray() 및 toVariantMap()도 참조하십시오 .

QVariantHash QCborMap::toVariantHash() const

QCborValue::toVariant()를 사용하여 CBOR 값을 QVariant 로 변환하고, 이 맵에 포함된 모든 CBOR 키를 문자열로 변환한 후, 해당 연관 리스트에서 생성된 QVariantHash 를 반환합니다.

QVariantMaps는 CBOR과 달리 문자열 키를 사용하므로, QCborMap 을 QVariantMap 로 변환하는 과정에는 키 값을 "문자열화"하는 단계가 포함됩니다. 자세한 내용은 QCborMap::toJsonObject()을 참조하십시오.

또한, QVariant 로의 변환은 완전히 무손실이 아닙니다. 자세한 내용은 QCborValue::toVariant()의 문서를 참조하십시오.

fromVariantHash(), toVariantMap(), toJsonObject(), QCborValue::toVariant(), QCborArray::toVariantList()도 참조하십시오 .

QVariantMap QCborMap::toVariantMap() const

QCborValue::toVariant()를 사용하여 CBOR 값을 QVariant 로 변환하고, 이 맵에 포함된 모든 CBOR 키를 문자열로 변환한 뒤, 해당 연관 목록에서 생성된 QVariantMap 를 반환합니다.

QVariantMaps는 CBOR과 달리 문자열 키를 사용하므로, QCborMap 를 QVariantMap 로 변환하는 과정에는 키 값을 "문자열화"하는 단계가 포함됩니다. 자세한 내용은 QCborMap::toJsonObject()을 참조하십시오.

또한, QVariant 로의 변환은 완전히 무손실이 아닙니다. 자세한 내용은 QCborValue::toVariant()의 문서를 참조하십시오.

fromVariantMap(), toVariantHash(), toJsonObject(), QCborValue::toVariant(), QCborArray::toVariantList()도 참조하십시오 .

QCborValue QCborMap::value(const QCborValue &key) const

이 맵에서 키 key 에 해당하는 QCborValue 요소를 반환합니다(해당 요소가 존재하는 경우).

맵에 키 key 가 포함되어 있지 않은 경우, 이 함수는 정의되지 않은 값을 포함하는 QCborValue 를 반환합니다. 이러한 이유로, 이 함수만으로는 키가 존재하지 않는 상황과 키가 정의되지 않은 값에 매핑된 상황을 구분할 수 없습니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 반환할지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

value(qint64), value(QLatin1StringView), value(const QString &)

operator[](const QCborValue &), find(const QCborValue &), constFind(const QCborValue &), remove(const QCborValue &), contains(const QCborValue &)도 참조하십시오.

QCborValue QCborMap::value(qint64 key) const

이 맵에서 키 key 에 해당하는 QCborValue 요소를 반환합니다(해당 요소가 있는 경우). CBOR에서는 정수 키를 사용할 것을 권장합니다. 정수 키는 차지하는 공간이 적고 인코딩 및 디코딩이 더 간단하기 때문입니다.

맵에 key 키가 포함되어 있지 않은 경우, 이 함수는 정의되지 않은 값을 포함하는 QCborValue 를 반환합니다. 이러한 이유로, 이 함수만으로는 키가 존재하지 않는 상황과 키가 정의되지 않은 값으로 매핑된 상황을 구분할 수 없습니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 함수의 반환값이 어느 키를 참조할지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재하는 것은 대개 발신 측의 문제를 나타냅니다.

value(QLatin1StringView), value(const QString &), value(const QCborValue &)

operator[](qint64), find(qint64), constFind(qint64), remove(qint64) 및 contains(qint64)도 참조하십시오 .

QCborValue QCborMap::value(QLatin1StringView key) const

이 맵에서 키 ` key`에 해당하는 ` QCborValue ` 요소를 반환합니다(해당 요소가 존재하는 경우).

맵에 키 key 가 포함되어 있지 않은 경우, 이 함수는 정의되지 않은 값을 포함하는 QCborValue 를 반환합니다. 따라서 이 함수만으로는 키가 존재하지 않는 경우와 키가 정의되지 않은 값에 매핑된 경우를 구분할 수 없습니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 반환할지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키를 포함한 CBOR 스트림을 디코딩하여 이러한 맵을 생성하는 것은 가능합니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

value(qint64), value(const QString &), value(const QCborValue &)

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

operator[](QLatin1StringView), find(QLatin1StringView), constFind(QLatin1StringView), remove(QLatin1StringView) 및 contains(QLatin1StringView)도 참조하십시오 .

QCborValue QCborMap::value(const QString &key) const

이 맵에서 키 key 에 해당하는 QCborValue 요소를 반환합니다(해당 요소가 존재하는 경우).

맵에 key 키가 포함되어 있지 않은 경우, 이 함수는 정의되지 않은 값을 포함하는 QCborValue 를 반환합니다. 이러한 이유로, 이 함수만으로는 키가 존재하지 않는 경우와 키가 정의되지 않은 값에 매핑된 경우를 구분할 수 없습니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 반환할지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

value(qint64), value(QLatin1StringView), value(const QCborValue &)

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

operator[](const QString &), find(const QString &), constFind(const QString &), remove(const QString &), contains(const QString &)도 참조하십시오 .

[noexcept, since 6.10] QCborMap &QCborMap::operator=(QCborMap &&other)

이동 할당 연산자.

이동된 객체 other 는 유효하지만 정의되지 않은 상태로 설정됩니다.

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

[noexcept] QCborMap &QCborMap::operator=(const QCborMap &other)

이 객체의 내용을 ` other`의 복사본으로 대체한 다음, 이 객체에 대한 참조를 반환합니다.

QCborValueRef QCborMap::operator[](qint64 key)

이 맵에서 키 key 에 해당하는 값에 대한 QCborValueRef를 반환합니다. CBOR에서는 정수 키를 사용할 것을 권장합니다. 정수 키는 공간을 덜 차지하고 인코딩 및 디코딩이 더 간단하기 때문입니다.

QCborValueRef는 QCborValue 와 정확히 동일한 API를 가지지만, 한 가지 중요한 차이점이 있습니다. 즉, 새로운 값을 할당하면 이 맵이 해당 새 값으로 업데이트됩니다.

맵에 key 과 동일한 키가 없는 경우, 해당 키가 삽입되고 이 함수는 새로운 값에 대한 참조를 반환하는데, 이 값은 정의되지 않은 값을 가진 ` QCborValue `가 됩니다. 이러한 이유로, 이 함수를 사용해 키가 존재하지 않았던 상황과 키가 정의되지 않은 값에 매핑되었던 상황을 구분할 수는 없습니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 반환값이 어느 키를 참조할지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성하는 것은 가능합니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 전송 측에 문제가 있음을 나타냅니다.

value(qint64), find(qint64), contains(qint64), remove(qint64), operator[](QLatin1StringView), operator[](const QString &), operator[](const QCborValue &)도 참조하십시오 .

const QCborValue QCborMap::operator[](const QCborValue &key) const

이 맵에서 키 key 에 해당하는 QCborValue 요소가 있다면 이를 반환합니다.

맵에 키 key 이 포함되어 있지 않은 경우, 이 함수는 정의되지 않은 값을 포함하는 QCborValue 을 반환합니다. 이러한 이유로, 이 함수만으로는 키가 존재하지 않는 상황과 키가 정의되지 않은 값에 매핑된 상황을 구분할 수 없습니다.

맵에 key 과 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 반환할지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성하는 것은 가능합니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 송신 측에 문제가 있음을 나타냅니다.

operator[](qint64), operator[](QLatin1StringView), operator[](const QCborOperator[] &)

value(const QCborValue &), find(const QCborValue &), constFind(const QCborValue &), remove(const QCborValue &), contains(const QCborValue &)도 참조하십시오.

const QCborValue QCborMap::operator[](qint64 key) const

이 맵에서 키 key 에 해당하는 QCborValue 요소를 반환합니다(해당 요소가 존재하는 경우). CBOR에서는 정수 키를 사용할 것을 권장합니다. 정수 키는 차지하는 공간이 적고 인코딩 및 디코딩이 더 간단하기 때문입니다.

맵에 key 키가 포함되어 있지 않은 경우, 이 함수는 정의되지 않은 값을 포함하는 QCborValue 를 반환합니다. 이러한 이유로, 이 함수만으로는 키가 존재하지 않는 상황과 키가 정의되지 않은 값으로 매핑된 상황을 구분할 수 없습니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 반환할지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

operator[](QLatin1StringView), operator[](const QString &), operator[](const QCborOperator[] &)

value(qint64), find(qint64), constFind(qint64), remove(qint64) 및 contains(qint64)도 참조하십시오 .

QCborValueRef QCborMap::operator[](QLatin1StringView key)

이 맵에서 키 ` key`에 해당하는 값을 `QCborValueRef`로 반환합니다.

QCborValueRef는 QCborValue 와 정확히 동일한 API를 가지지만, 한 가지 중요한 차이점이 있습니다. 즉, 새로운 값을 할당하면 이 맵이 해당 새 값으로 업데이트됩니다.

맵에 key 와 동일한 키가 없는 경우, 해당 키가 삽입되고 이 함수는 새로운 값에 대한 참조를 반환합니다. 이 참조는 정의되지 않은 값을 가진 QCborValue 가 됩니다. 이러한 이유로, 이 함수만으로는 키가 존재하지 않았던 상황과 키가 정의되지 않은 값에 매핑되었던 상황을 구분할 수 없습니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 반환값이 어느 키를 참조할지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

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

value(QLatin1StringView), find(QLatin1StringView), contains(QLatin1StringView), remove(QLatin1StringView), operator[](qint64), operator[](const QString &), operator[](const QCborValue &)도 참조하십시오 .

QCborValueRef QCborMap::operator[](const QCborValue &key)

이 맵에서 키 ` key`에 해당하는 값을 `QCborValueRef`로 반환합니다.

QCborValueRef는 QCborValue 와 정확히 동일한 API를 가지지만, 한 가지 중요한 차이점이 있습니다. 즉, 새로운 값을 할당하면 이 맵이 해당 새 값으로 업데이트됩니다.

맵에 key 와 동일한 키가 없는 경우, 해당 키가 삽입되고 이 함수는 새 값에 대한 참조를 반환합니다. 이 참조는 정의되지 않은 값을 가진 QCborValue 가 됩니다. 이러한 이유로, 이 함수만으로는 키가 존재하지 않았던 상황과 키가 정의되지 않은 값에 매핑되었던 상황을 구분할 수 없습니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 반환값이 어느 키를 참조할지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성하는 것은 가능합니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

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

value(const QCborValue &), find(const QCborValue &), contains(const QCborValue &), remove(const QCborValue &), operator[](qint64), operator[](QLatin1StringView), operator[](const QString &)도 참조하십시오.

QCborValueRef QCborMap::operator[](const QString &key)

이 맵에서 키 ` key`에 해당하는 값을 `QCborValueRef`로 반환합니다.

QCborValueRef는 QCborValue 와 API가 완전히 동일하지만, 한 가지 중요한 차이점이 있습니다. 즉, 새로운 값을 할당하면 이 맵이 해당 새 값으로 업데이트됩니다.

맵에 key 와 동일한 키가 없는 경우, 해당 키가 삽입되고 이 함수는 새 값에 대한 참조를 반환하는데, 이 참조는 값이 정의되지 않은 QCborValue 가 됩니다. 이러한 이유로, 이 함수만으로는 키가 존재하지 않았던 상황과 키가 정의되지 않은 값에 매핑된 상황을 구분할 수 없습니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 반환값이 어느 키를 참조할지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 발신 측에 문제가 있음을 나타냅니다.

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

value(const QString &), find(const QString &), contains(const QString &), remove(const QString &), operator[](qint64), operator[](QLatin1StringView), operator[](const QCborValue &)도 참조하십시오.

const QCborValue QCborMap::operator[](QLatin1StringView key) const

이 맵에서 키 key 에 해당하는 QCborValue 요소를 반환합니다(해당 요소가 있는 경우).

맵에 키 key 이 포함되어 있지 않은 경우, 이 함수는 정의되지 않은 값을 포함하는 QCborValue 을 반환합니다. 이러한 이유로, 이 함수를 사용하여 키가 존재하지 않는 상황과 키가 정의되지 않은 값에 매핑된 상황을 구분할 수는 없습니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 반환할지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키가 포함된 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 송신 측에 문제가 있음을 나타냅니다.

operator[](qint64), operator[](const QString &), operator[](const QCborOperator[] &)

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

value(QLatin1StringView), find(QLatin1StringView), constFind(QLatin1StringView), remove(QLatin1StringView) 및 contains(QLatin1StringView)도 참조하십시오 .

const QCborValue QCborMap::operator[](const QString &key) const

이 맵에서 키 key 에 해당하는 QCborValue 요소를 반환합니다(해당 요소가 존재하는 경우).

맵에 key 키가 포함되어 있지 않은 경우, 이 함수는 정의되지 않은 값을 포함하는 QCborValue 를 반환합니다. 이러한 이유로, 이 함수만으로는 키가 존재하지 않는 상황과 키가 정의되지 않은 값에 매핑된 상황을 구분할 수 없습니다.

맵에 key 와 동일한 키가 두 개 이상 포함된 경우, 이 함수가 어떤 키를 반환할지는 정의되지 않습니다. QCborMap 는 중복 키 삽입을 허용하지 않지만, 중복 키를 포함한 CBOR 스트림을 디코딩하여 이러한 맵을 생성할 수는 있습니다. 일반적으로 중복 키는 허용되지 않으며, 중복 키가 존재한다는 것은 대개 송신 측에 문제가 있음을 나타냅니다.

operator[](qint64), operator[](QLatin1StringView), operator[](const QCborOperator[] &)

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

value(const QString &), find(const QString &), constFind(const QString &), remove(const QString &) 및 contains(const QString &)도 참조하십시오 .

관련 비회원 변수

[noexcept] bool operator!=(const QCborMap &lhs, const QCborMap &rhs)

lhs 와 rhs 맵을 순서대로 각 요소를 비교하며, 두 맵에 서로 다른 요소가 포함되어 있거나 요소의 순서가 다른 경우 true를 반환하고, 그렇지 않은 경우 false를 반환합니다.

CBOR 맵은 순서가 정해져 있지 않으므로, 완전히 동일한 쌍을 포함하고 있지만 순서가 다른 두 맵은 여전히 서로 다르게 비교된다는 점에 유의하십시오. 이를 방지하려면 키 값의 오름차순과 같이 예측 가능한 순서로 맵에 요소를 삽입하는 것이 좋습니다. 실제로, 정렬된 순서의 키를 가진 맵은 표준 CBOR 표현에 필수적입니다.

Qt XML에서 CBOR 동일성 비교에 대한 자세한 내용은 QCborValue::compare()을 참조하십시오.

또한 compare(), QCborValue::operator==(), operator==(), operator<()도참조하십시오 .

[noexcept] bool operator<(const QCborMap &lhs, const QCborMap &rhs)

lhs 와 rhs 맵을 각 요소를 순서대로 비교하며, lhs 맵이 rhs 보다 먼저 정렬되어야 할 경우 true를, 그렇지 않은 경우 false를 반환합니다.

CBOR 맵은 정렬되지 않은 상태이므로, 완전히 동일한 쌍을 포함하고 있지만 순서가 다른 두 맵은 여전히 서로 다르게 비교된다는 점에 유의하십시오. 이를 방지하려면 키 값의 오름차순과 같이 예측 가능한 순서대로 맵에 요소를 삽입하는 것이 좋습니다. 실제로, 정렬된 순서의 키를 가진 맵은 표준 CBOR 표현에 필수적입니다.

CBOR 정렬 순서에 대한 자세한 내용은 QCborValue::compare()을 참조하십시오.

또한 compare(), QCborValue::operator==(), QCborMap::operator==(), operator==(), 및 operator!=()을 참조하십시오 .

[noexcept] bool operator<=(const QCborMap &lhs, const QCborMap &rhs)

lhs 와 rhs 맵을 순서대로 각 요소를 비교하며, lhs 맵이 rhs 보다 먼저 정렬되어야 하거나 두 맵이 동일한 요소를 동일한 순서로 포함하고 있는 경우 true를 반환하고, 그렇지 않은 경우 false를 반환합니다.

CBOR 맵은 정렬되지 않은 구조이므로, 완전히 동일한 쌍을 포함하고 있지만 순서가 다른 두 맵은 서로 다르게 비교된다는 점에 유의하십시오. 이를 방지하려면 키 값의 오름차순과 같이 예측 가능한 순서로 맵에 요소를 삽입하는 것이 권장됩니다. 실제로, 표준 CBOR 표현을 위해서는 키가 정렬된 순서로 구성된 맵이 필요합니다.

CBOR 정렬 순서에 대한 자세한 내용은 QCborValue::compare()을 참조하십시오.

또한 compare(), QCborValue::operator==(), QCborMap::operator==(), operator==(), operator!=()도참조하십시오 .

[noexcept] bool operator==(const QCborMap &lhs, const QCborMap &rhs)

lhs 와 rhs 맵을 순서대로 각 요소를 비교하며, 두 맵이 동일한 요소를 동일한 순서로 포함하고 있으면 true를, 그렇지 않으면 false를 반환합니다.

CBOR 맵은 정렬되지 않은 구조이므로, 완전히 동일한 쌍을 포함하고 있지만 순서가 다른 두 맵은 여전히 서로 다르게 비교된다는 점에 유의하십시오. 이를 방지하려면 키 값의 오름차순과 같이 예측 가능한 순서로 맵에 요소를 삽입하는 것이 권장됩니다. 실제로, 정렬된 순서의 키를 가진 맵은 표준 CBOR 표현에 필수적입니다.

Qt XML에서 CBOR 동일성 비교에 대한 자세한 내용은 QCborValue::compare()을 참조하십시오.

또한 compare(), QCborValue::operator==(), operator!=(), operator<()도참조하십시오 .

[noexcept] bool operator>(const QCborMap &lhs, const QCborMap &rhs)

lhs 와 rhs 맵을 각 요소를 순서대로 비교하며, lhs 맵이 rhs 맵보다 정렬되어야 할 경우 true를, 그렇지 않은 경우 false를 반환합니다.

CBOR 맵은 정렬되지 않은 구조이므로, 완전히 동일한 맵 쌍이라도 순서가 다르면 비교 결과가 달라질 수 있습니다. 이를 방지하려면 키 값의 오름차순과 같이 예측 가능한 순서로 맵에 요소를 삽입하는 것이 좋습니다. 실제로, 정식 CBOR 표현을 위해서는 키가 정렬된 순서로 구성된 맵이 필수적입니다.

CBOR 정렬 순서에 대한 자세한 내용은 QCborValue::compare()을 참조하십시오.

또한 compare(), QCborValue::operator==(), QCborMap::operator==(), operator==(), operator!=()도참조하십시오 .

[noexcept] bool operator>=(const QCborMap &lhs, const QCborMap &rhs)

lhs 와 rhs 맵을 순차적으로 각 요소를 비교하며, lhs 맵이 rhs 맵보다 뒤에 와야 하거나 두 맵이 동일한 요소를 동일한 순서로 포함하고 있는 경우 true를 반환하고, 그렇지 않은 경우 false를 반환합니다.

CBOR 맵은 정렬되지 않은 구조이므로, 완전히 동일한 쌍을 포함하고 있지만 순서가 다른 두 맵은 여전히 서로 다르게 비교된다는 점에 유의하십시오. 이를 방지하려면 키 값의 오름차순과 같이 예측 가능한 순서대로 맵에 요소를 삽입하는 것이 권장됩니다. 실제로, 정렬된 순서의 키를 가진 맵은 표준 CBOR 표현에 필수적입니다.

CBOR 정렬 순서에 대한 자세한 내용은 QCborValue::compare()을 참조하십시오.

또한 compare(), QCborValue::operator==(), QCborMap::operator==(), operator==(), 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.