Класс QEnableSharedFromThis

Базовый класс, позволяющий получить QSharedPointer для объекта, уже управляемого общим указателем. Подробнее...

Этот класс был введён в Qt 5.4.

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

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

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

Вы можете унаследовать этот класс, когда вам нужно создать QSharedPointer от любого экземпляра класса; например, изнутри самого объекта. Ключевым моментом является то, что техника простого возврата QSharedPointer<T>(this) не может быть использована, потому что это приводит к созданию нескольких различных объектов QSharedPointer с отдельными счётчиками ссылок. По этой причине вы никогда не должны создавать более одного QSharedPointer из одного и того же сырого указателя.

QEnableSharedFromThis определяет две функции-члена, называемые sharedFromThis(), которые возвращают QSharedPointer<T> и QSharedPointer<const T>, в зависимости от константности, для this:

    class Y: public QEnableSharedFromThis<Y>
    {
    public:
        QSharedPointer<Y> f()
        {
            return sharedFromThis();
        }
    };

    int main()
    {
        QSharedPointer<Y> p(new Y());
        QSharedPointer<Y> y = p->f();
        Q_ASSERT(p == y); // p and q must share ownership
    }

Также возможно получить общий указатель из объекта вне самого класса. Это особенно полезно в коде, предоставляющем интерфейс для скриптов, где в настоящее время использование общих указателей невозможно. Например:

    class ScriptInterface : public QObject
    {
        Q_OBJECT

        // ...

    public slots:
        void slotCalledByScript(Y *managedBySharedPointer)
        {
            QSharedPointer<Y> yPtr = managedBySharedPointer->sharedFromThis();
            // Some other code unrelated to scripts that expects a QSharedPointer<Y> ...
        }
    };

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

QSharedPointer<T> QEnableSharedFromThis::sharedFromThis()

Если this (то есть, экземпляр подкласса, вызывающий этот метод) управляется QSharedPointer, возвращает экземпляр общего указателя, указывающий на this; в противном случае возвращает нулевой QSharedPointer.

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

QSharedPointer<const T> QEnableSharedFromThis::sharedFromThis() const

Это перегруженная функция.

Перегрузка sharedFromThis() с константой.

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