سلسلة أدوات

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

ملخّص

الاستخدام:

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

 OT_FALL_THROUGH do                  \
    {                   \
    } while (false) /* fallthrough */

يحدث إيقاف بسبب ظهور تحذير في برنامج تحويل صوتي محدّد.

OT_MUST_USE_RESULT

 OT_MUST_USE_RESULT

إشارة خاصة ببرنامج التجميع إلى أنه يجب استخدام فئة أو تعداد عندما تكون القيمة المعروضة لدالة ما.

OT_TOOL_PACKED_BEGIN

 OT_TOOL_PACKED_BEGIN

إشارة خاصة ببرنامج التجميع إلى أنّ الفئة أو البنية يجب أن تكون مُعبّأة بالبايت.

OT_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_TOOL_WEAK

 OT_TOOL_WEAK

معدِّل الرموز الضعيفة الخاص بمطوّر البرامج

OT_UNREACHABLE_CODE

 OT_UNREACHABLE_CODE CODE

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

OT_UNUSED_VARIABLE

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

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

المراجِع

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