memcmp, _fmemcmp

compare a given number of characters in two objects

Synopsis:

#include <string.h>
int memcmp( const void *s1,
            const void *s2,
            size_t length );
int _fmemcmp( const void __far *s1,
              const void __far *s2,
              size_t length );

Description:

The memcmp() and _fmemcmp() functions compare the first lengthcharacters of the object pointed to by s1 to the object pointed to by s2.

The _fmemcmp() function is a data-model-independent form of the memcmp() function that accepts far pointer arguments. It is most useful in mixed memory model applications.

Returns:

an integer, with the value given below:

less than 0

the object pointed to by s1 is less than the object pointed to by s2.

0

the object pointed to by s1 is equal to the object pointed to by s2.

greater than zero

the object pointed to by s1 is greater than the object pointed to by s2.

See also:

memchr(), memcpy(), memicmp(), memset()

Examples:

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

void main()
  {
    char buffer[80];

    strcpy( buffer, "World" );
    if( memcmp( buffer, "hello", 5 ) < 0 ) {
      printf( "Less than\n" );
    } else {
      printf( "Equal to or greater than\n");
    }
  }

produces the output:

Less than

Classification:

Systems:

memcmp()

All (except DOS/PM)

_fmemcmp()

All (except Netware, DOS/PM)