nl::Weave::TLV::TLVUpdater

Inizializza un oggetto TLVUpdater per modificare un singolo buffer di input.

Quando chiami questo metodo, i dati TLV nel buffer vengono spostati alla fine del buffer e in questo buffer riposizionato viene inizializzato un oggetto TLVReader privato. Viene inizializzato anche un oggetto TLVWriter privato nello spazio libero ora disponibile all'inizio. Le applicazioni possono utilizzare l'oggetto TLVUpdater per analizzare i dati TLV e modificare/eliminare elementi esistenti o aggiungere nuovi elementi alla codifica.

Inizializza un oggetto TLVUpdater utilizzando un TLVReader.

Quando chiami questo metodo, i dati TLV nel buffer a cui punta TLVReader vengono spostati dal punto di lettura corrente alla fine del buffer. Un nuovo oggetto TLVReader viene inizializzato per la lettura da questa nuova posizione, mentre un nuovo oggetto TLVWriter privato viene inizializzato per scrivere nello spazio del buffer liberato.

Tieni presente che se TLVReader è già posizionato su "On" di un elemento, ne viene prima eseguito il backup all'inizio di quell'elemento. Tieni inoltre presente che questo backoff funziona bene con gli elementi container, ad esempio se TLVReader è già stato utilizzato per chiamare EnterContainer(), non c'è nulla di cui eseguire il backoff. Tuttavia, se TLVReader è stato posizionato sull'elemento container e la funzione EnterContainer() non è ancora stata chiamata, l'oggetto TLVReader viene eseguito il back-off all'inizio dell'intestazione del container.

L'oggetto TLVReader di input verrà eliminato prima della restituzione e l'applicazione non deve utilizzarlo al momento del ritorno.

Copia l'elemento corrente dall'input TLV in output TLV.

Il metodo Sposta() copia l'elemento corrente su cui è posizionato il lettore di TLVUpdater nel writer di TLVUpdater. L'applicazione deve chiamare Next() e posizionare il lettore di TLVUpdater su un elemento prima di chiamare questo metodo. Come nel caso del metodo TLVReader::Next(), se il lettore è posizionato su un elemento contenitore al momento della chiamata, tutti i membri del contenitore verranno copiati. Se il lettore non è posizionato su alcun elemento, la chiamata di questo metodo non cambia.

Sposta tutto dall'attuale punto di lettura di TLVUpdater fino alla fine del buffer TLV di input nell'output.

Questo metodo supporta lo spostamento di tutto dall'attuale punto di lettura di TLVUpdater fino alla fine del buffer del lettore al writer di TLVUpdater.

Ignora l'elemento corrente e avanza l'oggetto TLVUpdater all'elemento successivo nell'input TLV.

Il metodo Next() ignora l'elemento corrente nell'input TLV e fa avanzare il lettore di TLVUpdater all'elemento successivo che risiede nello stesso contesto di contenimento. In particolare, se il lettore è posizionato all'estremità più esterna di una codifica TLV, la chiamata a Next() consente di avanzare all'elemento immediatamente successivo. Se il lettore viene posizionato all'interno di un elemento contenitore TLV (una struttura, un array o un percorso), la chiamata a Next() lo avanza all'elemento membro successivo del contenitore.

Poiché Next() vincola il movimento del lettore al contesto di contenimento corrente, la chiamata a Next() quando il lettore è posizionato su un elemento contenitore avanza oltre il container, saltando i relativi elementi membri (e i membri di eventuali contenitori nidificati) fino a raggiungere il primo elemento dopo il contenitore.

Quando non ci sono altri elementi in un particolare contesto di contenimento, il metodo Next() restituirà un errore WEAVE_END_OF_TLV e la posizione del lettore rimarrà invariata.

Adotta

WEAVE_ERROR Put(
  uint64_t tag,
  int16_t v
)

WEAVE_ERROR Put(
  uint64_t tag,
  int32_t v
)

WEAVE_ERROR Put(
  uint64_t tag,
  int64_t v
)

WEAVE_ERROR Put(
  uint64_t tag,
  uint8_t v
)

WEAVE_ERROR Put(
  uint64_t tag,
  uint16_t v
)

WEAVE_ERROR Put(
  uint64_t tag,
  uint32_t v
)

WEAVE_ERROR Put(
  uint64_t tag,
  uint64_t v
)

WEAVE_ERROR Put(
  uint64_t tag,
  int8_t v,
  bool preserveSize
)

WEAVE_ERROR Put(
  uint64_t tag,
  int16_t v,
  bool preserveSize
)

WEAVE_ERROR Put(
  uint64_t tag,
  int32_t v,
  bool preserveSize
)

WEAVE_ERROR Put(
  uint64_t tag,
  int64_t v,
  bool preserveSize
)

WEAVE_ERROR Put(
  uint64_t tag,
  uint8_t v,
  bool preserveSize
)

WEAVE_ERROR Put(
  uint64_t tag,
  uint16_t v,
  bool preserveSize
)

WEAVE_ERROR Put(
  uint64_t tag,
  uint32_t v,
  bool preserveSize
)

WEAVE_ERROR Put(
  uint64_t tag,
  uint64_t v,
  bool preserveSize
)

WEAVE_ERROR Put(
  uint64_t tag,
  float v
)

WEAVE_ERROR Put(
  uint64_t tag,
  double v
)

WEAVE_ERROR PutBoolean(
  uint64_t tag,
  bool v
)

WEAVE_ERROR PutBytes(
  uint64_t tag,
  const uint8_t *buf,
  uint32_t len
)

WEAVE_ERROR PutNull(
  uint64_t tag
)

WEAVE_ERROR PutString(
  uint64_t tag,
  const char *buf
)

WEAVE_ERROR PutString(
  uint64_t tag,
  const char *buf,
  uint32_t len
)

void SetImplicitProfileId(
  uint32_t profileId
)

WEAVE_ERROR StartContainer(
  uint64_t tag,
  TLVType containerType,
  TLVType & outerContainerType
)

WEAVE_ERROR VerifyEndOfContainer(
  void
)