السمات المعيارية: deprecated وmaybe_unused وnodiscard وfallthrough [[attribute]]

الصياغة

[[deprecated("reason")]] ReturnType func(...);
[[maybe_unused]] Type var;
[[nodiscard]] ReturnType func(...);
case X: stmt; [[fallthrough]];

📄 مثال

#include <stdio.h>

[[nodiscard]] int mustCheck(void) { return 42; }

int main(void) {
    int x = 1;
    switch (x) {
        case 1:
            printf("واحد\n");
            [[fallthrough]];
        case 2:
            printf("أو اثنين\n");
            break;
    }
    int v = mustCheck();   // لو تجاهلت القيمة، المترجم يحذّر
    printf("%d\n", v);
    return 0;
}

أهم النقاط

💡 نصائح عملية

• ضع [[nodiscard]] على دوالك التي تُرجع نتيجة يجب فحصها (مثل نجاح/فشل عملية)
• استخدم [[fallthrough]] بدل ترك تعليق //fallthrough — المترجم يفهمها فعليًا ويتوقف عن التحذير

⚠️ أخطاء شائعة

• افتراض أن هذه السمات تُغيّر سلوك البرنامج وقت التشغيل — هي فقط تلميحات وقت الترجمة
• الاعتماد عليها بمترجم لا يدعم C23 دون فحص التوافق، أو الخلط بينها وبين __attribute__ الخاصة بـ GCC

خصائص ذات صلة