nl::Weave::TLV::TLVWriter

Codifica un valor de punto flotante TLV.

Esta es una función de miembro sobrecargada, proporcionada 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 de contenedor TLV de un conjunto precodificado de elementos miembros.

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 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 tener etiquetas).

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

Codifica un valor de cadena UTF8 TLV.

Codifica un valor de cadena UTF8 TLV.

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

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

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 n caracteres 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 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 mejoras a la familia printf ni malloc, el resultado se trunca de modo que se ajuste al estado continuo en el almacenamiento TLV actual

Comienza a codificar un elemento de contenedor TLV nuevo.

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

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 finaliza, la aplicación debe llamar al método EndContainer() para finalizar la codificación del contenedor.

Codifica una cadena de bytes TLV en varios fragmentos.

Se debe usar con ContinuePutBytes.

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

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

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 n caracteres 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 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 mejoras a la familia printf ni malloc, el resultado se trunca de modo que se ajuste al estado continuo en el almacenamiento TLV actual

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

La función FinalizePacketBuffer() realiza la finalización necesaria que se requiere cuando se usa un TLVWriter para escribir en una cadena de batchBuffers. La función está diseñada para usarse junto con la función 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 la función GetNewBuffer 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 más información acerca de la API de la función GetNewBuffer_Malloced().

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

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 paquetesBundleBuffers, 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 se usa el GetNewPacketBuffer con un TLVWriter, también se debe usar la función FinalizePacketBuffer() correspondiente (o una equivalente) para finalizar la cadena de búferes.

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

Determina si el contenedor debe reservar espacio para el símbolo de CloseContainer en el punto de inicio o de apertura del 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
)