Prototyper une fonction

Lorsqu’on veut utiliser une fonction, pour l’appeler, on a besoin de préciser les informations suivantes.

• Son nom.
  
  Exemple : euclid, fct, etc.
• Ses paramètres et leur type, c’est-à-dire quelles sont les valeurs que doit utiliser la fonction, ainsi que leur type (int, float, str, etc.)
  
  Exemple
  euclid(int a, int b) indique que cette fonction prend des paramètres entiers. int est pour rappel l’abréviation de « integer », ce qui signifie « entier » en français.
• Le retour et son type.
  
  Exemple
  int euclid(int a, int b) indique que le retour de la fonction est un nombre entier.

La précision de ces informations constitue le prototype de la fonction.

Voici quelques recommandations concernant le nommage de fonctions.

• Le nom doit indiquer de manière succincte ce qu’est la fonction, cela permet d’améliorer la lisibilité du code.
• Par convention, les informaticiens utilisent le camelCase ou le snake_case pour nommer une fonction.
  • Le camelCase (« casse de chameau » en anglais) est une convention d’écriture qui consiste à écrire un ensemble de mots en les liant, sans espace ni ponctuation, et à mettre une majuscule sur la première lettre de chaque mot (sauf le premier).
  • Le snake_case (« casse de serpent » en anglais) est une convention d’écriture qui consiste à écrire un ensemble de mots en les séparant par des tirets bas, et à mettre une minuscule sur la première lettre de chaque mot.

Exemple
Nommage de la fonction « test affichage écran » avec les conventions camelCase et snake_case.

camelCase	snake_case
testAffichageEcran	test_affichage_ecran

Un nom de fonction ou de variable ne doit pas contenir d’espaces, ni de tirets « hauts » (-) ou d’accents.

On veut prototyper une fonction qui prend en paramètres les coordonnées de deux points d’un plan orthonormé et qui retourne la distance euclidienne entre les deux points.

Rappel
Si A(x_A ; y_A) et B(x_B ; y_B) alors .

Pour prototyper cette fonction, on doit choisir un nom qui corresponde à ce qu’elle fait : cette fonction est censée calculer une distance euclidienne, on peut donc la nommer « distance ».

On doit ensuite déterminer les paramètres de la fonction : l’énoncé indique que l’on doit entrer les coordonnées de deux points, il y a donc quatre variables.

Pour le choix des variables, autant utiliser les notations mathématiques qui sont universelles, soient :

• x₁ pour l’abscisse du premier point ;
• y₁ pour l’ordonnée du premier ;
• x₂ pour l’abscisse du second ;
• y₂ pour l’ordonnée du second.

Python n’a pas besoin du type de variable, il est donc ici inutile de préciser que ces paramètres doivent être des flottants (nombres décimaux).

Le retour de la fonction est une distance, il faut donc écrire en langage informatique (implémenter) la formule mathématique rappelée ci-dessus. Dans un langage autre que Python, il faudrait préciser que c’est un flottant de la manière suivante : float distance(float x1,float y1,float x2,float y2).

Pour pouvoir utiliser la racine carrée, on est obligé d’importer la bibliothèque qui permet de faire des mathématiques et d’utiliser la fonction racine carrée, qui est sqrt pour Python.

Voici ci-dessous les lignes de code qui permettent de prototyper la fonction souhaitée.

Le tableau ci-dessous donne l’explication ligne à ligne.