QJsonObject::iterator Class

メンバ関数のドキュメント

iterator::iterator()

初期化されていないイテレータを生成します。

key()、value()、およびoperator++() などの関数は、初期化されていないイテレータに対して呼び出してはなりません。使用する前に、operator=() を使用して値を代入してください。

QJsonObject::begin() およびQJsonObject::end()も参照してください 。

[constexpr noexcept default] iterator::iterator(const QJsonObject::iterator &other)

iterator のインスタンスをコピーして生成します。

QString iterator::key() const

現在の項目のキーを返します。

イテレータを通じて項目のキーを直接変更する方法はありませんが、QJsonObject::erase() を呼び出した後にQJsonObject::insert() を呼び出すことで変更することは可能です。

value() およびkeyView()も参照してください 。

[since 6.10] QAnyStringView iterator::keyView() const

現在の項目のキーを `QAnyStringView` として返します。この関数はメモリを割り当てません。

QJsonObject はキーをUS-ASCII、UTF-8、またはUTF-16で格納するため、返されるQAnyStringView はこれらのエンコーディングのいずれかになる可能性があります。

イテレータを通じて項目のキーを直接変更する方法はありませんが、QJsonObject::erase() を呼び出した後にQJsonObject::insert() を呼び出すことで変更することは可能です。

この関数は Qt 6.10 で導入されました。

key() およびvalue()も参照してください 。

QJsonValueRef iterator::value() const

現在の項目の値への、変更可能な参照を返します。

代入式の左辺で value() を使用することで、項の値を変更できます。

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

key()、keyView()、およびoperator*()も参照してください 。

QJsonValueRef iterator::operator*() const

現在の項目の値への、変更可能な参照を返します。

value() と同じです。

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

key() およびkeyView()も参照してください 。

QJsonObject::iterator iterator::operator+(qsizetype j) const

このイテレータからj の位置だけ前方にある項目へのイテレータを返します。j が負の値の場合、イテレータは後方へ移動します。

operator-()も参照してください 。

QJsonObject::iterator &iterator::operator++()

プレフィックス演算子 `++ `（++i ）は、イテレータをオブジェクト内の次の項目へと進め、新しい現在の項目へのイテレータを返します。

QJsonObject::end() に対してこの関数を呼び出すと、未定義の結果となります。

operator--()も参照してください 。

QJsonObject::iterator iterator::operator++(int)

後置演算子++ （i++ ）は、イテレータをオブジェクト内の次の項目に進め、直前に現在位置にあった項目へのイテレータを返します。

QJsonObject::iterator &iterator::operator+=(qsizetype j)

イテレータをj 個分進めます。j が負の場合、イテレータは後退します。

operator-=() およびoperator+()も参照してください 。

qsizetype iterator::operator-(QJsonObject::iterator other) const

other が指す要素と、このイテレータが指す要素との間の要素数を返します。

QJsonObject::iterator iterator::operator-(qsizetype j) const

このイテレータからj の位置だけ後ろにある項目へのイテレータを返します。j が負の値の場合、イテレータは前方へ移動します。

operator+()も参照してください 。

QJsonObject::iterator &iterator::operator--()

プレフィックス-- 演算子（--i ）は、直前の要素を現在の要素として設定し、新しい現在の要素を指すイテレータを返します。

QJsonObject::begin() に対してこの関数を呼び出すと、未定義の結果となります。

operator++()も参照してください 。

QJsonObject::iterator iterator::operator--(int)

後置演算子-- （i-- ）は、直前の要素を現在の要素とし、その直前に現在の要素だった要素を指すイテレータを返します。

QJsonObject::iterator &iterator::operator-=(qsizetype j)

イテレータをj 個分戻します。j が負の値の場合、イテレータは前進します。

operator+=() およびoperator-()も参照してください 。

QJsonValueRef *iterator::operator->()

現在の項目への変更可能な参照へのポインタを返します。

const QJsonValueConstRef *iterator::operator->() const

現在の項目への定数参照へのポインタを返します。

QJsonValueRef iterator::operator[](qsizetype j) const

このイテレータが指す項目（位置*this + j にある項目）のうち、オフセットj にある項目への、変更可能な参照を返します。

この関数は、QJsonObject 型イテレータが C++ のポインタのように振る舞うようにするために提供されています。

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

operator+()も参照してください 。