nl::Weave::TLV::TLVWriter

Codifica un valore con virgola mobile TLV.

Si tratta di una funzione membro con sovraccarico, fornita per praticità. Differisce dalla funzione precedente solo per quali argomenti accetta.

Codifica un valore booleano TLV.

Codifica un valore di stringa di byte TLV.

Codifica un valore nullo TLV.

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

Il metodo PutPreEncodedContainer() codifica un nuovo elemento container TLV (una struttura, un array o un percorso) contenente un insieme di elementi membri presi 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 es. i membri della struttura devono avere tag, mentre i membri dell'array no).

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

Codifica un valore di stringa UTF8 TLV.

Codifica un valore di stringa UTF8 TLV.

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

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

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

La piattaforma fornisce una variante di vsnprintf chiamata vsnprintf_ex, che si comporta esattamente come vsnprintf, tranne per il fatto che ha delle disposizioni per omettere i primi n caratteri dell'output.

Tieni presente che, sebbene la funzione basata su callback possa essere la più semplice e utilizzi la minor quantità di codice, la varietà di funzioni vsprintf_ex consumerà meno stack.

Se nessuna delle opzioni precedenti è disponibile, ma la piattaforma fornisce malloc, la funzione allocherà un buffer temporaneo per conservare l'output. Quando la piattaforma non fornisce né miglioramenti alla famiglia di stampa né al Malloc, l'output viene troncato in modo da adattarsi allo 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 del container TLV (struttura, array o percorsi) in una codifica. Il metodo prende il tipo e il tag (se presenti) del nuovo contenitore e un riferimento a un valore TLVType che verrà utilizzato per salvare il contesto corrente dell'autore del testo mentre 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 terminare la codifica del container.

Codifica una stringa di byte TLV in più blocchi.

Deve essere usato con ContinuePutBytes.

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

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

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

La piattaforma fornisce una variante di vsnprintf chiamata vsnprintf_ex, che si comporta esattamente come vsnprintf, tranne per il fatto che ha delle disposizioni per omettere i primi n caratteri dell'output.

Tieni presente che, sebbene la funzione basata su callback possa essere la più semplice e utilizzi la minor quantità di codice, la varietà di funzioni vsprintf_ex consumerà meno stack.

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

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

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

Per ulteriori informazioni sull'API della funzione FinalizePacketBuffer(), consulta la definizione del tipo di FinalizeBufferFunct.

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

La funzione GetNewBuffer_Malloced() fornisce nuovo spazio di output a TLVWriter raddoppiando la dimensione del buffer dinamico sottostante 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 TLVWriter allocando una catena di uno o più PacketBuffers in base alle esigenze per archiviare la codifica. La funzione è progettata per essere assegnata al puntatore della funzione GetNewBuffer TLVWriter.

Tieni presente che quando utilizzi GetNewPacketBuffer con un oggetto TLVWriter, devi utilizzare anche la funzione FinalizePacketBuffer() (o una funzione equivalente) per finalizzare la catena di buffer.

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

Determina se il container deve riservare spazio per il simbolo 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
)