.\" -*- coding: UTF-8 -*-
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH AUSEARCH_ADD_ITEM 3 "فبراير 2012" "ريد هات" "واجهة برمجة تطبيقات تدقيق لينكس"
.SH الاسم
ausearch_add_item \- بناء قاعدة بحث
.SH موجز
.nf
\fB#include <auparse.h>\fP
.PP
\fBint ausearch_add_item(auparse_state_t *\fP\fIau\fP\fB, const char *\fP\fIfield\fP\fB, const char *\fP\fIop\fP\fB, const char *\fP\fIvalue\fP\fB, ausearch_rule_t \fP\fIhow\fP\fB);"\fP
.fi

.SH الوصف

تضيف ausearch_add_item شرط بحث واحد إلى تعبير البحث الحالي للتدقيق. يمكن
استخدام شروط البحث لمسح السجلات أو الملفات أو المخازن المؤقتة للعثور على شيء
مهم. قيمة \fIfield\fP هي اسم الحقل الذي سيتم التحقق من \fIvalue\fP لأجله. يصف
المتغير \fIop\fP نوع الفحص الذي سيتم إجراؤه. قيم \fIop\fP القانونية هي:

.RS
.TP 
\fIexists\fP
 فقط تحقق من وجود اسم الحقل
.TP 
\fI=\fP
 حدد اسم الحقل وتحقق من أن القيمة المرتبطة به مساوية للقيمة المعطاة في هذه القاعدة.
.TP 
\fI!=\fP
 حدد اسم الحقل وتحقق من أن القيمة المرتبطة به غير مساوية للقيمة المعطاة في هذه القاعدة.
.RE

تتم مقارنة معامل القيمة بقيمة الحقل غير المفسرة. إذا كنت تحاول المطابقة مع
حقل نوعه AUPARSE_TYPE_ESCAPED، فستحتاج إلى استخدام الدالة
ausearch_add_interpreted_item() بدلاً من ذلك.

تحدد قيمة \fIhow\fP كيف سيؤثر شرط البحث هذا على تعبير البحث الحالي إذا كان
معرفًا بالفعل. القيم الممكنة هي:
.RS
.TP 
\fIAUSEARCH_RULE_CLEAR\fP
امسح تعبير البحث الحالي، إن وجد، واستخدم شرط البحث هذا فقط.
.TP 
\fIAUSEARCH_RULE_OR\fP
إذا كان تعبير البحث \fIE\fP مكونًا بالفعل، استبدله بـ \fB(\fP\fIE\fP\fB || \fP\fIthis_search_condition\fP\fB)\fP.
.TP 
\fIAUSEARCH_RULE_AND\fP
إذا كان تعبير البحث \fIE\fP مكونًا بالفعل، استبدله بـ \fB(\fP\fIE\fP\fB && \fP\fIthis_search_condition\fP\fB)\fP.
.RE

.SH "قيمة الإرجاع"

يُرجع \-1 في حال حدوث خطأ؛ وإلا، يُرجع 0 للنجاح.

.SH "انظر أيضًا"

\fBausearch_add_expression\fP(3), \fBausearch_add_interpreted_item\fP(3),
\fBausearch_add_timestamp_item\fP(3), \fBausearch_add_regex\fP(3),
\fBausearch_set_stop\fP(3), \fBausearch_clear\fP(3), \fBausearch_next_event\fP(3),
\fBausearch_cur_event\fP(3), \fBausearch\-expression\fP(5).

.SH المؤلف
Steve Grubb
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .