_memicmp, _memicmp_l

Artigo
06/09/2015

Compara caracteres em dois buffers (sem diferenciação de maiúsculas e minúsculas).

int _memicmp(
   const void *buf1,
   const void *buf2,
   size_t count 
);
int _memicmp_l(
   const void *buf1,
   const void *buf2,
   size_t count,
   _locale_t locale
);

Parâmetros

buf1
Primeiro buffer.
buf2
Segundo buffer.
count
Número de caracteres.
locale
Localidade a ser usada.

Valor de retorno

O valor de retorno indica a relação entre os buffers.

Valor de retorno	Relação de primeiros bytes de contagem de buf1 e de buf2
< 0	buf1 menor que buf2.
0	buf1 idêntico a buf2.
> 0	buf1 maior que buf2.
_NLSCMPERROR	Erro.

Comentários

A função de _memicmp compara os primeiros caracteres de count dos dois buffers buf1 e de buf2 de byte por byte. A comparação não diferencia maiúsculas de minúsculas.

Se buf1 ou buf2 for um ponteiro nulo, essa função invoca um manipulador inválido do parâmetro, conforme descrito em Validação do parâmetro. Se a execução puder continuar, a função retornará _NLSCMPERROR e definirá errno como EINVAL.

_memicmp usa a localidade atual para o comportamento de localidade dependente; _memicmp_l é idêntico exceto que usa a localidade passada por vez. Para obter mais informações, consulte Localidade.

Requisitos

Rotina	Cabeçalho necessário
_memicmp	<memory.h ou> string.h <>
_memicmp_l	<memory.h ou> string.h <>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.

Exemplo

// crt_memicmp.c
// This program uses _memicmp to compare
// the first 29 letters of the strings named first and
// second without regard to the case of the letters.

#include <memory.h>
#include <stdio.h>
#include <string.h>

int main( void )
{
   int result;
   char first[] = "Those Who Will Not Learn from History";
   char second[] = "THOSE WHO WILL NOT LEARN FROM their mistakes";
   // Note that the 29th character is right here ^

   printf( "Compare '%.29s' to '%.29s'\n", first, second );
   result = _memicmp( first, second, 29 );
   if( result < 0 )
      printf( "First is less than second.\n" );
   else if( result == 0 )
      printf( "First is equal to second.\n" );
   else if( result > 0 )
      printf( "First is greater than second.\n" );
}