GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  BSEARCH (3)

NAME

bsearch - binary search of a sorted table

CONTENTS

Library
Synopsis
Description
Return Values
See Also
Standards

LIBRARY


.Lb libc

SYNOPSIS


.In stdlib.h void * bsearch const void *key const void *base size_t nmemb size_t size int (*compar) (const void *, const void *)

DESCRIPTION

The bsearch function searches an array of nmemb objects, the initial member of which is pointed to by base, for a member that matches the object pointed to by key. The size of each member of the array is specified by size.

The contents of the array should be in ascending sorted order according to the comparison function referenced by compar. The compar routine is expected to have two arguments which point to the key object and to an array member, in that order, and should return an integer less than, equal to, or greater than zero if the key object is found, respectively, to be less than, to match, or be greater than the array member. See the int_compare sample function in qsort(3) for a comparison function that is also compatible with bsearch.

RETURN VALUES

The bsearch function returns a pointer to a matching member of the array, or a null pointer if no match is found. If two members compare as equal, which member is matched is unspecified.

SEE ALSO

db(3), lsearch(3), qsort(3)

STANDARDS

The bsearch function conforms to -isoC.
Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.