QJsonArray Class

QJsonArray 클래스는 JSON 배열을 캡슐화합니다. 더 보기...

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

이 클래스는 동등 비교가 가능합니다.

이 클래스는 QJsonValue동등 비교 가능합니다.

참고: 이 클래스의 모든 함수는 재인용됩니다.

공용 형

공용 함수

QJsonArray()
QJsonArray(std::initializer_list<QJsonValue> args)
QJsonArray(const QJsonArray &other)
QJsonArray(QJsonArray &&other)
~QJsonArray()
void append(const QJsonValue &value)
QJsonValue at(qsizetype i) const
QJsonArray::iterator begin()
QJsonArray::const_iterator begin() const
QJsonArray::const_iterator cbegin() const
QJsonArray::const_iterator cend() const
QJsonArray::const_iterator constBegin() const
QJsonArray::const_iterator constEnd() const
bool contains(const QJsonValue &value) const
qsizetype count() const
bool empty() const
QJsonArray::iterator end()
QJsonArray::const_iterator end() const
QJsonArray::iterator erase(QJsonArray::iterator it)
QJsonValue first() const
QJsonArray::iterator insert(QJsonArray::iterator before, const QJsonValue &value)
void insert(qsizetype i, const QJsonValue &value)
bool isEmpty() const
QJsonValue last() const
void pop_back()
void pop_front()
void prepend(const QJsonValue &value)
void push_back(const QJsonValue &value)
void push_front(const QJsonValue &value)
void removeAt(qsizetype i)
void removeFirst()
void removeLast()
void replace(qsizetype i, const QJsonValue &value)
qsizetype size() const
void swap(QJsonArray &other)
QJsonValue takeAt(qsizetype i)
QVariantList toVariantList() const
QJsonArray operator+(const QJsonValue &value) const
QJsonArray &operator+=(const QJsonValue &value)
QJsonArray &operator<<(const QJsonValue &value)
QJsonArray &operator=(QJsonArray &&other)
QJsonArray &operator=(const QJsonArray &other)
QJsonValueRef operator[](qsizetype i)
QJsonValue operator[](qsizetype i) const

정적 공용 멤버

QJsonArray fromStringList(const QStringList &list)
QJsonArray fromVariantList(const QVariantList &list)
bool operator!=(const QJsonArray &lhs, const QJsonArray &rhs)
bool operator==(const QJsonArray &lhs, const QJsonArray &rhs)

상세 설명

JSON 배열은 값의 목록입니다. 배열에서 QJsonValue 를 삽입하거나 제거하여 목록을 조작할 수 있습니다.

QJsonArray는 QVariantList. size(), insert(), removeAt() 항목으로 항목 수를 쿼리하고 표준 C++ 이터레이터 패턴을 사용하여 그 내용을 반복할 수 있습니다.

QJsonArray는 암시적으로 공유되는 클래스이며, 수정되지 않는 한 생성된 문서와 데이터를 공유합니다.

QJsonDocument 을 통해 배열을 텍스트 기반 JSON으로 변환하거나 변환할 수 있습니다.

Qt의 JSON 지원게임 저장 및 로드도참고하세요 .

멤버 유형 문서

QJsonArray::ConstIterator

QJsonArray::const_iterator 의 Qt 스타일 동의어.

QJsonArray::Iterator

QJsonArray::iterator 의 Qt 스타일 동의어.

QJsonArray::const_pointer

const QJsonValue *. STL 호환성을 위해 제공됩니다.

QJsonArray::const_reference

const QJsonValue &. STL 호환성을 위해 제공됩니다.

QJsonArray::difference_type

qsizetype의 경우 Typedef. STL 호환성을 위해 제공됩니다.

QJsonArray::pointer

QJsonValue *. STL 호환성을 위해 제공됩니다.

QJsonArray::reference

QJsonValue &. STL 호환성을 위해 제공됩니다.

QJsonArray::size_type

qsizetype의 경우 Typedef. STL 호환성을 위해 제공됩니다.

QJsonArray::value_type

QJsonValue. STL 호환성을 위해 제공됩니다.

멤버 함수 문서

QJsonArray::QJsonArray()

빈 배열을 생성합니다.

QJsonArray::QJsonArray(std::initializer_list<QJsonValue> args)

args 초기화 목록에서 초기화된 배열을 생성합니다.

예를 들어 QJsonArray는 JSON 표기법과 유사한 방식으로 구성할 수 있습니다:

QJsonArray array = { 1, 2.2, QString() };

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

other 의 복사본을 만듭니다.

QJsonArray는 암시적으로 공유되므로 객체가 수정되지 않는 한 복사본은 얕습니다.

[noexcept] QJsonArray::QJsonArray(QJsonArray &&other)

이동 - other 에서 QJsonArray를 구성합니다.

[noexcept] QJsonArray::~QJsonArray()

배열을 삭제합니다.

void QJsonArray::append(const QJsonValue &value)

배열 끝에 value 을 삽입합니다.

prepend() 및 insert()도 참조하세요 .

QJsonValue QJsonArray::at(qsizetype i) const

색인 i 의 값을 나타내는 QJsonValue 을 반환합니다.

i 이 범위를 벗어난 경우 반환되는 QJsonValueUndefined 입니다.

QJsonArray::iterator QJsonArray::begin()

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

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

QJsonArray::const_iterator QJsonArray::begin() const

과부하가 걸린 기능입니다.

QJsonArray::const_iterator QJsonArray::cbegin() const

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

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

QJsonArray::const_iterator QJsonArray::cend() const

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

cbegin() 및 end()도 참조하세요 .

QJsonArray::const_iterator QJsonArray::constBegin() const

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

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

QJsonArray::const_iterator QJsonArray::constEnd() const

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

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

bool QJsonArray::contains(const QJsonValue &value) const

배열에 value 이 포함된 경우 true 을 반환하고 그렇지 않으면 false 을 반환합니다.

count()도 참조하세요 .

qsizetype QJsonArray::count() const

size()와 동일합니다.

size()도 참조하세요 .

bool QJsonArray::empty() const

이 함수는 STL 호환성을 위해 제공됩니다. isEmpty ()와 동일하며 배열이 비어 있으면 true 을 반환합니다.

QJsonArray::iterator QJsonArray::end()

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

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

QJsonArray::const_iterator QJsonArray::end() const

과부하가 걸린 기능입니다.

QJsonArray::iterator QJsonArray::erase(QJsonArray::iterator it)

it 이 가리키는 항목을 제거하고 다음 항목을 가리키는 이터레이터를 반환합니다.

removeAt()도 참조하세요 .

QJsonValue QJsonArray::first() const

배열에 저장된 첫 번째 값을 반환합니다.

at(0) 와 동일합니다.

at()도 참조하세요 .

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

문자열 목록 listQJsonArray 으로 변환합니다.

list 의 값은 JSON 값으로 변환됩니다.

toVariantList() 및 QJsonValue::fromVariant()도 참조하세요 .

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

이형 상품 목록 listQJsonArray 으로 변환합니다.

listQVariant 값은 JSON 값으로 변환됩니다.

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

toVariantList() 및 QJsonValue::fromVariant()도 참조하세요 .

QJsonArray::iterator QJsonArray::insert(QJsonArray::iterator before, const QJsonValue &value)

before 이 가리키는 위치 앞에 value 을 삽입하고 새로 삽입된 항목을 가리키는 이터레이터를 반환합니다.

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

void QJsonArray::insert(qsizetype i, const QJsonValue &value)

배열의 인덱스 위치 ivalue 를 삽입합니다. i0 인 경우 값이 배열 앞에 추가됩니다. isize()인 경우 배열에 값이 추가됩니다.

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

bool QJsonArray::isEmpty() const

객체가 비어 있으면 true 을 반환합니다. 이는 size() == 0과 동일합니다.

size()도 참조하세요 .

QJsonValue QJsonArray::last() const

배열에 저장된 마지막 값을 반환합니다.

at(size() - 1) 와 동일합니다.

at()도 참조하세요 .

void QJsonArray::pop_back()

이 기능은 STL 호환성을 위해 제공됩니다. removeLast ()와 동일합니다. 배열은 비어 있지 않아야 합니다. 배열이 비어 있을 수 있는 경우 이 함수를 호출하기 전에 isEmpty()를 호출하세요.

void QJsonArray::pop_front()

이 기능은 STL 호환성을 위해 제공됩니다. removeFirst ()와 동일합니다. 배열은 비어 있지 않아야 합니다. 배열이 비어 있을 수 있는 경우 이 함수를 호출하기 전에 isEmpty()를 호출하세요.

void QJsonArray::prepend(const QJsonValue &value)

배열의 시작 부분에 value 을 삽입합니다.

이는 insert(0, value) 와 동일하며 배열 앞에 value 을 추가합니다.

append() 및 insert()도 참조하세요 .

void QJsonArray::push_back(const QJsonValue &value)

이 함수는 STL 호환성을 위해 제공됩니다. append (값)과 동일하며 배열에 value 을 추가합니다.

void QJsonArray::push_front(const QJsonValue &value)

이 함수는 STL 호환성을 위해 제공됩니다. prepend (값)과 동일하며 배열 앞에 value 을 추가합니다.

void QJsonArray::removeAt(qsizetype i)

인덱스 위치 i 에서 값을 제거합니다. i 은 배열에서 유효한 인덱스 위치여야 합니다(예: 0 <= i < size()).

insert() 및 replace()도 참조하세요 .

void QJsonArray::removeFirst()

배열의 첫 번째 항목을 제거합니다. 이 함수를 호출하는 것은 removeAt(0) 을 호출하는 것과 같습니다. 배열은 비어 있지 않아야 합니다. 배열이 비어 있으면 이 함수를 호출하기 전에 isEmpty()를 호출하세요.

removeAt() 및 removeLast()도 참조하세요 .

void QJsonArray::removeLast()

배열의 마지막 항목을 제거합니다. 이 함수를 호출하는 것은 removeAt(size() - 1) 을 호출하는 것과 같습니다. 배열은 비어 있지 않아야 합니다. 배열이 비어 있으면 이 함수를 호출하기 전에 isEmpty()를 호출하세요.

removeAt() 및 removeFirst()도 참조하세요 .

void QJsonArray::replace(qsizetype i, const QJsonValue &value)

인덱스 위치 i 의 항목을 value 으로 바꿉니다. i 는 배열에서 유효한 인덱스 위치여야 합니다(예: 0 <= i < size()).

operator[]() 및 removeAt()도 참조하세요 .

qsizetype QJsonArray::size() const

배열에 저장된 값의 개수를 반환합니다.

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

이 배열을 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

QJsonValue QJsonArray::takeAt(qsizetype i)

인덱스 위치 i 에서 항목을 제거하고 반환합니다. i 은 배열에서 유효한 인덱스 위치(예: 0 <= i < size())여야 합니다.

반환 값을 사용하지 않는 경우 removeAt()를 사용하는 것이 더 효율적입니다.

removeAt()도 참조하세요 .

QVariantList QJsonArray::toVariantList() const

이 객체를 QVariantList 로 변환합니다.

생성된 맵을 반환합니다.

QJsonArray QJsonArray::operator+(const QJsonValue &value) const

이 배열의 모든 항목이 포함된 배열을 반환하고 그 뒤에 제공된 value 을 반환합니다.

operator+=()도 참조하세요 .

QJsonArray &QJsonArray::operator+=(const QJsonValue &value)

value 을 배열에 추가하고 배열 자체에 대한 참조를 반환합니다.

append() 및 operator<<()도 참조하세요 .

QJsonArray &QJsonArray::operator<<(const QJsonValue &value)

value 을 배열에 추가하고 배열 자체에 대한 참조를 반환합니다.

operator+=() 및 append()도 참조하세요 .

[noexcept] QJsonArray &QJsonArray::operator=(QJsonArray &&other)

이동 - other 이 배열에 할당합니다.

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

other 을 이 배열에 할당합니다.

QJsonValueRef QJsonArray::operator[](qsizetype i)

인덱스 위치 i 의 값을 수정 가능한 참조로 반환합니다. i 은 배열에서 유효한 인덱스 위치여야 합니다(예: 0 <= i < size()).

반환 값은 QJsonArrayQJsonObject 에 대한 헬퍼 클래스인 QJsonValueRef 유형입니다. QJsonValueRef 유형의 객체를 가져오면 QJsonValue 에 대한 참조인 것처럼 사용할 수 있습니다. 여기에 할당하면 참조를 가져온 QJsonObjectQJsonArray 에 있는 문자에 할당이 적용됩니다.

at()도 참조하세요 .

QJsonValue QJsonArray::operator[](qsizetype i) const

이 함수는 과부하된 함수입니다.

at()와 동일합니다.

관련 비회원

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

lhs 배열이 rhs, false 과 같지 않은 경우 true 을 반환합니다.

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

lhs 배열이 rhs, false 과 같으면 true 을 반환합니다.

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