Udostępnij za pośrednictwem


memcmp, wmemcmp

Porównuje znaki w dwóch buforach.

int memcmp( 
   const void *buf1, 
   const void *buf2, 
   size_t count 
); 
int wmemcmp( 
   const wchar_t * buf1, 
   const wchar_t * buf2, 
   size_t count 
);

Parametry

  • buf1
    Bufor pierwszy.

  • buf2
    Bufor drugi.

  • count
    Liczba znaków do porównania. (Porównuje bajty w przypadku memcmp, znaki dwubajtowe w przypadku wmemcmp).

Wartość zwracana

Wartość zwracana określa relację pomiędzy buforami.

Wartość zwrócona

Relacja pierwszych count znaków z buf1 i buf2

< 0

buf1 mniejszy niż buf2

0

buf1 identyczne z buf2

> 0

buf1 większy niż buf2

Uwagi

Porównuje pierwsze count znaków z buf1 oraz buf2 i zwraca wartość, która wskazuje ich relację.Znak niezerowej wartości zwróconej jest znakiem różnicy między pierwszą różniącą się parą wartości z buforów.Wartości są interpretowane jako unsigned char w przypadku memcmp i jako wchar_t w przypadku wmemcmp.

Wymagania

Procedura

Wymagany nagłówek

memcmp

<memory.h> or <string.h>

wmemcmp

<wchar.h>

Dodatkowe informacje o zgodności – zobacz: Zgodność.

Biblioteki

Wszystkie wersje Biblioteki uruchomieniowej C.

Przykład

// crt_memcmp.c
/* This program uses memcmp to compare
 * the strings named first and second. If the first
 * 19 bytes of the strings are equal, the program
 * considers the strings to be equal.
 */

#include <string.h>
#include <stdio.h>

int main( void )
{
   char first[]  = "12345678901234567890";
   char second[] = "12345678901234567891";
   int int_arr1[] = {1,2,3,4};
   int int_arr2[] = {1,2,3,4};
   int result;

   printf( "Compare '%.19s' to '%.19s':\n", first, second );
   result = memcmp( first, second, 19 );
   if( result < 0 )
      printf( "First is less than second.\n" );
   else if( result == 0 )
      printf( "First is equal to second.\n" );
   else
      printf( "First is greater than second.\n" );

   printf( "Compare '%d,%d' to '%d,%d':\n", int_arr1[0], int_arr1[1], int_arr2[0], int_arr2[1]);
   result = memcmp( int_arr1, int_arr2, sizeof(int) * 2 );
   if( result < 0 )
      printf( "int_arr1 is less than int_arr2.\n" );
   else if( result == 0 )
      printf( "int_arr1 is equal to int_arr2.\n" );
   else 
      printf( "int_arr1 is greater than int_arr2.\n" );
}

Dane wyjściowe

Compare '1234567890123456789' to '1234567890123456789':
First is equal to second.
Compare '1,2' to '1,2':
int_arr1 is equal to int_arr2.

Odpowiednik w programie .NET Framework

Nie dotyczy. Aby wywołać standardową funkcję C, należy użyć PInvoke. Aby uzyskać więcej informacji, zobacz Przykłady wywołań platformy.

Zobacz też

Informacje

Manipulowanie buforem

_memccpy

memchr, wmemchr

memcpy, wmemcpy

memset, wmemset

strcmp, wcscmp, _mbscmp

strncmp, wcsncmp, _mbsncmp, _mbsncmp_l