Udostępnij za pośrednictwem

_memicmp, _memicmp_l

  • Artykuł

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

Składnia

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

Parametry

buffer1
Pierwszy bufor.

buffer2
Drugi bufor.

count
Liczba znaków.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

Wartość zwracana wskazuje relację między.

Wartość zwracana Relacja pierwszych bajtów zliczanych buf1 i buf2
< 0 buffer1 mniejsze niż buffer2.
0 buffer1 identyczne z buffer2.
> 0 buffer1 większe niż buffer2.
_NLSCMPERROR Wystąpił błąd.

Uwagi

Funkcja _memicmp porównuje pierwsze count znaki dwóch buffer1 i buffer2 bajtów bajtów bajtów. Porównanie nie uwzględnia wielkości liter.

Jeśli element buffer1 lub buffer2 jest wskaźnikiem o wartości null, ta funkcja wywołuje nieprawidłową procedurę obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonywanie jest dozwolone do kontynuowania, funkcja zwraca _NLSCMPERROR i ustawia wartość errno EINVAL.

_memicmp używa bieżących ustawień regionalnych dla zachowania zależnego od ustawień regionalnych; _memicmp_l jest identyczna, z tą różnicą, że używa ustawień regionalnych przekazanych w zamian. Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Wymagania

Procedura Wymagany nagłówek
_memicmp <memory.h> lub <string.h>
_memicmp_l <memory.h> lub <string.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

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

Compare 'Those Who Will Not Learn from' to 'THOSE WHO WILL NOT LEARN FROM'
First is equal to second.

Zobacz też

Manipulowanie buforem
_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