الاسم¶

auparse_init - تهيئة نسخة من مكتبة تحليل التدقيق

موجز¶

#include <auparse.h>

auparse_state_t *auparse_init(ausource_t source, const void *b);

الوصف¶

auparse_init تهيئ نسخة من مكتبة تحليل التدقيق. تُرجع الدالة مؤشرًا معتمًا للحالة الداخلية للمحلل. يُستخدم في الاستدعاءات اللاحقة للمكتبة. يحدد المتغير source أين تبحث المكتبة عن البيانات. القيم القانونية يمكن أن تكون:

	AUSOURCE_LOGS - استخدام سجلات التدقيق (audit logs)
	AUSOURCE_FILE - استخدام ملف واحد
	AUSOURCE_FILE_ARRAY - استخدام عدة ملفات
	AUSOURCE_BUFFER - استخدام مخزن مؤقت (buffer)
	AUSOURCE_BUFFER_ARRAY - استخدام مصفوفة من المخازن المؤقتة
	AUSOURCE_DESCRIPTOR - استخدام واصف (descriptor) محدد
	AUSOURCE_FILE_POINTER - استخدام مؤشر ملف stdio
	AUSOURCE_FEED - تزويد المحلل بالبيانات عبر الدالة auparse_feed()

يُستخدم المؤشر 'b' لتعيين اسم الملف، مصفوفة أسماء الملفات، عنوان الخبيئة، أو مصفوفة من المؤشرات إلى الخبائن، أو رقم الواصف بناءً على المصدر المُعطى. عندما يكون مصدر البيانات مصفوفة من الملفات أو الخبائن، تُنشئ مصفوفة من المؤشرات بحيث يكون آخرها مؤشرًا NULL. يجب أن تكون الخبائن منتهية بـ NUL.

هيكل البيانات المُعاد بواسطة auparse_init ليس آمنًا للخيوط. إذا احتجت استخدامه في برنامج متعدد الخيوط، ستحتاج إضافة تأمين حول أي استخدام لهيكل البيانات.

قيمة الإرجاع¶

تُرجع مؤشرًا NULL إذا حدث خطأ؛ وإلا، فإن القيمة المُعادة هي مؤشر معتم للحالة الداخلية للمحلل.

انظر أيضًا¶

auparse_reset(3)، auparse_destroy(3). auparse_feed(3).

المؤلف¶

Steve Grubb

ترجمة¶

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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