NOMBRE

       lfind, lsearch - búsqueda lineal en una matriz.

SINOPSIS

       #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 *));

DESCRIPCIÓN

       lfind()  y  lsearch() realizan una búsqueda lineal de key en la matriz base que tiene *nmemb elementos de
       size bytes cada uno. Se espera que la función de comparación a  que  hace  referencia  compar  tenga  dos
       argumentos que apuntan al objeto key y a un miembro de la matriz, en ese orden, y que devuelva cero si el
       objeto key coincide con el miembro de la matriz, y distinto de cero en cualquier otro caso.

       Si  lsearch()  no  encuentra  un elemento coincidente, entonces el objeto key es insertado al final de la
       tabla, y *nmemb es incrementado.

VALOR DEVUELTO

       lfind() devuelve un puntero a un miembro coincidente de la matriz,  o  NULL  si  no  hubo  coincidencias.
       lsearch()  devuelve  un  puntero  a un miembro coincidente de la matriz, o al nuevo miembro añadido si no
       hubo coincidencias.

VÉASE TAMBIÉN

       bsearch(3), hsearch(3), tsearch(3)

GNU                                            27 septiembre 1999                                     LSEARCH(3)