QJsonArray Class

QJsonArrayクラスは、JSON配列をカプセル化します。詳細...

ヘッダー #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に変換したり、テキスト・ベースのJSONから変換したりすることができます。

QtのJSONサポートと ゲームの保存と読み込みも参照してください

メンバ型のドキュメント

QJsonArray::ConstIterator

Qt-style synonym forQJsonArray::const_iterator.

QJsonArray::Iterator

Qt-style synonym forQJsonArray::iterator.

QJsonArray::const_pointer

constQJsonValue * の型定義。STL との互換性のために提供される。

QJsonArray::const_reference

constQJsonValue & の型定義。STL との互換性のために提供される。

QJsonArray::difference_type

qsizetypeの型定義。STL との互換性のために提供される。

QJsonArray::pointer

QJsonValue * の型定義。STL との互換性のために提供される。

QJsonArray::reference

QJsonValue & の型定義。STL との互換性のために提供される。

QJsonArray::size_type

qsizetypeの型定義。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)

Move -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) と等価であり、配列に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)

Move-この配列にother を割り当てる。

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

この配列にother を代入する。

QJsonValueRef QJsonArray::operator[](qsizetype i)

インデックス位置i にある値を、変更可能な参照として返します。i は、配列の有効なインデックス位置(つまり0 <= i < size() )でなければなりません。

戻り値は、QJsonArray およびQJsonObject のヘルパー・クラスであるQJsonValueRef 型です。QJsonValueRef 型のオブジェクトを取得すると、それをQJsonValue への参照と同じように使用できます。これに代入すると、その代入は、参照を取得したQJsonObjectQJsonArray の文字に適用されます。

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 を返す。

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