nl::Weave::TLV::TLVUpdater

Zainicjuj obiekt TLVUpdater, aby edytować pojedynczy bufor wejściowy.

Po wywołaniu tej metody dane TLV w buforze są przenoszone na koniec bufora, a w tym przeniesionym buforze zainicjowany jest prywatny obiekt TLVReader. W wolnym miejscu, które jest teraz dostępne na początku, inicjowany jest również prywatny obiekt TLVWriter. Aplikacje mogą używać obiektu TLVUpdater do analizowania danych TLV oraz modyfikowania i usuwania istniejących elementów oraz dodawania nowych elementów do kodowania.

Zainicjuj obiekt TLVUpdater za pomocą narzędzia TLVReader.

Po wywołaniu tej metody dane TLV w buforze wskazywane przez tag TLVReader są przenoszone z bieżącego punktu odczytu na koniec bufora. Zainicjowano nowy prywatny obiekt TLVReader do odczytu z tej nowej lokalizacji, a nowy obiekt TLVWriter zostaje zainicjowany w celu zapisu w zwolnionym miejscu bufora.

Pamiętaj, że jeśli element TLVReader jest już w pozycji „w” elementu, kopia zapasowa jest najpierw wykonywane na początku tego elementu. Pamiętaj też, że to zabezpieczenie działa dobrze w przypadku elementów kontenera, tj. jeśli obiekt TLVReader był już używany do wywołania EnterContainer(), nie ma niczego, co można by wycofać. Jeśli jednak obiekt TLVReader był umieszczony w elemencie kontenera, a metoda EnterContainer() nie została jeszcze wywołana, obiekt TLVReader zostaje wycofany na początku nagłówka kontenera.

Wejściowy obiekt TLVReader zostanie zniszczony przed zwróceniem, a aplikacja nie może go używać po zwróceniu.

Kopiuje bieżący element z wejściowego elementu TLV do wyjściowego elementu TLV.

Metoda Move() kopiuje bieżący element, w którym znajduje się czytnik TLVUpdater, do zapisującego w narzędziu TLVUpdater. Przed wywołaniem tej metody aplikacja powinna wywołać metodę Next() i umieścić czytnik TLVUpdater w elemencie. Podobnie jak w przypadku metody TLVReader::Next(), jeśli w czasie wywołania czytnik znajdzie się na elemencie kontenera, wszystkie jego elementy zostaną skopiowane. Jeśli czytnik nie znajduje się na żadnym elemencie, wywołanie tej metody nie ulegnie zmianie.

Przenieś wszystko od bieżącego punktu odczytu narzędzia TLVUpdater do końca wejściowego bufora TLV do danych wyjściowych.

Ta metoda umożliwia przeniesienie wszystkiego od bieżącego punktu odczytu w narzędziu TLVUpdater do końca bufora czytnika do zapisu w narzędziu TLVUpdater.

Pomiń bieżący element i przenieś obiekt TLVUpdater do następnego elementu w wejściowym TLV.

Metoda Next() pomija bieżący element w wejściowym TLV i przenosi czytnik TLVUpdater do następnego elementu, który znajduje się w tym samym kontekście izolacji. W szczególności, jeśli czytnik znajduje się na najwyższym poziomie kodu TLV, wywołanie metody Next() spowoduje przejście do kolejnego, najwyższego poziomu. Jeśli czytnik znajduje się w elemencie kontenera TLV (strukturze, tablicy lub ścieżce), wywołanie funkcji Next() spowoduje przejście do następnego elementu kontenera.

Funkcja Next() ogranicza ruch czytnika do bieżącego kontekstu izolacji, dlatego wywołanie metody Next(), gdy czytnik znajduje się w elemencie kontenera, powoduje przejście nad kontenera, pomijanie jego elementów składowych (i elementów zagnieżdżonych kontenerów), aż dotrze do pierwszego elementu za kontenerem.

Gdy w konkretnym kontekście izolacji nie ma więcej elementów, metoda Next() zwraca błąd WEAVE_END_OF_TLV, a położenie czytnika się nie zmienia.

Put

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
)