QJniArray Class

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

[default] QJniArray::QJniArray()

QJniArray のデフォルトコンストラクタです。これは Java 側の配列を作成しないため、インスタンスは無効となります。

isValidも参照してください 。

[explicit] template <typename Container> requires if_compatible_source_container<Container> QJniArray::QJniArray(Container &&container)

Container::value_type 型の要素を持つ、新しく作成されたJava配列をラップするQJniArrayを構築し、container のデータでそのJava配列に値を設定します。

制約

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

構築される QJniArray の特化は、container の値型に依存します。Container<T> （例：QList<T> ）の場合、通常はQJniArray<T> となりますが、以下の例外があります：

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

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

other からデータを移動して、QJniArrayを構築します。other 配列はinvalid となります。

制約

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

[noexcept delete] template <typename Other> requires unless_convertible<Other, T> QJniArray::QJniArray(QJniArray<Other> &&other)

QJniArray のインスタンスをデフォルトで生成します。この関数は削除されました。

[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> requires if_convertible<Other, T> QJniArray::QJniArray(const QJniArray<Other> &other)

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

制約

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

[delete] template <typename Other> requires unless_convertible<Other, T> QJniArray::QJniArray(const QJniArray<Other> &other)

QJniArray のインスタンスをデフォルトで生成します。この関数は削除されています。

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

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

[explicit] QJniArray::QJniArray(jarray array)

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

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

T 型の要素を持つ、新しく作成された Java 配列をラップする QJniArray を構築し、list のデータでその Java 配列に値を設定します。

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

[default] QJniArray::~QJniArray()

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

auto QJniArray::arrayObject() const

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

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

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

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

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

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

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

リストの最後の要素の直後を指す、STL スタイルのイテレータを返します。

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

配列の最初の要素を指す、STL 形式の逆順イテレータを、逆順で返します。

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

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

リストの最後の要素の直後を指す、STL スタイルの逆イテレータを、逆順で返します。

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

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

ラップされたJava配列内のデータで初期化されたコンテナを返します。

container が指定されていない場合、返されるコンテナの型は、このQJniArray の要素型によって決まります。QJniArray<T> の場合、通常はQList<T> になりますが、以下の例外があります：

container に名前付きコンテナ（lvalue）を引数として渡した場合、そのコンテナにデータが格納され、その参照が返されます。一時コンテナ（rvalue、デフォルト引数を含む）を引数として渡した場合、そのコンテナにデータが格納され、値として返されます。

この関数は、配列が `invalid` である場合、直ちに返ります。

QJniArrayBase::fromContainer()も参照してください 。

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

other をQJniArray に移動し、これへの参照を返します。other 配列はinvalid となります。

制約

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

template <typename Other> requires if_convertible<Other, T> 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 i は、リスト内の有効なインデックス位置でなければなりません（つまり、0 <= < ())。size

返される参照オブジェクトは、位置i にある値を保持しており、ほとんどの場合、その値に暗黙的に変換されます。返された参照に値を代入すると、Java 配列内のエントリが上書きされます。ただし、そのオブジェクトに対して変更を伴うメンバ関数を呼び出しても、配列内のエントリは変更されません。この演算子の結果に対してメンバ関数を呼び出すには、参照オブジェクトの参照を解除してください:

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

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

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

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