max

    (PHP 4, PHP 5, PHP 7, PHP 8)

    max — La plus grande valeur

    Description

    max(mixed$value, mixed...$values): mixed

    Signature alternative (non supporté avec les arguments nommés) :

    max(array$value_array): 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 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 max() 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 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.

    Erreurs / Exceptions

    Si un tableau vide est passé, la fonction max() lance une ValueError.

    Historique

    VersionDescription
    8.0.0max() lance désormais une ValueError en cas d'échec ; précédemment, false était renvoyé et une erreur E_WARNING était émise.
    8.0.0 Comme les comparaisons entre les chaînes et les nombres ont été changées, max() ne retourne plus une valeur différente basée sur l'ordre des arguments dans ces cas là.

    Exemples

    Exemple #1 Exemple avec max()

    <?php
    echo max(2, 3, 1, 6, 7); // 7
    echo max(array(2, 4, 5)); // 5

    // 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(2, 2, 2), array(1, 1, 1, 1)); // 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(2, 4, 8), array(2, 5, 1)); // 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(2, 5, 7), 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(-10, FALSE); // -10

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

    Voir aussi

    • min() - La plus petite valeur
    • count() - Compte tous les éléments d'un tableau ou dans un objet Countable
    To Top