QJsonArray Class
QJsonArray 클래스는 JSON 배열을 캡슐화합니다. 더 보기...
Header: | #include <QJsonArray> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
qmake: | QT += core |
- 상속된 멤버를 포함한 모든 멤버의 목록
- QJsonArray는 Qt의 JSON 지원과 암시적으로 공유되는 클래스의 일부입니다.
이 클래스는 동등 비교가 가능합니다.
이 클래스는 QJsonValue 와 동등 비교 가능합니다.
참고: 이 클래스의 모든 함수는 재인용됩니다.
공용 형
class | const_iterator |
class | iterator |
ConstIterator | |
Iterator | |
const_pointer | |
const_reference | |
difference_type | |
pointer | |
reference | |
size_type | |
value_type |
공용 함수
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 을 삽입합니다.
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 스타일 이터레이터를 반환합니다.
QJsonArray::const_iterator QJsonArray::cend() const
배열의 마지막 항목 뒤에 있는 가상의 항목을 가리키는 상수 STL 스타일 이터레이터를 반환합니다.
QJsonArray::const_iterator QJsonArray::constBegin() const
배열의 첫 번째 항목을 가리키는 상수 STL 스타일 이터레이터를 반환합니다.
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 스타일 이터레이터를 반환합니다.
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()도 참조하세요 .
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 을 추가합니다.
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()
).
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()
).
반환 값은 QJsonArray 및 QJsonObject 에 대한 헬퍼 클래스인 QJsonValueRef 유형입니다. QJsonValueRef 유형의 객체를 가져오면 QJsonValue 에 대한 참조인 것처럼 사용할 수 있습니다. 여기에 할당하면 참조를 가져온 QJsonObject 의 QJsonArray 에 있는 문자에 할당이 적용됩니다.
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.