_memicmp, _memicmp_l
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 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 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 |
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 en errno en EINVAL.
_memicmp utiliza la configuración regional actual para el comportamiento configuración regional-dependiente; _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" );
}
Equivalente en .NET Framework
No es aplicable Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.
Vea también
Referencia
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l