Description

strnatcmp(string $string1, string $string2): int

Implémente l'algorithme de comparaison qui ordonne les chaînes tel qu'un homme le ferait. Il est à noter que cette comparaison est sensible à la casse.

Liste de paramètres

string1: La première chaîne.
string2: La seconde chaîne.

Valeurs de retour

Retourne une valeur inférieure à 0 si string1 est inférieure à string2 ; une valeur supérieure à 0 si string1 est supérieure à string2, et 0 si elles sont égales. Aucune signification particulière ne peut être déduite de cette valeur, hormis son signe.

Historique

Version	Description
8.2.0	Cette fonction ne garantit plus de retourner `strlen($string1) - strlen($string2)` lorsque les longueurs des chaînes ne sont pas égales, et peut désormais retourner `-1` ou `1` à la place.

Exemples

Un exemple de la différence de traitement avec l'algorithme standard est présenté ci-dessous :

Exemple #1 strcmp()

<?php
$arr1 = $arr2 = array("img12.png", "img10.png", "img2.png", "img1.png");
echo "Tri de chaînes standard\n";
usort($arr1, "strcmp");
print_r($arr1);
echo "\nTri de chaînes \"ordre naturel\"\n";
usort($arr2, "strnatcmp");
print_r($arr2);
?>

L'exemple ci-dessus va afficher :

Tri de chaînes standard
Array
(
    [0] => img1.png
    [1] => img10.png
    [2] => img12.png
    [3] => img2.png
)

Tri de chaînes "ordre naturel"
Array
(
    [0] => img1.png
    [1] => img2.png
    [2] => img10.png
    [3] => img12.png
)

Pour plus de détails, se reporter à »

Natural Order String
     Comparison

de Martin Pool (en anglais).

Voir aussi

preg_match() - Effectue une recherche de correspondance avec une expression rationnelle standard
strcasecmp() - Comparaison insensible à la casse de chaînes binaires
substr() - Retourne un segment de chaîne
stristr() - Version insensible à la casse de strstr
strcmp() - Comparaison binaire de chaînes
strncmp() - Comparaison binaire des n premiers caractères
strncasecmp() - Compare en binaire des chaînes de caractères
strnatcasecmp() - Comparaison de chaînes avec l'algorithme d'"ordre naturel" (insensible à la casse)
strstr() - Trouve la première occurrence dans une chaîne
natsort() - Trie un tableau avec l'algorithme à "ordre naturel"
natcasesort() - Trie un tableau avec l'algorithme à "ordre naturel" insensible à la casse