bSearch
Executa um binário Pesquisar de uma matriz classificada.Uma versão mais segura desta função está disponível; consulte bsearch_s.
void *bsearch(
const void *key,
const void *base,
size_t num,
size_t width,
int ( __cdecl *compare ) (const void *, const void *)
);
key
Objeto para pesquisar.base
Ponteiro para a base de dados de Pesquisar.num
Número de elementos.width
Largura dos elementos.compare
Função de retorno de chamada que compara dois elementos.A primeira é um ponteiro para a chave para a Pesquisar e a segunda é um ponteiro para o elemento de matriz a ser comparada com a tecla.
bsearch Retorna um ponteiro para uma ocorrência da key na matriz apontada por base. If key não for encontrado, a função retornará NULL. Se o array não está na ordem de classificar crescente ou contém registros duplicados com chaves idênticas, o resultado é imprevisível.
The bsearch função realiza uma Pesquisar binária de uma matriz classificada de num elementos, cada um dos width bytes de dimensionar. The base valor é um ponteiro para a base da matriz a ser pesquisada e key é o valor procurado. The compare parâmetro é um ponteiro para uma rotina fornecido pelo usuário que compara a chave solicitada a um elemento de matriz e retorna um dos seguintes valores especificando seu Relação:
Valor retornado por compare rotina |
Descrição |
---|---|
< 0 |
Chave é menor que o elemento de matriz. |
0 |
Chave é igual a elemento da matriz. |
> 0 |
Chave é maior do que o elemento de matriz. |
Esta função valida os parâmetros.If compare, key ou num é NULL, ou se base é NULL e *num é diferente de zero, ou se width é zero, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. If execution is allowed to continue, errno is set to EINVAL and the function returns NULL.
Rotina |
Cabeçalho necessário |
---|---|
bsearch |
<stdlib.h> e <Pesquisar.h> |
Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.
Este programa classifica uma matriz de seqüência de caracteres com qsort e, em seguida, 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