icon Top 9 categories map      RocketAware > man pages >


Tips: Browse or Search all pages for efficient awareness of more than 6000 of the most popular reusable and open source applications, functions, libraries, and FAQs.

The "RKT couplings" below include links to source code, updates, additional information, advice, FAQs, and overviews.


Search all pages


By activity
Professions, Sciences, Humanities, Business, ...

User Interface
Text-based, GUI, Audio, Video, Keyboards, Mouse, Images,...

Text Strings
Conversions, tests, processing, manipulation,...

Integer, Floating point, Matrix, Statistics, Boolean, ...

Algorithms, Memory, Process control, Debugging, ...

Stored Data
Data storage, Integrity, Encryption, Compression, ...

Networks, protocols, Interprocess, Remote, Client Server, ...

Hard World
Timing, Calendar and Clock, Audio, Video, Printer, Controls...

File System
Management, Filtering, File & Directory access, Viewers, ...


RocketLink!--> Man page versions: OpenBSD FreeBSD Solaris Others

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

     lsearch, lfind - linear searching routines

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

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

     These interfaces were obsolete before they were written.  They are avail-
     able from the compatibility library, libcompat.

     The functions lsearch(), and lfind() provide basic linear searching func-

     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 ob-
     ject 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 con-
     sidered, respectively, to be less than, equal to, or greater than the ar-
     ray member.

     The lsearch() and lfind() functions return a pointer into the array ref-
     erenced 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.

     bsearch(3),  db(3)

OpenBSD 2.6                      June 4, 1993                                1

Source: OpenBSD 2.6 man pages. Copyright: Portions are copyrighted by BERKELEY
SOFTWARE DESIGN, INC., The Regents of the University of California, Massachusetts
Institute of Technology, Free Software Foundation, FreeBSD Inc., and others.

(Corrections, notes, and links courtesy of RocketAware.com)

[Detailed Topics]
FreeBSD Sources for lsearch(3) functions

[Overview Topics]

Up to: Searching Algorithms - Algorithms for locating an item by searching.

RocketLink!--> Man page versions: OpenBSD FreeBSD Solaris Others

Rapid-Links: Search | About | Comments | Submit Path: RocketAware > man pages > lsearch.3/
RocketAware.com is a service of Mib Software
Copyright 1999, Forrest J. Cavalier III. All Rights Reserved.
We welcome submissions and comments