QWeakPointer Class

멤버 함수 문서

QWeakPointer::QWeakPointer()

아무것도 가리키지 않는 QWeakPointer를 생성합니다.

QWeakPointer::QWeakPointer(const QSharedPointer<T> &other)

other 가 가리키는 포인터에 대한 약한 참조를 보유하는 QWeakPointer를 생성합니다.

T 가 이 클래스의 템플릿 매개변수의 파생형인 경우, QWeakPointer는 자동 형변환을 수행합니다. 그렇지 않은 경우 컴파일 오류가 발생합니다.

[noexcept] QWeakPointer::QWeakPointer(const QWeakPointer<T> &other)

other 가 가리키는 포인터에 대한 약한 참조를 보유하는 QWeakPointer를 생성합니다.

T 가 이 클래스의 템플릿 매개변수의 파생형인 경우, QWeakPointer는 자동 형 변환을 수행합니다. 그렇지 않은 경우 컴파일러 오류가 발생합니다.

QWeakPointer::~QWeakPointer()

이 QWeakPointer 객체를 파기합니다. 이 객체가 참조하는 포인터는 삭제되지 않습니다.

void QWeakPointer::clear()

이 QWeakPointer 객체를 지우고, 해당 객체가 포인터에 대해 가지고 있을 수 있는 참조를 해제합니다.

bool QWeakPointer::isNull() const

이 객체가 ` nullptr`을 가리키는 경우 ` true `을 반환합니다.

약한 참조의 특성상, QWeakPointer 가 가리키는 포인터는 언제든지 nullptr 가 될 수 있으므로, 이 함수에서 반환되는 값은 호출할 때마다 false에서 true로 바뀔 수 있습니다.

QSharedPointer<T> QWeakPointer::lock() const

toStrongRef()와 동일합니다.

이 함수는 std::weak_ptr과의 API 호환성을 위해 제공됩니다.

이 스마트 포인터가 구현에 정의된 소유자 기반 정렬 순서에서 other 보다 앞서 있을 때만 true 를 반환합니다. 이 정렬 순서는 두 스마트 포인터가 모두 비어 있거나, 둘 다 동일한 객체를 소유하고 있는 경우(겉보기 유형과 포인터가 다르더라도) 서로 동등한 것으로 간주됩니다.

이 함수들은 Qt 6.7에서 도입되었습니다.

owner_equal도 참조하십시오 .

이 스마트 포인터와 ` other `가 소유권을 공유하는 경우에만 ` true `을 반환합니다.

이 함수들은 Qt 6.7에서 도입되었습니다.

owner_before 및 owner_hash도 참조하십시오 .

[noexcept, since 6.7] size_t QWeakPointer::owner_hash() const

이 스마트 포인터 객체에 대한 소유자 기반 해시 값을 반환합니다. ( owner_equal 에 따라) 동일하게 비교되는 스마트 포인터들은 동일한 소유자 기반 해시 값을 가집니다.

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

owner_equal도 참조하십시오 .

[noexcept] void QWeakPointer::swap(QWeakPointer<T> &other)

이 약한 포인터 인스턴스를 other 로 교체합니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

QSharedPointer<T> QWeakPointer::toStrongRef() const

이 약한 참조를 강한 참조로 승격시키고, 해당 참조를 포함하는 ` QSharedPointer ` 객체를 반환합니다. ` QSharedPointer`로 승격할 때, 이 함수는 해당 객체가 이미 삭제되었는지 여부를 확인합니다. 아직 삭제되지 않은 경우, 이 함수는 공유 객체에 대한 참조 횟수를 증가시켜 해당 객체가 삭제되지 않도록 보장합니다.

이 함수는 공유 객체에 대한 유효한 강한 참조를 얻지 못할 수도 있으므로, 반환된 객체에 대해 QSharedPointer::isNull()를 호출하여 변환이 성공했는지 항상 확인해야 합니다.

예를 들어, 다음 코드는 강 참조로 보유되었던 ` QWeakPointer `를 승격시키고, 성공한 경우 보유되었던 정수의 값을 출력합니다:

QWeakPointer<int> weakref;

// ...

QSharedPointer<int> strong = weakref.toStrongRef();
if (strong)
    qDebug() << "The value is:" << *strong;
else
    qDebug() << "The value has already been deleted";

QSharedPointer::QSharedPointer()도 참조하십시오 .

QWeakPointer::operator bool() const

포함된 포인터가 nullptr 가 아닌 경우 true 를 반환합니다. 이 함수는 다음과 같이 if-constructs 에서 사용하기에 적합합니다:

if (weakref) { /*...*/ }

약한 참조의 특성상, ` QWeakPointer `가 가리키는 포인터는 언제든지 ` nullptr `가 될 수 있으므로, 이 함수에서 반환되는 값은 호출할 때마다 `true`에서 `false`로 바뀔 수 있습니다.

isNull()도 참조하십시오 .

bool QWeakPointer::operator!() const

이 객체가 nullptr 를 가리키는 경우 true 를 반환합니다. 이 함수는 다음과 같이 if-constructs 에서 사용하기에 적합합니다:

if (!weakref) { /*...*/ }

약한 참조의 특성상, QWeakPointer 가 가리키는 포인터는 언제든지 nullptr 로 변경될 수 있으므로, 이 함수에서 반환되는 값은 호출할 때마다 false에서 true로 바뀔 수 있습니다.

isNull()도 참조하십시오 .

QWeakPointer<T> &QWeakPointer::operator=(const QSharedPointer<T> &other)

이 객체가 ` other`의 포인터를 공유하도록 합니다. 현재 포인터 참조는 폐기되지만 삭제되지는 않습니다.

T 가 이 클래스의 템플릿 매개변수의 파생형인 경우, ` QWeakPointer `는 자동 형 변환을 수행합니다. 그렇지 않은 경우 컴파일러 오류가 발생합니다.

[noexcept] QWeakPointer<T> &QWeakPointer::operator=(const QWeakPointer<T> &other)

이 객체가 ` other`의 포인터를 공유하도록 합니다. 현재 포인터 참조는 버려지지만 삭제되지는 않습니다.

T 가 이 클래스의 템플릿 매개변수의 파생형인 경우, ` QWeakPointer `은 자동 형 변환을 수행합니다. 그렇지 않은 경우 컴파일러 오류가 발생합니다.