Класс 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() для const.

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