Compartilhar via

_memicmp, _memicmp_l

  • Artigo

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

Sintaxe

int _memicmp(
   const void *buffer1,
   const void *buffer2,
   size_t count
);
int _memicmp_l(
   const void *buffer1,
   const void *buffer2,
   size_t count,
   _locale_t locale
);

Parâmetros

buffer1
Primeiro buffer.

buffer2
Segundo buffer.

count
Número de caracteres.

locale
Localidade a usar.

Valor retornado

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

Valor retornado Relação dos primeiros count caracteres de buf1 e buf2
< 0 buffer1 é menor que buffer2.
0 buffer1 é idêntica a buffer2.
> 0 buffer1 é maior que buffer2.
_NLSCMPERROR Ocorreu um erro.

Comentários

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

Se for buffer1 buffer2 um ponteiro nulo, essa função invocará um manipulador de parâmetro inválido, conforme descrito em Validação de 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 dependente da localidade, _memicmp_l é idêntico, exceto pelo fato de que ele usa a localidade passada. Para obter mais informações, consulte Localidade.

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
_memicmp <memory.h> ou <string.h>
_memicmp_l <memory.h> ou <string.h>

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

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

Compare 'Those Who Will Not Learn from' to 'THOSE WHO WILL NOT LEARN FROM'
First is equal to second.

Confira também

Manipulação de buffer
_memccpy
memchr, wmemchr
memcmp, wmemcmp
memcpy, wmemcpy
memset, wmemset
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, , _mbsicmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, , _mbsnicmp_l