nl::Weave::TLV::TLVWriter

Encode une valeur à virgule flottante TLV.

Il s'agit d'une fonction de membre surchargée, fournie pour plus de commodité. Elle ne diffère de la fonction ci-dessus que par le ou les arguments qu'elle accepte.

Encode une valeur booléenne TLV.

Encode une valeur de chaîne d'octets TLV.

Encode une valeur nulle TLV.

Encode un élément de conteneur TLV à partir d'un ensemble précodé d'éléments membres.

La méthode PutPreEncodedContainer() encode un nouvel élément de conteneur TLV (une structure, un tableau ou un chemin) contenant un ensemble d'éléments membres issus d'un tampon pré-codé. Le tampon d'entrée doit contenir zéro, un ou plusieurs éléments TLV à encodage complet, avec des balises conformes aux règles associées au type de conteneur spécifié (par exemple, les membres de la structure doivent avoir des balises, contrairement aux membres du tableau).

La méthode encode l'intégralité de l'élément conteneur en un seul appel. Lorsque PutPreEncodedContainer() est renvoyé, l'objet "writer" peut être utilisé pour écrire des éléments TLV supplémentaires après l'élément conteneur.

Encode une valeur de chaîne TLV UTF8.

Encode une valeur de chaîne TLV UTF8.

Encodez la sortie de chaîne au format approprié dans l'élément TLV.

PutStringF est un analogue à un sprintf dans lequel la sortie est stockée dans un élément TLV et non dans un tampon de caractères. Lorsque la fonctionnalité printf étendue est disponible, la fonction peut générer la chaîne de résultat dans un espace de stockage sous-jacent discontinu. L'implémentation prend en charge les améliorations printf suivantes:

La plate-forme fournit un vcbprintf basé sur le rappel qui permet d'appeler un rappel personnalisé à la place du putchar.

La plate-forme fournit une variante de vsnprintf appelée vsnprintf_ex, qui se comporte exactement comme vsnprintf, à la différence qu'elle permet d'omettre les premiers caractères n de la sortie.

Notez que même si la fonction basée sur le rappel est la plus simple et qu'elle utilise le moins de code, la variété de fonctions vsprintf_ex consomme moins de pile.

Si aucune des options ci-dessus n'est disponible, mais que la plate-forme fournit malloc, la fonction alloue un tampon temporaire pour contenir la sortie. Lorsque la plate-forme ne fournit aucune amélioration à la famille printf ni malloc, la sortie est tronquée afin qu'elle s'adapte à l'état continu dans le stockage TLV actuel.

Commence à encoder un nouvel élément de conteneur TLV.

La méthode StartContainer() permet d'écrire des éléments de conteneur TLV (structure, tableaux ou chemins) dans un encodage. La méthode utilise le type et la balise (le cas échéant) du nouveau conteneur, ainsi qu'une référence à une valeur TLVType qui sera utilisée pour enregistrer le contexte actuel du rédacteur pendant qu'il est utilisé pour écrire le conteneur.

Une fois la méthode StartContainer() renvoyée, l'application doit utiliser l'objet TLVWriter actuel pour écrire les éléments du conteneur. Une fois l'opération terminée, l'application doit appeler la méthode EndContainer() pour terminer l'encodage du conteneur.

Encode une chaîne d'octets TLV en plusieurs fragments.

Il doit être utilisé avec ContinuePutBytes.

Encodez la sortie de chaîne au format approprié dans l'élément TLV.

PutStringF est un analogue à un sprintf dans lequel la sortie est stockée dans un élément TLV et non dans un tampon de caractères. Lorsque la fonctionnalité printf étendue est disponible, la fonction peut générer la chaîne de résultat dans un espace de stockage sous-jacent discontinu. L'implémentation prend en charge les améliorations printf suivantes:

La plate-forme fournit un vcbprintf basé sur le rappel qui permet d'appeler un rappel personnalisé à la place du putchar.

La plate-forme fournit une variante de vsnprintf appelée vsnprintf_ex, qui se comporte exactement comme vsnprintf, à la différence qu'elle permet d'omettre les premiers caractères n de la sortie.

Notez que même si la fonction basée sur le rappel est la plus simple et qu'elle utilise le moins de code, la variété de fonctions vsprintf_ex consomme moins de pile.

Si aucune des options ci-dessus n'est disponible, mais que la plate-forme fournit malloc, la fonction alloue un tampon temporaire pour contenir la sortie. Lorsque la plate-forme ne fournit aucune amélioration à la famille printf ni malloc, la sortie est tronquée afin qu'elle s'adapte à l'état continu dans le stockage TLV actuel.

Implémentation d'une fonction FinalizeBuffer TLVWriter permettant d'écrire dans une chaîne de PacketBuffers.

La fonction FinalizePacketBuffer() effectue la finalisation nécessaire lors de l'utilisation d'un TLVWriter pour écrire dans une chaîne de PacketBuffers. La fonction est conçue pour être utilisée avec la fonction GetNewPacketBuffer().

Consultez la définition du type FinalizeBufferFunct pour en savoir plus sur l'API de la fonction FinalizePacketBuffer().

Implémentation d'une fonction GetNewBuffer TLVWriter permettant d'écrire dans un tampon dynamique.

La fonction GetNewBuffer_Malloced() fournit un nouvel espace de sortie à un TLVWriter en doublant la taille du tampon dynamique sous-jacent si nécessaire pour stocker l'encodage. La fonction est conçue pour être attribuée au pointeur de fonction GetNewBuffer TLVWriter.

Consultez la définition du type GetNewBufferFunct pour en savoir plus sur l'API de la fonction GetNewBuffer_Malloced().

Implémentation d'une fonction GetNewBuffer TLVWriter permettant d'écrire dans une chaîne de PacketBuffers.

La fonction GetNewPacketBuffer() fournit un nouvel espace de sortie à un TLVWriter en allouant une chaîne d'un ou plusieurs PacketBuffers si nécessaire au stockage de l'encodage. La fonction est conçue pour être attribuée au pointeur de fonction GetNewBuffer TLVWriter.

Notez que lorsque vous utilisez GetNewPacketBuffer avec un TLVWriter, la fonction FinalizePacketBuffer() correspondante (ou un équivalent) doit également être utilisée pour finaliser la chaîne de tampon.

Consultez la définition du type GetNewBufferFunct pour en savoir plus sur l'API de la fonction GetNewPacketBuffer().

Déterminez si le conteneur doit réserver de l'espace pour le symbole CloseContainer au moment du démarrage et de l'ouverture du conteneur.

SetCloseContainerReserved

void SetCloseContainerReserved(
  bool aCloseContainerReserved
)

SetContainerOpen

void SetContainerOpen(
  bool aContainerOpen
)

WEAVE_ERROR WriteData(
  const uint8_t *p,
  uint32_t len
)

WEAVE_ERROR WriteElementHead(
  TLVElementType elemType,
  uint64_t tag,
  uint64_t lenOrVal
)

WEAVE_ERROR WriteElementWithData(
  TLVType type,
  uint64_t tag,
  const uint8_t *data,
  uint32_t dataLen
)