Класс 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, может стать нулевым в любой момент, поэтому возвращаемое значение этой функции может измениться с true на false от одного вызова к следующему.

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

bool QWeakPointer::operator!() const

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

if (!weakref) { ... }

Обратите внимание, что из-за природы слабых ссылок, указатель, на который ссылается QWeakPointer, может стать нулевым в любой момент, поэтому возвращаемое значение этой функции может измениться с 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 выполнит автоматическое приведение типов. В противном случае вы получите ошибку компилятора.