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)인지(false)지(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를 호출합니다.

aHandler가 WEAVE_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를 호출합니다.

aHandler가 WEAVE_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를 호출합니다.

aHandler가 WEAVE_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와 다른 경우)