QProtobufMessage Class
Clase base para todos los mensajes de Protobuf. Más información...
| Cabecera: | #include <QProtobufMessage> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Protobuf) target_link_libraries(mytarget PRIVATE Qt6::Protobuf) |
| Desde: | Qt 6.5 |
| Heredado por: |
Funciones públicas
(since 6.8) bool | deserialize(QAbstractProtobufSerializer *serializer, QByteArrayView data) |
| QVariant | property(QAnyStringView propertyName) const |
(since 6.8) const QtProtobufPrivate::QProtobufPropertyOrdering * | propertyOrdering() const |
(since 6.8) QByteArray | serialize(QAbstractProtobufSerializer *serializer) const |
| bool | setProperty(QAnyStringView propertyName, const QVariant &value) |
(since 6.6) bool | setProperty(QAnyStringView propertyName, QVariant &&value) |
(since 6.7) QList<QByteArray> | unknownFieldData(qint32 field) const |
(since 6.7) QList<qint32> | unknownFieldNumbers() const |
Miembros públicos estáticos
| QProtobufMessagePointer | constructByName(const QString &messageType) |
Funciones protegidas
| QProtobufMessage(QProtobufMessage &&other) |
Elementos no miembros relacionados
| QProtobufMessagePointer | |
(since 6.11) To | qprotobufmessage_cast(QProtobufMessage *from) |
(since 6.11) To | qprotobufmessage_cast(const QProtobufMessage *from) |
Descripción detallada
Proporciona acceso a las propiedades de un mensaje, utilizando setProperty() y property(), sin depender del tipo de mensaje.
Documentación de las funciones de miembro
[constexpr noexcept protected default] QProtobufMessage::QProtobufMessage(QProtobufMessage &&other)
Crea una instancia de ` QProtobufMessage` mediante la construcción «move».
[static] QProtobufMessagePointer QProtobufMessage::constructByName(const QString &messageType)
Crea un objeto ` QProtobufMessage ` utilizando ` messageType`. Devuelve un puntero al objeto creado ` QProtobufMessage`.
Esta función intenta crear un mensaje con un tipo que coincida con messageType. Si messageType es desconocido, la función devuelve nullptr. Si el mensaje no se encuentra en el registro, la función devuelve nullptr. Se otorga al autor de la llamada la propiedad del mensaje creado.
[since 6.8] bool QProtobufMessage::deserialize(QAbstractProtobufSerializer *serializer, QByteArrayView data)
Deserializa este mensaje Protobuf a partir de un ` QByteArray ` data utilizando serializer. Devuelve ` true ` si la deserialización se ha realizado correctamente; en caso contrario, devuelve ` false`.
Esta función se introdujo en Qt 6.8.
Véase también serialize().
QVariant QProtobufMessage::property(QAnyStringView propertyName) const
Obtén el valor de la propiedad « propertyName ».
Si no se conoce el valor de ` propertyName `, el valor devuelto ` QVariant ` no es válido.
Véase también setProperty().
[since 6.8] const QtProtobufPrivate::QProtobufPropertyOrdering *QProtobufMessage::propertyOrdering() const
Devuelve el puntero al orden de las propiedades del mensaje Protobuf derivado.
Esta función se introdujo en Qt 6.8.
[since 6.8] QByteArray QProtobufMessage::serialize(QAbstractProtobufSerializer *serializer) const
Serializa este mensaje protobuf en un objeto ` QByteArray ` utilizando ` serializer`.
Esta función se introdujo en Qt 6.8.
Véase también deserialize().
bool QProtobufMessage::setProperty(QAnyStringView propertyName, const QVariant &value)
Establece la propiedad « propertyName » con el valor almacenado en « value ».
Si « propertyName » no es un campo conocido, se ignora el valor y la función devuelve « false ».
Devuelve ` false ` si no se consigue almacenar ` value ` en la propiedad. En caso contrario, devuelve ` true`.
Véase también ` property()`.
[since 6.6] bool QProtobufMessage::setProperty(QAnyStringView propertyName, QVariant &&value)
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.6.
[since 6.7] QList<QByteArray> QProtobufMessage::unknownFieldData(qint32 field) const
Devuelve los valores desconocidos de « field » ordenados tal y como se recibieron por la red.
Esta función se introdujo en Qt 6.7.
[since 6.7] QList<qint32> QProtobufMessage::unknownFieldNumbers() const
Devuelve los números de campo que QtProtobuf no conocía durante la deserialización.
Esta función se introdujo en Qt 6.7.
Elementos no miembros relacionados
[alias] QProtobufMessagePointer
Sinónimo de std::unique_ptr<QProtobufMessage, QProtobufMessageDeleter>. Utilízalo para gestionar el ciclo de vida de los objetos QProtobufMessage asignados dinámicamente, como los creados al llamar a QProtobufMessage::constructByName.
[since 6.11] template <typename To> To qprotobufmessage_cast(QProtobufMessage *from)
[since 6.11] template <typename To> To qprotobufmessage_cast(const QProtobufMessage *from)
Devuelve el objeto ` from ` dado, convertido al tipo de puntero ` To ` si el objeto es de tipo ` To ` (o una subclase); en caso contrario, devuelve ` nullptr`. Si ` from ` es ` nullptr`, esta función también devuelve ` nullptr`.
El argumento de plantilla ` To ` debe ser un puntero a una clase que herede de ` QProtobufMessage ` y esté declarada con la macro ` Q_PROTOBUF_OBJECT `.
Ejemplo:
QProtobufMessage *message = new myproject::MySpecificMessage();
// Cast to its own type (success)
auto *specific = qprotobufmessage_cast<myproject::MySpecificMessage *>(message);
// specific is a valid pointer
// Cast to an unrelated type (failure)
auto *another = qprotobufmessage_cast<myproject::AnotherMessage *>(message);
// another is nullptrEsta función se comporta de forma similar a la función estándar de C++ ` dynamic_cast()`, con la ventaja de que no requiere compatibilidad con RTTI y funciona más allá de los límites de las bibliotecas dinámicas.
Advertencia: Si el tipo al que apunta ` To ` no está declarado con la macro ` Q_PROTOBUF_OBJECT `, el valor de retorno de esta función es indefinido.
Estas funciones se introdujeron en Qt 6.11.
© 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.