À quoi sert self dans une méthode d’instance Python ?

Réponse courte

Dans une méthode d’instance, self désigne l’objet concerné par l’appel. Il permet à la méthode de lire ou modifier ses attributs, par exemple self.nom ; Python lui transmet automatiquement l’instance lors d’un appel via l’objet.

Comprendre

Le rôle du premier paramètre

Une classe décrit des objets qui possèdent des attributs et des méthodes. Une méthode d’instance reçoit en premier paramètre une référence vers l’objet sur lequel elle est appelée. On nomme habituellement ce paramètre self. Ce nom est une convention Python largement suivie ; le mécanisme vient du premier paramètre de la méthode, pas d’un mot réservé qui changerait de sens.

Suivre un appel

Si p est une instance de la classe Personne et qu’on écrit p.saluer(), Python appelle la méthode en lui passant p comme premier argument. Dans la définition, self désigne alors ce même objet. Ainsi, self.prenom lit l’attribut de p, et une affectation self.prenom = valeur modifie l’attribut de cette instance. Deux objets distincts peuvent donc utiliser la même méthode tout en consultant des données différentes.

Un exemple

Dans une classe Compteur, une méthode incrementer(self) peut réaliser self.valeur = self.valeur + 1. Après c.incrementer(), c.valeur augmente ; un autre compteur d n’est pas modifié. On ne passe généralement pas explicitement c dans c.incrementer(c) : cela donnerait un argument en trop. Dans l’appel Compteur.incrementer(c), en revanche, l’objet apparaît explicitement parce que la méthode est appelée depuis la classe.

Exemples

  • Si c.valeur vaut 4, alors c.incrementer() avec self.valeur = self.valeur + 1 donne c.valeur égal à 5.
  • Avec p1.prenom = 'Ada' et p2.prenom = 'Lin', p1.saluer() et p2.saluer() consultent respectivement l’attribut de p1 et celui de p2.

Pièges fréquents

  • Oublier self dans la définition d’une méthode d’instance : l’objet ne serait pas reçu dans le paramètre prévu.
  • Écrire c.incrementer(c) après avoir déjà appelé la méthode depuis c : Python transmet déjà c comme premier argument.

Et maintenant ?

Questions proches

← Toutes les questions-réponses