QCborArray Class

멤버 함수 문서

이 배열의 i 위치에 value 을 배열에 삽입합니다. i 가 -1이면 해당 항목이 배열에 추가됩니다. i 이 배열의 이전 크기보다 크면 잘못된 항목으로 배열을 채웁니다.

at(), operator[](), first(), last(), prepend(), append(), removeAt(), takeAt(), extract()도 참조하세요 .

이터레이터 it 로 지정된 위치의 배열에서 값을 추출하고 추출된 값을 반환합니다.

insert(), erase(), takeAt() 및 removeAt()도 참조하세요 .

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

at(), operator[](), first(), last(), insert(), append(), removeAt(), takeAt()도 참조하세요 .

배열에 이미 포함되었을 수 있는 다른 모든 요소 뒤에 value 를 추가합니다.

at(), operator[](), first(), last(), insert(), prepend(), removeAt(), takeAt()도 참조하세요 .

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

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

erase(), removeAt(), prepend() 및 append()도 참조하세요 .

배열 이터레이터 it 가 가리키는 요소를 이 배열에서 제거한 다음 다음 요소( it 가 차지했던 배열에서 동일한 위치를 차지했던 요소)에 대한 이터레이터를 반환합니다.

insert(), removeAt(), takeAt(), takeFirst() 및 takeLast()도 참조하세요 .

[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 의 내용을 이 개체에 복사합니다.

[noexcept] QCborArray::~QCborArray()

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

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를 사용하는 일반 코드와의 호환성을 위해 제공됩니다.

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

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

QCborArray::iterator QCborArray::end()

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

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

QCborArray::const_iterator QCborArray::end() const

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

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

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()도 참조하세요 .

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()도 참조하세요 .

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 요소가 2개 이상 있어야 합니다.

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 요소가 2개 이상 있어야 합니다.

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::toJsonValue()을 사용하여 이 배열의 모든 QCborValue 요소를 재귀적으로 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] QCborArray &QCborArray::operator=(const QCborArray &other)

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

QCborValueRef QCborArray::operator[](qsizetype i)

배열의 i 위치에 있는 QCborValue 요소에 대한 참조를 반환합니다. 배열의 끝을 벗어난 인덱스는 지정된 인덱스에 항목이 있을 때까지 정의되지 않은 항목으로 배열을 채우면서 배열을 늘립니다.

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()도 참조하세요 .