max

(PHP 4, PHP 5, PHP 7)

maxLa plus grande valeur

Description

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

Si le premier et unique paramètre est un tableau, max() retourne la valeur la plus haute du tableau. Si au moins deux paramètres sont fournis, max() retourne la plus grosse 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 max() 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 max() retourne la valeur du paramètre considéré comme "supé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 max()

<?php
echo max(23167);  // 7
echo max(array(245)); // 5

// La chaîne 'hello', lors de la comparaison avec un entier, est traitée
// comme valant 0. Sachant que les deux valeurs sont égales,
// l'ordre fourni va déterminer le résultat
echo max(0'hello');     // 0
echo max('hello'0);     // hello

// Ici, nous comparons -1 < 0, aussi 'hello' est la plus grande valeur
echo max('hello', -1);    // hello

// Avec plusieurs tableaux de tailles différentes, max retourne
// le plus long
$val max(array(222), array(1111)); // array(1, 1, 1, 1)

// Plusieurs tableaux de même longueur sont comparés de la gauche vers la droite
// aussi, dans notre exemple : 2 == 2, but 5 > 4
$val max(array(248), array(251)); // array(2, 5, 1)

// Si un tableau et un non-tableau sont fournis, le tableau sera toujours
// retourné, sachant que les comparaisons traitent les tableaux comme
// étant plus grand que n'importe quelle valeur
$val max('string', array(257), 42);   // array(2, 5, 7)

// Si un argument vaut NULL ou est un booléen, il sera comparé avec les autres
// valeurs en utilisant la règle FALSE < TRUE suivant les autres types concernés
// Dans l'exemple ci-dessous, -10 est traité comme valant TRUE dans la comparaison
$val max(-10FALSE); // -10

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

Voir aussi

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