_memicmp, _memicmp_l

Confronta i caratteri in due buffer (senza distinzione tra maiuscole e minuscole).

Sintassi

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

Parametri

buffer1
Primo buffer.

buffer2
Secondo buffer.

count
Numero di caratteri.

locale
Impostazioni locali da usare.

Valore restituito

Il valore restituito indica la relazione tra i buffer.

Valore restituito	Relazione dei primi byte corrispondenti al conteggio di buf1 e buf2
< 0	buffer1 minore di buffer2.
0	buffer1 uguale a buffer2.
> 0	buffer1 maggiore di buffer2.
_NLSCMPERROR	Si è verificato un errore.

Osservazioni:

La funzione _memicmp confronta i primi count caratteri dei due buffer buffer1 e buffer2 byte per byte. Il confronto non fa distinzione tra maiuscole e minuscole.

buffer1 Se o buffer2 è un puntatore Null, questa funzione richiama un gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce _NLSCMPERROR e imposta errno su EINVAL.

_memicmp usa le impostazioni locali correnti per qualsiasi comportamento dipendente dalle impostazioni locali. La funzione _memicmp_l è identica, ma usa le impostazioni locali passate. Per altre informazioni, vedere Locale.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Ciclo	Intestazione obbligatoria
_memicmp	<memory.h> o <string.h>
_memicmp_l	<memory.h> o <string.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

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

Vedi anche

Manipolazione del 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