LSEARCH(3)

NOME
lfind, lsearch - pesquisa linear em uma matriz

SINÓPSE
#include <search.h>

void *lfind(const void *chave, const void *base, size_t *nmemb,
    size_t tam, int (*compar)(const void *, const void *));

void *lsearch(const void *chave, void *base, size_t *nmemb,
    size_t tam, int (*compar)(const void *, const void *));

DESCRIÇÃO
lfind() e lsearch() executam uma pesquisa linear por chave na matriz base que contém *nmemb elementos de tamanho de tam bytes cada. Espera-se que a função de comparação referenciada por compar tenha dois argumentos apontando para o objeto chave e para um membro da matriz, nessa ordem, e que retorne zero se o objeto chave corresponda ao membro da matriz (e, caso contrário, que retorne algo diferente de zero).

Se lsearch() não encontrar um elemento correspondente, então objeto chave será inserido no fim da tabela, e *nmemb será incrementado.

VALORES RETORNADOS
lfind() retorna um ponteiro a um membro correspondente da matriz, ou NULL se nenhuma corrspondência for encontrada. lsearch() retorna um ponteiro a um membro da matriz que corresponda, ou ao novo membro adicionado se nenhuma correspondência for encontrada.

VEJA TAMBÉM
bsearch(3), hsearch(3), tsearch(3).

TRADUZIDO POR LDP-BR em 30/05/2001.

  Tradução:
E. A. Tacão <tacao@conectiva.com.br>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>