The functions
lsearch(), and
lfind() provide basic linear searching functionality.
base is the pointer to the beginning of an array. The argument
nelp is the current number of elements in the array, where each element is
width bytes long. The
compar argument points to a function which compares its two arguments and returns zero if they are matching, and non-zero otherwise.
The
lsearch() and
lfind() functions return a pointer into the array referenced by
base where
key is located. If
key does not exist,
lfind() will return a null pointer and
lsearch() will add it to the array. When an element is added to the array by
lsearch() the location referenced by the argument
nelp is incremented by one.