تعداد عناصر TLV را در خواننده TLV مشخصشده میشمارد و بهصورت نزولی در آرایهها یا ساختارها قرار میدهد.
جزئیات
پارامترها
[in] aReader
مرجع فقط خواندنی به خواننده TLV که تعداد عناصر TLV برای آن شمارش میشود.
[in,out] aCount
ارجاعی به فضای ذخیرهسازی برای تعداد برگرداندهشده. این مقدار قبلاز شمارش روی صفر (۰) مقداردهی اولیه میشود و درصورت موفقیت، روی تعداد عناصر شمارششده تنظیم میشود.
تعداد عناصر TLV را در خواننده TLV مشخصشده میشمارد، بهطور اختیاری به آرایهها یا ساختارها نزول میکند.
جزئیات
پارامترها
[in] aReader
مرجع فقط خواندنی به خواننده TLV که تعداد عناصر TLV برای آن شمارش میشود.
[in,out] aCount
ارجاعی به فضای ذخیرهسازی برای تعداد برگرداندهشده. این مقدار قبلاز شمارش روی صفر (۰) مقداردهی اولیه میشود و درصورت موفقیت، روی تعداد عناصر شمارششده تنظیم میشود.
[in] 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 نشان میدهد که عنصر موردنظر پیدا نشده است، و همه مقادیر دیگر نشان میدهند که جستجو باید پایان یابد.
[in] aContext
اشارهگر اختیاری به دادههای زمینهای ارائهشده توسط تماسگیرنده.
[out] aResult
ارجاع به فضای ذخیرهسازی برای خواننده TLV که درصورت موفقیتآمیز بودن در برچسب مشخصشده قرار میگیرد.
مقادیر برگشتی
WEAVE_NO_ERROR
درصورت موفقیت.
WEAVE_ERROR_TLV_TAG_NOT_FOUND
اگر aPredicate مشخصشده عنصر مشخصشده را پیدا نکرد
جستجوی اولین عنصر منطبق با گزاره در خواننده 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 نشان میدهد که عنصر موردنظر پیدا نشده است، و همه مقادیر دیگر نشان میدهند که جستجو باید پایان یابد.
[in] aContext
اشارهگر اختیاری به دادههای زمینهای ارائهشده توسط تماسگیرنده.
[out] aResult
ارجاع به فضای ذخیرهسازی برای خواننده TLV که درصورت موفقیتآمیز بودن در برچسب مشخصشده قرار میگیرد.
[in] aRecurse
یک عبارت بولی که نشان میدهد آیا (درست) یا نه (نادرست) هر آرایه یا ساختار مواجهشده باید نزولی باشد.
مقادیر برگشتی
WEAVE_NO_ERROR
درصورت موفقیت.
WEAVE_ERROR_TLV_TAG_NOT_FOUND
اگر aPredicate مشخصشده عنصر مشخصشده را پیدا نکرد
Iterate through the TLV data referenced by aReader and invoke aHandler for each visited TLV element in the context of aContext.
اگر aHandler چیزی غیراز WEAVE_NO_ERROR برگرداند، تکرار لغو میشود
جزئیات
پارامترها
[in] aReader
ارجاع به خواننده TLV حاوی دادههای TLV برای تکرار.
[in] aHandler
یک فراخوانی برگشتی برای فراخوانی عنصر TLV فعلی که بازدید میشود.
[in,out] aContext
اشارهگر اختیاری به دادههای زمینهای ارائهشده توسط تماسگیرنده.
[in] aRecurse
یک عبارت بولی که نشان میدهد آیا (درست) یا نه (نادرست) هر آرایه یا ساختار مواجهشده باید نزولی شود.
مقادیر برگشتی
WEAVE_END_OF_TLV
در تکرار موفقیتآمیز تا پایان کدبندی TLV، یا تا پایان محفظه TLV.
WEAVE_ERROR_INVALID_ARGUMENT
اگر aHandler مقدار NULL داشته باشد.
The
آخرین مقدار برگرداندهشده توسط aHandler، اگر با WEAVE_NO_ERROR متفاوت باشد
جز در مواردی که غیراز این ذکر شده باشد، محتوای این صفحه تحت مجوز پروانه ارجاع مشترکات خلاقانه نسخه ۴.۰ است. نمونه کدها نیز دارای مجوز پروانه آپاچی نسخه ۲.۰ است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است. OpenThread و علائم مربوط به آن، علامتهای تجاری Thread Group هستند و تحت پروانه استفاده میشوند.
تاریخ آخرین بهروزرسانی 2026-10-31 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-10-31 بهوقت ساعت هماهنگ جهانی."],[],[]]