Intl.Collator.prototype.compare

Die Intl.Collator.prototype.compare Eigenschaft gibt eine Funktion zurück, die zwei Strings, abhängig von der Sortierreihenfolge des Collator Objektes, vergleicht.

Syntax

collator.compare(string1, string2)

Parameter

string1
string2
Die Strings, die miteinander verglichen werden sollen.

Beschreibung

Die Funktion, die von dem Getter compare zurückgegeben wird, gibt eine Zahl zurück, die angibt, wie string1 und string2 in der Sortierreihenfolge des Collator Objektes zueinander stehen: Ein negativer Wert gibt an, string1 vor string2 kommt; Ein positiver Wert gibt an, dass string1 nach string2 kommt; 0 gibt an, dass beide gleich sind.

Beispiele

Einsatz von compare zum Sortieren von Arrays

Man kann die vom Getter compare zurückgegebenen Funktion zum Sortieren von Arrays einsetzen. Zu beachten ist, dass diese Funktion an das collator-Objekte gebunden ist, auf dem es aufgerufen wurde, so dass es direkt an Array.prototype.sort() übergeben werden kann.

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"

Einsatz von compare zum Suchen in Arrays

Man kann die vom Getter compare zurückgegebenen Funktion zum suchen von passenden Elementen in einem Array benutzen:

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(v => collator.compare(v, s) === 0);
console.log(matches.join(', '));
// → "Congrès, congres"

Spezifikationen

Spezifikation Status Kommentar
ECMAScript Internationalization API 1.0 (ECMA-402)
Die Definition von 'Intl.Collator.prototype.compare' in dieser Spezifikation.
Standard Initiale Definition.
ECMAScript Internationalization API 2.0 (ECMA-402)
Die Definition von 'Intl.Collator.prototype.compare' in dieser Spezifikation.
Standard  
ECMAScript Internationalization API (ECMA-402)
Die Definition von 'Intl.Collator.prototype.compare' in dieser Spezifikation.
Lebender Standard  

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidFirefox für AndroidOpera für AndroidSafari auf iOSSamsung InternetNode.js
compareChrome Vollständige Unterstützung 24Edge Vollständige Unterstützung 12Firefox Vollständige Unterstützung 29IE Vollständige Unterstützung 11Opera Vollständige Unterstützung 15Safari Vollständige Unterstützung 10WebView Android Vollständige Unterstützung 4.4Chrome Android Vollständige Unterstützung 25Firefox Android Vollständige Unterstützung 56Opera Android Vollständige Unterstützung 14Safari iOS Vollständige Unterstützung 10Samsung Internet Android Vollständige Unterstützung 1.5nodejs Vollständige Unterstützung 0.12
Hinweise
Vollständige Unterstützung 0.12
Hinweise
Hinweise Before version 13.0.0, only the locale data for en-US is available by default. See the Collator() constructor for more details.

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Siehe Implementierungshinweise.
Siehe Implementierungshinweise.

Siehe auch