C 庫函數 - 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 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