(PHP 4, PHP 5, PHP 7, PHP 8)
min — La plus petite valeur
Description
min(mixed
$value, mixed
...$values): mixed
Signature alternative (non supporté avec les arguments nommés) :
min(array
$value_array): mixed
Note:
Les valeurs de différents types seront comparées en utilisant
les règles de
comparaison standard. Actuellement, une chaîne non numérique
sera comparée à un entier, comme s'il s'agissait de la valeur
0, mais plusieurs chaîne de caractères non-numérique seront comparées de façon
alphanumérique. La valeur actuelle retournée sera du même type que
l'original et aucune conversion de type ne sera appliquée.
Attention
Soyez prudent lorsque vous passez des arguments avec des types différents,
car min() peut produire des résultats imprévisibles.
Liste de paramètres
-
value
-
Toute valeur comparable.
-
values
-
Toute valeurs comparable.
-
value_array
-
Un tableau contenant les valeurs.
Valeurs de retour
La fonction min() retourne la valeur du paramètre
considéré comme "inférieure" suivant la comparaison standard.
Si plusieurs valeurs de types différents sont évaluées comme étant égales
(i.e. 0 et 'abc'), la première fournie
à la fonction sera retournée.
Erreurs / Exceptions
Si un tableau vide est passé, la fonction min() lance une ValueError.
Historique
Exemples
Exemple #1 Exemple avec min()
<?php
echo min(2, 3, 1, 6, 7); // 1
echo min(array(2, 4, 5)); // 2
// Ici, nous comparons -1 < 0, aussi, -1 est la valeur la plus basse
echo min('hello', -1); // -1
// Avec plusieurs tableaux de différentes tailles, min retourne le plus court
$val = min(array(2, 2, 2), array(1, 1, 1, 1)); // array(2, 2, 2)
// Plusieurs tableaux de même taille sont comparés depuis la gauche vers la droite,
// aussi, dans notre exemple : 2 == 2, mais 4 < 5
$val = min(array(2, 4, 8), array(2, 5, 1)); // array(2, 4, 8)
// Si un tableau et un non-tableau sont fournis, le tableau ne sera jamais retourné
// car les comparaisons traitent les tableaux comme plus grand que n'importe quelle valeur
$val = min('string', array(2, 5, 7), 42); // string
// Si un argument vaut NULL ou vaut un booléen, il sera comparé avec
// d'autres valeurs en utilisant la règle FALSE < TRUE suivant les autres
// types fournis. Dans l'exemple ci-dessous, à la fois -10 et 10 sont traités
// comme valant TRUE dans la comparaison
$val = min(-10, FALSE, 10); // FALSE
$val = min(-10, NULL, 10); // NULL
// D'un autre côté, 0 est traité comme valant FALSE, aussi, il est "plus petit que" TRUE
$val = min(0, TRUE); // 0
?>
Voir aussi
- max() - La plus grande valeur
- count() - Compte tous les éléments d'un tableau ou dans un objet Countable