bsearch
Executa uma pesquisa binária de uma matriz classificada. Uma versão mais segura dessa função está disponível, confira bsearch_s.
Sintaxe
void *bsearch(
const void *key,
const void *base,
size_t num,
size_t width,
int ( __cdecl *compare ) (const void *key, const void *datum)
);
Parâmetros
key
Ponteiro para a chave a ser pesquisada.
base
Ponteiro para a base dos dados de pesquisa.
number
Número de elementos.
width
Largura de elementos.
compare
Função de retorno de chamada que compara dois elementos. O primeiro é um ponteiro para a chave para a pesquisa e o segundo é um ponteiro para o elemento de matriz a ser comparado com a chave.
Valor retornado
bsearch retorna um ponteiro para uma ocorrência de key na matriz apontada por base. Se key não for encontrado, a função retornará NULL. Se a matriz não estiver em ordem de classificação crescente ou contiver registros duplicados com chaves idênticas, o resultado será imprevisível.
Comentários
A função bsearch realiza uma pesquisa binária de uma matriz classificada de number elementos, cada um com width bytes de tamanho. O valor base é um ponteiro para a base da matriz a ser pesquisada e key é o valor que está sendo procurado. O compare parâmetro é um ponteiro para uma rotina fornecida pelo usuário que compara a chave solicitada a um elemento de matriz. Ela retorna um dos seguintes valores que especificam sua relação:
Valor retornado pela rotina compare |
Descrição |
|---|---|
< 0 |
A chave é menor que o elemento da matriz. |
0 |
A chave é igual ao elemento da matriz. |
> 0 |
A chave é maior que o elemento da matriz. |
Essa função valida seus parâmetros. Se compare, key ou number for NULL, ou se base for NULL e number for diferente de zero, ou se width for zero, a função invocará o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, errno será definido como EINVAL e a função retornará NULL.
Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.
Requisitos
| Rotina | Cabeçalho necessário |
|---|---|
bsearch |
<stdlib.h> e <search.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.
Exemplo
Este programa classifica uma matriz de cadeia de caracteres com qsort e então usa bsearch para localizar a palavra "gato".
// crt_bsearch.c
#include <search.h>
#include <string.h>
#include <stdio.h>
int compare( char **arg1, char **arg2 )
{
/* Compare all of both strings: */
return _strcmpi( *arg1, *arg2 );
}
int main( void )
{
char *arr[] = {"dog", "pig", "horse", "cat", "human", "rat", "cow", "goat"};
char **result;
char *key = "cat";
int i;
/* Sort using Quicksort algorithm: */
qsort( (void *)arr, sizeof(arr)/sizeof(arr[0]), sizeof( char * ), (int (*)(const
void*, const void*))compare );
for( i = 0; i < sizeof(arr)/sizeof(arr[0]); ++i ) /* Output sorted list */
printf( "%s ", arr[i] );
/* Find the word "cat" using a binary search algorithm: */
result = (char **)bsearch( (char *) &key, (char *)arr, sizeof(arr)/sizeof(arr[0]),
sizeof( char * ), (int (*)(const void*, const void*))compare );
if( result )
printf( "\n%s found at %Fp\n", *result, result );
else
printf( "\nCat not found!\n" );
}
cat cow dog goat horse human pig rat
cat found at 002F0F04