PHP Function Reference

PHP strcmp() Function



The PHP strcmp() function is used to perform binary safe case-sensitive string comparison of two strings.

This function is same as strncmp() function, except strncmp() function has one more parameter which is used to specify number of (upper limit of the) characters from each string to be used in the comparison.

Note: The strcmp() function is a binary-safe and a case-sensitive function.

Syntax

strcmp(str1, str2)

Parameters

str1 Required. Specify the first string to compare
str2 Required. Specify the second string to compare

Return Value

Returns the following value:

  • Returns a number less than 0, when first string is less than second string.
  • Returns 0, when both strings are equal.
  • Returns a number greater than 0, when first string is greater than second string.

Example:

In the example below, strcmp() function is used to compare two strings and returns values based on the value of two strings.

<?php
//returns 0 as both strings are same
echo "result1: ".strcmp('Hello', 'Hello')."\n";

//returns positive number as first unmatched character
//of first string is greater than that of second string
echo "result2: ".strcmp('World', 'Hello')."\n";

//returns negative number as first unmatched character
//of first string is less than that of second string
echo "result3: ".strcmp('Hello', 'World')."\n";
?>

The output of the above code will be:

result1: 0
result2: 1
result3: -1

❮ PHP String Reference