C 库函数 - bsearch()
描述
C 库函数 void *bsearch(const void *key, const void *base, size_t nitems, size_t size, int (*compar)(const void *, const void *)) 对 nitems 对象的数组执行二分查找，base 指向进行查找的数组，key 指向要查找的元素，size 指定数组中每个元素的大小。
数组的内容应根据 compar 所对应的比较函数升序排序。
声明
下面是 bsearch() 函数的声明。
void *bsearch(const void *key, const void *base, size_t nitems, size_t size, int (*compar)(const void *, const void *))
参数
- key -- 指向要查找的元素的指针，类型转换为 void*。
- base -- 指向进行查找的数组的第一个对象的指针，类型转换为 void*。
- nitems -- base 所指向的数组中元素的个数。
- size -- 数组中每个元素的大小，以字节为单位。
- compar -- 用来比较两个元素的函数。
返回值
如果查找成功，该函数返回一个指向数组中匹配元素的指针，否则返回空指针。.
实例
下面的实例演示了 bsearch() 函数的用法。
#include <stdio.h>
#include <stdlib.h>
int cmpfunc(const void * a, const void * b)
{
return ( *(int*)a - *(int*)b );
}
int values[] = { 5, 20, 29, 32, 63 };
int main ()
{
int *item;
int key = 32;
/* 使用 bsearch() 在数组中查找值 32 */
item = (int*) bsearch (&key, values, 5, sizeof (int), cmpfunc);
if( item != NULL )
{
printf("Found item = %d\n", *item);
}
else
{
printf("Item = %d could not be found\n", *item);
}
return(0);
}
让我们编译并运行上面的程序，这将产生以下结果:
Found item = 32
