En esta página

QDBusReply Class

template <typename T> class QDBusReply

La clase QDBusReply almacena la respuesta a una llamada de método a un objeto remoto. Más información...

Encabezado: #include <QDBusReply>
CMake: find_package(Qt6 REQUIRED COMPONENTS DBus)
target_link_libraries(mytarget PRIVATE Qt6::DBus)
qmake: QT += dbus

Funciones públicas

QDBusReply(const QDBusError &error = QDBusError())
QDBusReply(const QDBusMessage &reply)
QDBusReply(const QDBusPendingCall &pcall)
QDBusReply(const QDBusPendingReply<T> &reply)
const QDBusError &error() const
bool isValid() const
QDBusReply<T>::Type value() const
operator QDBusReply<T>::Type() const
QDBusReply<T> &operator=(const QDBusError &dbusError)
QDBusReply<T> &operator=(const QDBusMessage &reply)
QDBusReply<T> &operator=(const QDBusPendingCall &pcall)

Descripción detallada

QDBusReply<T> es una clase de plantilla en la que T especifica el tipo de retorno esperado. Un objeto QDBusReply es un subconjunto del objeto QDBusMessage que representa la respuesta a una llamada a un método. Contiene únicamente el primer argumento de salida o el código de error, y es utilizado por las clases derivadas de QDBusInterface para permitir devolver el código de error como argumento de retorno de la función.

Se puede utilizar de la siguiente manera:

QDBusReply<QString> reply = interface->call("RemoteMethod");
if (reply.isValid())
    // use the returned value
    useValue(reply.value());
else
    // call failed. Show an error condition.
    showError(reply.error());

Si la llamada al método remoto no puede fallar, puedes omitir la comprobación de errores:

reply = interface->call("RemoteMethod");

Sin embargo, si falla en esas condiciones, el valor devuelto por QDBusReply<T>::value() es un valor construido por defecto. Puede ser indistinguible de un valor de retorno válido.

Los objetos `QDBusReply` se utilizan para llamadas remotas que no tienen argumentos de salida ni valores de retorno (es decir, que tienen un tipo de retorno «void»). Utilice la función ` isValid()` para comprobar si la respuesta se ha realizado con éxito.

Véase también QDBusMessage y QDBusInterface.

Documentación de las funciones de miembro

QDBusReply::QDBusReply(const QDBusError &error = QDBusError())

Crea una respuesta de error a partir del código de error de D-Bus proporcionado por error.

QDBusReply::QDBusReply(const QDBusMessage &reply)

Crea automáticamente un objeto `QDBusReply` a partir del mensaje de respuesta ` reply`, extrayendo de él el primer valor de retorno si se trata de una respuesta de éxito.

QDBusReply::QDBusReply(const QDBusPendingCall &pcall)

Crea automáticamente un objeto `QDBusReply` a partir de la llamada asíncrona pendiente ` pcall`. Si la llamada aún no ha finalizado, `QDBusReply` llamará a `QDBusPendingCall::waitForFinished()`, que es una operación bloqueante.

Si los tipos de retorno coinciden, QDBusReply extraerá el primer argumento de retorno de la respuesta.

QDBusReply::QDBusReply(const QDBusPendingReply<T> &reply)

Crea un objeto `QDBusReply` a partir del mensaje de respuesta pendiente, ` reply`.

const QDBusError &QDBusReply::error() const

Devuelve el código de error que se obtuvo de la llamada a la función remota. Si la llamada remota no devolvió ningún error (es decir, si se realizó correctamente), el objeto ` QDBusError ` que se devuelve no será un código de error válido (la función `QDBusError::isValid()` devolverá `false`).

Véase también ` isValid()`.

bool QDBusReply::isValid() const

Devuelve « true » si no se ha producido ningún error; en caso contrario, devuelve « false ».

Véase también error().

QDBusReply<T>::Type QDBusReply::value() const

Devuelve el valor de retorno de la llamada a la función remota. Si la llamada remota devolvió un error, el valor de retorno de esta función es indefinido y puede ser imposible de distinguir de un valor de retorno válido.

Esta función no está disponible si la llamada remota devuelve un valor de tip void.

QDBusReply::operator QDBusReply<T>::Type() const

Devuelve lo mismo que ` value()`.

Esta función no está disponible si la llamada remota devuelve void.

QDBusReply<T> &QDBusReply::operator=(const QDBusError &dbusError)

Establece este objeto para que contenga el código de error proporcionado por dbusError. Posteriormente, podrás acceder a él mediante error().

QDBusReply<T> &QDBusReply::operator=(const QDBusMessage &reply)

Hace que este objeto contenga el mensaje « reply ». Si « reply » es un mensaje de error, esta función copiará el código de error y el mensaje en este objeto

Si reply es un mensaje de respuesta estándar y contiene al menos un parámetro, se copiará en este objeto, siempre que sea del tipo correcto. Si no es del mismo tipo que este objeto QDBusError, esta función establecerá en su lugar un código de error que indique una discrepancia de tipos.

QDBusReply<T> &QDBusReply::operator=(const QDBusPendingCall &pcall)

Hace que este objeto contenga la respuesta especificada por la llamada asíncrona pendiente pcall. Si la llamada aún no ha finalizado, esta función llamará a QDBusPendingCall::waitForFinished() para bloquearse hasta que llegue la respuesta.

Si pcall finaliza con un mensaje de error, esta función copiará el código de error y el mensaje en este objeto

Si pcall finaliza con un mensaje de respuesta estándar y contiene al menos un parámetro, este se copiará en este objeto, siempre que sea del tipo correcto. Si no es del mismo tipo que este objeto QDBusError, esta función establecerá, en su lugar, un código de error que indique una discrepancia de tipos.

© 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.