*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Linux man pages -> lsearch (3)              
Title
Content
Arch
Section
 

LSEARCH(3)

Contents


NAME    [Toc]    [Back]

       lfind, lsearch - linear search of an array.

SYNOPSIS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

       lfind() and lsearch() perform a linear search for key in the array base
       which has *nmemb elements of size bytes each.  The comparison  function
       referenced  by  compar is expected to have two arguments which point to
       the key object and to an array member, in that order, and which returns
       zero  if  the  key object matches the array member, and non-zero otherwise.


       If lsearch() does not find a matching element, then the key  object  is
       inserted at the end of the table, and *nmemb is incremented.

RETURN VALUE    [Toc]    [Back]

       lfind() returns a pointer to a matching member of the array, or NULL if
       no match is found.  lsearch() returns a pointer to a matching member of
       the array, or to the newly added member if no match is found.

SEE ALSO    [Toc]    [Back]

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




GNU				  1999-09-27			    LSEARCH(3)
[ Back ]
 Similar pages
Name OS Title
lsearch FreeBSD linear search and append
lfind FreeBSD linear search and append
lsearch IRIX linear search and update
lfind Tru64 Perform a linear search and update
lsearch Tru64 Perform a linear search and update
bsearch Linux binary search of a sorted array.
wmemchr Linux search a wide character in a wide-character array
unpack IRIX Unpacks an array of rank one into an array under control of a mask
devclass_find FreeBSD search for a devclass
wcschr Tru64 Search for the first or last occurrence
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service