En esta página

QCoapOption Class

La clase QCoapOption contiene datos sobre las opciones de CoAP. Más información...

Encabezado: #include <QCoapOption>
CMake: find_package(Qt6 REQUIRED COMPONENTS Coap)
target_link_libraries(mytarget PRIVATE Qt6::Coap)
qmake: QT += coap

Nota: Todas las funciones de esta clase son reentrantes.

Tipos públicos

enum OptionName { Invalid, IfMatch, UriHost, Etag, IfNoneMatch, …, Size1 }

Funciones públicas

QCoapOption(QCoapOption::OptionName name = Invalid, const QByteArray &opaqueValue = QByteArray())
QCoapOption(QCoapOption::OptionName name, const QString &stringValue)
QCoapOption(QCoapOption::OptionName name, quint32 intValue)
QCoapOption(const QCoapOption &other)
QCoapOption(QCoapOption &&other)
~QCoapOption()
bool isValid() const
int length() const
QCoapOption::OptionName name() const
QByteArray opaqueValue() const
QString stringValue() const
void swap(QCoapOption &other)
quint32 uintValue() const
bool operator!=(const QCoapOption &other) const
QCoapOption &operator=(QCoapOption &&other)
QCoapOption &operator=(const QCoapOption &other)
bool operator==(const QCoapOption &other) const

Descripción detallada

CoAP define una serie de opciones que pueden incluirse en un mensaje. Tanto las solicitudes como las respuestas pueden incluir una lista de una o más opciones. Por ejemplo, el URI de una solicitud se transmite en varias opciones, y los metadatos que en HTTP se incluirían en un encabezado HTTP también se proporcionan como opciones.

Una opción contiene un nombre, relacionado con un identificador de opción, y un valor. El nombre es uno de los valores de la enumeración « OptionName ».

Documentación sobre los tipos de miembros

enum QCoapOption::OptionName

Indica el nombre de una opción. El valor de cada ID es el especificado en el estándar CoAP, con la excepción de «Invalid». Para obtener más detalles, puede consultar los documentos RFC 7252 y RFC 7959.

ConstanteValorDescripción
QCoapOption::Invalid0Una opción no válida.
QCoapOption::IfMatch1Opción «If-Match».
QCoapOption::UriHost3Opción «Uri-Host».
QCoapOption::Etag4Opción «Etag».
QCoapOption::IfNoneMatch5Opción «If-None-Match».
QCoapOption::Observe6Opción «Observe».
QCoapOption::UriPort7Opción «Uri-Port».
QCoapOption::LocationPath8Opción «Location-path».
QCoapOption::UriPath11Opción Uri-Path.
QCoapOption::ContentFormat12Opción «Content-Format».
QCoapOption::MaxAge14Opción «Max-Age».
QCoapOption::UriQuery15Opción «Uri-Query».
QCoapOption::Accept17Opción «Accept».
QCoapOption::LocationQuery20Opción «Location-Query».
QCoapOption::Block223Opción «Block2».
QCoapOption::Block127Opción Block1.
QCoapOption::Size228Opción «Size2».
QCoapOption::ProxyUri35Opción «Proxy-Uri».
QCoapOption::ProxyScheme39Opción «Proxy-Scheme».
QCoapOption::Size160Opción Size1.

Documentación de las funciones miembro

QCoapOption::QCoapOption(QCoapOption::OptionName name = Invalid, const QByteArray &opaqueValue = QByteArray())

Crea una nueva opción CoAP con los valores indicados para « name », « QByteArray » y « opaqueValue ». Si no se pasan parámetros, crea un objeto «Invalid».

Véase también isValid().

QCoapOption::QCoapOption(QCoapOption::OptionName name, const QString &stringValue)

Crea una nueva opción CoAP con el « name » y el « QString » stringValue indicados.

Véase también isValid().

QCoapOption::QCoapOption(QCoapOption::OptionName name, quint32 intValue)

Crea una nueva opción CoAP con el « name » indicado y el entero sin signo « intValue ».

Véase también isValid().

QCoapOption::QCoapOption(const QCoapOption &other)

Crea una nueva opción CoAP como copia de other, de modo que ambas opciones sean idénticas.

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

QCoapOption::QCoapOption(QCoapOption &&other)

Crea un objeto `QCoapOption` mediante la construcción por movimiento, de modo que apunte al mismo objeto al que apuntaba ` other `.

[noexcept] QCoapOption::~QCoapOption()

Elimina el objeto « QCoapOption ».

bool QCoapOption::isValid() const

Devuelve « true » si la opción es válida.

int QCoapOption::length() const

Devuelve la longitud del valor de la opción.

QCoapOption::OptionName QCoapOption::name() const

Devuelve el nombre de la opción.

QByteArray QCoapOption::opaqueValue() const

Devuelve el valor de la opción.

QString QCoapOption::stringValue() const

Devuelve el valor « QString » de la opción.

[noexcept] void QCoapOption::swap(QCoapOption &other)

Intercambia esta opción con « other ». Esta operación es muy rápida y nunca falla.

quint32 QCoapOption::uintValue() const

Devuelve el valor entero de la opción.

Nota: Una opción de tipo uint tiene una longitud máxima de 4 bytes. Si el valor de la opción es más largo, solo se utilizan sus 4 bytes menos significativos para calcular el resultado; utiliza length() para detectar un valor demasiado largo.

bool QCoapOption::operator!=(const QCoapOption &other) const

Devuelve « true » si « QCoapOption » y « other » son diferentes.

[noexcept] QCoapOption &QCoapOption::operator=(QCoapOption &&other)

Asigna « other » a esta opción y devuelve una referencia a « QCoapOption ».

QCoapOption &QCoapOption::operator=(const QCoapOption &other)

Copia other en esta opción, de modo que ambas opciones quedan idénticas. Devuelve una referencia a este QCoapOption.

bool QCoapOption::operator==(const QCoapOption &other) const

Devuelve « true » si « QCoapOption » y « other » son iguales.

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