nl::Weave::TLV::TLVWriter

Codifica un valore in virgola mobile TLV.

Questa è una funzione membro sovraccarico, fornita per praticità. Si differenzia dalla funzione precedente solo per gli argomenti che accetta.

Codifica un valore booleano TLV.

Codifica un valore di stringa di byte TLV.

Codifica un valore null TLV.

Codifica un elemento container TLV da un insieme precodificato di elementi membro.

Il metodo PutPreEncodedContainer() codifica un nuovo elemento contenitore TLV (una struttura, un array o un percorso) contenente un insieme di elementi membro acquisiti da un buffer precodificato. Il buffer di input dovrebbe contenere zero o più elementi TLV con codifica completa, con tag conformi alle regole associate al tipo di contenitore specificato (ad esempio, i membri della struttura devono avere tag, mentre i membri dell'array no).

Il metodo codifica l'intero elemento contenitore in un'unica chiamata. Quando restituisce PutPreEncodedContainer(), l'oggetto writer può essere utilizzato per scrivere elementi TLV aggiuntivi che seguono l'elemento contenitore.

Codifica un valore stringa UTF8 TLV.

Codifica un valore stringa UTF8 TLV.

Codifica l'output della stringa formattato in base al formato dell'elemento TLV.

PutStringF è un analogo di uno sprintf in cui l'output è archiviato in un elemento TLV anziché in un buffer dei caratteri. Quando è disponibile la funzionalità printf estesa, la funzione è in grado di generare la stringa risultato in uno spazio di archiviazione sottostante discontinuo. L'implementazione supporta i seguenti miglioramenti printf:

La piattaforma fornisce un vcbprintf basato su callback che offre la possibilità di chiamare una callback personalizzata al posto del putchar.

La piattaforma fornisce una variante di vsnprintf denominata vsnprintf_ex, che si comporta esattamente come vsnprintf, tranne per il fatto che prevede l'omissione dei primi n caratteri dell'output.

Tieni presente che mentre la funzione basata su callback potrebbe essere la più semplice e utilizzare la minor quantità di codice, la varietà di funzioni vsprintf_ex consuma meno stack.

Se nessuna delle opzioni precedenti è disponibile, ma la piattaforma fornisce malloc, la funzione allocherà un buffer temporaneo per contenere l'output. Quando la piattaforma non fornisce miglioramenti alla famiglia printf né al Malloc, l'output viene troncato in modo da rientrare nello stato continuo nell'attuale spazio di archiviazione TLV

Inizia la codifica di un nuovo elemento contenitore TLV.

Il metodo StartContainer() viene utilizzato per scrivere elementi contenitore TLV (struttura, array o percorsi) in una codifica. Il metodo prende il tipo e il tag (se presenti) del nuovo contenitore, oltre a un riferimento a un valore TLVType che verrà utilizzato per salvare il contesto corrente dell'autore mentre questo viene utilizzato per scrivere il container.

Una volta restituito il metodo StartContainer(), l'applicazione deve utilizzare l'oggetto TLVWriter corrente per scrivere gli elementi del container. Al termine, l'applicazione deve chiamare il metodo EndContainer() per completare la codifica del contenitore.

Codifica una stringa di byte TLV in più blocchi.

Deve essere utilizzato con ContinuePutBytes.

Codifica l'output della stringa formattato in base al formato dell'elemento TLV.

PutStringF è un analogo di uno sprintf in cui l'output è archiviato in un elemento TLV anziché in un buffer dei caratteri. Quando è disponibile la funzionalità printf estesa, la funzione è in grado di generare la stringa risultato in uno spazio di archiviazione sottostante discontinuo. L'implementazione supporta i seguenti miglioramenti printf:

La piattaforma fornisce un vcbprintf basato su callback che offre la possibilità di chiamare una callback personalizzata al posto del putchar.

La piattaforma fornisce una variante di vsnprintf denominata vsnprintf_ex, che si comporta esattamente come vsnprintf, tranne per il fatto che prevede l'omissione dei primi n caratteri dell'output.

Tieni presente che mentre la funzione basata su callback potrebbe essere la più semplice e utilizzare la minor quantità di codice, la varietà di funzioni vsprintf_ex consuma meno stack.

Se nessuna delle opzioni precedenti è disponibile, ma la piattaforma fornisce malloc, la funzione allocherà un buffer temporaneo per contenere l'output. Quando la piattaforma non fornisce miglioramenti alla famiglia printf né al Malloc, l'output viene troncato in modo da rientrare nello stato continuo nell'attuale spazio di archiviazione TLV

Un'implementazione di una funzione FinalizeBuffer TLVWriter per la scrittura in una catena di PacketBuffers.

La funzione FinalizePacketBuffer() esegue la finalizzazione necessaria quando si utilizza un TLVWriter per scrivere in una catena di PacketBuffers. La funzione è progettata per essere utilizzata in combinazione con la funzione GetNewPacketBuffer().

Consulta la definizione del tipo FinalizeBufferFunct per ulteriori informazioni sull'API della funzione FinalizePacketBuffer().

Un'implementazione di una funzione GetNewBuffer TLVWriter per la scrittura in un buffer dinamico.

La funzione GetNewBuffer_Malloced() fornisce nuovo spazio di output a un TLVWriter raddoppiando le dimensioni del buffer dinamico sottostante secondo necessità per archiviare la codifica. La funzione è progettata per essere assegnata al puntatore della funzione GetNewBuffer TLVWriter.

Consulta la definizione del tipo GetNewBufferFunct per ulteriori informazioni sull'API della funzione GetNewBuffer_Malloced().

Un'implementazione di una funzione GetNewBuffer TLVWriter per la scrittura in una catena di PacketBuffers.

La funzione GetNewPacketBuffer() fornisce nuovo spazio di output a un TLVWriter allocando una catena di uno o più PacketBuffers necessari per archiviare la codifica. La funzione è progettata per essere assegnata al puntatore della funzione GetNewBuffer TLVWriter.

Tieni presente che quando utilizzi GetNewPacketBuffer con un TLVWriter, per finalizzare la catena del buffer è necessario utilizzare anche la corrispondente funzione FinalizePacketBuffer() (o una funzione equivalente).

Consulta la definizione del tipo GetNewBufferFunct per ulteriori informazioni sull'API della funzione GetNewPacketBuffer().

Stabilisci se il container deve riservare spazio per il simbolo di CloseContainer nel punto di avvio / apertura del container.

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
)