Notation en python, variables, commentaires, ...
Définition :
Une variable est un emplacement mémoire contenant des données. Cette variable a un nom utilisé pour référencer( c.a.d. le retrouver) cet emplacement dans un programme.
Syntaxe : Règle pour nommer une variable
Un nom de variable doit respecter les règles suivantes :
il doit être constituer d'un seul mot
il doit contenir uniquement des lettres, des nombres ou le symbole _
il ne peut pas contenir de caractères accentués
il ne doit pas commencer par un chiffre
Convention utilisée en python
La convention d'usage[1] est décrite sur cette page web
Un nom de variable ou de fonctions commence par une minuscule. Si c'est un nom composé, il faut le séparer par des underscrores (caractère souligné _).
Une constante doit être écrite en majuscule.
Exemple :
usage | syntaxe |
variable pour un nombre de caméra | nombre_de_camera |
fonction racine carré | sqrt() |
constante pour le nombre maximum de camera tout en majuscule | NB_MAX_CAMERA |
nom d'une classe ou d'un type | MaCamera |
commentaire en python
Les commentaires sont précédés du symbole # (croisillon ou hash character)
Python coders from non-English speaking countries: please write your comments in English, unless you are 120% sure that the code will never be read by people who don't speak your language.
indentation
Python est un langage indenté.
Il est recommandé d'utiliser 4 espaces pour indenter une ligne.
4 espaces est la règle communément admise.
Après les mots clefs if, else, elif, for, while, def, with, try, except une indentation (4 espaces) doit être ajoutée pour définir le bloc d'instructions.
Si une seule ligne est définie dans le bloc tout peut être écrit sur la même ligne. Pour des raisons de lisibilité cette solution doit être évitée (tout sur une même ligne).