_memicmp, _memicmp_l

Artículo
02/19/2013

Compara los caracteres de dos búferes (sin distinción entre mayúsculas y 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
primer búfer.
buf2
Segundo búfer.
count
número de caracteres.
locale
configuración regional a utilizar.

Valor devuelto

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

Valor devuelto	Relación de los primeros bytes del número de buf1 y de buf2
< 0	buf1 menos que buf2.
0	buf1 idéntico a buf2.
> 0	buf1 es mayor que buf2.
_NLSCMPERROR	Se ha producido un error.

Comentarios

La función de _memicmp compara los primeros caracteres de count de los dos búferes buf1 y de byte buf2 por byte.La comparación no distingue entre mayúsculas y minúsculas.

Si buf1 o buf2 es un puntero NULL, esta función invoca un controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, la función devuelve _NLSCMPERROR y establece errno a EINVAL.

_memicmp utiliza la configuración regional actual para el comportamiento configuración; dependientes _memicmp_l es idéntico pero utiliza la configuración regional pasado en su lugar.Para obtener más información, vea Configuración regional.

Requisitos

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

Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.

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