Sur cette page

QCoapOption Class

La classe QCoapOption contient des données relatives aux options CoAP. En savoir plus...

En-tête : #include <QCoapOption>
CMake : find_package(Qt6 REQUIRED COMPONENTS Coap)
target_link_libraries(mytarget PRIVATE Qt6::Coap)
qmake : QT += coap

Remarque : toutes les fonctions de cette classe sont réentrantes.

Types publics

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

Fonctions publiques

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

Description détaillée

Le protocole CoAP définit un certain nombre d'options pouvant être incluses dans un message. Les requêtes et les réponses peuvent toutes deux comporter une liste d'une ou plusieurs options. Par exemple, l'URI d'une requête est transporté dans plusieurs options, et les métadonnées qui seraient transmises dans un en-tête HTTP dans le protocole HTTP sont également fournies sous forme d'options.

Une option contient un nom, associé à un identifiant d’option, et une valeur. Le nom correspond à l’une des valeurs de l’énumération « OptionName ».

Documentation sur les types de membres

enum QCoapOption::OptionName

Indique le nom d'une option. La valeur de chaque identifiant est celle spécifiée par la norme CoAP, à l'exception de « Invalid ». Pour plus de détails, vous pouvez vous reporter aux RFC 7252 et RFC 7959.

ConstanteValeurDescription
QCoapOption::Invalid0Une option non valide.
QCoapOption::IfMatch1Option « If-Match ».
QCoapOption::UriHost3Option Uri-Host.
QCoapOption::Etag4Option Etag.
QCoapOption::IfNoneMatch5Option If-None-Match.
QCoapOption::Observe6Option Observe.
QCoapOption::UriPort7Option Uri-Port.
QCoapOption::LocationPath8Option « Location-path ».
QCoapOption::UriPath11Option Uri-Path.
QCoapOption::ContentFormat12Option « Content-Format ».
QCoapOption::MaxAge14Option Max-Age.
QCoapOption::UriQuery15Option Uri-Query.
QCoapOption::Accept17Option « Accept ».
QCoapOption::LocationQuery20Option Location-Query.
QCoapOption::Block223Option « Block2 ».
QCoapOption::Block127Option Block1.
QCoapOption::Size228Option Size2.
QCoapOption::ProxyUri35Option « Proxy-Uri ».
QCoapOption::ProxyScheme39Option « Proxy-Scheme ».
QCoapOption::Size160Option Size1.

Documentation des fonctions membres

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

Crée une nouvelle option CoAP avec les valeurs spécifiées pour name et QByteArray opaqueValue . Si aucun paramètre n'est fourni, crée un objet Invalid.

Voir également isValid().

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

Crée une nouvelle option CoAP avec l'name fournie et l'QString stringValue .

Voir également isValid().

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

Crée une nouvelle option CoAP avec l'name spécifiée et l'entier non signé intValue.

Voir également isValid().

QCoapOption::QCoapOption(const QCoapOption &other)

Crée une nouvelle option CoAP en tant que copie de other, rendant ainsi les deux options identiques.

Voir également isValid().

QCoapOption::QCoapOption(QCoapOption &&other)

Déplace et construit un objet `QCoapOption`, de sorte qu'il pointe vers le même objet que celui vers lequel pointait ` other `.

[noexcept] QCoapOption::~QCoapOption()

Supprime l'objet « QCoapOption ».

bool QCoapOption::isValid() const

Renvoie « true » si l'option est valide.

int QCoapOption::length() const

Renvoie la longueur de la valeur de l'option.

QCoapOption::OptionName QCoapOption::name() const

Renvoie le nom de l'option.

QByteArray QCoapOption::opaqueValue() const

Renvoie la valeur de l'option.

QString QCoapOption::stringValue() const

Renvoie la valeur « QString » de l'option.

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

Permet d'inverser cette option avec « other ». Cette opération est très rapide et ne rencontre jamais d'échec.

quint32 QCoapOption::uintValue() const

Renvoie la valeur entière de l'option.

Remarque : une option de type uint peut contenir au maximum 4 octets. Si la valeur de l'option est plus longue, seuls ses 4 octets de poids faible sont utilisés pour calculer le résultat ; utilisez la fonction length() pour détecter une valeur trop longue.

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

Renvoie « true » si les adresses QCoapOption et other sont différentes.

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

Déplace ` other ` vers cette option et renvoie une référence à ` QCoapOption`.

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

Copie other dans cette option, rendant ainsi les deux options identiques. Renvoie une référence à QCoapOption.

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

Renvoie « true » si les adresses QCoapOption et other sont identiques.

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