_lsearch

Executa uma pesquisa linear para um valor e o adicionará ao final da lista se ele não for encontrado. Uma versão mais segura dessa função está disponível, confira _lsearch_s.

Sintaxe

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

Parâmetros

key
O objeto a ser pesquisado.

base
Ponteiro para a base da matriz a ser pesquisada.

number
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 de pesquisa. O segundo parâmetro é um ponteiro para um elemento de matriz a ser comparado com a chave.

Valor retornado

Se a chave for encontrada, _lsearch retornará um ponteiro para o elemento da matriz em base que corresponde a key. Se a chave não for encontrada, _lsearch retornará um ponteiro para o item recém-adicionado no final da matriz.

Comentários

A função _lsearch executa uma pesquisa linear para o valor key em uma matriz de number elementos, cada uma de width bytes. Ao contrário bsearchdo , _lsearch não requer que a matriz seja classificada. Se key não for encontrado, _lsearch adiciona-o ao final da matriz e incrementa number.

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

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 menor que zero, o manipulador de parâmetro inválido será invocado, 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

Para obter informações sobre compatibilidade, consulte Compatibilidade.

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 ) );
}

wordlist before _lsearch: hello thanks bye
wordlist after _lsearch: hello thanks bye extra

Confira também

Pesquisando e classificando
bsearch
_lfind
_lsearch_s