Collator::sort

collator_sort

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

Collator::sort -- collator_sort — 指定した collator で配列を並べ替える

説明

オブジェクト指向型

public Collator::sort(array &$array, int $flags = Collator::SORT_REGULAR): bool

手続き型

collator_sort(Collator $object, array &$array, int $flags = Collator::SORT_REGULAR): bool

この関数は、現在のロケールの規則にもとづいて配列を並べ替えます。

PHP の標準関数 sort() と同等です。

パラメータ

object

Collator オブジェクト。

array

並べ替えたい文字列の配列。

flags

オプションの並べ替え方式。以下のいずれか。

Collator::SORT_REGULAR - 通常の比較 (型を変更しない)
Collator::SORT_NUMERIC - 数値としての比較
Collator::SORT_STRING - 文字列としての比較

デフォルトの並べ替え方式は Collator::SORT_REGULAR です。flags に無効な値を指定した場合もこの方式を使います。

戻り値

成功した場合に true を、失敗した場合に false を返します。

例

例1 collator_sort() の例

<?php
$coll = collator_create( 'en_US' );
$arr  = array( 'at', 'às', 'as' );

var_export( $arr );
collator_sort( $coll, $arr );
var_export( $arr );
?>

上の例の出力は以下となります。

array (
  0 => 'at',
  1 => 'às',
  2 => 'as',
)array (
  0 => 'as',
  1 => 'às',
  2 => 'at',
)

参考

Collator の定数
collator_asort() - インデックスの情報を保持しつつ配列を並べ替える
collator_sort_with_sort_keys() - 指定した collator とキーで配列を並べ替える

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.