Класс QEnableSharedFromThis

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

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

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

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

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

Вы можете унаследовать этот класс, когда вам нужно создать 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.