nl::Weave::TLV::TLVWriter

Codifica un valore in virgola mobile TLV.

Questa è una funzione membro sovraccarica, fornita per praticità. La funzione di cui sopra differisce solo per gli argomenti accettati.

Codifica un valore booleano TLV.

Codifica un valore stringa di byte TLV.

Codifica un valore null TLV.

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

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 pre-codificato. Il buffer di input dovrebbe contenere zero o più elementi TLV con codifica completa, con tag conformi alle regole associate ai tipi di container specificati (ad esempio, i membri della struttura devono avere tag, al contrario dei membri dell'array).

Il metodo codifica l'intero elemento del container in una sola chiamata. Quando viene restituito PutPreEncodedContainer(), l'oggetto writer può essere utilizzato per scrivere elementi TLV aggiuntivi dopo l'elemento container.

Codifica un valore stringa UTF8 TLV.

Codifica un valore stringa UTF8 TLV.

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

PutStringF è un analogico 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 generare la stringa di risultati in uno spazio di archiviazione sottostante discontinuo. L'implementazione supporta i seguenti miglioramenti dell'edizione cartacea:

La piattaforma fornisce un vcbprintf basato su callback che consente 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, salvo che prevede delle omissioni dei primi n caratteri dell'output.

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

Se nessuna delle opzioni precedenti è disponibile, ma la piattaforma fornisce malloc, la funzione alloca un buffer temporaneo per contenere l'output. Quando la piattaforma non offre miglioramenti né alla famiglia della versione stampata né al centro commerciale, l'output viene troncato in modo da adattarsi allo stato continuo dell'archiviazione TLV corrente.

Inizia la codifica di un nuovo elemento container TLV.

Il metodo StartContainer() viene utilizzato per scrivere elementi container TLV (struttura, array o percorsi) in una codifica. Il metodo prevede 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 durante l'utilizzo per la scrittura del container.

Una volta restituito il metodo StartContainer(), l'applicazione deve utilizzare l'oggetto TLVWriter corrente per scrivere gli elementi del contenitore. 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 usato con ContinuePutBytes.

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

PutStringF è un analogico 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 generare la stringa di risultati in uno spazio di archiviazione sottostante discontinuo. L'implementazione supporta i seguenti miglioramenti dell'edizione cartacea:

La piattaforma fornisce un vcbprintf basato su callback che consente 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, salvo che prevede delle omissioni dei primi n caratteri dell'output.

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

Se nessuna delle opzioni precedenti è disponibile, ma la piattaforma fornisce malloc, la funzione alloca un buffer temporaneo per contenere l'output. Quando la piattaforma non offre miglioramenti né alla famiglia della versione stampata né al centro commerciale, l'output viene troncato in modo da adattarsi allo stato continuo dell'archiviazione TLV corrente.

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 è stata progettata per essere utilizzata insieme alla funzione GetNewPacketBuffer().

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

Implementazione di una funzione GetNewBuffer TLVWriter per scrivere 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 di TLVWriter.

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

Implementazione di una funzione GetNewBuffer TLVWriter per scrivere in una catena di PacketBuffers.

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

Tieni presente che quando utilizzi GetNewPacketBuffer con un TLVWriter, devi finalizzare la funzione FinalizePacketBuffer() corrispondente (o 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 in cui viene avviato o aperto il container.

SetCloseContainerPrenotato

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
)