QWeakPointer Class
template <typename T> class QWeakPointerLa clase QWeakPointer contiene una referencia débil a un puntero compartido. Más información...
| Cabecera: | #include <QWeakPointer> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| QWeakPointer() | |
| QWeakPointer(const QSharedPointer<T> &other) | |
| QWeakPointer(const QWeakPointer<T> &other) | |
| ~QWeakPointer() | |
| void | clear() |
| bool | isNull() const |
| QSharedPointer<T> | lock() const |
(since 6.7) bool | owner_before(const QSharedPointer<X> &other) const |
(since 6.7) bool | owner_before(const QWeakPointer<X> &other) const |
(since 6.7) bool | owner_equal(const QSharedPointer<X> &other) const |
(since 6.7) bool | owner_equal(const QWeakPointer<X> &other) const |
(since 6.7) size_t | owner_hash() const |
| void | swap(QWeakPointer<T> &other) |
| QSharedPointer<T> | toStrongRef() const |
| operator bool() const | |
| bool | operator!() const |
| QWeakPointer<T> & | operator=(const QSharedPointer<T> &other) |
| QWeakPointer<T> & | operator=(const QWeakPointer<T> &other) |
Elementos no miembros relacionados
| QWeakPointer<X> | qWeakPointerCast(const QWeakPointer<T> &src) |
| bool | operator!=(const QSharedPointer<T> &ptr1, const QWeakPointer<X> &ptr2) |
| bool | operator!=(const QWeakPointer<T> &ptr1, const QSharedPointer<X> &ptr2) |
| bool | operator!=(const QWeakPointer<T> &lhs, std::nullptr_t) |
| bool | operator!=(std::nullptr_t, const QWeakPointer<T> &rhs) |
| bool | operator==(const QSharedPointer<T> &ptr1, const QWeakPointer<X> &ptr2) |
| bool | operator==(const QWeakPointer<T> &ptr1, const QSharedPointer<X> &ptr2) |
| bool | operator==(const QWeakPointer<T> &lhs, std::nullptr_t) |
| bool | operator==(std::nullptr_t, const QWeakPointer<T> &rhs) |
Descripción detallada
QWeakPointer es una referencia débil automática a un puntero en C++, en la que el parámetro de plantilla ` T ` especifica el tipo del puntero al que se realiza el seguimiento. No se puede utilizar para desreferenciar el puntero directamente, pero sí para comprobar si el puntero ha sido eliminado o no en otro contexto.
Los objetos QWeakPointer solo pueden crearse mediante asignación a partir de un QSharedPointer.
Es importante señalar que QWeakPointer no proporciona operadores de conversión automática para evitar que se produzcan errores. Aunque QWeakPointer realiza un seguimiento de un puntero, no debe considerarse un puntero en sí mismo, ya que no garantiza que el objeto al que apunta siga siendo válido.
Por lo tanto, para acceder al puntero que QWeakPointer está rastreando, primero debes convertirlo a QSharedPointer y comprobar si el objeto resultante es nulo o no. QSharedPointer garantiza que el objeto no ha sido eliminado, por lo que, si obtienes un objeto no nulo, puedes utilizar el puntero. Consulta QWeakPointer::toStrongRef() para ver un ejemplo.
Véase también QSharedPointer y QScopedPointer.
Documentación de las 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 al que hace referencia other.
Si ` T ` es un tipo derivado del parámetro de plantilla de esta clase, `QWeakPointer` realizará una conversión automática. De lo contrario, se producirá un error de compilación.
[noexcept] QWeakPointer::QWeakPointer(const QWeakPointer<T> &other)
Crea un QWeakPointer que contiene una referencia débil al puntero al que hace referencia other.
Si ` T ` es un tipo derivado del parámetro de plantilla de esta clase, `QWeakPointer` realizará una conversión automática. De lo contrario, se producirá un error de compilación.
QWeakPointer::~QWeakPointer()
Destruye este objeto ` QWeakPointer `. El puntero al que hace referencia este objeto no se eliminará.
void QWeakPointer::clear()
Borra este objeto ` QWeakPointer `, eliminando la referencia que pudiera tener al puntero.
bool QWeakPointer::isNull() const
Devuelve ` true ` si este objeto hace referencia a ` nullptr`.
Ten 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 otra.
QSharedPointer<T> QWeakPointer::lock() const
Es lo mismo que ` toStrongRef()`.
Esta función se proporciona para garantizar la compatibilidad de la API con std::weak_ptr.
[noexcept, since 6.7] template <typename X> bool QWeakPointer::owner_before(const QSharedPointer<X> &other) const
[noexcept, since 6.7] template <typename X> bool QWeakPointer::owner_before(const QWeakPointer<X> &other) const
Devuelve ` true ` si y solo si este puntero inteligente precede a ` other ` en un orden basado en la propiedad 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 son propietarios del mismo objeto (incluso si su tipo aparente y su puntero son diferentes).
Estas funciones se introdujeron en Qt 6.7.
Véase también owner_equal.
[noexcept, since 6.7] template <typename X> bool QWeakPointer::owner_equal(const QSharedPointer<X> &other) const
[noexcept, since 6.7] template <typename X> bool QWeakPointer::owner_equal(const QWeakPointer<X> &other) const
Devuelve ` true ` si y solo si este puntero inteligente y ` other ` comparten la 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 de puntero inteligente. Los punteros inteligentes que se consideren iguales (según owner_equal) tendrán un valor hash basado en el propietario idéntico.
Estas funciones se introdujeron en Qt 6.7.
Véase también owner_equal.
[noexcept] void QWeakPointer::swap(QWeakPointer<T> &other)
Cambia esta instancia de puntero débil por other. Esta operación es muy rápida y nunca falla.
QSharedPointer<T> QWeakPointer::toStrongRef() const
Convierte esta referencia débil en una fuerte y devuelve un objeto de tipo « QSharedPointer » que contiene dicha referencia. Al convertirla en « QSharedPointer », esta función comprueba si el objeto ya ha sido eliminado o no. Si no es así, esta función incrementa el recuento de referencias al objeto compartido, garantizando así que no sea eliminado.
Dado que esta función puede no conseguir obtener una referencia fuerte válida al objeto compartido, siempre debes comprobar si la conversión se ha realizado correctamente, llamando a ` QSharedPointer::isNull()` sobre el objeto devuelto.
Por ejemplo, el siguiente código convierte una referencia de tipo « QWeakPointer » que se mantenía en una referencia fuerte y, si tiene éxito, muestra el valor del entero que se mantenía:
QWeakPointer<int> weakref;
// ...
QSharedPointer<int> strong = weakref.toStrongRef();
if (strong)
qDebug() << "The value is:" << *strong;
sino
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 por ejemplo:
if (weakref) { /*...*/ }Ten 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 otra.
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 por ejemplo:
if (!weakref) { /*...*/ }Ten 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 otra.
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á una conversión automática. De lo contrario, se producirá un error de compilación.
[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á una conversión automática. De lo contrario, se producirá un error de compilación.
Elementos no miembros relacionados
template <typename X, typename T> QWeakPointer<X> qWeakPointerCast(const QWeakPointer<T> &src)
Devuelve un puntero débil al puntero que contiene ` src`, convertido al tipo ` X`. Los tipos ` T ` y ` X ` deben pertenecer a una misma jerarquía para que la llamada a ` static_cast ` se realice con éxito.
Ten en cuenta que X debe tener los mismos calificadores cv (const y volatile) que T; de lo contrario, el código no se compilará. Utiliza qSharedPointerConstCast para eliminar la constante.
template <typename T, typename X> bool operator!=(const QSharedPointer<T> &ptr1, const QWeakPointer<X> &ptr2)
Devuelve ` true ` si ` ptr1 ` y ` ptr2 ` hacen referencia a punteros distintos.
Si el parámetro de plantilla de ` ptr2` es diferente al de ` ptr1`, ` QSharedPointer ` intentará realizar una « static_cast » automática para garantizar que los punteros que se comparan sean iguales. Si el parámetro de plantilla de ` ptr2` no es un tipo base ni un tipo derivado del de ` ptr1`, se producirá un error de compilación.
template <typename T, typename X> bool operator!=(const QWeakPointer<T> &ptr1, const QSharedPointer<X> &ptr2)
Devuelve ` true ` si ` ptr1 ` y ` ptr2 ` hacen referencia a punteros distintos.
Si el parámetro de plantilla de ` ptr2` es diferente al de ` ptr1`, ` QSharedPointer ` intentará realizar una conversión automática ` static_cast ` para garantizar que los punteros que se comparan sean iguales. Si el parámetro de plantilla de ` ptr2` no es un tipo base o un tipo derivado del de ` ptr1`, se producirá un error de compilación.
template <typename T> bool operator!=(const QWeakPointer<T> &lhs, std::nullptr_t)
Devuelve ` true ` si ` lhs ` hace referencia a un puntero válido (es decir, no nulo).
Véase también QWeakPointer::isNull().
template <typename T> bool operator!=(std::nullptr_t, const QWeakPointer<T> &rhs)
Devuelve ` true ` si ` rhs ` apunta a un puntero válido (es decir, no nulo).
Véase también QWeakPointer::isNull().
template <typename T, typename X> bool operator==(const QSharedPointer<T> &ptr1, const QWeakPointer<X> &ptr2)
Devuelve ` true ` si ` ptr1 ` y ` ptr2 ` apuntan al mismo puntero.
Si el parámetro de plantilla de ` ptr2` es diferente al de ` ptr1`, ` QSharedPointer ` intentará realizar un « static_cast » automático para garantizar que los punteros que se comparan sean iguales. Si el parámetro de plantilla de ` ptr2` no es un tipo base ni un tipo derivado de ` ptr1`, se producirá un error de compilación.
template <typename T, typename X> bool operator==(const QWeakPointer<T> &ptr1, const QSharedPointer<X> &ptr2)
Devuelve ` true ` si ` ptr1 ` y ` ptr2 ` hacen referencia al mismo puntero.
Si el parámetro de plantilla de ` ptr2` es diferente al de ` ptr1`, ` QSharedPointer ` intentará realizar una conversión automática ` static_cast ` para garantizar que los punteros que se comparan sean iguales. Si el parámetro de plantilla de ` ptr2` no es un tipo base ni un tipo derivado del de ` ptr1`, se producirá un error de compilación.
template <typename T> bool operator==(const QWeakPointer<T> &lhs, std::nullptr_t)
Devuelve « true » si « lhs » hace referencia a « nullptr ».
Véase también QWeakPointer::isNull().
template <typename T> bool operator==(std::nullptr_t, const QWeakPointer<T> &rhs)
Devuelve « true » si « rhs » hace referencia a « nullptr ».
Véase también QWeakPointer::isNull().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.