std::bsearch in C++

07 Aug, 2017
Basics of Binary Search
std::bsearch searches for an element in a sorted array. Finds an element equal to element pointed to by key in an array pointed to by ptr.If the array contains several elements that comp would indicate as equal to the element searched for, then it is unspecified which element the function will return as the result.Syntax :
void* bsearch( const void* key, const void* ptr, std::size_t count,
               std::size_t size, * comp );

Parameters :
key     -    element to be found
ptr     -    pointer to the array to examine
count    -    number of element in the array
size    -    size of each element in the array in bytes
comp    -    comparison function which returns ?a negative integer value if 
             the first argument is less than the second,
             a positive integer value if the first argument is greater than the second
             and zero if the arguments are equal.

Return value :
Pointer to the found element or null pointer if the element has not been found.

Implementing the binary predicate comp :
// Binary predicate which returns 0 if numbers found equalint comp(int* a, int* b){      if (*a < *b)        return -1;      else if (*a > *b)        return 1;      // elements found equal    else        return 0;}
Implementation
// CPP program to implement// std::bsearch#include <bits/stdc++.h>  // Binary predicateint compare(const void* ap, const void* bp){    // Typecasting    const int* a = (int*)ap;    const int* b = (int*)bp;      if (*a < *b)        return -1;    else if (*a > *b)        return 1;    else        return 0;}  // Driver codeint main(){    // Given array    int arr[] = { 1, 2, 3, 4, 5, 6, 7, 8 };      // Size of array    int ARR_SIZE = sizeof(arr) / sizeof(arr[0]);      // Element to be found    int key1 = 4;      // Calling std::bsearch    // Typecasting the returned pointer to int    int* p1 = (int*)std::bsearch(&key1, arr, ARR_SIZE, sizeof(arr[0]), compare);      // If non-zero value is returned, key is found    if (p1)        std::cout << key1 << " found at position " << (p1 - arr) << '\n';    else        std::cout << key1 << " not found\n";      // Element to be found    int key2 = 9;      // Calling std::bsearch    // Typecasting the returned pointer to int    int* p2 = (int*)std::bsearch(&key2, arr, ARR_SIZE, sizeof(arr[0]), compare);      // If non-zero value is returned, key is found    if (p2)        std::cout << key2 << " found at position " << (p2 - arr) << '\n';    else        std::cout << key2 << " not found\n";}
Output:
4 found at position 3
9 not found

Where to use :Binary search can be used on sorted data where a key is to be found. It can be used in cases like computing frequency of a key in a sorted list.
Why Binary Search?Binary search is much more effective than linear search because it halves the search space at each step. This is not significant for our array of length 9. Here, linear search takes at most 9 steps and binary search takes at most 4 steps. But consider an array with 1000 elements, here linear search takes at most 1000 steps, while binary search takes at most 10 steps.For 1 billion elements, binary search will find our key in at most 30 steps.
Related Article: std::binary_searchThis article is contributed by Rohit Thapliyal. If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.
Please write comments if you find anything incorrect, or you want to share more information about the topic discussed above.
cpp-algorithm-library
STL
C++
STL
CPP
Writing code in comment?
Please use ide.geeksforgeeks.org,
generate link and share the link here.
Sorting a vector in C++
Polymorphism in C++
Friend class and function in C++
Pair in C++ Standard Template Library (STL)
std::string class in C++
Queue in C++ Standard Template Library (STL)
Unordered Sets in C++ Standard Template Library
std::find in C++
List in C++ Standard Template Library (STL)
Inline Functions in C++