_memicmp, _memicmp_l

Compara os caracteres nos dois buffers (diferencia maiúsculas de 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
    Código de idioma.

Valor de retorno

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

Valor de Retorno

Relação dos primeiros bytes de contagem de buf1 e buf2

< 0

buf1menos de buf2.

0

buf1idêntico ao buf2.

> 0

buf1maior que buf2.

_NLSCMPERROR

Ocorreu um erro.

Comentários

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

Se qualquer um dos buf1 ou buf2 é um ponteiro nulo, essa função chama um manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, a função retornará _NLSCMPERROR e define errno para EINVAL.

_memicmpusa a localidade atual para um comportamento depende da localidade; _memicmp_lé idêntica, exceto que ele usa a localidade passada em vez disso.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 de 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" );
}
  

Equivalência do .NET Framework

Não aplicável. Para chamar a função c padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

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