BSEARCH(3)

ИМЯ
bsearch - выполняет двоичный поиск в упорядоченном массиве

ОБЗОР
#include <stdlib.h>

void *bsearch(const void *key, const void *base,
              size_t nmemb, size_t size,
              int (*compar)(const void *, const void *));

ОПИСАНИЕ
Функция bsearch() ищет в массиве размером nmemb ( base указывает на начальный элемент) элемент, который совпадает с элементом, указываемым в key. Размер каждого элемента массива задаётся в size.

Содержимое массива должно быть отсортировано по возрастанию с помощью функции сравнения, на которую ссылается compar. Функция compar принимает два аргумента, один указывает на элемент key, а другой на элемент массива (в таком порядке), и должна возвращать целое, которое меньше, равно или больше нуля, если найденный элемент key меньше, совпадает или больше элемента массива, соответственно.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Функция bsearch() возвращает указатель на совпадающий элемент массива или NULL, если ничего не найдено. Если с ключом совпадает несколько элементов, то какой из них будет возвращён стандартом не определено.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
bsearch() | Безвредность в нитях | MT-Safe

СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD.

ПРИМЕР
В этом примере сначала выполняется сортировка массива структур с помощью qsort(3), а затем возвращается желаемый элемент с помощью bsearch().

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
struct mi {
    int nr;
    char *name;
} months[] = {
    { 1, "jan" }, { 2, "feb" }, { 3, "mar" }, { 4, "apr" },
    { 5, "may" }, { 6, "jun" }, { 7, "jul" }, { 8, "aug" },
    { 9, "sep" }, {10, "oct" }, {11, "nov" }, {12, "dec" }
};
#define nr_of_months (sizeof(months)/sizeof(months[0]))
static int
compmi(const void *m1, const void *m2)
{
    struct mi *mi1 = (struct mi *) m1;
    struct mi *mi2 = (struct mi *) m2;
    return strcmp(mi1->name, mi2->name);
}
int
main(int argc, char **argv)
{
    int i;
    qsort(months, nr_of_months, sizeof(struct mi), compmi);
    for (i = 1; i < argc; i++) {
        struct mi key, *res;
        key.name = argv[i];
        res = bsearch(&key, months, nr_of_months,
                      sizeof(struct mi), compmi);
        if (res == NULL)
            printf("'%s': неизвестный месяц\n", argv[i]);
        else
            printf("%s: месяц #%d\n", res->name, res->nr);
    }
    exit(EXIT_SUCCESS);
}

СМОТРИТЕ ТАКЖЕ
hsearch(3), lsearch(3), qsort(3), tsearch(3)