الاسم

مكتبة سي المعيارية (libc، -lc)

#include <search.h>

void *lfind(size_t *n, size_t size;
            const void key[size],
            const void base[*n * size],
            size_t *n, size_t size,
            typeof(int (const void [size], const void [size]))
                *compar);
void *lsearch(size_t *n, size_t size;
            const void key[size],
            void base[*n * size],
            size_t *n, size_t size,
            typeof(int (const void [size], const void [size]))
                *compar);

تُنفذ الدالتان lfind() و lsearch() بحثًا خطيًا عن key في المصفوفة base التي تحتوي على *n عنصرًا، كل منها بحجم size بايت. من المتوقع أن تحتوي دالة المقارنة المشار إليها بواسطة compar على وسيطين يشيران إلى كائن key وعضو المصفوفة، بهذا الترتيب، وتُرجع صفرًا إذا تطابق كائن key مع عضو المصفوفة، وقيمة غير صفرية بخلاف ذلك.

إذا لم تعثر lsearch() على عنصر مطابق، فسيُدرج كائن key في نهاية الجدول، وتُزاد قيمة *n. على وجه الخصوص، ينبغي معرفة وجود عنصر مطابق، أو توفر مساحة إضافية.

تُرجع lfind() مؤشرًا إلى عضو مطابق في المصفوفة، أو NULL إذا لم يُعثر على تطابق. تُرجع lsearch() مؤشرًا إلى عضو مطابق في المصفوفة، أو إلى العضو المضاف حديثًا إذا لم يُعثر على تطابق.

للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).

POSIX.1-2008.

POSIX.1-2001، SVr4، 4.3BSD. libc-4.6.27.

التسمية غير موفقة.

bsearch(3)، hsearch(3)، tsearch(3)

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

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

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