.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1995, James R. Van Zandt <jrv@vanzandt.mv.com>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH lsearch 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
lfind, lsearch \- بحث خطي في مصفوفة
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <search.h>\fP
.P
\fBvoid *lfind(\fPsize_t *n, size_t size;
\fB            const void \fP\fIkey\fP\fB[\fP\fIsize\fP\fB],\fP
\fB            const void \fP\fIbase\fP\fB[*\fP\fIn\fP\fB * \fP\fIsize\fP\fB],\fP
\fB            size_t *\fP\fIn\fP\fB, size_t \fP\fIsize\fP\fB,\fP
\fB            typeof(int (const void [\fP\fIsize\fP\fB], const void [\fP\fIsize\fP\fB]))\fP
\fB                *\fP\fIcompar\fP\fB);\fP
\fBvoid *lsearch(\fPsize_t *n, size_t size;
\fB            const void \fP\fIkey\fP\fB[\fP\fIsize\fP\fB],\fP
\fB            void \fP\fIbase\fP\fB[*\fP\fIn\fP\fB * \fP\fIsize\fP\fB],\fP
\fB            size_t *\fP\fIn\fP\fB, size_t \fP\fIsize\fP\fB,\fP
\fB            typeof(int (const void [\fP\fIsize\fP\fB], const void [\fP\fIsize\fP\fB]))\fP
\fB                *\fP\fIcompar\fP\fB);\fP
.fi
.SH الوصف
تُنفذ الدالتان \fBlfind\fP() و \fBlsearch\fP() بحثًا خطيًا عن \fIkey\fP في المصفوفة
\fIbase\fP التي تحتوي على \fI*n\fP عنصرًا، كل منها بحجم \fIsize\fP بايت. من المتوقع
أن تحتوي دالة المقارنة المشار إليها بواسطة \fIcompar\fP على وسيطين يشيران إلى
كائن \fIkey\fP وعضو المصفوفة، بهذا الترتيب، وتُرجع صفرًا إذا تطابق كائن \fIkey\fP
مع عضو المصفوفة، وقيمة غير صفرية بخلاف ذلك.
.P
إذا لم تعثر \fBlsearch\fP() على عنصر مطابق، فسيُدرج كائن \fIkey\fP في نهاية
الجدول، وتُزاد قيمة \fI*n\fP. على وجه الخصوص، ينبغي معرفة وجود عنصر مطابق، أو
توفر مساحة إضافية.
.SH "قيمة الإرجاع"
تُرجع \fBlfind\fP() مؤشرًا إلى عضو مطابق في المصفوفة، أو NULL إذا لم يُعثر على
تطابق. تُرجع \fBlsearch\fP() مؤشرًا إلى عضو مطابق في المصفوفة، أو إلى العضو
المضاف حديثًا إذا لم يُعثر على تطابق.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBlfind\fP()،
\fBlsearch\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001، SVr4، 4.3BSD. libc\-4.6.27.
.SH العلل
التسمية غير موفقة.
.SH "انظر أيضًا"
\fBbsearch\fP(3)، \fBhsearch\fP(3)، \fBtsearch\fP(3)
.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 .