Python: Fonctions

<--Sommaire

Définir une fonction

Deux options suivant la complexité

1. définition usuelle à l'aide du mot-clé def et ouverture d'un bloc. return permet que la fonction renvoie un résultat mais ce n'est pas obligatoire, la fonction peut simplement manipuler les données en entrée

def f(x):
    return x**2

2. on peut également définir une fonction lambda ou 'fonction anonyme' selon

f = lambda x: x**2

dans l'exemple ci-dessus, le caractère anonyme n'est pas très clair car on lui a affecté la variable f pour l'utiliser avec f(x) comme précédemment le caractère anonyme apparaît lorsqu'on passe ce type de fonction en argument.

Récursivité

Une fonction peut s'appeler elle-même

def f(x):
    if x < 10: return x*f(x+1)
    else: return 10
print f(1), f(10), f(9), f(2.34)

Fonction à l'intérieur d'une fonction

Il est possible de définir une fonction à l'intérieur d'une autre fonction. Dans ce cas, la fonction n'est visible qu'à l'intérieur de la fonction principale et ne peut être utilisée dans le champ global:

def f(x):
    from math import exp
    def g(y): return y**2+1
    return exp(g(x)) / g(x)
print f(1), g(2)

Dans l'exemple, l'affichage de g(2) renvoie une erreur. Cela peut être très pratique pour structure le corps d'une fonction complexe sans avoir à polluer le niveau global avec beaucoup de fonctions.

Passage d'arguments d'une fonction

Dans ce qui suit, arguments et paramètres seront considérés comme synonymes. f.__module__ : affiche le module de rattachement d'une fonction f.__name__ : affiche le nom de la fonction, par exemple si g = f, g.__name__ donne 'f'

Signature d'une fonction: c'est la combinaison du nom et de la liste d'arguments

def f(a,b,c): 
    return a+b**2+c**3

définit localement les variables a,b,c qui prendront comme valeurs celles transmises lors de l'appel de la fonction, par exemple f(1,2,3). Il est obligatoire de donner la liste des arguments et dans le bon ordre.

arguments optionnels: il est possible de mettre des arguments optionnels à condition de leur donner une valeur par défaut et ils doivent nécessairement être placés après les arguments obligatoires def f(a,b,c=0): c est optionnel donc f(1,2) fonctionne et c prendra la valeur 0 f.__defaults__ : affiche les valeurs par défaut des arguments optionnels

def f(a=1,b=2,c=3):
    return a+b**2+c**3
print f.__defaults__
f(1,2,3), f(2)

paramètres nommés: lorsqu'il y a des paramètres optionnels, on peut ne passer que l'argument dont on veut attribuer une valeur différente de la valeur par défaut, sans avoir à respecter l'ordre:

f(b=3)
f(c=2,a=2)

On parle de paramètres nommés. Cela donne une lecture claire de l'appel à la fonction. Si l'on utilise des paramètres non nommés et des paramètres nommés, ces derniers sont toujours placés à la fin:

f(1,c=3)

paramètres extensibles non nommés: Python permet à une fonction d'accepter une liste extensible d'arguments, c'est-à-dire que le nombre d'arguments n'est pas défini à l'avance. Il faudra dans ce cas veiller à ce que la fonction gère correctement cette liste quelconque d'arguments. La syntaxe est la suivante, avec une * devant le nom de ce qui sera un tuple contenant la liste des paramètres (on aime bien utiliser 'args' mais on peut appeler ce tuple autrement):

def f(*args):
    print args
    if len(args) == 3:
        a,b,c = args[0],args[1],args[2]
        return a+b+c
    else:
        return None
f(1,2,3)
f(3)

paramètres extensibles nommés: il est en fait plus judicieux d'utiliser une liste de paramètres nommés extensible. La syntaxe est la suivante, avec cette fois une double étoile ** et kwargs n'est alors plus un tuple mais un dictionnaire associant nom et valeur des variables à transmettre:

def f(**kwargs):
    print str(kwargs)
    if len(kwargs) == 3:
        a,b,c = kwargs['a'],kwargs['b'],kwargs['c']
        return a+b**2+c**3
    else:
        return None
print f(a=1,b=2,c=3),f(c=1,b=2,a=3)
print f(c=2)

Là encore, le nommage rend claire l'appel de la fonction.

On peut mixer tous ces mécanismes de passage d'arguments mais en respectant l'ordre suivant: obligatoires, optionnels, extensible non nommés puis extensible nommés soit:

def g(a,b=2,*args,**kwargs):
    print a,b,args,kwargs
g(1,2,3,4,5,x=3)

L'utilisation des listes extensibles d'arguments requiert une bonne maîtrise de la programmation et n'est pas recommandée en première utilisation. Il est idéal d'avoir un nombre fini d'arguments nommés avec valeurs par défaut dans un premier. Cependant, ce mécanisme permet de transmettre des listes d'arguments de façon efficace et évolutive et s'avère utile dans la construction de bibliothèques de fonctions dépendantes les unes les autres.

Exemple: une fonction de scipy:

Documentation d'une fonction

On peut écrire aisément une documentation pour une fonction en écrivant sous la définition un texte insérer dans des triples guillemets. On peut alors faire afficher la documentation à l'aide de la fonction help ou en faisant afficher l'attribut __doc__ de la fonction qui conserve le texte.

def Sort(L, cmp):
    """
    Fonction Sort(L): 
    prend une liste L en argument et la tri selon la méthode cmp.
    """
help(Sort)
print Sort.__doc__

Appliquer une fonction à une liste

une suppose une fonction f() définie, par exemple

f = lambda x: x**2
A = range(10)# initialisation d'une liste

une première version lourde mais qui ressemble au C

B = [ 0.0 ]*len(A)
for i in range(len(A)):
    B[i] = f(A[i])

une version similaire mais écrite en ligne

B = [ f(A[i]) for i in range(len(A)) ]

le même résultat en itérant directement sur les éléments de A

B = [ f(a) for a in A ]

en utilisant la fonction map du standard Python (générique)

B = map(f,A)

enfin le tout en une ligne, possible uniquement avec une définition faite par le mot-clé lambda

B = map(lambda x: x**2,A)