nl::编织: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()。输入缓冲区应至少比字符串长度多一个字节，以适应 null 字符。

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

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

返回当前 TLV 元素的类型。

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

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

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

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

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

解析从初始缓冲区的起始位置 (buf->DataStart()) 开始。如果 allowDiscontiguousBuffers 为 true，读取器将会完成由其 Next() 指针链接的缓冲区链的后续操作。解析过程会一直持续，直到缓冲区链中的所有数据被消耗（以 buf->Datalen() 表示）或者 maxLen 字节均已解析。

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

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

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

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

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

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

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

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
)