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

Это допустимо получить значение указателя и использовать его само по себе, например, в отладочных утверждениях:

    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().

bool 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 выполнит автоматическое преобразование. В противном случае вы получите ошибку компилятора.