QJniArray Class

Documentation des fonctions membres

[default] QJniArray::QJniArray()

Constructeur par défaut de QJniArray. Cela ne crée pas de tableau côté Java, et l'instance sera invalide.

Voir également isValid.

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

Crée un objet `QJniArray` qui encapsule un tableau Java nouvellement créé contenant des éléments de type ` Container::value_type`, et remplit ce tableau Java avec les données provenant de ` container`.

Contraintes

Ne participe à la résolution des surcharges que si ` Container ` est un conteneur stockant des éléments de type ` JNI type ` ou d’un type C++ équivalent, et fournissant un itérateur avant.

La spécialisation du QJniArray construit dépend du type de valeur de container. Pour un Container<T> (tel que, par exemple, QList<T>), il s’agira généralement de QJniArray<T>, avec les exceptions suivantes :

Voir également QJniArrayBase::fromContainer() et toContainer().

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

Crée un objet `QJniArray` à partir de ` other`. Le tableau ` other ` devient ` invalid`.

Contraintes

Ne participe à la résolution des surcharges que si le type d’élément Other de other est convertible vers le type d’élément T du QJniArray en cours de construction. Cependant, aucune conversion n’a lieu concrètement.

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

Construit par défaut une instance de ` QJniArray`. Cette fonction est supprimée.

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

Crée un QJniArray vide de taille size. Les éléments du tableau ne sont pas initialisés.

Cette fonction a été introduite dans Qt 6.9.

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

Construit un QJniArray à partir de object. L'QJniObject devient invalid.

template <typename Other> requires if_convertible<Other, T> QJniArray::QJniArray(const QJniArray<Other> &other)

Crée un objet `QJniArray` en copiant ` other`. Les deux objets `QJniArray` feront référence au même objet de tableau Java.

Contraintes

Ne participe à la résolution des surcharges que si le type d’élément Other de other est convertible vers le type d’élément T du QJniArray en cours de construction. Cependant, aucune conversion n’a lieu concrètement.

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

Construit par défaut une instance de ` QJniArray`. Cette fonction est supprimée.

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

Construit un QJniArray qui encapsule le même tableau Java que object, en créant une nouvelle référence globale. Pour construire un QJniArray à partir d'une référence locale existante, utilisez un QJniObject construit via fromLocalRef().

[explicit] QJniArray::QJniArray(jarray array)

Construit un objet `QJniArray` qui encapsule le tableau côté Java ` array`, en créant une nouvelle référence globale à ` array`.

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

Crée un objet `QJniArray` qui encapsule un tableau Java nouvellement créé contenant des éléments de type ` T`, et remplit ce tableau Java avec les données provenant de ` list`.

Voir également QJniArrayBase::fromContainer() et toContainer().

[default] QJniArray::~QJniArray()

Détruit l'objet ` QJniArray ` et libère toutes les références pointant vers le tableau Java encapsulé.

auto QJniArray::arrayObject() const

Renvoie l'objet Java encapsulé sous la forme du type « jarray » correspondant au type d'élément T de cet objet QJniArray.

Renvoie la valeur située à la position i dans le tableau Java encapsulé.

i i doit être un indice valide dans la liste (c'est-à-dire 0 <= < ()). size

Voir également ` size()`.

Renvoie un itérateur `const` de type STL pointant vers le premier élément du tableau.

Si le tableau est de type « invalid », cette fonction renvoie le même itérateur que la fonction correspondante « end() ».

Voir également ` end()` et ` rbegin()`.

Renvoie un itérateur de type STL pointant juste après le dernier élément de la liste.

Voir également begin() et rend().

Renvoie un itérateur inversé de type STL pointant vers le premier élément du tableau, dans l'ordre inverse.

Si le tableau est de type ` invalid`, cette méthode renvoie le même itérateur que la fonction correspondante ` rend()`.

Voir également ` rend()` et ` begin()`.

Renvoie un itérateur inversé de type STL pointant juste après le dernier élément de la liste, dans l'ordre inverse.

Voir également ` rbegin()` et ` end()`.

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

Renvoie un conteneur rempli avec les données du tableau Java encapsulé.

Si aucun container n’est fourni, le type du conteneur renvoyé dépend alors du type d’élément de cette QJniArray. Pour QJniArray<T>, il s’agira généralement de QList<T>, avec les exceptions suivantes :

Si vous passez un conteneur nommé (une l-valeur) à la fonction ` container`, ce conteneur est rempli et une référence à celui-ci est renvoyée. Si vous passez un conteneur temporaire (une r-valeur, y compris l’argument par défaut), ce conteneur est rempli et renvoyé par valeur.

Cette fonction retourne immédiatement si le tableau est de type ` invalid`.

Voir également ` QJniArrayBase::fromContainer()`.

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

Déplace ` other ` vers ` QJniArray` et renvoie une référence à ce dernier. Le tableau ` other ` devient ` invalid`.

Contraintes

Ne participe à la résolution des surcharges que si le type d’élément Other de other est convertible vers le type d’élément T de cet objet QJniArray. Toutefois, aucune conversion n’a lieu.

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

Attribue la valeur « other » à cet objet « QJniArray » et renvoie une référence à celui-ci. Les deux objets « QJniArray » feront référence au même objet tableau Java.

Contraintes

Ne participe à la résolution des surcharges que si le type d’élément Other de other est convertible vers le type d’élément T de cet objet QJniArray. Toutefois, aucune conversion n’a lieu en réalité.

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

Renvoie un objet de référence correspondant à la valeur située à l'indice i dans le tableau Java encapsulé.

i i doit être un indice valide dans la liste (c'est-à-dire 0 <= < ()). size

L’objet de référence renvoyé contient la valeur située à la position i et, dans la plupart des cas, sera implicitement converti en cette valeur. L’affectation à la référence renvoyée écrasera l’élément du tableau Java. Cependant, l’appel de fonctions membres mutantes sur l’objet ne modifiera pas l’élément du tableau. Pour appeler une fonction membre sur le résultat de cet opérateur, déréférencez l’objet de référence :

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

Toutefois, si vous ne souhaitez pas modifier la valeur dans le tableau lui-même, déclarez le tableau comme `const` ou utilisez plutôt ` at()` à la place.

Cette fonction a été introduite dans Qt 6.9.

Voir également ` at()` et ` size()`.