سلسلة أدوات
تحدد هذه الوحدة طبقة تجريدية لسلسلة الأدوات من خلال وحدات الماكرو.
ملخّص
الاستخدام:
typedef OT_TOOL_PACKED_BEGIN struct { char mField1; union { char mField2; long mField3; } OT_TOOL_PACKED_FIELD; } OT_TOOL_PACKED_END packed_struct_t;
وحدات ماكرو
OT_APPLE_IGNORE_GNU_FOLDING_CONSTANT
OT_APPLE_IGNORE_GNU_FOLDING_CONSTANT __VA_ARGS__
وقت الاستراحة
OT_FALL_THROUGH do \ { \ } while (false) /* fallthrough */
منع التحذير في محتوى محدّد
الوقت الإضافي_MUST_USE_RESULT
OT_MUST_USE_RESULT
إشارة خاصة بالعارض وهي يجب استخدام فئة أو تعداد عندما تكون هي قيمة العرض لدالة.
OT_TOOL_PACKED_BEGIN
OT_TOOL_PACKED_BEGIN
إشارة خاصة بالعارض وهي فئة أو بنية يجب تعبئتها بالبايت.
OOT_TOOL_PACKED_FIELD
OT_TOOL_PACKED_FIELD
يُرجى الإشارة إلى العارض في بنية مدمجة أو اتحاد ليتم تجميعه داخل فئة أو بنية معبّأة.
OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK
OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK
تحدّد هذه السياسة أنّ الدالة أو الطريقة تأخذ وسيطات نمط printf
ويجب التحقّق منها بسبب سلسلة التنسيق.
يجب إضافته بعد تعريف الدالة/الطريقة. على سبيل المثال:
void MyPrintf(void *aObject, const char *aFormat, ...) OT_TOOL_PRINTF_STYLE_FORMAT_ARG_CHECK(2, 3);
تشير قيمتا فهرس الوسيطة إلى سلسلة التنسيق والوسيطة الأولى للتحقق منها. وتبدأ عند المَعلمة 1 للمَعلمة الأولى في دالة وعند المَعلمة 2 للمَعلمة الأولى في طريقة.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
الدالة OT_WEAK
OT_TOOL_WEAK
معدِّل الرمز الضعيف الخاص بالعارض.
رمز_الحدث
OT_UNREACHABLE_CODE CODE
منع عرض تحذير بشأن الرموز التي لا يمكن الوصول إليها في سلاسل أدوات محدَّدة
الوقت الإضافي_غير المستخدم
OT_UNUSED_VARIABLE do \ { \ (void)(VARIABLE); \ } while (false)
منع التحذير بشأن المتغيّرات غير المستخدَمة في سلاسل أدوات محدَّدة
الموارد
تبدأ مواضيع مراجع واجهة برمجة تطبيقات OpenThread من رمز المصدر، وهو متاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.