LSEARCH(3)

НАЗВАНИЕ
lfind, lsearch - выполняют линейный поиск в массиве

СИНТАКСИС
#include <search.h>

void *lfind(const void *key, const void *base, size_t *nmemb,
    size_t size, int (*compar)(const void *, const void *));

void *lsearch(const void *key, void *base, size_t *nmemb,
    size_t size, int (*compar)(const void *, const void *));

ОПИСАНИЕ
Функции lfind() и lsearch() выполняют линейный поиск key в массиве base, который имеет *nmemb элементов, каждый по size байт. Функция сравнения, определяемая compar, должна иметь два параметра, которые указывают на объект key и на член массива, в указанном порядке, и который возвращает ноль, если объект key совпадает с членом массива, и ненулевое значение в противном случае.

Если lsearch() не находит совпадающих элементов, то объект key вставляется в конце таблицы и *nmemb увеличивается.

ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
Функцияlfind() возвращает указатель на совпадающий член массива, или NULL, если не было совпадений. Функция lsearch() возвращает указатель на совпадающий член массива, или на добавленный новый член, если не было найдено совпадений.

СМ. ТАКЖЕ
bsearch(3), hsearch(3), tsearch(3)