lsearch(3)

الاسم
lfind, lsearch - بحث خطي في مصفوفة

المكتبة
مكتبة سي المعيارية (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).
الواجهة | السمة | القيمة
lfind()، lsearch() | سلامة الخيوط | MT-Safe

المعايير
POSIX.1-2008.

التاريخ
POSIX.1-2001، SVr4، 4.3BSD. libc-4.6.27.

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

انظر أيضًا
bsearch(3)، hsearch(3)، tsearch(3)

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

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

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