El sistema de tipos de Qt D-Bus
D-Bus cuenta con un sistema de tipos extensible basado en unos pocos tipos primitivos y en la composición de dichos tipos primitivos en matrices y estructuras. Qt D-Bus implementa la interfaz para ese sistema de tipos a través de la clase ` QDBusArgument `, lo que permite a los programas de usuario enviar y recibir prácticamente cualquier tipo de C++ a través del bus.
Tipos primitivos
QDBusArgument admite de forma nativa los tipos primitivos, que no requieren ninguna personalización especial para su envío o recepción. A continuación se enumeran, junto con la clase de C++ a la que corresponden:
| Tipo Qt | Tipo equivalente en D-Bus |
|---|---|
| uchar | BYTE |
| bool | BOOLEANO |
| short | INT16 |
| ushort | UINT16 |
| int | INT32 |
| uint | UINT32 |
| qlonglong | INT64 |
| qulonglong | UINT64 |
| double | DOUBLE |
| QString | STRING |
| QDBusVariant | VARIANT |
| QDBusObjectPath | OBJECT_PATH |
| QDBusSignature | FIRMA |
Además de los tipos primitivos, QDBusArgument también admite de forma nativa dos tipos no primitivos, debido a su uso generalizado en las aplicaciones Qt: QStringList y QByteArray.
Tipos compuestos
D-Bus especifica tres tipos de agregaciones de tipos primitivos que permiten crear tipos compuestos. Son ARRAY, STRUCT y los mapas o diccionarios.
Las matrices son conjuntos de cero o más elementos del mismo tipo, mientras que las estructuras son conjuntos de un número fijo de elementos, cada uno de cualquier tipo. Los mapas o diccionarios se implementan como matrices de pares de elementos, por lo que puede haber cero o más elementos en un mapa.
Ampliación del sistema de tipos
Para poder utilizar un tipo propio con Qt D-Bus, dicho tipo debe declararse como un metatipo de Qt mediante la macro Q_DECLARE_METATYPE() y registrarse con la función qDBusRegisterMetaType(). El sistema de registro detectará automáticamente los operadores de streaming operator>> y operator<<.
Qt D-Bus Proporciona especializaciones de plantillas para matrices y mapas destinadas a su uso con las clases contenedoras de Qt, como QMap y QList, por lo que no es necesario escribir las funciones de los operadores de streaming para ellas. Para las estructuras, Qt proporciona especializaciones genéricas que se asignan a y desde std::tuple. Para utilizar un tipo personalizado en su lugar o para otros tipos, los operadores deben implementarse explícitamente.
Consulta la documentación de QDBusArgument para ver ejemplos de estructuras, matrices y mapas.
El sistema de tipos en uso
Todos los tipos de Qt D-Bus (tanto primitivos como definidos por el usuario) pueden utilizarse para enviar y recibir mensajes de cualquier tipo a través del bus.
© 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.