array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'collator.getsortkey.php', 1 => 'Collator::getSortKey', 2 => 'Récupère la clé de tri pour une chaîne', ), 'up' => array ( 0 => 'class.collator.php', 1 => 'Collator', ), 'prev' => array ( 0 => 'collator.getlocale.php', 1 => 'Collator::getLocale', ), 'next' => array ( 0 => 'collator.getstrength.php', 1 => 'Collator::getStrength', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/intl/collator/get-sort-key.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Collator::getSortKey

collator_get_sort_key

(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL intl >= 1.0.3)

Collator::getSortKey -- collator_get_sort_key — Récupère la clé de tri pour une chaîne

Description

Style orienté objet

public Collator::getSortKey(string $string): string|false

Style procédural

collator_get_sort_key(Collator $object, string $string): string|false

Retourne la clé de la collation pour une chaîne. Les clés de collation peuvent être comparées directement au lieu de chaînes, néanmoins elles sont spécifiques à l'implémentation et peuvent changer entre les versions de la bibliothèque ICU. Les clés de tri sont généralement seulement utiles dans les bases de données ou autres circonstances où les appels de fonctions sont extrêmement chers.

Liste de paramètres

object

Objet Collator.

string

La chaîne depuis laquelle produire la clé.

Valeurs de retour

Retourne la clé de collation pour la chaîne, ou false si une erreur survient.

Avertissement

Cette fonction peut retourner false, mais elle peut aussi retourner une valeur équivalent à false. Veuillez lire la section sur les booléens pour plus d'informations. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

Exemples

Exemple #1 Exemple collator_get_sort_key()

<?php

$s1 = 'Hello';

$coll = collator_create('en_US');
$res = collator_get_sort_key($coll, $s1);

echo bin2hex($res);
?>

Résultat de l'exemple ci-dessus est similaire à :


3832404046010901dc08

Exemple #2 Collator::getSortKey() : exemple avec usort()

<?php

$data = [
[ 'name' => '🇳🇱 Derick Rethans', 'linked_account' => 'https://phpc.social/users/derickr' ],
[ 'name' => 'Elephpant', 'linked_account' => 'https://phpc.social/phpc' ],
[ 'name' => '🇫🇷 Marcus Bointon', 'linked_account' => 'https://phpc.social/users/Synchro' ],
];

/* Créer le collateur */
$col = new Collator('en');

/* Trier les lettres majuscules avant les minuscules */
$col->setAttribute(Collator::CASE_FIRST, Collator::UPPER_FIRST);

/* Utiliser une fonction définie par l'utilisateur avec sort, qui supprime les émojis */
usort(
$data,
function($a, $b) use ($col) {
/* Supprimer la classe de caractères 'S' (Symboles) et les espaces
* (avec trim) */
$aName = trim(preg_replace('/\p{S}+/u', '', $a['name']));
$bName = trim(preg_replace('/\p{S}+/u', '', $b['name']));

/* Créer la clé de tri */
$aKey = $col->getSortKey($aName);
$bKey = $col->getSortKey($bName);

/* Utiliser la clé de tri pour déterminer l'ordre des éléments */
return $aKey <=> $bKey;
}
);

var_dump($data);
?>

Résultat de l'exemple ci-dessus est similaire à :


array(3) {
[0] =>
array(2) {
'name' =>
string(25) "🇳🇱 Derick Rethans"
'linked_account' =>
string(33) "https://phpc.social/users/derickr"
}
[1] =>
array(2) {
'name' =>
string(9) "Elephpant"
'linked_account' =>
string(24) "https://phpc.social/phpc"
}
[2] =>
array(2) {
'name' =>
string(25) "🇫🇷 Marcus Bointon"
'linked_account' =>
string(33) "https://phpc.social/users/Synchro"
}
}

Voir aussi