QJniArray Class

Documentation des fonctions membres

QJniArray::QJniArray()

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

Voir aussi isValid.

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

Construit un QJniArray qui enveloppe un tableau Java nouvellement créé pour les éléments de type Container::value_type, et remplit le tableau Java avec les données de container.

Contraintes

Participe à la résolution des surcharges uniquement si Container est un conteneur qui stocke des éléments d'un type JNI type ou d'un type C++ équivalent, et fournit un itérateur direct.

La spécialisation du QJniArray construit dépend du type de valeur de container. Pour un Container<T> (comme 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, QJniArrayBase::if_convertible<Other, T> = true> QJniArray::QJniArray(QJniArray<Other> &&other)

Construit un QJniArray en se déplaçant à partir de other. Le tableau other devient invalid.

Contraintes

Participe à la résolution de surcharge uniquement si le type d'élément Other de other est convertible en type d'élément T du QJniArray en cours de construction. Cependant, aucune conversion n'a lieu.

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

Construit un tableau QJni 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 en se déplaçant à partir de object. Le QJniObject devient invalid.

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

Construit un QJniArray en copiant other. Les deux objets QJniArray référenceront le même objet tableau Java.

Contraintes

Participe à la résolution des surcharges uniquement si le type d'élément Other de other est convertible en type d'élément T du QJniArray en cours de construction. Cependant, aucune conversion n'a lieu.

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

Construit un QJniArray qui enveloppe 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 QJniArray qui enveloppe le tableau côté Java array, en créant une nouvelle référence globale à array.

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

Construit un QJniArray qui enveloppe un tableau Java nouvellement créé pour les éléments de type T, et remplit le tableau Java avec les données de list.

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

QJniArray::~QJniArray()

Détruit l'objet QJniArray et libère toutes les références au tableau Java enveloppé.

auto QJniArray::arrayObject() const

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

Renvoie un itérateur constant de style STL pointant sur le premier élément du tableau.

Si le tableau est invalid, cette fonction renverra le même itérateur que la fonction end() correspondante.

Voir aussi end() et rbegin().

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

Voir aussi begin() et rend().

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

Si le tableau est invalid, cette fonction renverra le même itérateur que la fonction rend() correspondante.

Voir aussi rend() et begin().

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

Voir aussi rbegin() et end().

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

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

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

Si vous fournissez un conteneur nommé (une valeur l) pour container, ce conteneur est rempli et une référence à ce conteneur est renvoyée. Si vous passez un conteneur temporaire (une valeur r, y compris l'argument par défaut), ce conteneur est rempli et renvoyé par sa valeur.

Cette fonction revient immédiatement si le tableau est invalid.

Voir également QJniArrayBase::fromContainer().

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

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

Contraintes

Participe à la résolution de surcharge uniquement si le type d'élément Other de other est convertible en type d'élément T de ce QJniArray. Cependant, aucune conversion n'a lieu.

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

Affecte other à QJniArray et renvoie une référence à cet objet. Les deux objets QJniArray référenceront le même tableau Java.

Contraintes

Participe à la résolution de surcharge uniquement si le type d'élément Other de other est convertible en type d'élément T de ce QJniArray. Cependant, aucune conversion n'a lieu.

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

Renvoie un objet de référence pour la valeur à la position i dans le tableau Java enveloppé.

i doit être une position d'index valide dans la liste (c'est-à-dire 0 <= i < size()).

L'objet de référence renvoyé contient la valeur à la position i et, dans la plupart des cas, se convertit implicitement en cette valeur. L'affectation à la référence renvoyée remplacera l'entrée dans le tableau Java. Cependant, l'appel à des fonctions membres mutantes sur l'objet ne modifiera pas l'entrée dans le tableau. Pour appeler une fonction membre sur le résultat de cet opérateur, déréférencer l'objet de référence :

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

Cependant, si la modification de la valeur dans le tableau lui-même n'est pas prévue, rendez le tableau constant ou utilisez at() à la place.

Cette fonction a été introduite dans Qt 6.9.

Voir aussi at() et size().

Renvoie la valeur à la position i dans le tableau Java enveloppé.

i doit être une position d'index valide dans la liste (c'est-à-dire 0 <= i < size()).

Voir aussi size().