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 un oggetto TLVReader privato viene inizializzato su questo buffer riposizionato. 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 aggiungerne di nuovi 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 privato viene inizializzato per la lettura da questa nuova posizione, mentre un nuovo oggetto TLVWriter privato viene inizializzato per la scrittura nello spazio di buffer liberato.

Tieni presente che se TLVReader è già posizionato "su" un elemento, viene prima eseguito il backup all'inizio di quell'elemento. Tieni inoltre presente che questo backup funziona bene con gli elementi container, ad esempio, se TLVReader è già stato utilizzato per chiamare EnterContainer(), non c'è nulla da eseguire il backoff. Tuttavia, se TLVReader è stato posizionato sull'elemento container e EnterContainer() non è stato ancora chiamato, viene eseguito il backup dell'oggetto TLVReader all'inizio dell'intestazione container.

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

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

Il metodo Move() copia l'elemento corrente su cui è posizionato il lettore di TLVUpdater, nell'autore di TLVUpdater. L'applicazione deve chiamare Next() e posizionare il lettore 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, verranno copiati tutti i membri del contenitore. Se il lettore non è posizionato su alcun elemento, non cambia nulla quando chiami questo metodo.

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

Questo metodo supporta lo spostamento di tutto dal punto di lettura corrente di TLVUpdater fino alla fine del buffer del lettore all'autore di TLVUpdater.

Salta l'elemento corrente e passa all'oggetto TLVUpdater all'elemento successivo nell'input TLV.

Il metodo Next() ignora l'elemento corrente nell'input TLV e fa avanzare il lettore TLVUpdater all'elemento successivo che risiede nello stesso contesto di contenimento. In particolare, se il lettore è posizionato al livello più esterno di una codifica TLV, chiamando Next() lo sposterà all'elemento più in alto successivo. Se il lettore è posizionato all'interno di un elemento contenitore TLV (una struttura, un array o un percorso), chiamando Next() lo sposterà all'elemento membro successivo del container.

Poiché Next() vincola il movimento del lettore al contesto di contenimento corrente, chiamando Next() quando il lettore è posizionato su un elemento contenitore, avanzerà sopra il container, saltando i relativi elementi membro (e i membri di qualsiasi contenitore nidificato) fino a raggiungere il primo elemento dopo il container.

Quando non ci sono altri elementi all'interno di un determinato 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
)