strncasecmp

Binary safe case-insensitive string comparison of the first n characters

Description

int strncasecmp(string $string1, string $string2, int $length)

This function is similar to strcasecmp, with the difference that you can specify the (upper limit of the) number of characters from each string to be used in the comparison.

Parameters

string1

The first string.

string2

The second string.

length

The length of strings to be used in the comparison.

Return Values

Returns -1 if string1 is less than string2; 1 if string1 is greater than string2, and 0 if they are equal.

Changelog

Version Description
8.2.0 This function now returns -1 or 1, where it previously returned a negative or positive number.

Examples

Example #1 strncasecmp example

<?php

$var1 = 'Hello John';
$var2 = 'hello Doe';
if (strncasecmp($var1, $var2, 5) === 0) {
    echo 'First 5 characters of $var1 and $var2 are equals in a case-insensitive string comparison';
}
?>

See Also

  • strncmp
  • preg_match
  • substr_compare
  • strcasecmp
  • stristr
  • substr