C++ Programming/Code/Standard C Library/Functions/strcmp

From Wikibooks, open books for an open world
Jump to: navigation, search

strcmp[edit]

Syntax
#include <cstring>
int strcmp( const char *str1, const char *str2 );

The function strcmp() compares str1 and str2, then returns:

Return value Explanation
less than 0 str1 is less than str2
equal to 0 str1 is equal to str2
greater than 0 str1 is greater than str2

For example:

printf( "Enter your name: " );
scanf( "%s", name );
if( strcmp( name, "Mary" ) == 0 ) {
  printf( "Hello, Dr. Mary!\n" );
}

Note that if str1 or str2 are missing a null-termination character, then strcmp() may not produce valid results. For a similar (and safer) function that includes explicit bounds checking, see strncmp().

Related topics
memcmp - strcat - strchr - strcoll - strcpy - strlen - strncmp - strxfrm