_memicmp, _memicmp_l

Článek
06/09/2015

Porovnává znaky ve dvou vyrovnávacích pamětí (velká a malá písmena).

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
První vyrovnávací paměť.
buf2
Druhá vyrovnávací paměť.
count
Počet znaků.
locale
Použité národní prostředí.

Vrácená hodnota

Návratová hodnota označuje vztah mezi vyrovnávacími pamětmi.

Návratová hodnota	Vztah první počítání bajtů, buf1 a buf2
< 0	buf1méně než buf2.
0	buf1shodné s buf2.
> 0	buf1větší než buf2.
_NLSCMPERROR	Vyskytla se chyba.

Poznámky

_memicmp První porovnává funkce count znaky dvou vyrovnávacích pamětí buf1 a buf2 bajt po bajtu.Porovnání nerozlišuje velikost písmen.

Pokud buf1 nebo buf2 je ukazatel s hodnotou null, tato funkce vyvolá obslužnou rutinu neplatný parametr, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, funkce vrátí _NLSCMPERROR a nastaví errno na EINVAL.

_memicmppoužívá aktuální národní prostředí závislé chování; _memicmp_l je totožný s tím rozdílem, že používá místo něho předán národní prostředí.Další informace naleznete v tématu Národní prostředí.

Požadavky

Rutina	Požadované záhlaví
_memicmp	<memory.h> nebo <string.h>
_memicmp_l	<memory.h> nebo <string.h>

Další informace o kompatibilitě naleznete v úvodu tématu Kompatibilita.

Příklad

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