C 库函数 - bsearch()
bsearch 是 C 标准库中的一个函数,用于在有序数组中执行二分查找,它的定义在 stdlib.h 头文件中。
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 nmemb, size_t size, int (*compar)(const void *, const void *));
参数
key
:指向要查找的目标元素的指针。base
:指向数组起始位置的指针。nmemb
:数组中的元素数量。size
:每个元素的大小(以字节为单位)。compar
:指向比较函数的指针,该函数用于比较两个元素。
返回值
- 如果找到了匹配的元素,
bsearch
返回指向该元素的指针。 - 如果没有找到匹配的元素,
bsearch
返回NULL
。
比较函数
比较函数必须符合以下签名:
int compar(const void *a, const void *b);
函数返回:
- 一个负值,如果
a
小于b
。 - 零,如果
a
等于b
。 - 一个正值,如果
a
大于b
。
实例
下面的实例演示了 bsearch() 函数的用法。
实例
#include <stdio.h>
#include <stdlib.h>
// 比较函数,用于 bsearch 查找
int cmpfunc(const void * a, const void * b) {
return (*(int*)a - *(int*)b);
}
int main() {
int values[] = { 5, 20, 29, 32, 63 };
int key = 32;
int *item;
// 计算数组长度
size_t array_size = sizeof(values) / sizeof(values[0]);
// 使用 bsearch 在数组中查找值 32
item = (int*) bsearch(&key, values, array_size, sizeof(int), cmpfunc);
// 检查查找结果并输出
if (item != NULL) {
printf("Found item = %d\n", *item);
} else {
printf("Item = %d could not be found\n", key);
}
return 0;
}
让我们编译并运行上面的程序,这将产生以下结果:
Found item = 32