หน้านี้ได้รับการแปลโดย Cloud Translation API

ไม่มี:: สาน:: ทีแอลวี:: TLVUpdater

#include <src/lib/core/WeaveTLV.h>

มีอินเตอร์เฟซอ่าน / เขียนแบบครบวงจรสำหรับการแก้ไข / เพิ่ม / ลบองค์ประกอบใน TLV เข้ารหัส

สรุป

TLVUpdater เป็นสหภาพของTLVReader และTLVWriter วัตถุและมีวิธีการอินเตอร์เฟซสำหรับการแก้ไข / ลบข้อมูลในการเข้ารหัสเช่นเดียวกับการเพิ่มองค์ประกอบใหม่ใน TLV เข้ารหัส TLVUpdater วัตถุเป็นหลักทำหน้าที่เหมือนสองเคอร์เซอร์หนึ่งสำหรับการอ่านการเข้ารหัสที่มีอยู่และอื่น ๆ สำหรับการเขียน (ทั้งสำหรับการคัดลอกมากกว่าข้อมูลที่มีอยู่หรือการเขียนข้อมูลใหม่)

ความหมายที่ TLVUpdater ฟังก์ชั่นวัตถุที่ต้องการของสหภาพที่TLVReader และTLVWriter TLVUpdater วิธีการที่มีความหมายมากขึ้นหรือน้อยที่คล้ายกันเป็นคู่ชื่อในทำนองเดียวกันใน TLVReader / TLVWriter ในกรณีที่มีความแตกต่างในความหมายที่แตกต่างกันที่มีการบันทึกไว้อย่างชัดเจนในส่วนความคิดเห็นของฟังก์ชันใน WeaveTLVUpdater.cpp

หนึ่งหมายเหตุสำคัญโดยเฉพาะอย่างยิ่งเกี่ยวกับ TLVUpdater 's PutBytes () และ PutString () วิธีก็คือว่ามันสามารถออกจากการเข้ารหัสในรัฐเสียหายมีเพียงส่วนหัวขององค์ประกอบที่เขียนเมื่อล้นเกิดขึ้น การประยุกต์ใช้งานสามารถเรียก GetRemainingFreeLength () เพื่อให้แน่ใจว่ามีพื้นที่ว่างประมาณพอที่จะเขียนเข้ารหัส โปรดทราบว่า GetRemainingFreeLength () เท่านั้นที่จะบอกคุณไบต์ใช้ได้ฟรีและมีวิธีการสำหรับการประยุกต์ใช้ที่จะรู้ว่าความยาวของข้อมูลการเข้ารหัสที่ได้รับการเขียนไม่มี ในกรณีโอเวอร์โฟลว์ ทั้ง PutBytes() และ PutString() จะส่งกลับ WEAVE_ERROR_BUFFER_TOO_SMALL ให้กับผู้โทร

นอกจากนี้ทราบว่า ถัดไป () วิธีการมากเกินไปทั้งข้ามองค์ประกอบปัจจุบันและความก้าวหน้าของผู้อ่านภายในองค์ประกอบถัดไป เพราะข้ามองค์ประกอบที่เข้ารหัสแล้วต้องเปลี่ยนสถานะตัวแปรพื้นที่ว่างนักเขียนภายในไปยังบัญชีสำหรับพื้นที่อิสระใหม่ (ทำใช้ได้โดยการกระโดดข้าม) แอพลิเคชันที่คาดว่าจะเรียก ถัดไป () ในการอัพเดทหลังจากที่ได้รับ () วิธีการที่มีค่ามัน doesn ไม่ต้องการเขียนกลับ (ซึ่งเทียบเท่ากับการข้ามองค์ประกอบปัจจุบัน)

งานสาธารณะ
`CopyElement (TLVReader & reader)`	`WEAVE_ERROR`
`CopyElement (uint64_t tag,TLVReader & reader)`	`WEAVE_ERROR`
`DupBytes (uint8_t *& buf, uint32_t & dataLen)`	`WEAVE_ERROR`
`DupString (char *& buf)`	`WEAVE_ERROR`
`EndContainer ( TLVType outerContainerType)`	`WEAVE_ERROR`
`EnterContainer ( TLVType & outerContainerType)`	`WEAVE_ERROR` เตรียม TLVUpdater วัตถุสำหรับการอ่านองค์ประกอบของภาชนะ
`ExitContainer ( TLVType outerContainerType)`	`WEAVE_ERROR` เสร็จสิ้นการอ่านที่ TLV องค์ประกอบภาชนะและถอดรหัสท้ายของ TLV องค์ประกอบในการส่งออก TLV
`Finalize (void)`	`WEAVE_ERROR`
`Get (bool & v)`	`WEAVE_ERROR`
`Get (int8_t & v)`	`WEAVE_ERROR`
`Get (int16_t & v)`	`WEAVE_ERROR`
`Get (int32_t & v)`	`WEAVE_ERROR`
`Get (int64_t & v)`	`WEAVE_ERROR`
`Get (uint8_t & v)`	`WEAVE_ERROR`
`Get (uint16_t & v)`	`WEAVE_ERROR`
`Get (uint32_t & v)`	`WEAVE_ERROR`
`Get (uint64_t & v)`	`WEAVE_ERROR`
`Get (float & v)`	`WEAVE_ERROR`
`Get (double & v)`	`WEAVE_ERROR`
`GetBytes (uint8_t *buf, uint32_t bufSize)`	`WEAVE_ERROR`
`GetContainerType (void) const`	`TLVType`
`GetDataPtr (const uint8_t *& data)`	`WEAVE_ERROR`
`GetImplicitProfileId (void)`	`uint32_t`
`GetLength (void) const`	`uint32_t`
`GetLengthRead (void) const`	`uint32_t`
`GetLengthWritten (void)`	`uint32_t`
`GetReader (TLVReader & containerReader)`	`void`
`GetRemainingFreeLength (void)`	`uint32_t`
`GetRemainingLength (void) const`	`uint32_t`
`GetString (char *buf, uint32_t bufSize)`	`WEAVE_ERROR`
`GetTag (void) const`	`uint64_t`
`GetType (void) const`	`TLVType`
`Init (uint8_t *buf, uint32_t dataLen, uint32_t maxLen)`	`WEAVE_ERROR` เริ่มต้น TLVUpdater วัตถุแก้ไขบัฟเฟอร์เดียว
`Init (TLVReader & aReader, uint32_t freeLen)`	`WEAVE_ERROR` เริ่มต้น TLVUpdater วัตถุโดยใช้TLVReader
`Move (void)`	`WEAVE_ERROR` สำเนาองค์ประกอบปัจจุบันจากการป้อนข้อมูล TLV การส่งออก TLV
`MoveUntilEnd (void)`	`void` ย้ายทุกอย่างจาก TLVUpdater จุดอ่าน 's ปัจจุบันจนถึงสิ้นการป้อนข้อมูล TLV buffer มากกว่าการส่งออก
`Next (void)`	`WEAVE_ERROR` ข้ามองค์ประกอบปัจจุบันและความก้าวหน้าของ TLVUpdater วัตถุองค์ประกอบถัดไปในการป้อนข้อมูล TLV
`Put (uint64_t tag, int8_t v)`	`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)`	`WEAVE_ERROR`
`SetImplicitProfileId (uint32_t profileId)`	`void` ตั้งรหัสส่วนตัวโดยปริยายสำหรับ TLVUpdater วัตถุ
`StartContainer (uint64_t tag, TLVType containerType, TLVType & outerContainerType)`	`WEAVE_ERROR`
`VerifyEndOfContainer (void)`	`WEAVE_ERROR`

งานสาธารณะ

CopyElement

WEAVE_ERROR CopyElement(
  TLVReader & reader
)

CopyElement

WEAVE_ERROR CopyElement(
  uint64_t tag,
  TLVReader & reader
)

DupBytes

WEAVE_ERROR DupBytes(
  uint8_t *& buf,
  uint32_t & dataLen
)

DupString

WEAVE_ERROR DupString(
  char *& buf
)

EndContainer

WEAVE_ERROR EndContainer(
  TLVType outerContainerType
)

EnterContainer

WEAVE_ERROR EnterContainer(
  TLVType & outerContainerType
)

เตรียม TLVUpdater วัตถุสำหรับการอ่านองค์ประกอบของภาชนะ

นอกจากนี้ยัง encodes เริ่มต้นของวัตถุภาชนะในการส่งออก TLV

EnterContainer () วิธีการเตรียมความพร้อมในปัจจุบัน TLVUpdater วัตถุที่จะเริ่มต้นการอ่านองค์ประกอบสมาชิกของ TLV ภาชนะ (โครงสร้างอาร์เรย์หรือเส้นทาง) สำหรับการเรียกร้องให้ทุก EnterContainer () การใช้งานจะต้องทำให้การเรียกร้องที่สอดคล้องกับ ExitContainer ()

เมื่อ EnterContainer () เรียกว่า TLVUpdater ผู้อ่านจะต้องวางอยู่บนองค์ประกอบภาชนะ เมธอดนี้ใช้เป็นอาร์กิวเมนต์ในการอ้างอิงถึงค่า TLVType ซึ่งจะใช้เพื่อบันทึกบริบทของตัวอัปเดตในขณะที่กำลังอ่านคอนเทนเนอร์

เมื่อ EnterContainer () วิธีการผลตอบแทนที่อัพเดทอยู่ในตำแหน่งทันทีก่อนที่จะเป็นสมาชิกคนแรกของภาชนะ ซ้ำแล้วซ้ำอีกเรียก ถัดไป () จะได้เลื่อนอัพเดทผ่านสมาชิกของคอลเลกชันจนจบถึงจุดที่อัพเดทจะกลับ WEAVE_END_OF_TLV

เมื่อใบสมัครได้เสร็จสิ้นการอ่านภาชนะก็สามารถอ่านต่อองค์ประกอบหลังจากภาชนะโดยการเรียก ExitContainer () วิธีการ

รายละเอียด

พารามิเตอร์

[out] outerContainerType

การอ้างอิงถึงค่า TLVType ที่จะได้รับบริบทของตัวอัปเดต

ส่งกลับค่า

`WEAVE_NO_ERROR`	หากวิธีการสำเร็จ
`WEAVE_ERROR_INCORRECT_STATE`	หาก TLVUpdater อ่านจะไม่ได้ตำแหน่งในองค์ประกอบภาชนะ
`other`	รหัสสานหรือแพลตฟอร์มข้อผิดพลาดอื่น ๆ กลับโดย TLVWriter :: StartContainer () หรือ TLVReader :: EnterContainer ()

ทางออกคอนเทนเนอร์

WEAVE_ERROR ExitContainer(
  TLVType outerContainerType
)

เสร็จสิ้นการอ่านที่ TLV องค์ประกอบภาชนะและถอดรหัสท้ายของ TLV องค์ประกอบในการส่งออก TLV

ExitContainer () วิธีการเรียกคืนสถานะของที่ TLVUpdater วัตถุหลังจากที่โทรไป EnterContainer () สำหรับการโทรทุก EnterContainer () การใช้งานจะต้องทำให้การเรียกร้องที่สอดคล้องกับ ExitContainer () ผ่านค่าบริบทส่งกลับโดย EnterContainer () วิธีการ

เมื่อ ExitContainer () ผลตอบแทนที่ TLVUpdater ผู้อ่านอยู่ในตำแหน่งทันทีก่อนองค์ประกอบแรกที่เป็นไปตามภาชนะในการป้อนข้อมูล TLV จากจุดนี้การใช้งานสามารถเรียก ถัดไป () ล่วงหน้าผ่านองค์ประกอบใด ๆ ที่เหลือ

เมื่อ EnterContainer () ได้รับการเรียกการใช้งานสามารถเรียก ExitContainer () ในการอัพเดทที่จุดใด ๆ ในเวลาไม่คำนึงถึงว่าทุกองค์ประกอบในภาชนะพื้นฐานได้รับการอ่าน นอกจากนี้ทราบว่าโทร ExitContainer () ก่อนที่จะอ่านทุกองค์ประกอบในภาชนะที่จะส่งผลในภาชนะที่อัปเดตได้รับการตัดทอนในการส่งออก TLV

หมายเหตุ: การเปลี่ยนแปลงใด ๆ ที่เกิดขึ้นกับการกำหนดค่าของอัพเดทระหว่างสายไปที่ EnterContainer () และ ExitContainer () จะไม่ยกเลิกได้โดยการเรียกร้องให้ ExitContainer () ยกตัวอย่างเช่นการเปลี่ยนแปลงรหัสรายละเอียดโดยปริยาย ( ImplicitProfileId ) จะไม่สามารถย้อนกลับไปเมื่อเดินออกมาจากตู้คอนเทนเนอร์ ดังนั้นจึงเป็นความรับผิดชอบของแอปพลิเคชันในการปรับการกำหนดค่าตามเวลาที่เหมาะสม

รายละเอียด

พารามิเตอร์

[in] outerContainerType

ค่า TLVType ที่ถูกส่งกลับโดย EnterContainer () วิธีการ

ส่งกลับค่า

`WEAVE_NO_ERROR`	หากวิธีการสำเร็จ
`WEAVE_ERROR_TLV_UNDERRUN`	ถ้าพื้นฐาน TLV เข้ารหัสสิ้นสุดลงก่อนกำหนด
`WEAVE_ERROR_INVALID_TLV_ELEMENT`	ถ้าอัพเดทพบข้อที่ไม่ถูกต้องหรือไม่สนับสนุน TLV ประเภทองค์ประกอบ
`WEAVE_ERROR_INVALID_TLV_TAG`	หากอัพเดทพบ TLV แท็กในบริบทที่ไม่ถูกต้อง
`other`	รหัสสานหรือแพลตฟอร์มข้อผิดพลาดอื่น ๆ กลับโดย TLVWriter :: EndContainer () หรือ TLVReader :: ExitContainer ()

จบ

WEAVE_ERROR Finalize(
  void
)

รับ

WEAVE_ERROR Get(
  bool & v
)

รับ

WEAVE_ERROR Get(
  int8_t & v
)

รับ

WEAVE_ERROR Get(
  int16_t & v
)

รับ

WEAVE_ERROR Get(
  int32_t & v
)

รับ

WEAVE_ERROR Get(
  int64_t & v
)

รับ

WEAVE_ERROR Get(
  uint8_t & v
)

รับ

WEAVE_ERROR Get(
  uint16_t & v
)

รับ

WEAVE_ERROR Get(
  uint32_t & v
)

รับ

WEAVE_ERROR Get(
  uint64_t & v
)

รับ

WEAVE_ERROR Get(
  float & v
)

รับ

WEAVE_ERROR Get(
  double & v
)

GetBytes

WEAVE_ERROR GetBytes(
  uint8_t *buf,
  uint32_t bufSize
)

GetContainerType

TLVType GetContainerType(
  void
) const

GetDataPtr

WEAVE_ERROR GetDataPtr(
  const uint8_t *& data
)

GetImplicitProfileId

uint32_t GetImplicitProfileId(
  void
)

GetLength

uint32_t GetLength(
  void
) const

GetLengthRead

uint32_t GetLengthRead(
  void
) const

GetLengthWritten

uint32_t GetLengthWritten(
  void
)

GetReader

void GetReader(
  TLVReader & containerReader
)

GetRemainingFreeLength

uint32_t GetRemainingFreeLength(
  void
)

GetRemainingLength

uint32_t GetRemainingLength(
  void
) const

GetString

WEAVE_ERROR GetString(
  char *buf,
  uint32_t bufSize
)

GetTag

uint64_t GetTag(
  void
) const

GetType

TLVType GetType(
  void
) const

ในนั้น

WEAVE_ERROR Init(
  uint8_t *buf,
  uint32_t dataLen,
  uint32_t maxLen
)

เริ่มต้น TLVUpdater วัตถุแก้ไขบัฟเฟอร์เดียว

เมื่อวันที่เรียกวิธีการนี้ TLV ข้อมูลในบัฟเฟอร์ถูกย้ายไปยังจุดสิ้นสุดของบัฟเฟอร์และเอกชนTLVReader วัตถุจะเริ่มต้นในบัฟเฟอร์สมุนนี้ ส่วนตัวTLVWriter วัตถุยังจะเริ่มต้นบนพื้นที่ว่างที่มีอยู่ที่จุดเริ่มต้น การประยุกต์ใช้งานสามารถใช้ TLVUpdater วัตถุแยก TLV ข้อมูลและการแก้ไข / ลบองค์ประกอบที่มีอยู่หรือเพิ่มองค์ประกอบใหม่ในการเข้ารหัส

รายละเอียด

พารามิเตอร์

`[in] buf`	ตัวชี้ไปยังบัฟเฟอร์ที่มี TLV ข้อมูลที่จะแก้ไข
`[in] dataLen`	ความยาวของ TLV ข้อมูลในบัฟเฟอร์
`[in] maxLen`	ความยาวรวมของบัฟเฟอร์

ส่งกลับค่า

`WEAVE_NO_ERROR`	หากวิธีการสำเร็จ
`WEAVE_ERROR_INVALID_ARGUMENT`	หากที่อยู่บัฟเฟอร์ไม่ถูกต้อง
`WEAVE_ERROR_BUFFER_TOO_SMALL`	หากบัฟเฟอร์มีขนาดเล็กเกินไป

ในนั้น

WEAVE_ERROR Init(
  TLVReader & aReader,
  uint32_t freeLen
)

เริ่มต้น TLVUpdater วัตถุโดยใช้TLVReader

เมื่อวันที่เรียกวิธีการนี้ TLV ข้อมูลในบัฟเฟอร์ชี้ไปตามTLVReader ถูกย้ายจากจุดอ่านในปัจจุบันที่ส่วนท้ายของบัฟเฟอร์ ใหม่ส่วนตัวTLVReader วัตถุจะเริ่มต้นได้อ่านจากตำแหน่งใหม่นี้ในขณะที่ส่วนตัวใหม่TLVWriter วัตถุจะเริ่มต้นที่จะเขียนถึงอิสระขึ้นพื้นที่กันชน

โปรดทราบว่าถ้าTLVReader อยู่ในตำแหน่งที่มีอยู่แล้ว "กับ" องค์ประกอบก็จะได้รับการสนับสนุนออกคนแรกที่จะเริ่มต้นขององค์ประกอบว่า นอกจากนี้ทราบว่าการสนับสนุนออกนี้ทำงานได้ดีกับองค์ประกอบภาชนะเช่นถ้าTLVReader ถูกนำมาใช้แล้วจะเรียก EnterContainer () แล้วมีอะไรที่จะกลับออกไป แต่ถ้าTLVReader เป็นตำแหน่งในองค์ประกอบภาชนะและ EnterContainer () ยังไม่ได้เรียกแล้วTLVReader วัตถุได้รับการสนับสนุนออกไปยังจุดเริ่มต้นของหัวภาชนะ

อินพุตTLVReader วัตถุจะถูกทำลายก่อนที่จะกลับและการประยุกต์ใช้จะต้องไม่ทำให้การใช้งานเดียวกันกับผลตอบแทน

รายละเอียด

พารามิเตอร์

`[in,out] aReader`	อ้างอิงถึงTLVReader วัตถุนั้นจะถูกทำลายก่อนที่จะกลับ
`[in] freeLen`	ความยาวของพื้นที่ว่าง (เป็นไบต์) ที่มีอยู่ในบัฟเฟอร์ข้อมูลที่เข้ารหัสไว้ล่วงหน้า

ส่งกลับค่า

`WEAVE_NO_ERROR`	หากวิธีการสำเร็จ
`WEAVE_ERROR_INVALID_ARGUMENT`	หากที่อยู่บัฟเฟอร์ไม่ถูกต้อง
`WEAVE_ERROR_NOT_IMPLEMENTED`	หากผู้อ่านถูกเตรียมใช้งานบนสายบัฟเฟอร์

ย้าย

WEAVE_ERROR Move(
  void
)

สำเนาองค์ประกอบปัจจุบันจากการป้อนข้อมูล TLV การส่งออก TLV

ย้าย () วิธีการสำเนาองค์ประกอบปัจจุบันซึ่งมีการ TLVUpdater 'ผู้อ่านอยู่ในตำแหน่งเพื่อ TLVUpdater ' s นักเขียน โปรแกรมประยุกต์ที่ควรจะเรียก ถัดไป () และตำแหน่ง TLVUpdater 's อ่านบนองค์ประกอบก่อนที่จะเรียกวิธีการนี้ เช่นเดียวกับ TLVReader :: ถัดไป () วิธีการนี้หากผู้อ่านที่อยู่ในตำแหน่งในองค์ประกอบภาชนะที่เวลาของการโทรที่สมาชิกทุกคนในภาชนะที่จะถูกคัดลอก หากผู้อ่านไม่ได้วางตำแหน่งบนองค์ประกอบใด ๆ จะไม่มีอะไรเปลี่ยนแปลงในการเรียกวิธีนี้

รายละเอียด

ส่งกลับค่า

`WEAVE_NO_ERROR`	หาก TLVUpdater ผู้อ่านอยู่ในตำแหน่งที่ประสบความสำเร็จในองค์ประกอบใหม่
`WEAVE_END_OF_TLV`	หาก TLVUpdater 's อ่านจะชี้ไปยังจุดสิ้นสุดของภาชนะ
`WEAVE_ERROR_INVALID_TLV_ELEMENT`	หากผู้อ่าน TLVIpdater ของไม่ได้วางอยู่บนที่ถูกต้อง TLV องค์ประกอบ
`other`	ส่งกลับรหัสข้อผิดพลาดอื่น ๆ กลับโดย TLVReader :: ข้าม () วิธีการ

MoveUntilEnd

void MoveUntilEnd(
  void
)

ย้ายทุกอย่างจาก TLVUpdater จุดอ่าน 's ปัจจุบันจนถึงสิ้นการป้อนข้อมูล TLV buffer มากกว่าการส่งออก

วิธีการนี้จะสนับสนุนการเคลื่อนย้ายทุกอย่างจาก TLVUpdater จุดอ่านในปัจจุบันจนถึงสิ้นของผู้อ่าน buffer ไป TLVUpdater 's นักเขียน

ต่อไป

WEAVE_ERROR Next(
  void
)

ข้ามองค์ประกอบปัจจุบันและความก้าวหน้าของ TLVUpdater วัตถุองค์ประกอบถัดไปในการป้อนข้อมูล TLV

ถัดไป () วิธีการข้ามองค์ประกอบปัจจุบันในการป้อนข้อมูล TLV และก้าวหน้า TLVUpdater 's ผู้อ่านไปยังองค์ประกอบถัดไปที่อยู่ในบริบทบรรจุเดียวกัน โดยเฉพาะอย่างยิ่งถ้าผู้อ่านที่อยู่ในตำแหน่งในระดับมากที่สุดด้านนอกของ TLV เข้ารหัสเรียก ถัดไป () จะเลื่อนไปยังถัดไปด้านบนองค์ประกอบที่สุด หากผู้อ่านที่อยู่ในตำแหน่งภายใน TLV องค์ประกอบภาชนะ (โครงสร้างอาร์เรย์หรือเส้นทาง) เรียก ถัดไป () จะเลื่อนไปยังองค์ประกอบสมาชิกต่อไปของภาชนะ

ตั้งแต่ ถัดไป () จำกัด การเคลื่อนไหวอ่านบริบทบรรจุปัจจุบันเรียก ถัดไป () เมื่อผู้อ่านอยู่ในตำแหน่งในองค์ประกอบภาชนะที่จะได้เลื่อนมากกว่าภาชนะข้ามองค์ประกอบสมาชิก (และสมาชิกของตู้คอนเทนเนอร์ซ้อนกันใด ๆ ) จนกว่าจะถึงครั้งแรก องค์ประกอบหลังภาชนะ

เมื่อไม่มีองค์ประกอบต่อไปในบริบทการบรรจุโดยเฉพาะ ถัดไป () วิธีการจะกลับ WEAVE_END_OF_TLV ข้อผิดพลาดและตำแหน่งของผู้อ่านจะยังคงไม่เปลี่ยนแปลง

หมายเหตุ: ถัดไป () วิธีโดยปริยายข้ามองค์ประกอบปัจจุบัน ดังนั้น TLVUpdater 's ตัวแปรรัฐนักเขียนภาคเอกชนจะมีการปรับเปลี่ยนไปยังบัญชีสำหรับพื้นที่อิสระใหม่ (ทำใช้ได้โดยการกระโดดข้าม) ซึ่งหมายความว่าโปรแกรมที่คาดว่าจะเรียก ถัดไป () ใน TLVUpdater วัตถุหลังจากที่ได้รับ () มีค่าใบสมัครไม่ได้เขียนกลับ (ซึ่งจาก TLVUpdater มุมมอง 's เทียบเท่ากับการกระโดดข้ามองค์ประกอบนั้น)

หมายเหตุ: การใช้งานที่คาดว่าจะเรียก ถัดไป () เมื่อพวกเขาอยู่ในตอนท้ายของภาชนะและต้องการเพิ่มองค์ประกอบใหม่มี นี่เป็นสิ่งสำคัญอย่างยิ่งในสถานการณ์ที่มีสคีมาตายตัว การใช้งานที่มีการแก้ไขสกีมาและทราบว่าสิ้นภาชนะที่ไม่สามารถเพียงแค่เพิ่มองค์ประกอบใหม่ที่สิ้นสุดเพราะ TLVUpdater รัฐนักเขียนจะไม่ได้สะท้อนให้เห็นถึงพื้นที่ว่างที่ถูกต้องพร้อมใช้งานสำหรับใส่ () การดำเนินงาน ดังนั้นการใช้งานจะต้องเรียก ถัดไป () (และอาจจะยังทดสอบ WEAVE_END_OF_TLV) ก่อนที่จะเพิ่มองค์ประกอบในตอนท้ายของภาชนะ

รายละเอียด

ส่งกลับค่า

`WEAVE_NO_ERROR`	หาก TLVUpdater ผู้อ่านอยู่ในตำแหน่งที่ประสบความสำเร็จในองค์ประกอบใหม่
`other`	ส่งคืนรหัสสานหรือแพลตฟอร์มข้อผิดพลาดกลับโดย TLVReader :: ข้าม () และ TLVReader :: ถัดไป () วิธีการ

พุท

WEAVE_ERROR Put(
  uint64_t tag,
  int8_t v
)

พุท

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
)

พุทบูลีน

l10n-placeholder=56

PutBytes

l10n-placeholder=57

PutNull

l10n-placeholder=58

PutString

l10n-placeholder=59

PutString

l10n-placeholder=60

SetImplicitProfileId

l10n-placeholder=61

ตั้งรหัสส่วนตัวโดยปริยายสำหรับวัตถุ TLVUpdater

วิธีการนี้จะกำหนดรหัสโปรไฟล์โดยปริยายสำหรับวัตถุ TLVUpdater เมื่ออัพเดทจะถูกขอให้เข้ารหัสองค์ประกอบใหม่ถ้า ID รายละเอียดของแท็กที่เกี่ยวข้องกับองค์ประกอบใหม่ตรงกับค่าของ profileId ที่อัพเดทจะเข้ารหัสในรูปแบบแท็กนัยจึงไม่ใส่รหัสโปรไฟล์ในกระบวนการ

รายละเอียด

พารามิเตอร์

[ใน] profileId

รหัสโปรไฟล์ของแท็กที่ควรเข้ารหัสในรูปแบบโดยนัย

StartContainer

l10n-placeholder=62

ตรวจสอบEndOfContainer

l10n-placeholder=63