lfind man page on OpenBSD

Man page or keyword search:  
man Server   11362 pages
apropos Keyword Search (all sections)
Output format
OpenBSD logo
[printable version]

LSEARCH(3)		  OpenBSD Programmer's Manual		    LSEARCH(3)

NAME
     lsearch, lfind - linear searching routines

SYNOPSIS
     #include <search.h>

     char *
     lsearch(const void *key, const void *base, size_t *nelp, size_t
     width, int (*compar)(const void *, const void *));

     char *
     lfind(const void *key, const void *base, size_t *nelp, size_t width, int
     (*compar)(const void *, const void *));

DESCRIPTION
     The functions lsearch() and lfind() provide basic linear searching
     functionality.

     base is the pointer to the beginning of an array.	The argument nelp is
     the current number of elements in the array, where each element is width
     bytes long.  The compar function is a comparison routine which is used to
     compare two elements.  It takes two arguments which point to the key
     object and to an array member, in that order, and must return an integer
     less than, equivalent to, or greater than zero if the key object is
     considered, respectively, to be less than, equal to, or greater than the
     array member.

     The lsearch() and lfind() functions return a pointer into the array
     referenced by base where key is located.  If key does not exist, lfind()
     will return a null pointer and lsearch() will add it to the array.	 When
     an element is added to the array by lsearch(), the location referenced by
     the argument nelp is incremented by one.

SEE ALSO
     bsearch(3), db(3)

STANDARDS
     The lsearch() and lfind() functions conform to the IEEE Std 1003.1-2001
     (``POSIX'') and X/Open Portability Guide Issue 4.3 (``XPG4.3'')
     specifications.

OpenBSD 4.9		       February 10, 2009		   OpenBSD 4.9
[top]

List of man pages available for OpenBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net