C 库函数 - bsearch()

C 标准库 - <stdlib.h> C 标准库 - <stdlib.h>

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

C 标准库 - <stdlib.h> C 标准库 - <stdlib.h>