이 페이지에서

Qt의 CBOR 지원

Qt는 CBOR 데이터 처리를 지원합니다. CBOR는 JSON에서 사용할 수 있는 데이터 유형의 상위 집합을 포함하면서도 더 간결한 이진 데이터 저장 형식입니다.

Qt의 CBOR 지원 기능은 CBOR 데이터를 구문 분석, 수정 및 저장할 수 있는 사용하기 쉬운 C++ API를 제공합니다.

CBOR 데이터 형식에 대한 자세한 내용은 RFC 7049에서 확인할 수 있습니다.

개요

CBOR는 구조화된 데이터를 저장하기 위한 형식입니다. 이 형식에는 세 가지 그룹의 내장 유형이 있습니다:

  • 기본 유형: 정수, 부동 소수점, 부울, null 등
  • 문자열 유사 유형: 문자열 및 바이트 배열
  • 컨테이너: 배열 및 맵

또한, CBOR는 “태그”를 추가하여 데이터 유형의 의미를 확장할 수 있습니다. 컨테이너 유형은 기본 유형, 문자열 유사 유형 및 다른 컨테이너를 포함할 수 있습니다.

CBOR 클래스

QCborValue 클래스

QCborValue 클래스는 모든 CBOR 유형을 나타냅니다. 또한 QCborStreamReader 및 QCborStreamWriter 객체에 대한 읽기 및 쓰기 작업을 위한 간단한 API를 제공하며, QCborArray 및 QCborMap 를 활용하여 메모리 내의 해당 객체를 조작할 수도 있습니다. CborValue API는 전체 CBOR 데이터 유형에서 단순화된 것으로, 모든 정수는 항상 qint64 로, 모든 부동소수점은 double 로 표현합니다. 즉, QCborValue 는 qint64 (-2^63부터 2^63-1까지) 범위를 벗어난 CBOR 정수 값을 표현할 수 없습니다. CBOR 스트림을 생성할 때, ` QCborValue::toCbor()`를 구성하여 더 짧은 단정밀도 및 반정밀도 부동소수점 표현을 쓰도록 시도할 수 있습니다.

QCborArray 클래스

QCborArray 클래스는 QCborValue 객체의 배열을 저장하는 데 사용됩니다. QCborValue 객체는 QCborArray 객체를 포함할 수 있습니다. 이 클래스에는 QVariantList, QStringList, QJsonArray 로 변환하거나 그 반대로 변환하는 함수가 있습니다.

QCborMap 클래스

QCborMap 클래스는 QCborValue 객체들의 맵을 보관하는 데 사용됩니다. QCborValue 객체는 QCborMap 객체를 포함할 수 있습니다. 이 클래스에는 QVariantMap, QVariantHash, QJsonObject 간 변환을 위한 함수가 있지만, 키는 QString 뿐만 아니라 어떤 유형이든 가질 수 있습니다.

QCborStreamReader 클래스

QCborStreamReader 클래스는 QIODevice, QByteArray 또는 메모리 포인터에서 CBOR 데이터를 읽기 위한 저수준 API입니다. 이 클래스는 QXmlStreamReader 클래스와 유사한 API를 제공합니다.

QCborStreamWriter 클래스

QCborStreamWriter 클래스는 QIODevice 또는 QByteArray 에 CBOR 데이터를 기록하기 위한 저수준 API입니다. 이 클래스는 QXmlStreamWriter 클래스와 유사한 API를 제공합니다.

‘CBOR 데이터 구문 분석 및 표시’, ‘직렬화 변환기’, ‘게임 저장 및 불러오기’항목도 참조하십시오 .

QCborArray

CBOR 요소 배열을 담는 데 사용됩니다.

QCborArray::ConstIterator

QCborArray::ConstIterator 클래스는 QCborArray용 STL 스타일의 const 이터레이터를 제공합니다

QCborArray::Iterator

QCborArray::Iterator 클래스는 QCborArray에 대한 STL 스타일의 비상수(non-const) 이터레이터를 제공합니다.

QCborMap

CBOR로 표현 가능한 연관 컨테이너를 담는 데 사용됩니다.

QCborMap::ConstIterator

QCborMap::ConstIterator 클래스는 QCborMap에 대한 STL 스타일의 const 이터레이터를 제공합니다.

QCborMap::Iterator

QCborMap::Iterator 클래스는 QCborMap에 대한 STL 스타일의 비const 이터레이터를 제공합니다.

QCborParserError

QCborValue에서 구문 분석 오류를 보고하는 데 사용됩니다

QCborStreamReader

QByteArray 또는 QIODevice에서 작동하는 간단한 CBOR 스트림 디코더입니다.

QCborStreamWriter

단방향 스트림에서 작동하는 간단한 CBOR 인코더

QCborValue

CBOR 형식으로 값을 캡슐화합니다.

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