C 庫函數– 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 --數組中每個元素的大小,以字節為單位。
- 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