intro(3)

الاسم
intro - مقدمة حول دوال المكتبات

الوصف
يصف القسم 3 من الدليل جميع دوال المكتبة باستثناء وظائف المكتبة (أغلفة استدعاءات النظام) الموصوفة في القسم 2، والتي تُنفذ استدعاءات النظام.

العديد من الدوال الموصوفة في هذا القسم هي جزء من مكتبة C القياسية (libc). وبعض الوظائف جزء من مكتبات أخرى (مثل مكتبة الرياضيات، libm، أو مكتبة الوقت الحقيقي، librt) وفي هذه الحالة ستوضح صفحة الدليل خيار الرابط المطلوب للربط مع المكتبة المطلوبة (مثل -lm و -lrt، على التوالي، للمكتبات المذكورة آنفاً).

في بعض الحالات، يجب على المبرمج تعريف ماكرو لاختبار المزايا من أجل الحصول على تصريح لوظيفة من ملف الترويسة المحدد في قسم موجز بصفحة الدليل. (عند الحاجة، يجب تعريف ماكرو اختبار المزايا هذا قبل تضمين أي ملفات ترويسة.) وفي مثل هذه الحالات، يُوصف الماكرو المطلوب في صفحة الدليل. لمزيد من المعلومات حول ماكرو اختبار المزايا، انظر feature_test_macros(7).

  الأقسام الفرعية
نُظِّم القسم 3 من هذا الدليل إلى أقسام فرعية تعكس الهيكل المعقد لمكتبة C القياسية وتطبيقاتها المتعددة:

•   3const

•   3head

•   3type

هذا التاريخ الصعب غالباً ما يجعلها مثالاً سيئاً يُحتذى به في التصميم، والتنفيذ، والعرض.

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

المعايير
تُستخدم مصطلحات واختصارات معينة للإشارة إلى بدائل ومعايير UNIX التي تتوافق معها الاستدعاءات في هذا القسم. انظر standards(7).

ملاحظات

  المؤلفون وشروط حقوق النشر
انظر فى رأس صفحة الدليل لمعرفة المؤلف(ين) وحقوق النسخ. لأن هذا قد يختلف من واحدة ﻷخرى!

انظر أيضًا
intro(2), errno(3), capabilities(7), credentials(7), environ(7), feature_test_macros(7), libc(7), math_error(7), path_resolution(7), pthreads(7), signal(7), standards(7), system_data_types(7)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.