nl::Weave::TLV::TLVReader

获取当前字节或 UTF8 字符串元素的值。

要确定所需的输入缓冲区大小，请先调用 GetLength() 方法，然后再调用 GetBytes()。

返回 TLVReader 当前正在读取的容器的类型。

GetContainerType() 方法会返回 TLVReader 在其中读取数据的 TLV 容器的类型。如果 TLVReader 定位在 TLV 编码的最外层（即最外层的 TLV 元素之前、之后或之后），该方法将返回 kTLVType_NotSpecified。

返回与当前 TLV 元素关联的控制字节。

理想情况下，没有人需要知道控制字节，只有 TLV 的内部实现才能访问控制字节。然而，访问控制字节对于 TLV调试实用程序（在美观输出 TLV 缓冲区内容时会尝试对标记控制字节进行解码）对于调试目的非常有帮助。

获取指向 TLV 字节或 UTF8 字符串元素的初始编码字节的指针。

此方法会返回一个直接指针，该指针指向底层输入缓冲区内已编码的字符串值。要成功，此方法要求整个字符串值都出现在单个缓冲区中。否则，该方法会返回 WEAVE_ERROR_TLV_UNDERRUN。这使得该方法在从多个不连续的缓冲区读取数据时用途有限。

返回与当前 TLV 元素关联的数据长度。

数据长度仅适用于 UTF8 字符串或字节字符串类型的元素。对于 UTF8 字符串，返回的值是字符串中的字节数，而不是字符数。

返回自该读取器初始化后读取的总字节数。

获取底层输入缓冲区中与读取器当前位置相对应的点。

返回在达到最大读取长度之前可读取的总字节数。

获取当前字节或 UTF8 字符串元素的值（以 Null 终止的字符串）。

要确定所需的输入缓冲区大小，请先调用 GetLength() 方法，然后再调用 GetBytes()。输入缓冲区应至少比字符串长度大一个字节，以容纳空字符。

返回与当前 TLV 元素关联的标记。

GetTag() 返回的值可与标记实用函数（IsProfileTag()、IsContextTag()、ProfileIdFromTag() 等）搭配使用，以确定标记的类型并提取各种标记字段值。

返回当前 TLV 元素的类型。

从其他 TLVReader 对象初始化 TLVReader 对象。

初始化 TLVReader 对象，以从单个输入缓冲区读取数据。

初始化 TLVReader 对象，以从单个 PacketBuffer 读取数据。

解析从缓冲区的起始位置 (buf->DataStart()) 开始，一直到缓冲区中的数据结束（由 buf->Datalen() 表示）或 maxLen 字节完成解析。

初始化 TLVReader 对象，以从一个或多个 PacketBuffers 读取数据。

从初始缓冲区的起始位置 (buf->DataStart()) 开始解析。如果 allowDiscontiguousBuffers 为 true，则读取器会前进到通过其 Next() 指针关联的缓冲区链。解析会一直持续，直到缓冲区链中的所有数据都被耗尽（用 buf->Datalen() 表示）或 maxLen 字节完成解析。

将 TLVReader 对象推进到要读取的下一个 TLV 元素。

Next() 方法将读取器对象放置在位于同一包含上下文的 TLV 编码中的下一个元素上。特别是，如果读取器位于 TLV 编码的最外层，调用 Next() 会将读取器前进到下一个最顶层的元素。如果读取器位于 TLV 容器元素（结构、数组或路径）内，调用 Next() 会将读取器前进到容器的下一个成员元素。

由于 Next() 将读取器的动作限制在当前的包含上下文内，因此，当读取器位于容器元素上时，调用 Next() 会使读取器移到容器之上，并跳过其成员元素（以及任何嵌套容器的成员），直到它到达容器之后的第一个元素。

当特定包含内容上下文中没有其他元素时，Next() 方法将返回 WEAVE_END_OF_TLV 错误，并且 Reader 的位置将保持不变。

将 TLVReader 对象推进到要读取的下一个 TLV 元素，并断言新元素的类型和标记。

Next(TLVType expectedType, uint64_t expectedTag) 方法是一种便捷方法，它的行为与 Next() 相同，但还会验证新 TLV 元素的类型和标记是否与所提供的参数匹配。

初始化新的 TLVReader 对象，用于读取 TLV 容器元素的成员。

OpenContainer() 方法会初始化一个新的 TLVReader 对象，以读取 TLV 容器（结构、数组或路径）的成员元素。调用 OpenContainer() 时，当前的 TLVReader 对象必须放置在要读取的容器元素上。该方法将对新读取器的引用作为其唯一参数，该读取器将初始化为读取容器。此类读取器称为容器读取器，而对 OpenContainer() 调用的读取器称为父级读取器。

当 OpenContainer() 方法返回时，容器读取器将放置在容器的第一个成员之前，且紧邻该元素。对容器读取器调用 Next() 将遍历集合的成员，直到到达结束位置，此时读取器将返回 WEAVE_END_OF_TLV。

当容器读取器处于打开状态时，应用不得对父级读取器进行调用或以其他方式更改它的状态。应用使用完容器读取器后，必须通过对父读取器调用 CloseContainer() 并以参数形式传递容器读取器来将其关闭。应用可以随时关闭容器读取器，无论是否读取底层容器中包含的所有元素。关闭容器读取器后，应用可以继续使用父级读取器。

容器读取器会从父级读取器继承各种配置属性。它们是：

• 隐式个人资料 ID (ImplicitProfileId)
• 应用数据指针 (AppData)
• GetNextBuffer 函数指针

将 TLVReader 对象推进到当前 TLV 元素之后。

Skip() 方法会将读取器对象放置在当前 TLV 元素之后、紧邻该元素的位置，以便在后续调用 Next() 时将读取器推进到下一个元素。与 Next() 一样，如果在调用时将读取器置于容器元素上，则会跳过该容器的成员。如果读取器未放置在任何元素上，其位置将保持不变。

验证 TVLReader 对象是否位于 TLV 容器的末尾。

VerifyEndOfContainer() 方法用于验证当前是否在 TLV 容器中没有其他可供读取的 TLV 元素。这是一种便捷方法，效果相当于调用 Next() 并检查返回值为 WEAVE_END_OF_TLV。

清除 TLVReader 的状态。

此方法用于将读取器定位在第一个 TLV 之前、两个 TLV 之间或最后一个 TLV 之后。

这是一个私有方法，用于从 mControlByte 返回 TLVElementType。

GetElementHeadLength

WEAVE_ERROR GetElementHeadLength(
  uint8_t & elemHeadBytes
) const 

IsContainerOpen

bool IsContainerOpen(
  void
) const 

WEAVE_ERROR ReadData(
  uint8_t *buf,
  uint32_t len
)

WEAVE_ERROR ReadElement(
  void
)

uint64_t ReadTag(
  TLVTagControl tagControl,
  const uint8_t *& p
)

void SetContainerOpen(
  bool aContainerOpen
)

WEAVE_ERROR SkipData(
  void
)

WEAVE_ERROR SkipToEndOfContainer(
  void
)

WEAVE_ERROR VerifyElement(
  void
)

WEAVE_ERROR FailGetNextBuffer(
  TLVReader & reader,
  uintptr_t & bufHandle,
  const uint8_t *& bufStart,
  uint32_t & bufLen
)

WEAVE_ERROR GetNextPacketBuffer(
  TLVReader & reader,
  uintptr_t & bufHandle,
  const uint8_t *& bufStart,
  uint32_t & bufLen
)