LSEARCH

Section: Manual del Programador de Linux (3)
Updated: 27 septiembre 1999
Index Return to Main Contents

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

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

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

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

Index

NOMBRE

SINOPSIS

DESCRIPCIÓN

VALOR REGRESADO

VÉASE TAMBIÉN

This document was created by man2html, using the manual pages.
Time: 06:16:22 GMT, January 22, 2005