# Les fonctions

L'activité consiste en un TD comprenant un __cours dirigé__ et des __exercices__ relatifs à la notion de _fonctions_ en Python.

## Pré-requis

Avoir effectué l'activité sur les [boucles](../chapitre_3/)

## Consignes

1. Télécharger le fichier [TD.ipynb](./TD.ipynb),
2. Se rendre sur [Basthon](https://notebook.basthon.fr/),
3. Ouvrir le fichier TD.ipynb téléchargé,
4. Suivre le déroulé du TD, les réponses sont à mettre directement dans votre fichier,
5. À la fin de la séance, n'oubliez pas de sauvegarder votre fichier sur votre clé USB ou espace personnel.

---------

## Mémo - Les fonctions

### Définir une fonction

```python
def nom_fonction(parametre1, parametre2):
    """Documentation de la fonction (docstring)"""
    # Instructions
    resultat = parametre1 + parametre2
    return resultat
```

### Appeler une fonction

```python
# Définition
def carre(x):
    return x * x

# Appel
resultat = carre(5)  # resultat vaut 25
print(carre(3))      # Affiche 9
```

### Fonction sans retour

```python
def afficher_bonjour(prenom):
    print("Bonjour", prenom)
    # Pas de return → renvoie None

afficher_bonjour("Alice")  # Affiche : Bonjour Alice
```

### Fonction avec plusieurs paramètres

```python
def aire_rectangle(longueur, largeur):
    return longueur * largeur

surface = aire_rectangle(5, 3)  # surface vaut 15
```

### Fonction avec valeur par défaut

```python
def saluer(prenom, message="Bonjour"):
    print(message, prenom)

saluer("Alice")              # Affiche : Bonjour Alice
saluer("Bob", "Salut")       # Affiche : Salut Bob
```

### Portée des variables

```python
x = 10  # Variable globale

def ma_fonction():
    y = 5  # Variable locale (existe uniquement dans la fonction)
    return x + y

print(ma_fonction())  # Affiche 15
# print(y)  # ERREUR : y n'existe pas ici
```

### Docstring et spécification

```python
def moyenne(a, b):
    """
    Calcule la moyenne de deux nombres.

    Paramètres:
        a (int ou float): premier nombre
        b (int ou float): deuxième nombre

    Retourne:
        float: la moyenne de a et b
    """
    return (a + b) / 2
```

### Exemple complet

```python
def est_pair(n):
    """Renvoie True si n est pair, False sinon."""
    if n % 2 == 0:
        return True
    else:
        return False

# Version simplifiée
def est_pair(n):
    return n % 2 == 0

# Utilisation
print(est_pair(4))   # True
print(est_pair(7))   # False
```

---------

## Pour aller plus loin

Félicitations ! Vous avez terminé les bases de la programmation Python.