nl::Weave::TLV::Utilities

Namespace ini mencakup jenis dan antarmuka utilitas untuk mengelola dan menggunakan Weave TLV.

Ringkasan

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

Fungsi
Count(const TLVReader & aReader, size_t & aCount)
Menghitung jumlah elemen TLV dalam pembaca TLV yang ditentukan, secara turun ke array atau struktur.
Count(const TLVReader & aReader, size_t & aCount, const bool aRecurse)
Menghitung jumlah elemen TLV dalam pembaca TLV yang ditentukan, secara opsional menurun ke array atau struktur.
CountHandler(const TLVReader & aReader, size_t aDepth, void *aContext)
Menambahkan penghitung saat melakukan iterasi melalui data TLV.
Find(const TLVReader & aReader, const uint64_t & aTag, TLVReader & aResult)
Menelusuri tag tertentu dalam pembaca TLV yang disediakan.
Find(const TLVReader & aReader, const uint64_t & aTag, TLVReader & aResult, const bool aRecurse)
Menelusuri tag yang ditentukan dalam pembaca TLV yang disediakan, secara opsional menurun ke array atau struktur.
Find(const TLVReader & aReader, IterateHandler aPredicate, void *aContext, TLVReader & aResult)
Telusuri elemen pertama yang cocok dengan predikat dalam pembaca TLV secara menurun ke array atau struktur.
Find(const TLVReader & aReader, IterateHandler aPredicate, void *aContext, TLVReader & aResult, const bool aRecurse)
Telusuri elemen pertama yang cocok dengan predikat dalam pembaca TLV secara opsional menurun ke array atau struktur.
FindHandler(const TLVReader & aReader, size_t aDepth, void *aContext)
Menelusuri tag tertentu dalam pembaca TLV yang disediakan.
FindPredicateHandler(const TLVReader & aReader, size_t aDepth, void *aContext)
Iterate(TLVReader & aReader, size_t aDepth, IterateHandler aHandler, void *aContext, bool aRecurse)
Lakukan iterasi melalui data TLV yang dirujuk oleh aReader dan panggil aHandler untuk setiap elemen TLV yang dikunjungi dalam konteks aContext.
Iterate(const TLVReader & aReader, IterateHandler aHandler, void *aContext)
Lakukan iterasi melalui data TLV yang dirujuk oleh aReader dan panggil aHandler untuk setiap elemen TLV yang dikunjungi dalam konteks aContext.
Iterate(const TLVReader & aReader, IterateHandler aHandler, void *aContext, const bool aRecurse)
Lakukan iterasi melalui data TLV yang dirujuk oleh aReader dan panggil aHandler untuk setiap elemen TLV yang dikunjungi dalam konteks aContext.

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

Typedef

IterateHandler

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

Fungsi

Jumlah

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

Menghitung jumlah elemen TLV dalam pembaca TLV yang ditentukan, secara turun ke array atau struktur.

Detail
Parameter
[in] aReader
Referensi hanya baca ke pembaca TLV yang digunakan untuk menghitung jumlah elemen TLV.
[in,out] aCount
Referensi ke penyimpanan untuk jumlah yang ditampilkan. Ini diinisialisasi ke nol (0) sebelum penghitungan dan disetel ke jumlah elemen yang dihitung saat berhasil.
Nilai Pengembalian
WEAVE_NO_ERROR
Setelah berhasil.

Jumlah

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

Menghitung jumlah elemen TLV dalam pembaca TLV yang ditentukan, secara opsional menurun ke array atau struktur.

Detail
Parameter
[in] aReader
Referensi hanya baca ke pembaca TLV yang digunakan untuk menghitung jumlah elemen TLV.
[in,out] aCount
Referensi ke penyimpanan untuk jumlah yang ditampilkan. Ini diinisialisasi ke nol (0) sebelum penghitungan dan disetel ke jumlah elemen yang dihitung saat berhasil.
[in] aRecurse
Boolean yang menunjukkan apakah (benar) atau tidak (salah) setiap array atau struktur yang ditemukan harus diturunkan.
Nilai Pengembalian
WEAVE_NO_ERROR
Setelah berhasil.

CountHandler

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

Menambahkan penghitung saat melakukan iterasi melalui data TLV.

Detail
Parameter
[in] aReader
Referensi ke pembaca TLV yang berisi data TLV untuk menghitung jumlah elemen TLV.
[in] aDepth
Kedalaman saat ini ke data TLV.
[in,out] aContext
Pointer ke konteks khusus pengendali yang merupakan pointer ke penyimpanan untuk nilai hitungan.
Nilai Pengembalian
WEAVE_NO_ERROR
Setelah berhasil.
WEAVE_ERROR_INVALID_ARGUMENT
Jika aContext adalah NULL.

Mencari

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

Menelusuri tag tertentu dalam pembaca TLV yang disediakan.

Detail
Parameter
[in] aReader
Referensi hanya baca ke pembaca TLV tempat menemukan tag yang ditentukan.
[in] aTag
Referensi hanya baca ke tag TLV yang perlu ditemukan.
[out] aResult
Referensi ke penyimpanan ke pembaca TLV yang akan diposisikan pada tag yang ditentukan saat berhasil.
Nilai Pengembalian
WEAVE_NO_ERROR
Setelah berhasil.
WEAVE_ERROR_TLV_TAG_NOT_FOUND
Jika tag yang ditentukan aTag tidak ditemukan.

Mencari

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

Menelusuri tag yang ditentukan dalam pembaca TLV yang disediakan, secara opsional menurun ke array atau struktur.

Detail
Parameter
[in] aReader
Referensi hanya baca ke pembaca TLV tempat menemukan tag yang ditentukan.
[in] aTag
Referensi hanya baca ke tag TLV yang perlu ditemukan.
[out] aResult
Referensi ke penyimpanan ke pembaca TLV yang akan diposisikan pada tag yang ditentukan saat berhasil.
[in] aRecurse
Boolean yang menunjukkan apakah (benar) atau tidak (salah) setiap array atau struktur yang ditemukan harus diturunkan.
Nilai Pengembalian
WEAVE_NO_ERROR
Setelah berhasil.
WEAVE_ERROR_TLV_TAG_NOT_FOUND
Jika tag yang ditentukan aTag tidak ditemukan.

Mencari

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

Telusuri elemen pertama yang cocok dengan predikat dalam pembaca TLV secara menurun ke array atau struktur.

aPredicate diterapkan ke setiap elemen TLV yang dikunjungi; aPredicate akan menampilkan WEAVE_ERROR_MAX untuk elemen yang cocok, WEAVE_NO_ERROR untuk elemen yang tidak cocok, dan nilai lain apa pun untuk menghentikan penelusuran.

Detail
Parameter
[in] aReader
Referensi hanya baca ke pembaca TLV tempat menemukan elemen yang cocok dengan predikat.
[in] aPredicate
Predikat yang akan diterapkan ke setiap elemen TLV. Untuk mendukung penggunaan ulang kode, aPredicate memiliki jenis IterateHandler. Nilai hasil aPredicate mengontrol penelusuran: WEAVE_ERROR_MAX menandakan bahwa elemen yang diinginkan telah ditemukan, WEAVE_NO_ERROR menandakan bahwa elemen yang diinginkan tidak ditemukan, dan semua nilai lainnya menandakan bahwa pesan harus dihentikan.
[in] aContext
Pointer opsional ke data konteks yang disediakan pemanggil.
[out] aResult
Referensi ke penyimpanan ke pembaca TLV yang akan diposisikan pada tag yang ditentukan saat berhasil.
Nilai Pengembalian
WEAVE_NO_ERROR
Setelah berhasil.
WEAVE_ERROR_TLV_TAG_NOT_FOUND
Jika aPredicate yang ditentukan tidak menemukan elemen yang ditentukan

Mencari

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

Telusuri elemen pertama yang cocok dengan predikat dalam pembaca TLV secara opsional menurun ke array atau struktur.

aPredicate diterapkan ke setiap elemen TLV yang dikunjungi; aPredicate akan menampilkan WEAVE_ERROR_MAX untuk elemen yang cocok, WEAVE_NO_ERROR untuk elemen yang tidak cocok, dan nilai lain apa pun untuk menghentikan penelusuran.

Detail
Parameter
[in] aReader
Referensi hanya baca ke pembaca TLV tempat menemukan elemen yang cocok dengan predikat.
[in] aPredicate
Predikat yang akan diterapkan ke setiap elemen TLV. Untuk mendukung penggunaan ulang kode, aPredicate memiliki jenis IterateHandler. Nilai hasil aPredicate mengontrol penelusuran: WEAVE_ERROR_MAX menandakan bahwa elemen yang diinginkan telah ditemukan, WEAVE_NO_ERROR menandakan bahwa elemen yang diinginkan tidak ditemukan, dan semua nilai lainnya menandakan bahwa pesan harus dihentikan.
[in] aContext
Pointer opsional ke data konteks yang disediakan pemanggil.
[out] aResult
Referensi ke penyimpanan ke pembaca TLV yang akan diposisikan pada tag yang ditentukan saat berhasil.
[in] aRecurse
Boolean yang menunjukkan apakah (true) atau tidak (false) setiap array atau struktur yang ditemukan harus diturunkan.
Nilai Pengembalian
WEAVE_NO_ERROR
Setelah berhasil.
WEAVE_ERROR_TLV_TAG_NOT_FOUND
Jika aPredicate yang ditentukan tidak menemukan elemen yang ditentukan

FindHandler

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

Menelusuri tag tertentu dalam pembaca TLV yang disediakan.

Detail
Parameter
[in] aReader
Referensi hanya baca ke pembaca TLV tempat menemukan tag yang ditentukan.
[in] aDepth
Kedalaman saat ini ke data TLV.
[in,out] aContext
Pointer ke konteks khusus pengendali.
Nilai Pengembalian
WEAVE_NO_ERROR
Setelah berhasil.
WEAVE_ERROR_INVALID_ARGUMENT
Jika aContext adalah NULL.
WEAVE_ERROR_MAX
Jika tag yang ditentukan ditemukan.

FindPredicateHandler

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

Terus lakukan peningkatan

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

Lakukan iterasi melalui data TLV yang dirujuk oleh aReader dan panggil aHandler untuk setiap elemen TLV yang dikunjungi dalam konteks aContext.

Iterasi dibatalkan jika aHandler menampilkan apa pun selain WEAVE_NO_ERROR

Detail
Parameter
[in] aReader
Referensi ke pembaca TLV yang berisi data TLV yang akan diiterasi.
[in] aDepth
Kedalaman saat ini ke data TLV.
[in] aHandler
Callback yang akan dipanggil untuk elemen TLV saat ini yang sedang dikunjungi.
[in,out] aContext
Pointer opsional ke data konteks yang disediakan pemanggil.
[in] aRecurse
Boolean yang menunjukkan apakah (benar) atau tidak (salah) setiap array atau struktur yang ditemukan harus diturunkan.
Nilai Pengembalian
WEAVE_END_OF_TLV
Pada iterasi yang berhasil ke akhir encoding TLV, atau ke akhir penampung TLV.
The
nilai terakhir yang ditampilkan oleh aHandler, jika berbeda dengan WEAVE_NO_ERROR

Terus lakukan peningkatan

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

Lakukan iterasi melalui data TLV yang dirujuk oleh aReader dan panggil aHandler untuk setiap elemen TLV yang dikunjungi dalam konteks aContext.

Iterasi dibatalkan jika aHandler menampilkan apa pun selain WEAVE_NO_ERROR

Detail
Parameter
[in] aReader
Referensi ke pembaca TLV yang berisi data TLV yang akan diiterasi.
[in] aHandler
Callback yang akan dipanggil untuk elemen TLV saat ini yang sedang dikunjungi.
[in,out] aContext
Pointer opsional ke data konteks yang disediakan pemanggil.
Nilai Pengembalian
WEAVE_END_OF_TLV
Pada iterasi yang berhasil ke akhir encoding TLV, atau ke akhir penampung TLV.
WEAVE_ERROR_INVALID_ARGUMENT
Jika aHandler adalah NULL.
The
nilai terakhir yang ditampilkan oleh aHandler, jika berbeda dengan WEAVE_NO_ERROR

Terus lakukan peningkatan

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

Lakukan iterasi melalui data TLV yang dirujuk oleh aReader dan panggil aHandler untuk setiap elemen TLV yang dikunjungi dalam konteks aContext.

Iterasi dibatalkan jika aHandler menampilkan apa pun selain WEAVE_NO_ERROR

Detail
Parameter
[in] aReader
Referensi ke pembaca TLV yang berisi data TLV yang akan diiterasi.
[in] aHandler
Callback yang akan dipanggil untuk elemen TLV saat ini yang sedang dikunjungi.
[in,out] aContext
Pointer opsional ke data konteks yang disediakan pemanggil.
[in] aRecurse
Boolean yang menunjukkan apakah (benar) atau tidak (salah) setiap array atau struktur yang ditemukan harus diturunkan.
Nilai Pengembalian
WEAVE_END_OF_TLV
Pada iterasi yang berhasil ke akhir encoding TLV, atau ke akhir penampung TLV.
WEAVE_ERROR_INVALID_ARGUMENT
Jika aHandler adalah NULL.
The
nilai terakhir yang ditampilkan oleh aHandler, jika berbeda dengan WEAVE_NO_ERROR