nl::Weave::TLV::TLVUpdater

Khởi động đối tượng TLVUpdater để chỉnh sửa một vùng đệm đầu vào.

Khi gọi phương thức này, dữ liệu TLV trong vùng đệm được chuyển đến cuối vùng đệm và một đối tượng TLVReader riêng tư sẽ được khởi động trên vùng đệm di chuyển này. Đối tượng TLVWriter riêng tư cũng được khởi tạo trên không gian trống hiện có sẵn từ đầu. Các ứng dụng có thể dùng đối tượng TLVUpdater để phân tích cú pháp dữ liệu TLV và sửa đổi/xoá các phần tử hiện có hoặc thêm phần tử mới vào bộ mã hoá.

Khởi động đối tượng TLVUpdater bằng TLVReader.

Khi gọi phương thức này, dữ liệu TLV trong vùng đệm do TLVReader trỏ đến sẽ được di chuyển từ điểm đọc hiện tại đến cuối vùng đệm. Một đối tượng TLVReader riêng tư mới được khởi tạo để đọc từ vị trí mới này, trong khi một đối tượng TLVWriter riêng tư mới được khởi động để ghi vào không gian đệm đã giải phóng.

Lưu ý rằng nếu TLVReader đã được đặt ở vị trí "on" (bật) một phần tử thì đầu tiên phần tử đó sẽ được sao lưu vào phần đầu của phần tử đó. Ngoài ra, xin lưu ý rằng thao tác sao lưu này hoạt động tốt với các phần tử vùng chứa, tức là nếu TLVReader đã được dùng để gọi EnterContainer(), thì bạn không cần phải sao lưu. Nhưng nếu TLVReader được định vị trên phần tử vùng chứa và EnterContainer() chưa được gọi, thì đối tượng TLVReader sẽ được sao lưu vào phần đầu của tiêu đề vùng chứa.

Đối tượng TLVReader đầu vào sẽ bị huỷ trước khi quay lại và ứng dụng không được sử dụng đối tượng tương tự khi trả về.

Sao chép phần tử hiện tại trong dữ liệu đầu vào TLV để xuất TLV.

Phương thức Move() sẽ sao chép phần tử hiện tại nơi đặt trình đọc của TLVUpdater sang trình ghi của TLVUpdater. Ứng dụng sẽ gọi Next() và định vị trình đọc của TLVUpdater trên một phần tử trước khi gọi phương thức này. Giống như phương thức TLVReader::Next(), nếu trình đọc được định vị trên một phần tử vùng chứa tại thời điểm gọi, thì tất cả thành phần của vùng chứa sẽ được sao chép. Nếu trình đọc không được đặt trên bất kỳ phần tử nào thì sẽ không có gì thay đổi khi gọi phương thức này.

Di chuyển mọi thứ từ điểm đọc hiện tại của TLVUpdater cho đến khi kết thúc bộ đệm TLV đầu vào sang đầu ra.

Phương thức này hỗ trợ việc di chuyển mọi thứ từ điểm đọc hiện tại của TLVUpdater cho đến cuối vùng đệm trình đọc sang trình ghi của TLVUpdater.

Bỏ qua phần tử hiện tại và chuyển đối tượng TLVUpdater sang phần tử tiếp theo trong đầu vào TLV.

Phương thức Next() bỏ qua phần tử hiện tại trong TLV đầu vào và chuyển trình đọc của TLVUpdater sang phần tử tiếp theo nằm trong cùng ngữ cảnh chứa. Cụ thể, nếu trình đọc được đặt ở cấp độ ngoài cùng của bộ mã hoá TLV, thì lệnh gọi Next() sẽ chuyển trình đọc lên phần tử tiếp theo ở trên cùng nhất. Nếu trình đọc được đặt trong phần tử vùng chứa TLV (cấu trúc, mảng hoặc đường dẫn), thì lệnh gọi Next() sẽ chuyển trình đọc đến phần tử thành phần tiếp theo của vùng chứa.

Vì Next() ràng buộc chuyển động của người đọc trong ngữ cảnh chứa hiện tại, nên việc gọi Next() khi trình đọc được định vị trên phần tử vùng chứa sẽ di chuyển qua vùng chứa, bỏ qua các phần tử thành phần của vùng chứa (và các thành phần của bất kỳ vùng chứa lồng nhau nào) cho đến khi đến phần tử đầu tiên sau vùng chứa.

Khi không còn phần tử nào khác trong một ngữ cảnh chứa cụ thể, phương thức Next() sẽ trả về lỗi WEAVE_END_OF_TLV và vị trí của trình đọc sẽ không thay đổi.

Đặt

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
)