QCborArray Class

멤버 함수 설명서

[noexcept] QCborArray::QCborArray()

빈 QCborArray를 생성합니다.

QCborArray::QCborArray(std::initializer_list<QCborValue> args)

다음 예제와 같이, args 에 있는 C++ 중괄호로 묶인 목록을 사용하여 이 QCborArray를 초기화합니다.

QCborArray a = { null, 0, 1, 1.5, 2, "Hello", QByteArray("World") };

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

other 의 내용을 이 객체로 복사합니다.

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

이동 생성자.

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

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

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

[noexcept] QCborArray::~QCborArray()

이 QCborArray 를 삭제하고 관련 리소스를 모두 해제합니다.

배열에 이미 포함된 다른 모든 요소 뒤에 value 를 추가합니다.

at(), operator[](), first(), last(), insert(), prepend(), removeAt() 및 takeAt()도 참조하십시오 .

QCborValue QCborArray::at(qsizetype i) const

배열의 위치 i 에 있는 ` QCborValue ` 요소를 반환합니다.

배열의 요소 수가 ` i `보다 작을 경우, 이 함수는 정의되지 않은 값을 포함하는 ` QCborValue `를 반환합니다. 이러한 이유로, 이 함수만으로는 배열의 크기가 충분하지 않은 상황과 배열이 정의되지 않은 값으로 시작하는 경우를 구분할 수 없습니다.

operator[](), first(), last(), insert(), prepend(), append(), removeAt() 및 takeAt()도 참조하십시오 .

QCborArray::iterator QCborArray::begin()

이 배열의 첫 번째 항목을 가리키는 배열 이터레이터를 반환합니다. 배열이 비어 있는 경우, 이 함수는 end()와 동일한 결과를 반환합니다.

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

QCborArray::const_iterator QCborArray::begin() const

이 배열의 첫 번째 항목을 가리키는 배열 이터레이터를 반환합니다. 배열이 비어 있는 경우, 이 함수는 end()과 동일한 결과를 반환합니다.

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

QCborArray::const_iterator QCborArray::cbegin() const

이 배열의 첫 번째 항목을 가리키는 배열 이터레이터를 반환합니다. 배열이 비어 있는 경우, 이 함수는 end()과 동일한 결과를 반환합니다.

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

QCborArray::const_iterator QCborArray::cend() const

이 배열의 마지막 요소 바로 다음을 가리키는 배열 이터레이터를 반환합니다.

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

void QCborArray::clear()

이 배열을 비웁니다.

isEmpty()도 참조하십시오 .

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

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

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

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

QCborArray::const_iterator QCborArray::constBegin() const

이 배열의 첫 번째 항목을 가리키는 배열 이터레이터를 반환합니다. 배열이 비어 있는 경우, 이 함수는 end()과 동일한 결과를 반환합니다.

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

QCborArray::const_iterator QCborArray::constEnd() const

이 배열의 마지막 요소 바로 뒤를 가리키는 배열 이터레이터를 반환합니다.

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

bool QCborArray::contains(const QCborValue &value) const

이 배열에 value 과 동일한 요소가 포함되어 있으면 true를 반환합니다.

bool QCborArray::empty() const

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

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

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

QCborArray::iterator QCborArray::end()

이 배열의 마지막 요소 바로 다음을 가리키는 배열 이터레이터를 반환합니다.

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

QCborArray::const_iterator QCborArray::end() const

이 배열의 마지막 요소 바로 다음 위치를 가리키는 배열 반복자를 반환합니다.

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

배열 반복자 it 가 가리키는 요소를 이 배열에서 제거한 다음, 다음 요소( it 가 차지했던 배열 내 위치와 동일한 위치에 있는 요소)를 가리키는 반복자를 반환합니다.

insert(), removeAt(), takeAt(), takeFirst() 및 takeLast()도 참조하십시오 .

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

insert(), erase(), takeAt(), removeAt()도 참조하십시오 .

QCborValueRef QCborArray::first()

이 배열의 첫 번째 ` QCborValue `에 대한 참조를 반환합니다. 배열은 비어 있어서는 안 됩니다.

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

operator[](), at(), last(), insert(), prepend(), append(), removeAt() 및 takeAt()도 참조하십시오 .

QCborValue QCborArray::first() const

이 배열의 첫 번째 ` QCborValue `를 반환합니다.

배열이 비어 있는 경우, 이 함수는 정의되지 않은 값을 포함하는 ` QCborValue `를 반환합니다. 이러한 이유로, 이 함수만으로는 배열의 크기가 충분하지 않은 상황과 배열이 정의되지 않은 값으로 끝나는 경우를 구분할 수 없습니다.

operator[](), at(), last(), insert(), prepend(), append(), removeAt() 및 takeAt()도 참조하십시오 .

[static] QCborArray QCborArray::fromJsonArray(const QJsonArray &array)

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

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

toJsonArray(), toVariantList(), QCborValue::fromJsonValue() 및 QCborMap::fromJsonObject()도 참조하십시오 .

[static noexcept, since 6.3] QCborArray QCborArray::fromJsonArray(QJsonArray &&array)

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

[static] QCborArray QCborArray::fromStringList(const QStringList &list)

list 목록에서 발견된 모든 문자열을 포함하는 QCborArray 를 반환합니다.

fromVariantList() 및 fromJsonArray()도 참조하십시오 .

[static] QCborArray QCborArray::fromVariantList(const QVariantList &list)

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

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

toVariantList(), fromStringList(), fromJsonArray(), QCborMap::fromVariantMap()도 참조하십시오 .

이 배열의 i 위치에 value 를 삽입합니다. i 가 -1인 경우, 해당 항목은 배열의 끝에 추가됩니다. i 가 배열의 기존 크기보다 큰 경우, 배열을 유효하지 않은 항목으로 채웁니다.

at(), operator[](), first(), last(), prepend(), append(), removeAt(), takeAt() 및 extract()도 참조하십시오 .

이 배열의 before 요소 앞에 value 를 삽입하고, 방금 삽입된 요소를 가리키는 배열 이터레이터를 반환합니다.

erase(), removeAt(), prepend(), append()도 참조하십시오 .

bool QCborArray::isEmpty() const

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

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

QCborValueRef QCborArray::last()

이 배열의 마지막 QCborValue 에 대한 참조를 반환합니다. 배열은 비어 있어서는 안 됩니다.

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

operator[](), at(), first(), insert(), prepend(), append(), removeAt(), takeAt()도 참조하십시오 .

QCborValue QCborArray::last() const

이 배열의 마지막 ` QCborValue `를 반환합니다.

배열이 비어 있는 경우, 이 함수는 정의되지 않은 값을 포함하는 QCborValue 를 반환합니다. 이러한 이유로, 이 함수만으로는 배열의 크기가 충분하지 않은 경우와 배열이 정의되지 않은 값으로 끝나는 경우를 구분할 수 없습니다.

operator[](), at(), first(), insert(), prepend(), append(), removeAt() 및 takeAt()도 참조하십시오 .

void QCborArray::pop_back()

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

이 배열의 마지막 요소를 제거합니다. 제거하기 전에 배열이 비어 있어서는 안 됩니다.

removeLast(), takeLast(), pop_front(), push_back(), append(), insert()도 참조하십시오 .

void QCborArray::pop_front()

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

이 배열의 첫 번째 요소를 제거합니다. 제거하기 전에 배열이 비어 있어서는 안 됩니다.

removeFirst(), takeFirst(), pop_back(), push_front(), prepend() 및 insert()도 참조하십시오 .

배열에 이미 포함되어 있을 수 있는 다른 요소들보다 앞에 value 를 추가합니다.

at(), operator[](), first(), last(), insert(), append(), removeAt() 및 takeAt()도 참조하십시오 .

void QCborArray::push_back(const QCborValue &t)

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

t 요소를 이 배열에 추가합니다.

append(), push_front(), pop_back(), prepend(), insert()도 참조하십시오 .

void QCborArray::push_front(const QCborValue &t)

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

이 배열의 맨 앞에 t 요소를 추가합니다.

prepend(), push_back(), pop_front(), append() 및 insert()도 참조하십시오 .

void QCborArray::removeAt(qsizetype i)

배열에서 위치 i 에 있는 요소를 제거합니다. 제거하기 전에 배열의 요소 개수가 i 보다 많아야 합니다.

takeAt(), removeFirst(), removeLast(), at(), operator[](), insert(), prepend() 및 append()도 참조하십시오 .

void QCborArray::removeFirst()

배열의 첫 번째 요소를 제거하여 두 번째 요소가 첫 번째 요소가 되도록 합니다. 이 함수를 호출하기 전에 배열이 비어 있어서는 안 됩니다.

removeAt(), takeFirst(), removeLast(), at(), operator[](), insert(), prepend() 및 append()도 참조하십시오 .

void QCborArray::removeLast()

배열의 마지막 요소를 제거합니다. 이 함수를 호출하기 전에 배열이 비어 있어서는 안 됩니다.

removeAt(), takeLast(), removeFirst(), at(), operator[](), insert(), prepend() 및 append()도 참조하십시오 .

[noexcept] qsizetype QCborArray::size() const

이 배열의 크기를 반환합니다.

isEmpty()도 참조하십시오 .

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

이 배열을 other 와 교환합니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

QCborValue QCborArray::takeAt(qsizetype i)

배열에서 위치 i 에 있는 요소를 제거하고 해당 요소를 반환합니다. 제거하기 전에 배열의 요소 수가 i 보다 많아야 합니다.

removeAt(), removeFirst(), removeLast(), at(), operator[](), insert(), prepend() 및 append()도 참조하십시오 .

QCborValue QCborArray::takeFirst()

배열의 첫 번째 요소를 제거하고 이를 반환하여, 두 번째 요소가 첫 번째 요소가 되도록 합니다. 이 함수를 호출하기 전에 배열이 비어 있어서는 안 됩니다.

takeAt(), removeFirst(), removeLast(), at(), operator[](), insert(), prepend() 및 append()도 참조하십시오 .

QCborValue QCborArray::takeLast()

배열의 마지막 요소를 제거하고 해당 요소를 반환합니다. 이 함수를 호출하기 전에 배열이 비어 있어서는 안 됩니다.

takeAt(), removeLast(), removeFirst(), at(), operator[](), insert(), prepend() 및 append()도 참조하십시오 .

QCborValue QCborArray::toCborValue() const

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

QCborArray 를 QCborValue 로 변환하면, QCborValues를 사용할 수 있는 모든 컨텍스트에서 이를 사용할 수 있게 됩니다. 여기에는 QCborArrays의 항목으로 사용하거나, QCborMap 의 키 및 매핑된 유형으로 사용하는 것도 포함됩니다. 배열을 QCborValue 로 변환하면 QCborValue::toCbor()에 접근할 수 있습니다.

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

QJsonArray QCborArray::toJsonArray() const

이 배열에 포함된 모든 ` QCborValue ` 요소를 ` QCborValue::toJsonValue()`를 사용하여 재귀적으로 JSON으로 변환하고, 해당 요소들로 구성된 ` QJsonArray `를 반환합니다.

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

fromJsonArray(), QCborValue::toJsonValue(), QCborMap::toJsonObject(), toVariantList()도 참조하십시오 .

QVariantList QCborArray::toVariantList() const

QCborValue::toVariant() 함수를 사용하여 이 배열에 포함된 각 QCborValue 객체를 재귀적으로 변환하고, 변환된 항목들로 구성된 QVariantList 객체를 반환합니다.

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

fromVariantList(), fromStringList(), toJsonArray(), QCborValue::toVariant(), QCborMap::toVariantMap()도 참조하십시오 .

QCborArray QCborArray::operator+(const QCborValue &v) const

이 배열과 동일한 요소를 포함하고, 마지막 요소로 v 를 추가한 새로운 QCborArray 객체를 반환합니다.

operator+=(), operator<<() 및 append()도 참조하십시오 .

QCborArray &QCborArray::operator+=(const QCborValue &v)

이 배열에 ` v `를 추가하고, 이 배열에 대한 참조를 반환합니다.

append(), insert(), operator+(), operator<<()도 참조하십시오 .

QCborArray &QCborArray::operator<<(const QCborValue &v)

이 배열에 ` v `을 추가하고, 이 배열에 대한 참조를 반환합니다.

append(), insert(), operator+() 및 operator+=()도 참조하십시오 .

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

이동 할당 연산자.

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

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

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

이 배열의 내용을 other 에 있는 내용으로 대체한 다음, 이 객체에 대한 참조를 반환합니다.

QCborValueRef QCborArray::operator[](qsizetype i)

배열의 i 위치에 있는 QCborValue 요소에 대한 참조를 반환합니다. 배열 끝을 넘어가는 인덱스를 지정하면, 지정된 인덱스에 항목이 생길 때까지 배열이 확장되며, 확장된 부분은 undefined 항목으로 채워집니다.

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

at(), first(), last(), insert(), prepend(), append(), removeAt() 및 takeAt()도 참조하십시오 .

const QCborValue QCborArray::operator[](qsizetype i) const

배열의 위치 i 에 있는 QCborValue 요소를 반환합니다.

배열의 크기가 i 개 요소보다 작을 경우, 이 함수는 정의되지 않은 값을 포함하는 QCborValue 를 반환합니다. 이러한 이유로, 이 함수만으로는 배열의 크기가 충분하지 않은 경우와 배열의 i 위치에 정의되지 않은 값이 포함된 경우를 구분할 수 없습니다.

at(), first(), last(), insert(), prepend(), append(), removeAt() 및 takeAt()도 참조하십시오 .