Obsolete Members for QWeakPointer

The following members of class QWeakPointer are deprecated. They are provided to keep old source code working. We strongly advise against using them in new code.

Public Functions

(deprecated) QWeakPointer(const QObject *other)
(deprecated) T *data() const
(deprecated) QWeakPointer<T> &operator=(const QObject *other)

Member Function Documentation

QWeakPointer::QWeakPointer(const QObject *other)

This function is deprecated. We strongly advise against using it in new code.

Creates a QWeakPointer that holds a weak reference directly to the QObject other. This constructor is only available if the template type T is QObject or derives from it (otherwise a compilation error will result).

You can use this constructor with any QObject, even if they were not created with QSharedPointer.

Note that QWeakPointers created this way on arbitrary QObjects usually cannot be promoted to QSharedPointer.

See also QSharedPointer and QPointer.

T *QWeakPointer::data() const

This function is deprecated. We strongly advise against using it in new code.

Use toStrongRef() instead, and data() on the returned QSharedPointer.

Returns the value of the pointer being tracked by this QWeakPointer, without ensuring that it cannot get deleted. To have that guarantee, use toStrongRef(), which returns a QSharedPointer object. If this function can determine that the pointer has already been deleted, it returns nullptr.

It is ok to obtain the value of the pointer and using that value itself, like for example in debugging statements:

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

However, dereferencing the pointer is only allowed if you can guarantee by external means that the pointer does not get deleted. For example, if you can be certain that no other thread can delete it, nor the functions that you may call.

If that is the case, then the following code is valid:

    // 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);
    }

Use this function with care.

See also isNull() and toStrongRef().

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

This function is deprecated. We strongly advise against using it in new code.

Makes this QWeakPointer hold a weak reference directly to the QObject other. This function is only available if the template type T is QObject or derives from it.

See also QPointer.

© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.