Linux repositories inspector
2017-09-15

man-pages-ru

Russian man pages from the Linux Documentation Project

manpages-dev

Manual pages about using GNU/Linux for development

man-pages

Linux kernel and C library user-space interface documentation

ИМЯ

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("\(aq%s\(aq: неизвестный месяц\n", argv[i]);
else
printf("%s: месяц #%d\n", res->name, res->nr);
}
exit(EXIT_SUCCESS); }

СМОТРИТЕ ТАКЖЕ

⇧ Top