133 of 410 menu

The strcoll Function

The strcoll function compares two strings according to the current locale. The first parameter is the first string for comparison, the second is the second string. The function returns 0 if the strings are identical, a number -1 if the first string is less than the second, and a number greater than 1 if the first string is greater than the second.

Syntax

strcoll(string1, string2);

Example

Comparing strings with different locales:

<?php setlocale(LC_COLLATE, 'en_US.UTF-8'); $res1 = strcoll('apple', 'banana'); setlocale(LC_COLLATE, 'de_DE.UTF-8'); $res2 = strcoll('äpfel', 'zebra'); echo $res1; echo $res2; ?>

Code execution result:

-1 -1

Example

Comparing identical strings:

<?php setlocale(LC_COLLATE, 'ru_RU.UTF-8'); $res = strcoll('строка', 'строка'); echo $res; ?>

Code execution result:

0

See Also

  • the strcmp function,
    which compares strings without considering locale
  • the strcasecmp function,
    which compares strings case-insensitively
byenru