QJniArray Class

Documentación de las funciones miembro

QJniArray::QJniArray()

Constructor por defecto de QJniArray. Esto no crea un array del lado de Java, y la instancia será inválida.

Véase también isValid.

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

Construye un QJniArray que envuelve un array Java recién creado para elementos de tipo Container::value_type, y rellena el array Java con los datos de container.

Restricciones

Participa en la resolución de sobrecargas sólo si Container es un contenedor que almacena elementos de un tipo JNI type o equivalente en C++, y proporciona un iterador hacia adelante.

La especialización del QJniArray construido depende del tipo de valor de container. Para un Container<T> (como, por ejemplo, QList<T>) será normalmente QJniArray<T>, con las siguientes excepciones:

Véase también QJniArrayBase::fromContainer() y toContainer().

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

Construye un QJniArray desplazándose desde other. El array other se convierte en invalid.

Restricciones

Participa en la resolución de sobrecargas sólo si el tipo de elemento Other de other es convertible al tipo de elemento T del QJniArray que se está construyendo. Sin embargo, no se produce ninguna conversión real.

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

Construye un QJniArray vacío de tamaño size. Los elementos del array no se inicializan.

Esta función se introdujo en Qt 6.9.

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

Construye un QJniArray pasando de object. El QJniObject se convierte en invalid.

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

Construye un QJniArray copiando other. Ambos objetos QJniArray harán referencia al mismo objeto array Java.

Restricciones

Participa en la resolución de sobrecargas sólo si el tipo de elemento Other de other es convertible al tipo de elemento T del QJniArray que se está construyendo. Sin embargo, no se produce ninguna conversión.

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

Construye un QJniArray que envuelve el mismo array Java que object, creando una nueva referencia global. Para construir un QJniArray a partir de una referencia local existente, utilice un QJniObject construido mediante fromLocalRef().

[explicit] QJniArray::QJniArray(jarray array)

Construye un QJniArray que envuelve el array del lado Java array, creando una nueva referencia global a array.

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

Construye un QJniArray que envuelve un array Java recién creado para elementos de tipo T, y rellena el array Java con los datos de list.

Véase también QJniArrayBase::fromContainer() y toContainer().

QJniArray::~QJniArray()

Destruye el objeto QJniArray y libera cualquier referencia a la matriz Java envuelta.

auto QJniArray::arrayObject() const

Devuelve el objeto Java envuelto como el tipo jarray adecuado que coincide con el tipo de elemento T de este objeto QJniArray.

Devuelve un iterador const de estilo STL que apunta al primer elemento de la matriz.

Si el array es invalid, devolverá el mismo iterador que la función end() correspondiente.

Véase también end() y rbegin().

Devuelve un iterador estilo STL que apunta justo después del último elemento de la lista.

Véase también begin() y rend().

Devuelve un iterador inverso de estilo STL que apunta al primer elemento de la matriz, en orden inverso.

Si la matriz es invalid, devolverá el mismo iterador que la función rend() correspondiente.

Véase también rend() y begin().

Devuelve un iterador inverso estilo STL que apunta justo después del último elemento de la lista, en orden inverso.

Véase también rbegin() y end().

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

Devuelve un contenedor rellenado con los datos de la matriz Java envuelta.

Si no se proporciona container, el tipo del contenedor devuelto dependerá del tipo de elemento de este QJniArray. En el caso de QJniArray<T>, suele ser QList<T>, con las siguientes excepciones:

Si pasas un contenedor con nombre (un lvalue) para container, entonces ese contenedor se llena, y se devuelve una referencia a él. Si pasa un contenedor temporal (un rvalue, incluido el argumento por defecto), entonces ese contenedor se llena, y se devuelve por valor.

Esta función devuelve inmediatamente si el array es invalid.

Véase también QJniArrayBase::fromContainer().

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

Mueve other a este QJniArray, y devuelve una referencia a este. La matriz other se convierte en invalid.

Restricciones

Participa en la resolución de sobrecarga sólo si el tipo de elemento Other de other es convertible al tipo de elemento T de este QJniArray. Sin embargo, no se produce ninguna conversión real.

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

Asigna other a este QJniArray, y devuelve una referencia a este. Ambos objetos QJniArray harán referencia al mismo objeto de matriz Java.

Restricciones

Participa en la resolución de sobrecarga sólo si el tipo de elemento Other de other es convertible al tipo de elemento T de este QJniArray. Sin embargo, no se produce ninguna conversión real.

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

Devuelve un objeto de referencia para el valor en la posición i en la matriz Java envuelta.

i debe ser una posición de índice válida en la lista (es decir, 0 <= i < size()).

El objeto de referencia devuelto contiene el valor en la posición i, y en la mayoría de los casos se convertirá implícitamente al valor. La asignación a la referencia devuelta sobrescribirá la entrada en la matriz de Java. Sin embargo, la llamada a funciones miembro mutantes sobre el objeto no modificará la entrada en el array. Para llamar a una función miembro sobre el resultado de este operador, desreferencie el objeto de referencia:

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

Sin embargo, si no se pretende modificar el valor de la propia matriz, haga que la matriz sea const, o utilice at() en su lugar.

Esta función se introdujo en Qt 6.9.

Véase también at() y size().

Devuelve el valor en la posición i en la matriz Java envuelta.

i debe ser una posición de índice válida en la lista (es decir, 0 <= i < size()).

Véase también size().