Manual del Programador de Linux (3)
27 septiembre 1999
 

NOMBRE

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

SINOPSIS

#include <search.h>
void *lfind(const void *key, const void *base, size_t *nmemb,
<dl><dt><dd>size_t size, int (*compar)(const void *, const void *));
</dl>
void *lsearch(const void *key, void *base, size_t *nmemb,
<dl><dt><dd>size_t size, int (*compar)(const void *, const void *));
</dl>
 

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 REGRESADO

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)

Nuevo comentario