QJniArray Class

成员函数文档

返回一个STL 样式的常量迭代器，指向数组中的第一个项。

如果数组是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，为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)

构造一个 QJniArray，封装与object 相同的 Java 数组，创建一个新的全局引用。要从现有的本地引用构造一个 QJniArray，请使用通过fromLocalRef() 构造的QJniObject 。

[explicit] QJniArray::QJniArray(jarray array)

构造一个封装了 Java 端数组array 的 QJniArray，为array 创建一个新的全局引用。

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

构造一个 QJniArray，为T 类型的元素封装一个新创建的 Java 数组，并用list 中的数据填充 Java 数组。

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

QJniArray::~QJniArray()

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

auto QJniArray::arrayObject() const

返回包装后的 Java 对象，作为与该QJniArray 对象的元素类型T 匹配的合适jarray 类型。

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 可转换为 thisQJniArray 的元素类型T 时，才会参与重载解析。但不会进行实际转换。

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

将other 赋值给QJniArray ，并返回对 的引用。两个QJniArray 对象都将引用同一个 Java 数组对象。

限制条件

只有当other 的元素类型Other 可转换为 thisQJniArray 的元素类型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()) {
        // ...
    }
}

但是，如果不打算修改数组本身的值，则应使数组常量化，或使用at() 代替。

此函数在 Qt 6.9 中引入。

另请参阅 at() 和size()。