C 语言标准库函数 - bsearch() - C 语言标准库

C 语言标准库 <stdlib.h> 函数 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 所对应的比较函数升序排序。

头文件

#include <stdlib.h>

函数原型

下面是 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() 函数的用法

/**
 * file: main.c
 * author: 简单教程(www.twle.cn)
 *
 * Copyright © 2015-2065 www.twle.cn. All rights reserved.
 */

#include <stdio.h>
#include <stdlib.h>


int cmpfunc(const void * a, const void * b)
{
   return ( *(int*)a - *(int*)b );
}

int values[] = { 7, 17, 29, 37, 61 };

int main ()
{
   int *item;
   int key = 37;

   /* 使用 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);
}

编译运行范例，输出结果如下

$ gcc main.c && ./a.out
Found item = 37