C语言 <stdlib.h> 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-这是数组中每个元素的大小（以字节为单位）。
  • compare-这是比较两个元素的函数。
• 

  返回值

  此函数返回一个指向数组中与搜索键匹配的条目的指针。如果找不到键，则返回NULL指针。

  示例

  以下示例显示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;
  
     /* using bsearch() to find value 32 in the array */
     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