Intl.Collator.prototype.compare

このロケールの翻訳が存在しないため、英語バージョンのコンテンツを表示しています。 Help us translate this article!

概要

このCollatorオブジェクトのソート順に応じて2つの文字列を比較するゲッター関数を返します。

構文

collator.compare(string1, string2)

引数

string1
string2
互いに対して比較する文字列

説明

compareによって返される関数はstring1string2Collatorオブジェクトのソート順に応じてどのくらい互いに比較するかを指し示す数値を返します。: string1string2より小さい場合、マイナス値 ; string1string2より大きい場合、プラス値; 同じなら、0

例: ソート配列に対して、compareを使う

ソート配列に対してcompareによって返される関数を使ってください。Note that 関数は含まれていたcollatorにバインドされていることに注意して下さい。 というのも、Array.prototype.sort()に直接渡されるからです。

var a = ['Offenbach', 'Österreich', 'Odenwald'];
var collator = new Intl.Collator('de-u-co-phonebk');
a.sort(collator.compare);
console.log(a.join(', '));
// → "Odenwald, Österreich, Offenbach"

例: 配列の検索に対してcompareを使う

配列内の一致する文字列を見つけるためにcompareによって返される関数を使って下さい。:

var a = ['Congrès', 'congres', 'Assemblée', 'poisson'];
var collator = new Intl.Collator('fr', { usage: 'search', sensitivity: 'base' });
var s = 'congres';
var matches = a.filter(function(v) {
  return collator.compare(v, s) === 0;
});
console.log(matches.join(', '));
// → "Congrès, congres"

仕様

仕様 ステータス コメント
ECMAScript Internationalization API 1.0 (ECMA-402)
Intl.Collator.prototype.compare の定義
標準 Initial definition.

ブラウザ実装状況

現在、互換性データを可読形式の JSON フォーマットに置き換えているところです。 この互換性一覧は古い形式を使っており、これに含まれるデータの置き換えが済んでいません。 手助けしていただける場合は、こちらから!
機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート 24 29 (29) 11 15 未サポート
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート 未サポート 26 未サポート
バグ 864843
未サポート 未サポート 未サポート

関連情報