حل المرجع غير المعرّف أثناء الربط

افهم الأسباب المحتملة

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

1. تأكيد مرحلة البناء الفاشلة

اقرأ أول تشخيص ذي صلة والأمر الكامل. يخص الخطأ النحوي أو تعارض الأنواع الترجمة؛ ويخص الرمز الخارجي غير المحلول الربط. سجل الاسم المفقود ووحدة الترجمة التي تشير إليه. اعمل في مجلد مختبر مؤقت يحوي نسخ المصادر الدنيا، وأبق مخرجات الإنتاج دون تعديل.

2. العثور على التعريف المرجعي

ابحث في المصدر عن تعريف الدالة لا نموذجها الأولي أو استدعاءاتها فقط. قارن الاسم وأنواع المعاملات بالترويسة العامة. إذا كان التعريف الوحيد static في ملف .c آخر فقرر هل ينبغي أن يبقى خاصا؛ انشر واجهة خارجية مقصودة بدلا من إزالة static عشوائيا. ضمن الترويسة العامة في المصدر المعرف لكشف التناقضات.

3. تقديم التعريف للربط

لمكون مقسم بين main.c وcounter.c، ترجم المصدرين واربطهما بمشغل المترجم. يفترض الأمر التوضيحي وجود ملفي المختبر وتصريحات متوافقة. إذا جاء التعريف من مكتبة فاتبع تعليمات تضمينها وربطها الرسمية؛ وقد يهم موضع المكتبة للرابط الحساس للترتيب. لا تضمن نص counter.c مباشرة لإخفاء اعتماد بناء مفقود.

cc -std=c17 -Wall -Wextra -Wpedantic main.c counter.c -o lab_counter

4. المقارنة ببرنامج كامل يعمل

يحتوي المثال الضابط أحادي الملف التصريح وتعريفا مطابقا. يفصل مشكلة واجهة اللغة من غياب الملف الكائني. وهو بسيط عمدا: تشترط الدالة current أقل من INT_MAX ومؤشر إخراج قابل للكتابة، وتفي main بالشرطين. ينبغي أن يحفظ نقل التصريح إلى ترويسة والتعريف إلى counter.c السلوك عند ربط المصدرين.

#include <stdio.h>

void counter_next(int current, int *out);

void counter_next(int current, int *out)
{
    *out = current + 1;
}

int main(void)
{
    int next = 0;
    counter_next(8, &next);
    printf("next=%d\n", next);
    return 0;
}

next=9

5. فحص الإعداد بعد إصلاح المصدر

إذا وجد التعريف ورُبط فافحص المعمارية ومشغل اللغة ونسخة المكتبة والترجمة الشرطية. تختلف C وC++ في اللغة واصطلاحات الارتباط؛ وليس تحويل ملف C إلى C++ إصلاحا عاما. أعد بناء الملفات الكائنية المتأثرة من المصادر الحالية في المجلد المعزول حتى لا تخفي الآثار القديمة التعارض.

امنع تكرار المشكلة

• ضع التصريحات في ترويسة محمية واحدة وضمنها في المستدعين والتعريفات وتتبع اعتماداتها. سجل مدخلات المصادر والمكتبات في إعداد البناء. ميز المساعدات static الخاصة من الدوال المكشوفة وأبق خيارات المترجم متسقة بين الوحدات.