سلسلة أدوات

تحدد هذه الوحدة طبقة تجريدية لسلسلة الأدوات من خلال وحدات الماكرو.

ملخّص

الاستخدام:

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 للمَعلمة الأولى في طريقة.

التفاصيل
المَعلمات
[in] aFmtIndex
فهرس الوسيطة لسلسلة التنسيق.
[in] aStartIndex
فهرس الوسيطة للوسيطة الأولى المطلوب مقارنتها بسلسلة التنسيق.

الدالة OT_WEAK

 OT_TOOL_WEAK

معدِّل الرمز الضعيف الخاص بالعارض.

رمز_الحدث

 OT_UNREACHABLE_CODE CODE

منع عرض تحذير بشأن الرموز التي لا يمكن الوصول إليها في سلاسل أدوات محدَّدة

الوقت الإضافي_غير المستخدم

 OT_UNUSED_VARIABLE do                               \
    {                                \
        (void)(VARIABLE);            \
    } while (false)

منع التحذير بشأن المتغيّرات غير المستخدَمة في سلاسل أدوات محدَّدة

الموارد

تبدأ مواضيع مراجع واجهة برمجة تطبيقات OpenThread من رمز المصدر، وهو متاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.