w3resource
PHP Tutorial

PHP: substr_compare() function

Description

The substr_compare() function is used to compare two strings from a given starting position in the main string.

Version:

(PHP 5)

Syntax:

substr_compare(main_string, compare_string, star_pos, length, case_insensitivity)

Parameters:

Name Description Required /
Optional		 Type
main_string The main string. Required String
compare_string The string to be compared. Required String
star_pos The starting position in the main string. Required Integer
length A positive number : Start at the specified position in the string.
A negative number : Start at a specified position from the end of the string.		 Optional Integer
case_insensitivity If set TRUE comparison is case insensitive. Optional Boolean

Return value:

0 : If two main_string=compare_string
<0 : if the length of the main_string from the starting position is less than the compare_string
>0 : if the length of the main_string from the starting position is greater than the compare_string.

Value Type: Integer.

Pictorial Presentation

string_substr_compare

Example: 

<?php
echo substr_compare('uvwxyz', 'uv', 1, 2).'<br>';
echo substr_compare('uvwxyz', 'uvw', 1, 2).'<br>';
echo substr_compare('uvwxyz', 'uv', -2, 2).'<br>';
echo substr_compare('uvwxyz', 'xy', 1, 2).'<br>';
echo substr_compare('uvwxyz', 'xyz', -3, 3).'<br>';
?>

Output: 

1
1
4
-2
0

View the example in the browser

See also

PHP Function Reference

Previous: strtr
Next: substr_count