nl::Weave::TLV::TLVUpdater

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

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

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

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

TLVReader가 이미 'on'으로 배치된 경우 해당 요소의 시작 부분으로 백오프됩니다. 또한 이러한 백오프는 컨테이너 요소에서 원활하게 작동합니다. 즉, 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 오류를 반환하고 판독기의 위치가 변경되지 않은 상태로 유지됩니다.

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
)