_memicmp _memicmp_l

Článek
03/04/2013

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

Vrácená hodnota

Vrácená hodnota označuje vztah mezi vyrovnávací paměti.

Vrácená hodnota	Vztah první počet bajtů, buf1 a buf2
< 0	buf1menší než buf2.
0	buf1shodné s buf2.
> 0	buf1větší než buf2.
_NLSCMPERROR	Došlo k chybě.

Poznámky

_memicmp Funkce porovnává první count znaky dvou vyrovnávacích pamětí buf1 a buf2 bajt po bajtu.Při porovnávání se nerozlišují malá a velká písmena.

Pokud buf1 nebo buf2 je nulový ukazatel funkce spustí obslužnou rutinu neplatný parametr popsaným v Ověření parametrů.Pokud je povoleno spuštění pokračovat, vrátí funkce _NLSCMPERROR a errno na EINVAL.

_memicmppoužívá aktuální národní prostředí pro národní prostředí závislé na chování; _memicmp_lje identické používá místo předaný 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ě v tématu Compatibility v úvodu.

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