QJniArray Class

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

配列の最初の項目を指すSTL 形式の const イテレータを返します。

配列がinvalid の場合、対応するend() 関数と同じイテレータを返します。

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

リストの最後の項目の直後を指すSTL 形式のイテレータを返します。

begin() およびrend()も参照 。

配列の最初の項目を指すSTL 形式の逆順イテレータを返します。

配列がinvalid の場合、対応するrend() 関数と同じイテレータを返します。

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

リストの最後の項目の直後を指すSTL 形式の逆順イテレータを返します。

rbegin() およびend()も参照 ください。

ラップされたJava配列の位置i にある値を返す。

i は、リスト内の有効なインデックス位置でなければなりません (つまり、0 <= < ())。i size

size()も参照 。

QJniArray::QJniArray()

QJniArrayのデフォルトコンストラクタ。これはJava側の配列を作成せず、インスタンスは無効になります。

isValidも参照してください 。

[explicit] template <typename Container, QJniArrayBase::if_compatible_source_container<Container> = true> QJniArray::QJniArray(Container &&container)

QJniArray を構築します。この QJniArray は、Container::value_type 型の要素用に新しく作成された Java 配列をラップし、container からのデータで Java 配列を埋めます。

制約

Container がJNI type または同等の C++ 型の要素を格納するコンテナであり、前方イテレータを提供する場合に のみ、オーバーロード解決に参加します。

構築された QJniArray の特殊化は、container の値型に依存します。Container<T> （例えば、QList<T> など）の場合、以下の例外を除いて、通常はQJniArray<T> になります：

QJniArrayBase::fromContainer() およびtoContainer()も参照してください 。

[noexcept] template <typename Other, QJniArrayBase::if_convertible<Other, T> = true> QJniArray::QJniArray(QJniArray<Other> &&other)

other から移動して QJniArray を構築します。other の配列はinvalid になります。

制約

other の要素型Other が、構築される QJniArray の要素型T に変換可能である場合にのみ、オーバーロード解決に参加します。ただし、実際の変換は行われません。

[explicit, since 6.9] QJniArray::QJniArray(QJniArrayBase::size_type size)

サイズsize の空の QJniArray を構築する。配列の要素は初期化されません。

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

[explicit noexcept] QJniArray::QJniArray(QJniObject &&object)

object から移動して QJniArray を構築する。QJniObject はinvalid になる。

template <typename Other, QJniArrayBase::if_convertible<Other, T> = true> QJniArray::QJniArray(const QJniArray<Other> &other)

other をコピーして QJniArray を構築する。両方の QJniArray オブジェクトは、同じ Java 配列オブジェクトを参照します。

制約

other の要素型Other が、構築される QJniArray の要素型T に変換可能である場合にのみ、オーバーロード解決に参加します。ただし、実際の変換は行われない。

[explicit] QJniArray::QJniArray(const QJniObject &object)

object と同じ Java 配列をラップする QJniArray を構築し、新しいグローバル参照を作成する。既存のローカル参照から QJniArray を構築するには、fromLocalRef() によって構築されたQJniObject を使用します。

[explicit] QJniArray::QJniArray(jarray array)

Java 側配列array をラップする QJniArray を構築し、array への新しいグローバル参照を作成します。

[default] QJniArray::QJniArray(std::initializer_list<T> &list)

QJniArray を構築します。この QJniArray は、T 型の要素用に新しく作成された Java 配列をラップし、list からのデータで Java 配列を埋めます。

QJniArrayBase::fromContainer() およびtoContainer()も参照してください 。

QJniArray::~QJniArray()

QJniArray オブジェクトを破棄し、ラップされた Java 配列への参照をすべて解放します。

auto QJniArray::arrayObject() const

このQJniArray オブジェクトの要素型T と一致する、適切なjarray 型としてラップされた Java オブジェクトを返します。

template <typename Container = QJniArrayBase::ToContainerType<T>, QJniArrayBase::if_compatible_target_container<T, Container> = true> Container QJniArray::toContainer(Container &&container = {}) const

ラップされたJava配列のデータを入れたコンテナを返す。

container が提供されない場合、返されるコンテナの型は、このQJniArray の要素型に依存する。QJniArray<T> の場合、これは通常QList<T> となる：

container に名前付きコンテナ（l値）を渡すと、そのコンテナが満たされ、そのコンテナへの参照が返される。一時的なコンテナ（デフォルト引数を含むr値）を渡すと、そのコンテナが満たされ、値が返されます。

配列がinvalid の場合、この関数は直ちに戻る。

QJniArrayBase::fromContainer()も参照のこと 。

[noexcept] template <typename Other, QJniArrayBase::if_convertible<Other, T> = true> QJniArray<T> &QJniArray::operator=(QJniArray<Other> &&other)

other をこのQJniArray に移動し、この参照を返す。配列other はinvalid になる。

制約

other の要素型Other が、このQJniArray の要素型T に変換可能である場合にのみ、オーバーロード解決に参加します。 ただし、実際の変換は行われません。

template <typename Other, QJniArrayBase::if_convertible<Other, T> = true> QJniArray<T> &QJniArray::operator=(const QJniArray<Other> &other)

other をこのQJniArray に代入し、この参照を返す。両方のQJniArray オブジェクトは、同じ Java 配列オブジェクトを参照します。

制約

other の要素型Other が、このQJniArray の要素型T に変換可能である場合にのみ、オーバーロード解決に参加します。 ただし、実際の変換は行われません。

[since 6.9] QJniArray<T>::reference QJniArray::operator[](QJniArrayBase::size_type i)

ラップされたJava配列の位置i にある値の参照オブジェクトを返します。

i は、リスト内の有効なインデックス位置でなければなりません（つまり、0 <= < ()）。i size

返された参照オブジェクトは、位置i の値を保持し、ほとんどの場合、暗黙のうちにその値に変換されます。返された参照に代入すると、Java配列のエントリが上書きされます。しかし、そのオブジェクトに対して変異メンバ関数を呼んでも、配列のエントリは変更されません。この演算子の結果に対してメンバ関数を呼び出すには、参照オブジェクトを非参照にします：

QJniArray<QString> strings = object.callMethod<QString[]>("getStrings");
if (!strings.isEmpty()) {
    if (!(*array[0]).isEmpty()) {
        // ...
    }
}

ただし、配列自体の値を変更することを意図していない場合は、配列を const にするか、代わりにat() を使用してください。

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

at() およびsize()も参照してください 。