Класс QWeakPointer

Класс QWeakPointer хранит слабую ссылку на общий указатель Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Примечание: Все функции в этом классе являются внутрипотоковыми.

Открытые функции

Связанные нечлены

Подробное описание

Класс QWeakPointer хранит слабую ссылку на общий указатель

Класс QWeakPointer — это автоматическая слабая ссылка на указатель в C++. Она не может быть использована для непосредственного разыменования указателя, но может быть использована для проверки, был ли указатель удалён или нет в другом контексте.

Объекты QWeakPointer могут быть созданы только путём присваивания из QSharedPointer.

Важно отметить, что QWeakPointer не предоставляет автоматических операторов преобразования, чтобы предотвратить ошибки. Хотя QWeakPointer отслеживает указатель, его не следует рассматривать как указатель сам по себе, поскольку он не гарантирует, что указанный объект останется действительным.

Поэтому для доступа к указателю, который отслеживает QWeakPointer, необходимо сначала повысить его до QSharedPointer и проверить, является ли полученный объект пустым или нет. QSharedPointer гарантирует, что объект не будет удалён, поэтому если вы получите ненулевой объект, вы можете использовать указатель. См. QWeakPointer::toStrongRef() для примера.

Класс QWeakPointer также предоставляет метод QWeakPointer::data(), который возвращает отслеживаемый указатель без гарантии, что он останется действительным. Эта функция предоставляется, если вы можете гарантировать внешними средствами, что объект не будет удалён (или если вам нужен только сам указатель), и стоимость создания QSharedPointer с помощью toStrongRef() слишком высока.

См. также QSharedPointer и QScopedPointer.

Документация по функциям-членам

QWeakPointer::QWeakPointer()

Создаёт QWeakPointer, который не указывает ни на что.

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

Создаёт QWeakPointer, который хранит слабую ссылку на указатель, на который ссылается other.

Если T является производным типом шаблона-параметра этого класса, QWeakPointer выполнит автоматическое преобразование. В противном случае вы получите ошибку компилятора.

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

Создаёт QWeakPointer, который хранит слабую ссылку на указатель, на который ссылается other.

Если T является производным типом шаблона-параметра этого класса, QWeakPointer выполнит автоматическое преобразование. В противном случае вы получите ошибку компилятора.

QWeakPointer::~QWeakPointer()

Удаляет этот объект QWeakPointer. Указатель, на который ссылается этот объект, не будет удалён.

void QWeakPointer::clear()

Очищает этот объект QWeakPointer, удаляя ссылку, которую он мог иметь на указатель.

T *QWeakPointer::data() const

Возвращает значение указателя, отслеживаемого этим QWeakPointer, не гарантируя, что он не может быть удалён. Для получения этой гарантии используйте toStrongRef(), которая возвращает объект QSharedPointer. Если эта функция определит, что указатель уже был удалён, она возвращает 0.

В порядке получения значения указателя и использования его значения, например, в отладочных утверждениях:

qDebug("Tracking %p", weakref.data());

Однако разыменование указателя разрешено только в том случае, если вы можете гарантировать внешними средствами, что указатель не будет удалён. Например, если вы можете быть уверены, что ни один другой поток не может его удалить, а также функции, которые вы можете вызвать.

Если это так, следующий код является корректным:

// this pointer cannot be used in another thread
// so other threads cannot delete it
QWeakPointer<int> weakref = obtainReference();

Object *obj = weakref.data();
if (obj) {
    // if the pointer wasn't deleted yet, we know it can't get
    // deleted by our own code here nor the functions we call
    otherFunction(obj);
}

Используйте эту функцию с осторожностью.

Эта функция была добавлена в Qt 4.6.

См. также isNull() и toStrongRef().

bool QWeakPointer::isNull() const

Возвращает true если этот объект хранит ссылку на нулевой указатель.

Обратите внимание, что из-за природы слабых ссылок указатель, на который ссылается QWeakPointer, может стать нулевым в любой момент, поэтому возвращаемое значение этой функции может изменяться с false на true от одного вызова к другому.

QSharedPointer<T> QWeakPointer::lock() const

То же самое, что и toStrongRef().

Эта функция предоставляется для совместимости API со std::weak_ptr.

Эта функция была добавлена в Qt 5.4.

void QWeakPointer::swap(QWeakPointer<T> &other)

Меняет местами этот слабый указатель с other. Эта функция очень быстрая и никогда не терпит неудач.

Эта функция была добавлена в Qt 5.4.

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

Возвращает true , если этот объект не равен null. Эта функция подходит для использования в if-constructs, например:

if (weakref) { ... }

Обратите внимание, что из-за природы слабых ссылок, на который ссылается QWeakPointer, указатель может стать null в любой момент, поэтому значение, возвращаемое этой функцией, может измениться с true на false от одного вызова к другому.

См. такжеisNull().

bool QWeakPointer::operator!() const

Возвращает true , если этот объект равен null. Эта функция подходит для использования в if-constructs, например:

if (!weakref) { ... }

Обратите внимание, что из-за природы слабых ссылок, на который ссылается QWeakPointer, указатель может стать null в любой момент, поэтому значение, возвращаемое этой функцией, может измениться с false на true от одного вызова к другому.

См. такжеisNull().

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

Заставляет этот объект разделять указатель other. Текущая ссылка на указатель отбрасывается, но не удаляется.

Если T является производным типом шаблона параметров этого класса, QWeakPointer выполнит автоматическое преобразование. В противном случае у вас возникнет ошибка компилятора.

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

Заставляет этот объект разделять указатель other. Текущая ссылка на указатель отбрасывается, но не удаляется.

Если T является производным типом шаблона параметров этого класса, QWeakPointer выполнит автоматическое преобразование. В противном случае у вас возникнет ошибка компилятора.