Collator::asort
Collator::__construct
Collator
PHP Manual

# Collator::compare

# collator_compare

(No version information available, might be only in CVS)

Collator::compare -- collator_compare — Compare two Unicode strings

### Описание

Object oriented style

integer Collator::compare ( string `$str1` , string `$str2` )

Procedural style

integer collator_compare ( Collator `$coll` , string `$str1` , string `$str2` )

Compare two Unicode strings according to collation rules.

### Список параметров

`coll`

  Collator object.

`str1`

  The first string to compare.

`str2`

  The second string to compare.

### Возвращаемые значения

Return comparison result:

- 1 if str1 is greater than str2 ;

- 0 if str1 is equal to str2;

- -1 if str1 is less than str2 .

On error boolean `FALSE` is returned.
Внимание

Эта функция может возвращать как логическое значение `FALSE`, так и не относящееся к логическому типу значение, которое приводится к `FALSE`, например, 0 или "". За более подробной информации обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.

### Примеры

Пример #1 collator_compare()example

`<?php
$s1 = 'Hello';
$s2 = 'hello';
$coll = collator_create( 'en_US' );
$res = collator_compare( $coll, $s1, $s2 );
if ($res === false) {
echo collator_get_error_message( $coll );
} else if( $res > 0 ) {
echo "s1 is greater than s2\n";
} else if( $res < 0 ) {
echo "s1 is less than s2\n";
} else {
echo "s1 is equal to s2\n";
?>`

Результат выполнения данного примера:

         s1 is greater than s2

### Смотрите также

- collator_sort()

Collator::asort
Collator::__construct
Collator
PHP Manual