Page 55 - arduino_Neat

12. BIEN CODER

L'utilisation d'un langage de programmation passe par l’apprentissage d'un vocabulaire et d'une
syntaxe précise. Dans ce chapitre, nous aborderons quelques unes de ces règles ainsi que
d'autres éléments à prendre en considération dans l'écriture d'un programme Arduino. Si
quelqu’un doit lire ou modifier votre code, vous pouvez lui faciliter la tâche en attachant une
attention particulière à sa structure et en y apposant des commentaires qui expliquent votre
logique. Bref, un code clair offre une meilleure lecture, qu'il s'agisse de modifier ses
configurations pour l’adapter à votre besoin ou de localiser une source d'une erreur.
CONVENTIONS DE NOMMAGE

La syntaxe d'un langage de programmation se base généralement sur une « convention de
1
nommage ». Il est important de respecter cette nomenclature pour rester dans l'esthétique
du code.
Dans la déclaration des variables, il faut écrire les constantes en majuscule :
const int CAPTEUR = A0; // CAPTEUR est une constante.
Pour les autres variables (int, char, etc.), les fonctions et les sous-routines seront en minuscule.
Dans le cas où ces variables ont des noms composés, le premier mot est en minuscule et les
autres commencent par une majuscule. Par exemple :
int bookSprint = 2011;
Pour les sous-routines (voir explication plus bas), la règle est identique à celle des variables
composées. Par exemple :
afficherValeurCapteur ();
Attention à ne pas omettre le point-virgule à la fin des instructions.
DÉCLARER SES VARIABLES

Le nom des éléments (capteurs, actionneurs, etc. ) utilisés dans un projet sont généralement
repris par les variables du programme qui fait fonctionner le dispositif. Cette pratique permet
de clarifier la fonction des différentes variables. Par exemple pour choisir une variable qui a
pour fonction de définir port sur lequel est connectée une LED, nous choisirons la variable
suivante :
int brocheLed = 13;

INDENTER SON CODE

Il est conseillé d'effectuer un retrait par rapport à la ligne précédente à chaque nouveau bloc
d'instructions. Les blocs d'instructions inscrits dans les fonctions et boucles sont délimités par
des accolades, l'une est ouvrante et l'autre fermante.
if (etatCaptation == 1) {
if (valeurCapteur >= seuil) {
analogWrite (pinLed, HIGH);}
}
Le code ci-dessus n'est pas indenté. Après indentation, nous obtenons ceci :
if (etatCaptation == 1) {
if (valeurCapteur >= seuil) {
analogWrite (pinLed, HIGH);
}
}

55