Syntaxe de définition d'une fonction (def, paramètres, return)

Le mot-clé def : déclarer une fonction

En Python, vous définissez une fonction en utilisant le mot-clé `def`, suivi du nom de la fonction, de parenthèses `()`, et de deux-points `:`. Le corps de la fonction (le bloc de code qui est exécuté lorsque la fonction est appelée) est indenté après les deux-points.

Syntaxe de base :

def nom_de_la_fonction():
    # Corps de la fonction (bloc de code indenté)
    # ...

Exemple d'une fonction simple (sans arguments et sans valeur de retour) :

def dire_bonjour():
    print("Bonjour !")

Le nom de la fonction doit respecter les mêmes règles que les noms de variables (commencer par une lettre ou un trait de soulignement, suivi de lettres, de chiffres, ou de traits de soulignement). Il est recommandé d'utiliser des noms descriptifs, en minuscules, avec des mots séparés par des traits de soulignement (snake_case).

Paramètres (arguments) : passer des données à une fonction

Les paramètres (ou arguments) permettent de passer des données à une fonction. Ils sont définis entre les parenthèses, après le nom de la fonction. Vous pouvez définir autant de paramètres que nécessaire, en les séparant par des virgules.

Syntaxe avec paramètres :

def nom_de_la_fonction(parametre1, parametre2, parametre3):
    # Corps de la fonction (bloc de code indenté)
    # Utilisation des paramètres
    # ...

Exemple :

def additionner(a, b):
    somme = a + b
    print(somme)

Lorsque vous appelez la fonction, vous devez fournir des valeurs pour les paramètres (les arguments). Ces valeurs sont affectées aux paramètres dans l'ordre où ils sont définis.

Appel de la fonction :

additionner(5, 3)  # Affiche 8 (5 est affecté à a, 3 est affecté à b)

Les paramètres sont des variables locales à la fonction. Elles n'existent que dans le corps de la fonction.

L'instruction return : renvoyer une valeur

L'instruction `return` permet à une fonction de renvoyer une valeur (ou plusieurs valeurs) à l'appelant. Lorsqu'une instruction `return` est rencontrée, l'exécution de la fonction se termine immédiatement, et la valeur (ou les valeurs) spécifiée(s) après `return` est(sont) renvoyée(s).

Syntaxe :

def nom_de_la_fonction(parametres):
    # Corps de la fonction
    # ...
    return valeur  # Ou return valeur1, valeur2, ...

Exemple :

def carre(nombre):
    return nombre * nombre

resultat = carre(5)
print(resultat)  # Affiche 25

Si une fonction n'a pas d'instruction `return`, ou si `return` est utilisé sans valeur, la fonction renvoie implicitement `None`. `None` est une valeur spéciale en Python qui représente l'absence de valeur.

Exemple de fonction sans valeur de retour (ou qui retourne implicitement `None`) :

def afficher_message(message):
    print(message)

retour = afficher_message("Bonjour")
print(retour)  # Affiche None

Une fonction peut retourner plusieurs valeurs en les séparant par des virgules après `return`. Dans ce cas, les valeurs sont renvoyées sous forme de tuple.

Exemple de fonction retournant plusieurs valeurs :

def div_mod(a, b):
    quotient = a // b
    reste = a % b
    return quotient, reste  # Retourne un tuple (quotient, reste)

resultat = div_mod(10, 3)
print(resultat)  # Affiche (3, 1)

q, r = div_mod(10, 3)  # Tuple unpacking
print(q, r) # 3 1

Structure complète d'une définition de fonction : exemple

Voici un exemple complet de définition de fonction, combinant `def`, les paramètres, et `return` :

def calculer_prix_ttc(prix_ht, tva):
    """Calcule le prix TTC à partir du prix HT et du taux de TVA.

    Args:
        prix_ht (float): Le prix hors taxes.
        tva (float): Le taux de TVA (entre 0 et 1).

    Returns:
        float: Le prix TTC.
    """
    prix_ttc = prix_ht * (1 + tva)
    return prix_ttc

prix = calculer_prix_ttc(100, 0.20)  # Appel de la fonction
print(prix)  # Affiche 120.0

Cette fonction :

• Est nommée `calculer_prix_ttc`.
• Prend deux paramètres : `prix_ht` et `tva`.
• Calcule le prix TTC.
• Retourne le prix TTC.
• Inclut une docstring qui explique son rôle, ses arguments, et sa valeur de retour.