QJniArray Class

멤버 함수 문서

[default] QJniArray::QJniArray()

QJniArray의 기본 생성자입니다. 이 생성자는 Java 측의 배열을 생성하지 않으며, 생성된 인스턴스는 유효하지 않습니다.

isValid도 참조하십시오 .

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

Container::value_type 유형의 요소를 위해 새로 생성된 Java 배열을 감싸는 QJniArray를 생성하고, container 의 데이터로 Java 배열을 채웁니다.

제약 조건

Container 가 JNI type 또는 이에 상응하는 C++ 유형의 요소를 저장하고 포워드 이터레이터를 제공하는 컨테이너인 경우에만 오버로드 해결에 참여합니다.

생성된 QJniArray의 특수화는 container 의 값 유형에 따라 달라집니다. Container<T> (예: QList<T>)의 경우 일반적으로 QJniArray<T> 가 되지만, 다음 예외가 있습니다:

QJniArrayBase::fromContainer() 및 toContainer()도 참조하십시오 .

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

other 에서 데이터를 옮겨와 QJniArray를 생성합니다. other 배열은 invalid 로 변환됩니다.

제약 조건

other 의 요소 유형 Other 이 생성 중인 QJniArray의 요소 유형 T 으로 변환 가능한 경우에만 오버로드 해결에 참여합니다. 그러나 실제 변환은 수행되지 않습니다.

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

QJniArray 의 인스턴스를 기본 생성합니다. 이 함수는 삭제되었습니다.

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

size 크기의 빈 QJniArray를 생성합니다. 배열의 요소들은 초기화되지 않습니다.

이 함수는 Qt 6.9에서 도입되었습니다.

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

object 에서 데이터를 가져와 QJniArray를 생성합니다. QJniObject 는 invalid 로 변환됩니다.

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

other 를 복사하여 QJniArray를 생성합니다. 두 QJniArray 객체 모두 동일한 Java 배열 객체를 참조하게 됩니다.

제약 조건

other 의 요소 유형 Other 이 생성 중인 QJniArray의 요소 유형 T 으로 변환 가능한 경우에만 오버로드 해결에 참여합니다. 그러나 실제 변환은 수행되지 않습니다.

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

QJniArray 의 인스턴스를 기본 생성합니다. 이 함수는 삭제되었습니다.

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

object 와 동일한 Java 배열을 래핑하는 QJniArray를 생성하며, 새로운 전역 참조를 만듭니다. 기존 로컬 참조로부터 QJniArray를 생성하려면 fromLocalRef()를 통해 생성된 QJniObject 를 사용하십시오.

[explicit] QJniArray::QJniArray(jarray array)

Java 측 배열 array 을 감싸는 QJniArray를 생성하며, array 에 대한 새로운 전역 참조를 만듭니다.

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

T 유형의 요소를 위해 새로 생성된 Java 배열을 감싸는 QJniArray를 생성하고, list 의 데이터로 Java 배열을 채웁니다.

QJniArrayBase::fromContainer() 및 toContainer()도 참조하십시오 .

[default] QJniArray::~QJniArray()

QJniArray 객체를 삭제하고, 래핑된 Java 배열에 대한 모든 참조를 해제합니다.

auto QJniArray::arrayObject() const

이 QJniArray 객체의 요소 유형 T 과 일치하는 적절한 jarray 유형으로 래핑된 Java 객체를 반환합니다.

감싸진 Java 배열의 i 위치에 있는 값을 반환합니다.

i i 는 목록에서 유효한 인덱스 위치여야 합니다(즉, 0 <= < ()). size

size()도 참조하십시오 .

배열의 첫 번째 항목을 가리키는 STL 스타일의 const 이터레이터를 반환합니다.

배열이 ` invalid`인 경우, 이 함수는 해당 ` end()` 함수와 동일한 이터레이터를 반환합니다.

end() 및 rbegin()도 참조하십시오 .

목록의 마지막 항목 바로 다음을 가리키는 STL 스타일의 이터레이터를 반환합니다.

begin() 및 rend()도 참조하십시오 .

배열의 첫 번째 항목을 가리키는 STL 스타일의 역순 이터레이터를 반환합니다.

배열이 ` invalid`인 경우, 이 함수는 해당 ` rend()` 함수와 동일한 이터레이터를 반환합니다.

rend() 및 begin()도 참조하십시오 .

목록의 마지막 항목 바로 뒤를 가리키는, 역순으로 정렬된 STL 스타일의 역이테레이터를 반환합니다.

rbegin() 및 end()도 참조하십시오 .

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

포장된 Java 배열의 데이터로 채워진 컨테이너를 반환합니다.

container 가 제공되지 않으면, 반환되는 컨테이너의 유형은 이 QJniArray 의 요소 유형에 따라 달라집니다. QJniArray<T> 의 경우 일반적으로 QList<T> 가 되지만, 다음의 예외가 있습니다:

container 에 명명된 컨테이너(lvalue)를 전달하면, 해당 컨테이너가 채워지고 이에 대한 참조가 반환됩니다. 임시 컨테이너(rvalue, 기본 인자 포함)를 전달하면, 해당 컨테이너가 채워지고 값으로 반환됩니다.

이 함수는 배열이 ` invalid`인 경우 즉시 반환됩니다.

QJniArrayBase::fromContainer()도 참조하십시오 .

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

other 을 QJniArray 로 이동시키고, 이에 대한 참조를 반환합니다. other 배열은 invalid 가 됩니다.

제약 조건

other 의 요소 유형 Other 이 이 QJniArray 의 요소 유형 T 으로 변환 가능한 경우에만 오버로드 해결에 참여합니다. 그러나 실제 변환은 수행되지 않습니다.

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

other 를 이 QJniArray 에 할당하고, 이에 대한 참조를 반환합니다. 두 QJniArray 객체 모두 동일한 Java 배열 객체를 참조하게 됩니다.

제약 조건

other 의 요소 유형 Other 이 이 QJniArray 의 요소 유형 T 로 변환 가능한 경우에만 오버로드 해결에 참여합니다. 그러나 실제 변환은 수행되지 않습니다.

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

감싸진 Java 배열의 i 위치에 있는 값에 대한 참조 객체를 반환합니다.

i i 는 목록 내에서 유효한 인덱스 위치여야 합니다(즉, 0 <= < ()). size

반환된 참조 객체는 위치 i 에 있는 값을 보유하며, 대부분의 경우 해당 값으로 암시적으로 변환됩니다. 반환된 참조에 값을 할당하면 Java 배열의 해당 항목이 덮어쓰게 됩니다. 그러나 객체에 대해 변형을 일으키는 멤버 함수를 호출하더라도 배열의 항목은 수정되지 않습니다. 이 연산자의 결과에 대해 멤버 함수를 호출하려면 참조 객체의 참조를 해제하십시오:

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

그러나 배열 자체의 값을 수정할 의도가 없다면, 배열을 const로 선언하거나 대신 at()를 사용하십시오.

이 함수는 Qt 6.9에서 도입되었습니다.

at() 및 size()도 참조하십시오 .