استدعاء دوال C والربط

يوفّر لك @cImport التصريحات، لكن الشيفرة الآلية الفعلية تظل موجودة في مكتبة C التي يجب أن تربطها.

تحتاج معظم استدعاءات C إلى مكتبة C القياسية. أخبر نظام البناء بأن يربط libc لكي تُحل دوال مثل printf وقت الربط.

للتشغيل السريع، مرّر الخيار بنفسك. يربط -lc مكتبة libc عند ترجمة ملف واحد مباشرةً.

بعد الربط، تُستدعى دالة C تمامًا مثل دالة Zig. تكتب c.printf(...) ويتولى Zig التعامل مع اصطلاح الاستدعاء.

يجب تمرير وسائط توافق توقيع C. وتُعد الأنواع الخاطئة خطأً في الترجمة، لأن Zig يعرف النموذج الأولي المترجم.

بالنسبة إلى المكتبات الأخرى، سمّها. يخبر linkSystemLibrary الرابط بإدراج شيء مثل مكتبة الرياضيات.

تصل القيمة المرجعة من دالة C كـ قيمة عادية في Zig من النوع المترجم، وتكون جاهزة للتخزين أو الاختبار.

لا تحتوي C على اتحادات أخطاء، لذلك تظهر حالات الفشل على شكل رموز إرجاع أو errno معيّن. وعليك فحصها يدويًا بطريقة C.

لا يجري Zig أي تحويل صامت لبياناتك. فما تمرره هو ما تستلمه C، مما يحافظ على رخص الاستدعاء وقابليته للتوقع.

في build.zig، تربط إعدادات الربط بالعنصر البرمجي. وتسجل خطوة exe نفسها التي تترجم شيفرتك مكتباتها أيضًا.

يتطلب استدعاء C دائمًا الاستيراد والربط: اجلب التصريحات، ثم تأكد من إتاحة الرموز الفعلية للرابط.

فكّر في ما يجعل دالة C تُحل فعليًا.

تعلّمت أن استدعاء C يحتاج إلى الاستيراد والربط معًا، وبعد ذلك تُستدعى دوال C مثل دوال Zig الأصلية تمامًا. 🎯