nl::Weave::TLV::Utilities

이 네임스페이스에는 Weave TLV를 관리하고 사용하기 위한 유형과 유틸리티 인터페이스가 포함되어 있습니다.

요약

Typedef

IterateHandler)(const TLVReader &aReader, size_t aDepth, void *aContext) typedef

함수

Count(const TLVReader & aReader, size_t & aCount)
지정된 TLV 판독기 내 TLV 요소 수를 셉니다(배열 또는 구조 내림차순).
Count(const TLVReader & aReader, size_t & aCount, const bool aRecurse)
지정된 TLV 판독기 내에서 TLV 요소의 수를 셉니다. 원하는 경우 배열 또는 구조로 내림차순으로 내려갑니다.
CountHandler(const TLVReader & aReader, size_t aDepth, void *aContext)
TLV 데이터를 반복할 때 카운터를 증가시킵니다.
Find(const TLVReader & aReader, const uint64_t & aTag, TLVReader & aResult)
제공된 TLV 리더 내에서 지정된 태그를 검색합니다.
Find(const TLVReader & aReader, const uint64_t & aTag, TLVReader & aResult, const bool aRecurse)
제공된 TLV 리더 내에서 지정된 태그를 검색합니다. 원하는 경우 배열 또는 구조로 내림차순으로 내려갑니다.
Find(const TLVReader & aReader, IterateHandler aPredicate, void *aContext, TLVReader & aResult)
TLV 판독기 내에서 배열 또는 구조로 내림차순 조건자와 일치하는 첫 번째 요소를 검색합니다.
Find(const TLVReader & aReader, IterateHandler aPredicate, void *aContext, TLVReader & aResult, const bool aRecurse)
TLV 판독기 내에서 조건자와 일치하는 첫 번째 요소를 검색합니다(선택적으로 배열 또는 구조로 내림차순).
FindHandler(const TLVReader & aReader, size_t aDepth, void *aContext)
제공된 TLV 리더 내에서 지정된 태그를 검색합니다.
FindPredicateHandler(const TLVReader & aReader, size_t aDepth, void *aContext)
Iterate(TLVReader & aReader, size_t aDepth, IterateHandler aHandler, void *aContext, bool aRecurse)
aReader에서 참조한 TLV 데이터를 반복하고 aContext의 컨텍스트에서 방문한 각 TLV 요소에 대해 aHandler를 호출합니다.
Iterate(const TLVReader & aReader, IterateHandler aHandler, void *aContext)
aReader에서 참조한 TLV 데이터를 반복하고 aContext의 컨텍스트에서 방문한 각 TLV 요소에 대해 aHandler를 호출합니다.
Iterate(const TLVReader & aReader, IterateHandler aHandler, void *aContext, const bool aRecurse)
aReader에서 참조한 TLV 데이터를 반복하고 aContext의 컨텍스트에서 방문한 각 TLV 요소에 대해 aHandler를 호출합니다.

구조체

nl::Weave::TLV::Utilities::FindContext
nl::Weave::TLV::Utilities::FindPredicateContext

Typedef

IterateHandler

WEAVE_ERROR(* IterateHandler)(const TLVReader &aReader, size_t aDepth, void *aContext)

함수

개수

WEAVE_ERROR Count(
  const TLVReader & aReader,
  size_t & aCount
)

지정된 TLV 판독기에서 TLV 요소 수를 셉니다(배열 또는 구조 내림차순).

세부정보
매개변수
[in] aReader
TLV 요소의 수를 계산하는 TLV 판독기에 대한 읽기 전용 참조입니다.
[in,out] aCount
반환된 개수의 스토리지에 대한 참조입니다. 이 값은 계산하기 전에 0으로 초기화되며 성공 시 계산되는 요소 수로 설정됩니다.
반환 값
WEAVE_NO_ERROR
성공 시

개수

WEAVE_ERROR Count(
  const TLVReader & aReader,
  size_t & aCount,
  const bool aRecurse
)

지정된 TLV 판독기 내에서 TLV 요소의 수를 셉니다. 원하는 경우 배열 또는 구조로 내림차순으로 내려갑니다.

세부정보
매개변수
[in] aReader
TLV 요소의 수를 계산하는 TLV 판독기에 대한 읽기 전용 참조입니다.
[in,out] aCount
반환된 개수의 스토리지에 대한 참조입니다. 이 값은 계산하기 전에 0으로 초기화되며 성공 시 계산되는 요소 수로 설정됩니다.
[in] aRecurse
발견된 배열이나 구조체의 하위 요소 (true) 또는 값 (false)을 나타내는 부울입니다.
반환 값
WEAVE_NO_ERROR
성공 시

CountHandler

WEAVE_ERROR CountHandler(
  const TLVReader & aReader,
  size_t aDepth,
  void *aContext
)

TLV 데이터를 반복할 때 카운터를 증가시킵니다.

세부정보
매개변수
[in] aReader
TLV 요소 수를 계산하기 위한 TLV 데이터를 포함하는 TLV 판독기에 대한 참조입니다.
[in] aDepth
TLV 데이터의 현재 깊이입니다.
[in,out] aContext
개수 값의 저장소를 가리키는 포인터인 핸들러별 컨텍스트에 대한 포인터입니다.
반환 값
WEAVE_NO_ERROR
성공 시
WEAVE_ERROR_INVALID_ARGUMENT
aContext가 NULL인 경우

찾기

WEAVE_ERROR Find(
  const TLVReader & aReader,
  const uint64_t & aTag,
  TLVReader & aResult
)

제공된 TLV 리더 내에서 지정된 태그를 검색합니다.

세부정보
매개변수
[in] aReader
지정된 태그를 찾을 TLV 리더의 읽기 전용 참조입니다.
[in] aTag
찾을 TLV 태그에 대한 읽기 전용 참조입니다.
[out] aResult
성공 시 지정된 태그에 배치될 TLV 리더의 저장소에 대한 참조입니다.
반환 값
WEAVE_NO_ERROR
성공 시
WEAVE_ERROR_TLV_TAG_NOT_FOUND
지정된 태그 aTag를 찾을 수 없는 경우

찾기

WEAVE_ERROR Find(
  const TLVReader & aReader,
  const uint64_t & aTag,
  TLVReader & aResult,
  const bool aRecurse
)

제공된 TLV 리더 내에서 지정된 태그를 검색합니다. 원하는 경우 배열 또는 구조로 내림차순으로 내려갑니다.

세부정보
매개변수
[in] aReader
지정된 태그를 찾을 TLV 리더의 읽기 전용 참조입니다.
[in] aTag
찾을 TLV 태그에 대한 읽기 전용 참조입니다.
[out] aResult
성공 시 지정된 태그에 배치될 TLV 리더의 저장소에 대한 참조입니다.
[in] aRecurse
발견된 배열이나 구조체의 하위 요소 (true) 또는 값 (false)을 나타내는 부울입니다.
반환 값
WEAVE_NO_ERROR
성공 시
WEAVE_ERROR_TLV_TAG_NOT_FOUND
지정된 태그 aTag를 찾을 수 없는 경우

찾기

WEAVE_ERROR Find(
  const TLVReader & aReader,
  IterateHandler aPredicate,
  void *aContext,
  TLVReader & aResult
)

TLV 판독기 내에서 배열 또는 구조로 내림차순 조건자와 일치하는 첫 번째 요소를 검색합니다.

aPredicate가 방문한 각 TLV 요소에 적용됩니다. aPredicate는 일치하는 요소에 대해 WEAVE_ERROR_MAX를 반환하고 일치하지 않는 요소에 대해 WEAVE_NO_ERROR를 반환하며 검색을 종료하는 다른 값을 반환합니다.

세부정보
매개변수
[in] aReader
조건자와 일치하는 요소를 찾을 TLV 판독기에 대한 읽기 전용 참조입니다.
[in] aPredicate
TLV 요소에 적용될 조건자입니다. 코드 재사용을 지원하기 위해 aPredicate에는 IterateHandler 유형이 있습니다. aPredicate의 반환 값이 검색을 제어합니다. WEAVE_ERROR_MAX는 원하는 요소가 발견되었음을 알리고 WEAVE_NO_ERROR는 원하는 요소를 찾을 수 없음을 나타내며 다른 모든 값은 saerch를 종료해야 함을 알립니다.
[in] aContext
호출자가 제공한 컨텍스트 데이터에 대한 선택적 포인터입니다.
[out] aResult
성공 시 지정된 태그에 배치될 TLV 리더의 저장소에 대한 참조입니다.
반환 값
WEAVE_NO_ERROR
성공 시
WEAVE_ERROR_TLV_TAG_NOT_FOUND
지정된 aPredicate가 지정된 요소를 찾지 못한 경우

찾기

WEAVE_ERROR Find(
  const TLVReader & aReader,
  IterateHandler aPredicate,
  void *aContext,
  TLVReader & aResult,
  const bool aRecurse
)

TLV 판독기 내에서 조건자와 일치하는 첫 번째 요소를 검색합니다(선택적으로 배열 또는 구조로 내림차순).

aPredicate가 방문한 각 TLV 요소에 적용됩니다. aPredicate는 일치하는 요소에 대해 WEAVE_ERROR_MAX를 반환하고 일치하지 않는 요소에 대해 WEAVE_NO_ERROR를 반환하며 검색을 종료하는 다른 값을 반환합니다.

세부정보
매개변수
[in] aReader
조건자와 일치하는 요소를 찾을 TLV 판독기에 대한 읽기 전용 참조입니다.
[in] aPredicate
TLV 요소에 적용될 조건자입니다. 코드 재사용을 지원하기 위해 aPredicate에는 IterateHandler 유형이 있습니다. aPredicate의 반환 값이 검색을 제어합니다. WEAVE_ERROR_MAX는 원하는 요소가 발견되었음을 알리고 WEAVE_NO_ERROR는 원하는 요소를 찾을 수 없음을 나타내며 다른 모든 값은 saerch를 종료해야 함을 알립니다.
[in] aContext
호출자가 제공한 컨텍스트 데이터에 대한 선택적 포인터입니다.
[out] aResult
성공 시 지정된 태그에 배치될 TLV 리더의 저장소에 대한 참조입니다.
[in] aRecurse
발생한 배열이나 구조체가 하위로 내려가야 하는지 (true) 또는 not (false)을 나타내는 부울입니다.
반환 값
WEAVE_NO_ERROR
성공 시
WEAVE_ERROR_TLV_TAG_NOT_FOUND
지정된 aPredicate가 지정된 요소를 찾지 못한 경우

FindHandler

WEAVE_ERROR FindHandler(
  const TLVReader & aReader,
  size_t aDepth,
  void *aContext
)

제공된 TLV 리더 내에서 지정된 태그를 검색합니다.

세부정보
매개변수
[in] aReader
지정된 태그를 찾을 TLV 리더의 읽기 전용 참조입니다.
[in] aDepth
TLV 데이터의 현재 깊이입니다.
[in,out] aContext
핸들러별 컨텍스트를 가리키는 포인터입니다.
반환 값
WEAVE_NO_ERROR
성공 시
WEAVE_ERROR_INVALID_ARGUMENT
aContext가 NULL인 경우
WEAVE_ERROR_MAX
지정된 태그가 있는 경우

FindPredicateHandler

WEAVE_ERROR FindPredicateHandler(
  const TLVReader & aReader,
  size_t aDepth,
  void *aContext
)

반복

WEAVE_ERROR Iterate(
  TLVReader & aReader,
  size_t aDepth,
  IterateHandler aHandler,
  void *aContext,
  bool aRecurse
)

aReader에서 참조한 TLV 데이터를 반복하고 aContext의 컨텍스트에서 방문한 각 TLV 요소에 대해 aHandler를 호출합니다.

aHandlerWEAVE_NO_ERROR 이외의 값을 반환하면 반복이 취소됩니다.

세부정보
매개변수
[in] aReader
반복할 TLV 데이터를 포함하는 TLV 판독기에 대한 참조입니다.
[in] aDepth
TLV 데이터의 현재 깊이입니다.
[in] aHandler
방문 중인 현재 TLV 요소에 대해 호출할 콜백입니다.
[in,out] aContext
호출자가 제공한 컨텍스트 데이터에 대한 선택적 포인터입니다.
[in] aRecurse
발견된 배열이나 구조체의 하위 요소 (true) 또는 값 (false)을 나타내는 부울입니다.
반환 값
WEAVE_END_OF_TLV
반복에 성공하면 TLV 인코딩의 끝 또는 TLV 컨테이너의 끝까지 반복됩니다.
The
aHandler에 의해 반환된 마지막 값(WEAVE_NO_ERROR와 다른 경우)

반복

WEAVE_ERROR Iterate(
  const TLVReader & aReader,
  IterateHandler aHandler,
  void *aContext
)

aReader에서 참조한 TLV 데이터를 반복하고 aContext의 컨텍스트에서 방문한 각 TLV 요소에 대해 aHandler를 호출합니다.

aHandlerWEAVE_NO_ERROR 이외의 값을 반환하면 반복이 취소됩니다.

세부정보
매개변수
[in] aReader
반복할 TLV 데이터를 포함하는 TLV 판독기에 대한 참조입니다.
[in] aHandler
방문 중인 현재 TLV 요소에 대해 호출할 콜백입니다.
[in,out] aContext
호출자가 제공한 컨텍스트 데이터에 대한 선택적 포인터입니다.
반환 값
WEAVE_END_OF_TLV
반복에 성공하면 TLV 인코딩의 끝 또는 TLV 컨테이너의 끝까지 반복됩니다.
WEAVE_ERROR_INVALID_ARGUMENT
aHandler가 NULL인 경우
The
aHandler에 의해 반환된 마지막 값(WEAVE_NO_ERROR와 다른 경우)

반복

WEAVE_ERROR Iterate(
  const TLVReader & aReader,
  IterateHandler aHandler,
  void *aContext,
  const bool aRecurse
)

aReader에서 참조한 TLV 데이터를 반복하고 aContext의 컨텍스트에서 방문한 각 TLV 요소에 대해 aHandler를 호출합니다.

aHandlerWEAVE_NO_ERROR 이외의 값을 반환하면 반복이 취소됩니다.

세부정보
매개변수
[in] aReader
반복할 TLV 데이터를 포함하는 TLV 판독기에 대한 참조입니다.
[in] aHandler
방문 중인 현재 TLV 요소에 대해 호출할 콜백입니다.
[in,out] aContext
호출자가 제공한 컨텍스트 데이터에 대한 선택적 포인터입니다.
[in] aRecurse
발견된 배열이나 구조체의 하위 요소 (true) 또는 값 (false)을 나타내는 부울입니다.
반환 값
WEAVE_END_OF_TLV
반복에 성공하면 TLV 인코딩의 끝 또는 TLV 컨테이너의 끝까지 반복됩니다.
WEAVE_ERROR_INVALID_ARGUMENT
aHandler가 NULL인 경우
The
aHandler에 의해 반환된 마지막 값(WEAVE_NO_ERROR와 다른 경우)