String Functions

PHP strncasecmp() Function

Topic: PHP String ReferencePrev|Next

Description

The strncasecmp() function compares two strings up to a specified length.

This function is case-insensitive. For case-sensitive searches, use the strncmp() function.

The following table summarizes the technical details of this function.

Return Value: Returns a negative value (< 0) if string1 is less than string2; a positive value (> 0) if string1 is greater than string2, and 0 if both strings are equal.
Version: PHP 4.0.2+

Syntax

The basic syntax of the strncasecmp() function is given with:

strncasecmp(string1, string2, length);

The following example shows the strncasecmp() function in action.

<?php
// Sample strings
$str1 = "Hello World!";
$str2 = "HELLO WORLD!";

// Performing string comparison
if(strncasecmp($str1, $str2, 5) === 0) {
    echo "The two sub-strings are equal in a case-insensitive comparison.";
}
?>

Note: The strncasecmp() function is similar to strcasecmp(), except that in strncasecmp() you can specify the number of characters from each string to be used in the comparison.


Parameters

The strncasecmp() function accepts the following parameters.

Parameter Description
string1 Required. Specifies the first string to compare.
string2 Required. Specifies the second string to compare.
length Required. Specifies the maximum number of characters to use in the comparison.

More Examples

Here're some more examples showing how strncasecmp() function actually works:

The following example demonstrates the comparison of the first five characters of the two strings.

<?php
// Sample strings
$str1 = "Airport";
$str2 = "Airplane";

// Comparing the first five characters
echo strncasecmp($str1, $str2, 5);
?>

The following example shows the comparison of the first seven characters of the two strings.

<?php
// Sample strings
$str1 = "Hello John!";
$str2 = "hello johnny!";

// Comparing the first seven characters
echo strncasecmp($str1, $str2, 7);
?>
Bootstrap UI Design Templates Property Marvels - A Leading Real Estate Portal for Premium Properties