_memicmp, _memicmp_l

Compara los caracteres de dos búferes (distingue entre mayúsculas y minúsculas).

Sintaxis

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
Primer búfer.

buffer2
Segundo búfer.

count
Número de caracteres.

locale
Configuración regional que se va a usar.

Valor devuelto

El valor devuelto indica la relación entre los búferes.

Valor devuelto	Relación de los primeros count bytes de buf1 y buf2
< 0	buffer1 menor que buffer2.
0	buffer1 es idéntica a buffer2.
> 0	buffer1 mayor que buffer2.
_NLSCMPERROR	Se produjo un error.

Comentarios

La función _memicmp compara los primeros count caracteres de los búferes buffer1 y buffer2 byte a byte. La comparación no distingue mayúsculas de minúsculas.

Si o buffer1buffer2 es un puntero nulo, esta función invoca un controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, la función devuelve _NLSCMPERROR y establece en errno en EINVAL.

_memicmp usa la configuración regional actual para cualquier comportamiento dependiente de la configuración regional; _memicmp_l es igual, salvo que en su lugar usa la configuración regional pasada. Para obtener más información, vea Locale.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Routine	Encabezado necesario
_memicmp	<memory.h> o <string.h>
_memicmp_l	<memory.h> o <string.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo

// 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.

Consulte también

Manipulación del búfer
_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