QWeakPointer Class

Documentación de funciones miembro

QWeakPointer::QWeakPointer()

Crea un QWeakPointer que no apunta a nada.

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

Crea un QWeakPointer que contiene una referencia débil al puntero referenciado por other.

Si T es un tipo derivado del parámetro de plantilla de esta clase, QWeakPointer realizará un cast automático. En caso contrario, obtendrá un error del compilador.

[noexcept] QWeakPointer::QWeakPointer(const QWeakPointer<T> &other)

Crea un QWeakPointer que contiene una referencia débil al puntero referenciado por other.

Si T es un tipo derivado del parámetro de plantilla de esta clase, QWeakPointer realizará un cast automático. En caso contrario, obtendrá un error del compilador.

QWeakPointer::~QWeakPointer()

Destruye este objeto QWeakPointer. El puntero referenciado por este objeto no será eliminado.

void QWeakPointer::clear()

Borra este objeto QWeakPointer, eliminando la referencia que haya podido tener al puntero.

bool QWeakPointer::isNull() const

Devuelve true si este objeto hace referencia a nullptr.

Tenga en cuenta que, debido a la naturaleza de las referencias débiles, el puntero al que hace referencia QWeakPointer puede convertirse en nullptr en cualquier momento, por lo que el valor devuelto por esta función puede cambiar de falso a verdadero de una llamada a la siguiente.

QSharedPointer<T> QWeakPointer::lock() const

Igual que toStrongRef().

Esta función se proporciona por compatibilidad API con std::weak_ptr.

Devuelve true si y sólo si este puntero inteligente precede a other en un orden basado en el propietario definido por la implementación. El orden es tal que dos punteros inteligentes se consideran equivalentes si ambos están vacíos o si ambos poseen el mismo objeto (incluso si su tipo aparente y puntero son diferentes).

Estas funciones se introdujeron en Qt 6.7.

Véase también owner_equal.

Devuelve true si y sólo si este puntero inteligente y other comparten propiedad.

Estas funciones se introdujeron en Qt 6.7.

Véase también owner_before y owner_hash.

[noexcept, since 6.7] size_t QWeakPointer::owner_hash() const

Devuelve un valor hash basado en el propietario para este objeto puntero inteligente. Los punteros inteligentes que se comparan igual (según owner_equal) tendrán un hash basado en propietario idéntico.

Esta función se introdujo en Qt 6.7.

Véase también owner_equal.

[noexcept] void QWeakPointer::swap(QWeakPointer<T> &other)

Intercambia esta instancia de puntero débil con other. Esta operación es muy rápida y nunca falla.

QSharedPointer<T> QWeakPointer::toStrongRef() const

Promueve esta referencia débil a una fuerte y devuelve un objeto QSharedPointer que contiene esa referencia. Al promover a QSharedPointer, esta función verifica si el objeto ya ha sido borrado o no. Si no lo ha sido, esta función incrementa la cuenta de referencias al objeto compartido, asegurando así que no será borrado.

Dado que esta función puede fallar a la hora de obtener una referencia fuerte válida al objeto compartido, siempre se debe verificar si la conversión ha tenido éxito, llamando a QSharedPointer::isNull() sobre el objeto devuelto.

Por ejemplo, el siguiente código promueve un QWeakPointer que fue retenido a una referencia fuerte y, si tuvo éxito, imprime el valor del entero que fue retenido:

QWeakPointer<int> weakref;// ...QSharedPointer<int> strong = weakref.toStrongRef();if (strong)    qDebug() << "The value is:" << *strong;
si no    qDebug() << "The value has already been deleted";

Véase también QSharedPointer::QSharedPointer().

QWeakPointer::operator bool() const

Devuelve true si el puntero contenido no es nullptr. Esta función es adecuada para su uso en if-constructs, como:

if (weakref) { /*...*/ }

Tenga en cuenta que, debido a la naturaleza de las referencias débiles, el puntero al que hace referencia QWeakPointer puede convertirse en nullptr en cualquier momento, por lo que el valor devuelto por esta función puede cambiar de verdadero a falso de una llamada a la siguiente.

Véase también isNull().

bool QWeakPointer::operator!() const

Devuelve true si este objeto hace referencia a nullptr. Esta función es adecuada para su uso en if-constructs, como:

if (!weakref) { /*...*/ }

Tenga en cuenta que, debido a la naturaleza de las referencias débiles, el puntero al que hace referencia QWeakPointer puede convertirse en nullptr en cualquier momento, por lo que el valor devuelto por esta función puede cambiar de false a true de una llamada a la siguiente.

Véase también isNull().

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

Hace que este objeto comparta el puntero de other. La referencia al puntero actual se descarta pero no se elimina.

Si T es un tipo derivado del parámetro de plantilla de esta clase, QWeakPointer realizará un cast automático. En caso contrario, obtendrá un error del compilador.

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

Hace que este objeto comparta el puntero de other. La referencia al puntero actual se descarta pero no se elimina.

Si T es un tipo derivado del parámetro de plantilla de esta clase, QWeakPointer realizará un cast automático. En caso contrario, obtendrá un error del compilador.