QJniArray Class

成员函数文档

[default] QJniArray::QJniArray()

QJniArray 的默认构造函数。这不会创建 Java 侧的数组，且该实例将无效。

另请参阅 isValid 。

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

构建一个 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> 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)

构建一个 QJniArray，该对象封装与object 相同的 Java 数组，并创建一个新的全局引用。若要从现有的局部引用构建 QJniArray，请使用通过fromLocalRef() 构建的QJniObject 。

[explicit] QJniArray::QJniArray(jarray array)

构建一个 QJniArray，该对象封装了 Java 侧的数组array ，并生成一个指向array 的新全局引用。

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

构建一个 QJniArray，该对象封装了一个新创建的用于存储T 类型元素的Java数组，并将list 中的数据填入该Java数组。

另请参阅 QJniArrayBase::fromContainer() 和toContainer()。

[default] QJniArray::~QJniArray()

销毁QJniArray 对象，并释放对被封装的Java数组的任何引用。

auto QJniArray::arrayObject() const

返回一个包装好的Java对象，将其转换为与该QJniArray 对象的元素类型T 相匹配的jarray 类型。

返回包装后的 Java 数组中位于位置i 的值。

i 该索引必须是列表中的有效索引位置（即 0 <=i <size())。

另请参阅 size()。

返回一个指向数组中第一个元素的STL 风格常量迭代器。

如果数组是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` 传递一个命名容器（左值），则该容器将被填充，并返回对其的引用。若传递一个临时容器（右值，包括默认参数），则该容器将被填充，并按值返回。

如果数组为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 该索引必须是列表中的有效位置（即 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()。