QJniArray Class

Dokumentation der Mitgliedsfunktionen

Gibt einen konstanten Iterator im STL-Stil zurück, der auf das erste Element im Array zeigt.

Wenn das Array invalid ist, gibt dies 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 letzte Element der Liste zeigt.

Siehe auch begin() und rend().

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

Wenn das Array invalid ist, gibt dies denselben Iterator zurück wie die entsprechende Funktion rend().

Siehe auch rend() und begin().

Gibt einen umgekehrten Iterator im STL-Stil zurück, der in umgekehrter Reihenfolge direkt auf das letzte Element der Liste zeigt.

Siehe auch rbegin() und end().

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

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

Siehe auch size().

QJniArray::QJniArray()

Standard-Konstruktor von QJniArray. Dies erzeugt kein Java-seitiges Array, und die Instanz ist ungültig.

Siehe auch isValid.

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

Konstruiert ein QJniArray, das ein neu erstelltes Java-Array für Elemente des Typs Container::value_type umhüllt, und füllt das Java-Array mit den Daten von container.

Einschränkungen

Nimmt nur an der Überladungsauflösung teil, wenn Container ein Container ist, der Elemente eines JNI type oder eines äquivalenten C++-Typs speichert und einen Vorwärts-Iterator bereitstellt.

Die Spezialisierung des konstruierten QJniArray hängt vom Wertetyp des container ab. Für ein Container<T> (wie z.B. QList<T>) wird es typischerweise QJniArray<T> sein, mit den folgenden Ausnahmen:

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

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

Konstruiert ein QJniArray durch Verschieben von other. Das Array other wird zu invalid.

Einschränkungen

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

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

Konstruiert 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)

Konstruiert ein QJniArray, indem er von object ausgeht. QJniObject wird zu invalid.

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

Konstruiert ein QJniArray durch Kopieren von other. Beide QJniArray-Objekte verweisen auf das gleiche Java-Array-Objekt.

Einschränkungen

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

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

Konstruiert ein QJniArray, das dasselbe Java-Array wie object umhüllt und eine neue globale Referenz erzeugt. Um ein QJniArray aus einer bestehenden lokalen Referenz zu konstruieren, verwenden Sie ein QJniObject, das über fromLocalRef() konstruiert wird.

[explicit] QJniArray::QJniArray(jarray array)

Konstruiert ein QJniArray, das das Java-seitige Array array umhüllt und eine neue globale Referenz auf array erzeugt.

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

Konstruiert ein QJniArray, das ein neu erstelltes Java-Array für Elemente vom Typ T umhüllt, und füllt das Java-Array mit den Daten von list.

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

QJniArray::~QJniArray()

Zerstört das Objekt QJniArray und gibt alle Verweise auf das gewickelte Java-Array frei.

auto QJniArray::arrayObject() const

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

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

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

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

Wenn Sie einen benannten Container (einen l-Wert) für container übergeben, wird dieser Container gefüllt und ein Verweis auf ihn zurückgegeben. Wenn Sie einen temporären Container (einen 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, QJniArrayBase::if_convertible<Other, T> = true> QJniArray<T> &QJniArray::operator=(QJniArray<Other> &&other)

Verschiebt other in dieses QJniArray und gibt einen Verweis auf dieses 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, QJniArrayBase::if_convertible<Other, T> = true> QJniArray<T> &QJniArray::operator=(const QJniArray<Other> &other)

Weist other diesem QJniArray zu und gibt einen Verweis auf dieses zurück. Beide QJniArray Objekte verweisen auf das gleiche 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)

Liefert ein Referenzobjekt für den Wert an der Position i in dem umschlossenen Java-Array.

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 den Wert konvertiert. Die Zuweisung an die zurückgegebene Referenz überschreibt den Eintrag im Java-Array. Allerdings wird der Eintrag im Array durch den Aufruf von Mutating Member Functions auf das Objekt nicht verändert. Um eine Mitgliedsfunktion mit dem Ergebnis dieses Operators aufzurufen, dereferenzieren Sie das Referenzobjekt:

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

Wenn jedoch der Wert im Array selbst nicht geändert werden soll, machen Sie das Array konstant oder verwenden Sie stattdessen at().

Diese Funktion wurde in Qt 6.9 eingeführt.

Siehe auch at() und size().