bsearch

 

C

Linguagem

Digite apoio

Gerenciamento de memória dinâmica

De tratamento de erros

Utilidades do programa

Utilitários de data e hora

Biblioteca cordas

Algoritmos

Numéricos

Entrada / saída de apoio

Suporte de localização

Apoio discussão(C11)

Operações atômicas(C11)

 

Algoritmos

qsort

bsearch

 

Definido no cabeçalho <stdlib.h>
void* bsearch(constvoid* key, constvoid* ptr, size_t count, size_t size,                int(*comp)(constvoid*, constvoid*));

Localiza um elemento igual ao elemento apontado por key em uma matriz apontada por ptr. A matriz contém elementos count de size tamanho. Função apontada pelo comp é usado para comparação de objetos.

Original:

Finds an element equal to element pointed to by key in an array pointed to by ptr. The array contains count elements of size size. Function pointed to by comp is used for object comparison.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Parâmetros

key	-	ponteiro para o elemento para pesquisar Original: pointer to the element to search for The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
ptr	-	ponteiro para a matriz para examinar Original: pointer to the array to examine The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
count	-	número de elementos na matriz Original: number of element in the array The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
size	-	tamanho de cada elemento na matriz em bytes Original: size of each element in the array in bytes The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions.
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. key is passed as the first argument, an element from the array as the second. The signature of the comparison function should be equivalent to the following:  int cmp(constvoid*a, constvoid*b); The function must not modify the objects passed to it. ​

Valor de retorno

ponteiro para o elemento encontrado ou de outro modo.. NULL

Original:

pointer to the found element or NULL otherwise.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Exemplo

#include <stdlib.h>#include <stdio.h>   struct data {int nr;charconst*value;} dat[]={{1, "Foo"}, {2, "Bar"}, {3, "Hello"}, {4, "World"}};   int data_cmp(voidconst*lhs, voidconst*rhs){struct data const*const l = lhs;struct data const*const r = rhs;return l->nr < r->nr;}   int main(void){struct data key ={ .nr=3};struct data const*res = bsearch(&key, dat, sizeof(dat)/sizeof(dat[0]), sizeof(dat[0]), data_cmp);if(!res){printf("No %d not found\n", key.nr);}else{printf("No %d: %s\n", res->nr, res->value);}}

Saída:

No 3: Hello

Veja também

qsort	Classifica um intervalo de elementos de tipo não especificado Original: sorts a range of elements with unspecified type The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função)
C++ documentation for bsearch