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)