nl::Weave::TLV::TLVWriter

Codifica un valor de punto flotante TLV.

Esta es una función de miembro sobrecargada que se proporciona para mayor comodidad. Difiere de la función anterior solo en 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 contenedor TLV de un conjunto codificado previamente de elementos miembros.

El método PUTPreEncodedContainer() codifica un nuevo elemento de contenedor TLV (una estructura, un arreglo o una ruta) que contiene un conjunto de elementos miembros tomados de un búfer precodificado. Se espera que el búfer de entrada contenga cero o más elementos TLV con codificación completa, con etiquetas que cumplan con las reglas asociadas al tipo de contenedor especificado (p.ej., los miembros de la estructura deben tener etiquetas, mientras que los miembros del array no deben hacerlo).

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

Codifica un valor de string UTF8 TLV.

Codifica un valor de string UTF8 TLV.

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

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

La plataforma proporciona un vcbprintf basado en devolución 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 como vsnprintf, excepto que tiene disposiciones para omitir los primeros caracteres n del resultado.

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

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

Comienza a codificar un nuevo elemento de contenedor TLV.

El método StartContainer() se usa para escribir elementos de contenedor TLV (estructura, arrays o rutas de acceso) 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.

Una vez que 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 Continue PutBytes.

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

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

La plataforma proporciona un vcbprintf basado en devolución 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 como vsnprintf, excepto que tiene disposiciones para omitir los primeros caracteres n del resultado.

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

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

Implementación de una función FinalizeBuffer TLVWriter 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 se diseñó para utilizarse junto con la función GetNewPacketBuffer().

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

Implementación de una función GetNewBuffer de TLVWriter 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 GetNewBuffer TLVWriter.

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

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

La función GetNewPacketBuffer() proporciona un nuevo espacio de salida a un TLVWriter mediante la asignación de 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 GetNewBuffer TLVWriter.

Ten en cuenta que, cuando usas GetNewPacketBuffer con un TLVWriter, se debe usar la función FinalizePacketBuffer() (o una equivalente) correspondiente 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 de CloseContainer en el momento de iniciar o abrir 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
)