nl :: Dệt :: TLV :: TLVUpdater

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

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

Khởi tạo đối tượng TLVUpdater bằngTLVReader .

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

Lưu ý rằng nếuTLVReader đã được định vị "trên" một phần tử, thì trước tiên nó sẽ được sao lưu vào đầu phần tử đó. Cũng lưu ý rằng việ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ếuTLVReader đã được sử dụng để gọi EnterContainer () , thì không có gì phải lùi lại. Nhưng nếuTLVReader được định vị trên phần tử vùng chứa và EnterContainer () chưa được gọi, thì đối tượngTLVReader sẽ được lùi vào đầu phần tử vùng chứa.

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

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

Phương thức Move () sao chép phần tử hiện tại mà trình đọc của TLVUpdater được đặt trên đó, tới 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. 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 gọi, tất cả các thành viên của vùng chứa sẽ được sao chép. Nếu trình đọc không được định vị trên bất kỳ phần tử nào, 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 cuối bộ đệm TLV đầu vào sang đầu ra.

Phương pháp này hỗ trợ di chuyển mọi thứ từ điểm đọc hiện tại của TLVUpdater cho đến cuối bộ đệm của trình đọc qua trình ghi của TLVUpdater .

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

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 đến phần tử tiếp theo nằm trong cùng ngữ cảnh chứa. Đặc biệt, nếu trình đọc được đặt ở cấp ngoài cùng của mã hóa TLV , việc gọi Next () sẽ chuyển nó đến phần tử tiếp theo, ở trên cùng. Nếu trình đọc được định vị trong phần tử vùng chứa TLV (cấu trúc, mảng hoặc đường dẫn), việc gọi Next () sẽ chuyển nó đến phần tử thành viên tiếp theo của vùng chứa.

Vì Next () hạn chế chuyển động của trình đọc với ngữ cảnh chứa hiện tại, 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 qua vùng chứa, bỏ qua các phần tử thành viên của nó (và các thành viên của bất kỳ vùng chứa lồng nhau nào) cho đến khi nó đến phần tử đầu tiên phần tử 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
)