_memicmp, _memicmp_l

Artykuł
02/27/2013

Porównuje znaków w dwóch buforów (bez uwzględniania wielkości liter).

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

Parametry

buf1
Pierwszym buforze.
buf2
Bufor drugiego.
count
Liczba znaków.
locale
Ustawienia regionalne, aby użyć.

Wartość zwracana

Zwracana wartość wskazuje relację między buforów.

Zwracanie wartości	Relacja pierwszych zliczania bajtów buf1 i buf2
< 0	buf1mniej niż buf2.
0	buf1taka sama, jak buf2.
> 0	buf1większa niż buf2.
_NLSCMPERROR	Wystąpił błąd.

Uwagi

_memicmp Funkcja porównuje pierwszą count znaków dwa bufory buf1 i buf2 bajt po bajcie.Porównanie nie jest rozróżniana wielkość liter.

Jeśli albo buf1 lub buf2 jest wskaźnik null, funkcja ta wywołuje funkcję obsługi nieprawidłowy parametr, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie mogą w dalszym ciągu, funkcja zwraca _NLSCMPERROR i ustawia errno do EINVAL.

_memicmpwykorzystuje bieżące ustawienia regionalne dla zachowania zależnego od ustawień regionalnych; _memicmp_ljest identyczny z wyjątkiem, że korzysta z ustawień regionalnych, przekazany w zamian.Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka
_memicmp	<memory.h> lub <string.h>
_memicmp_l	<memory.h> lub <string.h>

Informacji dotyczących zgodności, zobacz zgodności we wprowadzeniu.

Przykład

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