이 페이지에서

QJsonArray Class

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

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

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

QJsonArray 비교

범주비교 가능한 유형
동등성QJsonArray
동등성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 *에 대한 typedef입니다. STL 호환성을 위해 제공됩니다.

QJsonArray::const_reference

const QJsonValue 에 대한 typedef입니다. STL 호환성을 위해 제공됩니다.

QJsonArray::difference_type

qsizetype에 대한 typedef입니다. STL 호환성을 위해 제공됩니다.

QJsonArray::pointer

QJsonValue 에 대한 typedef *. STL 호환성을 위해 제공됩니다.

QJsonArray::reference

QJsonValue 에 대한 typedef입니다. STL 호환성을 위해 제공됩니다.

QJsonArray::size_type

qsizetype에 대한 typedef입니다. STL 호환성을 위해 제공됩니다.

QJsonArray::value_type

QJsonValue 에 대한 typedef입니다. 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 가 범위를 벗어난 경우, 반환되는 QJsonValue 는 Undefined 입니다.

QJsonArray::iterator QJsonArray::begin()

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

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

QJsonArray::const_iterator QJsonArray::begin() const

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

QJsonArray::const_iterator QJsonArray::cbegin() const

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

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

QJsonArray::const_iterator QJsonArray::cend() const

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

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

QJsonArray::const_iterator QJsonArray::constBegin() const

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

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

QJsonArray::const_iterator QJsonArray::constEnd() const

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

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)

문자열 목록 ` list `을 ` QJsonArray`로 변환합니다.

list 에 포함된 값들은 JSON 값으로 변환됩니다.

toVariantList() 및 QJsonValue::fromVariant()도 참조하십시오 .

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

변형 목록 list 을 QJsonArray 로 변환합니다.

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

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

toVariantList() 및 QJsonValue::fromVariant()도 참조하십시오 .

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

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

erase() 및 insert(qsizetype, const QJsonValue &)도 참조하십시오 .

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

배열의 인덱스 위치 i 에 value 를 삽입합니다. i 가 0 인 경우, 해당 값이 배열의 맨 앞에 추가됩니다. i 가 size()인 경우, 해당 값이 배열의 맨 뒤에 추가됩니다.

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)`와 동일하며, 배열 끝에 ` value `를 추가합니다.

void QJsonArray::push_front(const QJsonValue &value)

이 함수는 STL 호환성을 위해 제공됩니다. 이 함수는 ` prepend(value)`와 동일하며, 배열의 맨 앞에 ` 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()).

반환 값의 유형은 QJsonValueRef 이며, 이는 QJsonArray 및 QJsonObject 을 위한 헬퍼 클래스입니다. QJsonValueRef 유형의 객체를 얻으면, 마치 QJsonValue 에 대한 참조인 것처럼 사용할 수 있습니다. 이 객체에 값을 할당하면, 해당 할당은 참조를 얻은 QJsonObject 의 QJsonArray 에 있는 문자에 적용됩니다.

at()도 참조하십시오 .

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

at()와 동일합니다.

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

관련 비멤버 변수

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

lhs 배열이 rhs 과 같지 않으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

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

lhs 배열이 rhs 과 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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