Класс QWeakPointer

Класс QWeakPointer хранит слабую ссылку на общий указатель. Подробнее...

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

Примечание: Все функции в этом классе являются реентерабельными.

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

Связанные нечлены

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

QWeakPointer — это автоматическая слабая ссылка на указатель в C++. Она не может использоваться для непосредственного разыменования указателя, но может использоваться для проверки того, был ли указатель удалён или нет в другом контексте.

Объекты QWeakPointer могут создаваться только присваиванием из QSharedPointer.

Важно отметить, что QWeakPointer не предоставляет автоматических операторов преобразования, чтобы предотвратить ошибки. Несмотря на то, что QWeakPointer отслеживает указатель, его не следует рассматривать как указатель сам по себе, так как он не гарантирует, что указанный объект останется допустимым.

Поэтому, чтобы получить доступ к указателю, который отслеживает QWeakPointer, необходимо сначала повысить его до QSharedPointer и проверить, является ли полученный объект нулевым или нет. QSharedPointer гарантирует, что объект не удаляется, поэтому если вы получите ненулевой объект, вы можете использовать указатель. См. QWeakPointer::toStrongRef() для примера.

См. также QSharedPointer и QScopedPointer.

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

QWeakPointer::QWeakPointer(const QSharedPointer<T> &other)

Создаёт QWeakPointer, который хранит слабую ссылку на указатель, на который ссылается other.

Если T является производным типом шаблона-параметра этого класса, QWeakPointer выполнит автоматическое преобразование. В противном случае вы получите ошибку компилятора.

QWeakPointer::QWeakPointer(const QWeakPointer<T> &other)

Создаёт QWeakPointer, который хранит слабую ссылку на указатель, на который ссылается other.

Если T является производным типом шаблона-параметра этого класса, QWeakPointer выполнит автоматическое преобразование. В противном случае вы получите ошибку компилятора.

QWeakPointer::QWeakPointer()

Создаёт QWeakPointer, который не ссылается ни на что.

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

Привязывает этот объект к указателю other. Текущая ссылка на указатель отбрасывается, но не удаляется.

Если T является производным типом шаблона-параметра этого класса, QWeakPointer выполнит автоматическое преобразование. В противном случае вы получите ошибку компилятора.

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

Привязывает этот объект к указателю other. Текущая ссылка на указатель отбрасывается, но не удаляется.

Если T является производным типом шаблона-параметра этого класса, QWeakPointer выполнит автоматическое преобразование. В противном случае вы получите ошибку компилятора.

QWeakPointer::~QWeakPointer()

Уничтожает объект QWeakPointer. Указатель, на который ссылается этот объект, не будет удалён.

void QWeakPointer::clear()

Очищает объект QWeakPointer, прекращая ссылку на указатель.

bool QWeakPointer::isNull() const

Возвращает true если этот объект ссылается на nullptr.

Обратите внимание, что из-за природы слабых ссылок, указатель, на который ссылается QWeakPointer, может стать nullptr в любой момент, поэтому возвращаемое значение этой функции может измениться с 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 если содержащийся указатель не nullptr. Эта функция подходит для использования в if-constructs, например:

    if (weakref) { ... }

Обратите внимание, что из-за природы слабых ссылок, на который ссылается QWeakPointer указатель, может стать nullptr в любой момент, поэтому возвращаемое значение этой функции может измениться с true на false при следующем вызове.

См. также isNull().

bool QWeakPointer::operator!() const

Возвращает true если этот объект ссылается на nullptr. Эта функция подходит для использования в if-constructs, например:

    if (!weakref) { ... }

Обратите внимание, что из-за природы слабых ссылок, на который ссылается QWeakPointer указатель, может стать nullptr в любой момент, поэтому возвращаемое значение этой функции может измениться с false на true при следующем вызове.

См. также isNull().