nl::Weave::TLV::TLVWriter

Codifica un valor de punto flotante TLV.

Esta es una función de miembro sobrecargada y se proporciona por conveniencia. Se diferencia de la función anterior solo por los argumentos que acepta.

Codifica un valor booleano TLV.

Codifica un valor de string de bytes TLV.

Codifica un valor nulo de TLV.

Codifica un elemento de contenedor TLV a partir de un conjunto de elementos miembros codificados previamente.

El método PutPreEncodedContainer() codifica un nuevo elemento de contenedor TLV (una estructura, un array o una ruta) que contiene un conjunto de elementos miembros tomados de un búfer previamente codificado. Se espera que el búfer de entrada contenga cero o más elementos TLV codificados por completo con etiquetas que cumplan con las reglas asociadas con el tipo de contenedor especificado (p.ej., los miembros de estructura deben tener etiquetas, mientras que los miembros del array no deben tenerlas).

El método codifica todo el elemento contenedor en una llamada. Cuando se muestra PutPreEncodedContainer(), se puede usar el objeto del escritor para escribir elementos TLV adicionales después del elemento del contenedor.

Codifica un valor de string UTF8 TLV.

Codifica un valor de string UTF8 TLV.

Codifica el resultado de la string con el formato del elemento TLV.

PutStringF es un análogo de un sprintf en el que el resultado se almacena en un elemento TLV, en lugar de en un búfer de caracteres. Cuando la funcionalidad printf extendida está disponible, la función puede generar la string de resultado en un almacenamiento subyacente discontinuo. La implementación admite las siguientes mejoras de printf:

La plataforma proporciona un vcbprintf basado en devoluciones de llamada que permite llamar a una devolución de llamada personalizada en lugar de putchar.

La plataforma proporciona una variante de vsnprintf llamada vsnprintf_ex que se comporta exactamente igual que vsnprintf, excepto que tiene disposiciones para omitir los primeros caracteres n del resultado.

Ten en cuenta que, si bien la función basada en devolución de llamada puede ser la más simple y usar la menor cantidad de código, la variedad de funciones vsprintf_ex consumirá menos pila.

Si no está disponible ninguna de las opciones anteriores, pero la plataforma proporciona malloc, la función asignará un búfer temporal para contener el resultado. Cuando la plataforma no proporciona mejoras a la familia printf ni malloc, el resultado se trunca de modo que quepa en el estado continuo en el almacenamiento TLV actual

Comienza a codificar un elemento contenedor TLV nuevo.

El método StartContainer() se usa para escribir elementos del contenedor TLV (estructura, arrays o rutas) en una codificación. El método toma el tipo y la etiqueta (si corresponde) del contenedor nuevo, y una referencia a un valor TLVType que se usará para guardar el contexto actual del escritor mientras se usa para escribir el contenedor.

Cuando se muestra el método StartContainer(), la aplicación debe usar el objeto TLVWriter actual para escribir los elementos del contenedor. Cuando termine, la aplicación debe llamar al método EndContainer() para finalizar la codificación del contenedor.

Codifica una string de bytes TLV en varios fragmentos.

Se debe usar con ContinuePutBytes.

Codifica el resultado de la string con el formato del elemento TLV.

PutStringF es un análogo de un sprintf en el que el resultado se almacena en un elemento TLV, en lugar de en un búfer de caracteres. Cuando la funcionalidad printf extendida está disponible, la función puede generar la string de resultado en un almacenamiento subyacente discontinuo. La implementación admite las siguientes mejoras de printf:

La plataforma proporciona un vcbprintf basado en devoluciones de llamada que permite llamar a una devolución de llamada personalizada en lugar de putchar.

La plataforma proporciona una variante de vsnprintf llamada vsnprintf_ex que se comporta exactamente igual que vsnprintf, excepto que tiene disposiciones para omitir los primeros caracteres n del resultado.

Ten en cuenta que, si bien la función basada en devolución de llamada puede ser la más simple y usar la menor cantidad de código, la variedad de funciones vsprintf_ex consumirá menos pila.

Si no está disponible ninguna de las opciones anteriores, pero la plataforma proporciona malloc, la función asignará un búfer temporal para contener el resultado. Cuando la plataforma no proporciona mejoras a la familia printf ni malloc, el resultado se trunca de modo que quepa en el estado continuo en el almacenamiento TLV actual

Una implementación de una función TLVWriter FinalizeBuffer para escribir en una cadena de PacketBuffers.

La función FinalizePacketBuffer() realiza la finalización necesaria cuando se usa un TLVWriter para escribir en una cadena de PacketBuffers. La función está diseñada para usarse junto con GetNewPacketBuffer().

Consulta la definición del tipo FinalizeBufferFunct para obtener información adicional sobre la API de la función FinalizePacketBuffer().

Una implementación de una función TLVWriter GetNewBuffer para escribir en un búfer dinámico.

La función GetNewBuffer_Malloced() proporciona un nuevo espacio de salida a un TLVWriter duplicando el tamaño del búfer dinámico subyacente según sea necesario para almacenar la codificación. La función está diseñada para asignarse al puntero de la función TLVWriter GetNewBuffer.

Consulta la definición del tipo GetNewBufferFunct para obtener información adicional sobre la API de la función GetNewBuffer_Malloced().

Una implementación de una función TLVWriter GetNewBuffer para escribir en una cadena de PacketBuffers.

La función GetNewPacketBuffer() proporciona un nuevo espacio de salida a un TLVWriter asignando una cadena de uno o más PacketBuffers según sea necesario para almacenar la codificación. La función está diseñada para asignarse al puntero de la función TLVWriter GetNewBuffer.

Ten en cuenta que cuando usas GetNewPacketBuffer con un TLVWriter, también se debe usar la función FinalizePacketBuffer() correspondiente (o su equivalente) para finalizar la cadena del búfer.

Consulta la definición del tipo GetNewBufferFunct para obtener información adicional sobre la API de la función GetNewPacketBuffer().

Determina si el contenedor debe reservar espacio para el símbolo CloseContainer cuando se inicia o abre el contenedor.

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
)