_lsearch

Artigo
02/25/2013

Realizar uma pesquisa linear de um valor; adiciona ao final da lista se não for encontrado.Uma versão mais segura desta função está disponível. consulte _lsearch_s.

void *_lsearch(
   const void *key,
   void *base,
   unsigned int *num,
   unsigned int width,
   int (__cdecl *compare)(const void *, const void *) 
);

Parâmetros

key
Para procurar o objeto.
base
Ponteiro para a base de matriz a ser pesquisada.
num
Número de elementos.
width
Largura de cada elemento da matriz.
compare
Ponteiro para a rotina de comparação.O primeiro parâmetro é um ponteiro para a chave para pesquisa.O segundo parâmetro é um ponteiro para um elemento de matriz a ser comparada com a chave.

Valor de retorno

Se a chave for encontrada, _lsearch retorna um ponteiro para o elemento da matriz em base que corresponde a key.Se a chave não for encontrada, _lsearch retorna um ponteiro para o item recentemente adicionado no final da matriz.

Comentários

O _lsearch função realiza uma pesquisa linear para o valor key em uma matriz de num elementos, cada um dos width bytes.Ao contrário do bsearch, _lsearch não requer a matriz a ser classificado.Se key não for encontrado, _lsearch adiciona ao final do array e incrementos num.

O compare argumento é um ponteiro para uma rotina fornecido pelo usuário que compara dois elementos de matriz e retorna um valor especificando seu relacionamento._lsearchchamadas de compare rotina um ou mais vezes durante a pesquisa, passando os ponteiros para dois elementos de matriz em cada chamada.comparedeve comparar os elementos e retornar um diferente de zero (ou seja, os elementos são diferentes) ou 0 (ou seja, os elementos são idênticos).

Esta função valida seus parâmetros.Se compare, key ou num é NULL, ou se base é NULL e *num é diferente de zero, ou se width é menor que zero, o manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, errno for definido como EINVAL e a função retornará NULL.

Requisitos

Rotina	Cabeçalho necessário
_lsearch	<search.h>

Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.

Exemplo

// crt_lsearch.c
#include <search.h>
#include <string.h>
#include <stdio.h>

int compare( const void *arg1, const void *arg2 );

int main(void)
{
   char * wordlist[4] = { "hello", "thanks", "bye" };
                            // leave room to grow...
   int n = 3;
   char **result;
   char *key = "extra";
   int i;

   printf( "wordlist before _lsearch:" );
   for( i=0; i<n; ++i ) printf( " %s", wordlist[i] );
   printf( "\n" );

   result = (char **)_lsearch( &key, wordlist, 
                      &n, sizeof(char *), compare );

   printf( "wordlist after _lsearch:" );
   for( i=0; i<n; ++i ) printf( " %s", wordlist[i] );
   printf( "\n" );
}

int compare(const void *arg1, const void *arg2 )
{
   return( _stricmp( * (char**)arg1, * (char**)arg2 ) );
}