min

(PHP 4, PHP 5, PHP 7)

minLa plus petite valeur

Description

min ( array $values ) : mixed
min ( mixed $value1 [, mixed $... ] ) : mixed

Si le premier et le seul paramètre est un tableau, min() retournera la plus petite valeur contenue dans le tableau. Si le premier paramètre est un entier, une chaîne ou un nombre décimal, vous devez fournir au moins deux paramètres et min() retournera la plus petite de ces valeurs.

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 string 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 valeurs de types mixtes, car min() peut produire des résultats imprévisibles.

Liste de paramètres

values

Un tableau contenant les valeurs.

value1

Toutes comparables value.

...

Toutes comparables value.

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.

Si un tableau vide est passé, alors FALSE sera retourné et une erreur E_WARNING sera émise.

Exemples

Exemple #1 Exemple avec min()

<?php
echo min(23167);  // 1
echo min(array(245)); // 2

// La chaîne 'hello' lorsque comparée à un entier, est traité comme étant de valeur 0.
// Sachant que les deux valeurs sont égales, l'ordre fourni va déterminer le résultat
echo min(0'hello');     // 0
echo min('hello'0);     // hello

// 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(222), array(1111)); // 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(248), array(251)); // 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(257), 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(-10FALSE10); // FALSE
$val min(-10NULL10);  // NULL

// D'un autre côté, 0 est traité comme valant FALSE, aussi, il est "plus petit que" TRUE
$val min(0TRUE); // 0
?>

Voir aussi

  • max() - La plus grande valeur
  • count() - Compte tous les éléments d'un tableau ou quelque chose d'un objet