QJniArray Class

QList<int> intList;
QJniArray intArray = QJniArray(intList);

QJniArray intArray{1, 2, 3};

auto charArray = stringObject.callMethod<jchar[]>("toCharArray");

QList<jchar> characters = charArray.toContainer();

Dokumentation der Mitgliedsfunktionen

Gibt einen 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.

Diese Funktion nimmt nur dann an der Überladungsauflösung teil, wenn Container ein Container ist, der Elemente eines JNI type oder ä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.

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

[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.

Dieser Konstruktor 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] 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.

Dieser Operator nimmt nur dann an der Überlastauflö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.

Dieser Operator 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.