nl::Weave::TLV::TLVUpdater

TLVUpdater 객체를 초기화하여 단일 입력 버퍼를 수정합니다.

이 메서드를 호출하면 버퍼의 TLV 데이터가 버퍼 끝으로 이동되고 비공개 TLVReader 객체가 재배치된 버퍼에서 초기화됩니다. 비공개 TLVWriter 객체도 이제 시작 시 사용할 수 있는 빈 공간에서 초기화됩니다. 애플리케이션은 TLVUpdater 객체를 사용하여 TLV 데이터를 파싱하고 기존 요소를 수정/삭제하거나 인코딩에 새 요소를 추가할 수 있습니다.

TLVReader를 사용하여 TLVUpdater 객체를 초기화합니다.

이 메서드를 호출하면 TLVReader가 가리키는 버퍼의 TLV 데이터가 현재 읽기 지점에서 버퍼 끝으로 이동합니다. 새 비공개 TLVReader 객체는 이 새 위치에서 읽도록 초기화되고, 새로운 비공개 TLVWriter 객체는 확보된 버퍼 공간에 쓰도록 초기화됩니다.

TLVReader가 이미 특정 요소 '위'에 배치된 경우 먼저 요소의 시작 부분부터 되돌려집니다. 또한 이 백오프는 컨테이너 요소에서 잘 작동합니다. 예를 들어 TLVReader가 이미 EnterContainer()를 호출하는 데 사용된 경우 백오프할 것이 없습니다. 그러나 TLVReader가 컨테이너 요소에 배치되었고 EnterContainer()가 아직 호출되지 않은 경우에는 컨테이너 헤드의 시작 부분에서 TLVReader 객체가 백오프됩니다.

입력 TLVReader 객체는 반환하기 전에 폐기되며 반환 시 애플리케이션에서 동일한 객체를 사용해서는 안 됩니다.

입력 TLV에서 현재 요소를 출력 TLV로 복사합니다.

Move() 메서드는 TLVUpdater의 판독기가 배치된 현재 요소를 TLVUpdater의 작성기에 복사합니다. 애플리케이션은 이 메서드를 호출하기 전에 Next()를 호출하고 TLVUpdater의 리더를 요소에 배치해야 합니다. TLVReader::Next() 메서드와 마찬가지로 호출 시 판독기가 컨테이너 요소에 배치되면 컨테이너의 모든 멤버가 복사됩니다. 판독기가 요소에 배치되지 않은 경우 이 메서드를 호출해도 아무것도 변경되지 않습니다.

TLVUpdater의 현재 읽기 지점에서 입력 TLV 버퍼의 끝까지 모든 것을 출력으로 이동합니다.

이 메서드는 TLVUpdater의 현재 읽기 지점에서 판독기 버퍼의 끝까지 TLVUpdater의 작성기로 모든 것을 이동하는 기능을 지원합니다.

현재 요소를 건너뛰고 TLVUpdater 객체를 입력 TLV의 다음 요소로 진행합니다.

Next() 메서드는 입력 TLV의 현재 요소를 건너뛰고 TLVUpdater의 판독기를 동일한 포함 컨텍스트에 있는 다음 요소로 진행합니다. 특히 판독기가 TLV 인코딩의 가장 바깥쪽에 위치한 경우 Next()를 호출하면 그다음의 최상위 요소로 이동합니다. 리더가 TLV 컨테이너 요소 (구조, 배열 또는 경로) 내에 위치한 경우 Next()를 호출하면 컨테이너의 다음 멤버 요소로 넘어갑니다.

Next()는 판독기 모션을 현재 포함 컨텍스트로 제한하므로 판독기가 컨테이너 요소에 배치될 때 Next()를 호출하면 컨테이너 위로 이동하고, 컨테이너 이후의 첫 번째 요소에 도달할 때까지 멤버 요소 (및 중첩된 컨테이너의 멤버)를 건너뜁니다.

특정 포함 컨텍스트 내에 추가 요소가 없는 경우 Next() 메서드는 WEAVE_END_OF_TLV 오류를 반환하고 판독기의 위치는 변경되지 않은 상태로 유지됩니다.

데이터 기반의

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
)