QJniArray Class

Dokumentation der Mitgliedsfunktionen

[default] QJniArray::QJniArray()

Standardkonstruktor von QJniArray. Dabei wird kein Array auf der Java-Seite erstellt, und die Instanz ist ungültig.

Siehe auch isValid.

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

Erstellt ein `QJniArray`, das ein neu erstelltes Java-Array für Elemente vom Typ ` Container::value_type` umschließt, und füllt das Java-Array mit den Daten aus ` container`.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn ` Container ` ein Container ist, der Elemente vom Typ ` JNI type ` oder einem äquivalenten C++-Typ speichert und einen Vorwärtsiterator bereitstellt.

Die Spezialisierung des erstellten `QJniArray` hängt vom Werttyp des ` container` ab. Bei einem ` Container<T> ` (wie z. B. ` QList<T>`) ist dies in der Regel ` QJniArray<T>`, mit folgenden Ausnahmen:

Siehe auch QJniArrayBase::fromContainer() und toContainer().

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

Erstellt ein `QJniArray`, indem Daten aus ` other` verschoben werden. Das Array ` other ` wird zu ` invalid`.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn der Elementtyp „ Other “ von „ other “ in den Elementtyp „ T “ des zu erstellenden QJniArray konvertierbar ist. Es findet jedoch keine tatsächliche Konvertierung statt.

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

Erstellt standardmäßig eine Instanz von ` QJniArray`. Diese Funktion wurde gelöscht.

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

Erstellt ein leeres QJniArray der Größe size. Die Elemente im Array werden nicht initialisiert.

Diese Funktion wurde in Qt 6.9 eingeführt.

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

Erstellt ein `QJniArray`, indem es von ` object` kopiert wird. Aus ` QJniObject ` wird ` invalid`.

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

Erstellt ein `QJniArray` durch Kopieren von ` other`. Beide `QJniArray`-Objekte verweisen auf dasselbe Java-Array-Objekt.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn der Elementtyp „ Other “ von „ other “ in den Elementtyp „ T “ des zu erstellenden QJniArray konvertierbar ist. Es findet jedoch keine tatsächliche Konvertierung statt.

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

Erstellt standardmäßig eine Instanz von ` QJniArray`. Diese Funktion wurde gelöscht.

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

Erstellt ein `QJniArray`, das dasselbe Java-Array wie ` object` umschließt, und erzeugt dabei eine neue globale Referenz. Um ein `QJniArray` aus einer bestehenden lokalen Referenz zu erstellen, verwenden Sie ein ` QJniObject `, das über ` fromLocalRef()` erstellt wurde.

[explicit] QJniArray::QJniArray(jarray array)

Erstellt ein QJniArray, das das Java-seitige Array „ array “ umschließt, und erstellt dabei eine neue globale Referenz auf „ array “.

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

Erstellt ein `QJniArray`, das ein neu erstelltes Java-Array für Elemente vom Typ ` T` umschließt, und füllt das Java-Array mit den Daten aus ` list`.

Siehe auch ` QJniArrayBase::fromContainer()` und ` toContainer()`.

[default] QJniArray::~QJniArray()

Löscht das „ QJniArray “-Objekt und gibt alle Verweise auf das umschlossene Java-Array frei.

auto QJniArray::arrayObject() const

Gibt das verpackte Java-Objekt als den passenden Typ „ jarray “ zurück, der dem Elementtyp „ T “ dieses „ QJniArray “-Objekts entspricht.

Gibt den Wert an der Position i im umschlossenen Java-Array zurück.

i muss eine gültige Indexposition in der Liste sein (d. h. 0 <= i < size()).

Siehe auch ` size()`.

Gibt einen const-Iterator im STL-Stil zurück, der auf das erste Element des Arrays zeigt.

Ist das Array vom Typ „ invalid “, gibt diese Funktion denselben Iterator zurück wie die entsprechende Funktion „ end()“.

Siehe auch ` end()` und ` rbegin()`.

Gibt einen Iterator im STL-Stil zurück, der direkt auf das Element nach dem letzten Element der Liste zeigt.

Siehe auch ` begin()` und ` rend()`.

Gibt einen Reverse-Iterator im STL-Stil zurück, der auf das erste Element des Arrays in umgekehrter Reihenfolge verweist.

Ist das Array vom Typ „ invalid “, wird derselbe Iterator zurückgegeben wie bei der entsprechenden Funktion „ rend()“.

Siehe auch ` rend()` und ` begin()`.

Gibt einen Reverse-Iterator im STL-Stil zurück, der in umgekehrter Reihenfolge direkt auf das Element nach dem letzten Element der Liste zeigt.

Siehe auch ` rbegin()` und ` end()`.

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

Gibt einen Container zurück, der mit den Daten des umschlossenen Java-Arrays gefüllt ist.

Wird kein ` container ` angegeben, hängt der Typ des zurückgegebenen Containers vom Elementtyp dieses ` QJniArray` ab. Bei ` QJniArray<T> ` ist dies in der Regel ` QList<T>`, mit folgenden Ausnahmen:

Wenn Sie einen benannten Container (ein L-Wert) an ` container` übergeben, wird dieser Container gefüllt und eine Referenz darauf zurückgegeben. Wenn Sie einen temporären Container (ein R-Wert, einschließlich des Standardarguments) übergeben, wird dieser Container gefüllt und als Wert zurückgegeben.

Diese Funktion kehrt sofort zurück, wenn das Array ` invalid` ist.

Siehe auch ` QJniArrayBase::fromContainer()`.

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

Verschiebt „ other “ in „ QJniArray “ und gibt einen Verweis darauf zurück. Das Array „ other “ wird zu „ invalid “.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn der Elementtyp Other von other in den Elementtyp T von diesem QJniArray konvertierbar ist. Es findet jedoch keine tatsächliche Konvertierung statt.

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

Weist „ other “ diesem „ QJniArray “ zu und gibt eine Referenz darauf zurück. Beide „ QJniArray “-Objekte verweisen auf dasselbe Java-Array-Objekt.

Einschränkungen

Nimmt nur dann an der Überladungsauflösung teil, wenn der Elementtyp ` Other ` von ` other ` in den Elementtyp ` T ` von diesem ` QJniArray` konvertierbar ist. Es findet jedoch keine tatsächliche Konvertierung statt.

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

Gibt ein Referenzobjekt für den Wert an der Position i im umschlossenen Java-Array zurück.

i muss eine gültige Indexposition in der Liste sein (d. h., 0 <= i < size()).

Das zurückgegebene Referenzobjekt enthält den Wert an der Position ` i` und wird in den meisten Fällen implizit in diesen Wert umgewandelt. Eine Zuweisung an die zurückgegebene Referenz überschreibt den Eintrag im Java-Array. Der Aufruf von mutierenden Member-Funktionen auf dem Objekt verändert jedoch nicht den Eintrag im Array. Um eine Member-Funktion auf das Ergebnis dieses Operators anzuwenden, müssen Sie das Referenzobjekt dereferenzieren:

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

Wenn jedoch keine Änderung des Werts im Array selbst beabsichtigt ist, sollten Sie das Array als `const` deklarieren oder stattdessen ` at()` verwenden.

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch ` at()` und ` size()`.