nl::Tạo văn bản::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à đối tượng TLVReader riêng tư được khởi tạo trên vùng đệm di chuyển này. Một đố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 ở đầ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 các phần tử mới vào phương thức mã hóa.

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 được TLVReader trỏ đến sẽ được di chuyển từ điểm đọc hiện tại sang 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 đối tượng TLVWriter riêng tư mới được khởi tạo để ghi vào không gian vùng đệm giải phóng.

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

Sao chép phần tử hiện tại từ đầu vào TLV sang đầu ra TLV.

Phương thức Move() sao chép phần tử hiện tại mà trình đọc TLVUpdater\39 được định vị, sang tác giả TLVUpdater&39;. Ứng dụng sẽ gọi Next() và định vị trình đọc TLVUpdater&39 trên một phần tử trước khi gọi phương thức này. Cũng 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 thực hiện lệnh gọi, thì tất cả thành viên của vùng chứa đó sẽ được sao chép. Nếu trình đọc không nằm 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 TLVUpdater\39; cho đến khi kết thúc bộ đệm TLV đầu vào.

Phương thức này hỗ trợ di chuyển mọi thứ từ điểm đọc hiện tại TLVUpdater\39 cho đến khi vùng đệm trình đọc kết thúc sang trình ghi của TLVUpdater&39;

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 đầu vào TLV và chuyển trình đọc TLVUpdater#39; 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 cao nhất bên ngoài của phương thức mã hóa TLV, thì lệnh gọi Next() sẽ chuyển đối tượng đó đến phần tử tiếp theo, trên cùng. 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), lệnh gọi Next() sẽ chuyển phần tử đó đến phần tử thành viên tiếp theo của vùng chứa đó.

Vì Next() ràng buộc chuyển động của trình đọc đối với ngữ cảnh vùng chứa hiện tại, nên việc gọi Next() khi trình đọc được định vị trên một phần tử vùng chứa sẽ tiến lên vùng chứa đó, bỏ qua các phần tử thành phần (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ó thêm phần tử nào trong 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
)