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
Browserkompatibilität
BCD tables only load in the browser