DESCRIPTION.

Retourne l'élément d'une suite ayant la valeur la plus élevée.

SYNTAXE.

Grand = max ( valeura , valeurb , ... , valeurn , defaut )

Grand = ⇨ variable qui recevra l'élément [ optionnel ]

max ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

valeur ⇨ suite des valeurs à évaluer [ OBLIGATOIRE ]

defaut ⇨ valeur par défaut si aucune valeur n'est fournie [ optionnel ]

Grand = max ( iterable , fonction , defaut )

Grand = ⇨ variable qui recevra l'élément [ optionnel ]

max ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

iterable ⇨ objet contenant les valeurs [ OBLIGATOIRE ]

fonction ⇨ fonction à appliquer à chaque élément [ optionnel ]

defaut ⇨ valeur par défaut si iterable est vide [ optionnel ]

REMARQUES.

valeur peut être n'importe quel objet valide de Python pouvant être comparé. Si plusieurs valeur représentent l'élément le plus élevé, c'est valeur présente en premier dans iterable qui est retourné.

iterable doit être un objet collection, ou séquence, tel que : range ( ), list ( ), tuple ( ), bytes ( ) ou bytearray ( ).

fonction peut être : une fonction, méthode, ou même un appelable, unique. Si fonction est précisé, c'est la valeur retournée, par le traitement de l'item par fonction, qui servira pour sélectionner l'élément de iterable ayant la valeur la plus élevée et non la valeur réelle de l'élément. fonction doit être écrite sans parenthèse ni arguments. Si un ou des argument doivent être notifiées pour le traitement des éléments, il faut utiliser un fonction anonyme, lambda. Quelque soit la valeur retournée par fonction, la valeur de l'élément de list ( ) change pas. fonction est un argument nommé key = fonction. 

defaut est une valeur a retourné si iterable est vide, par exemple : default = "la liste n'a pas de valeur." ou default = -1. Si defaut est omis et que iterable est vide, Python lèvera une exception. defaut est un argument nommée par default = defaut. 

EXEMPLES.

print ( max ( 14 , 8 , 1 , 11 , 22 , 4 , 7 ) ) retourne 22

Age = max ( 17 , 8 , 46 , 15 , 27 )

print ( Age ) retourne 46

LST_Nombres = [ 9 , 4 , -1 , 17 , 8 , 14 , 0 ]

LST_Lettres = [ "a" , "c" , "x" , "f" , "t" , "p" ]

print ( max ( LST_Nombres ) ) retourne 17

print ( max ( LST_Lettres ) ) retourne x

print ( max ( LST_Lettres , LST_Nombres ) ) retourne TypeError: '>' not supported between instances of 'str' and 'list'

TPL_Prenoms = ( "Marie" , "Jacques" , "Kevin" , "Yann" , "Annie"  )

print ( max ( TPL_Prenoms ) ) retourne Yann

print ( max ( TPL_Prenoms , key = lambda Qprenon : len ( Qprenon ) ) ) retourne Jacques

LST_Rien = [ ]

print ( max ( LST_Rien , default = "Cette suite est vide." ) ) retourne Cette suite est vide.

print ( max ( LST_Rien  ) ) retourne ValueError: max() arg is an empty sequence