[BEEC] Identificateurs (noms de variables, fonctions..)

Peut être qu'il y a pas de règle à établir la dessus, mais j'ai plusieurs dilemmes.

1) Faudrait il ne pas melanger l'anglais et le français dans les noms de variables/fonctions? je crois qu'on peut pas se passer des "set", "get", "print"...
Mais "print_tableau()" est il correct? Faudrait il ecrire "print_array()"? ou "afficher_tableau()" ?

2) Ensuite, qd un identificateur contient plusieurs mots, faudrait il séparer systematiquement chaque mot d'un underscore?

"set_element_tableau_final()", "url_image_avion"
J'ai plutot tendance à faire "set_cheminvideolarge()"

3) Faudrait il donner une taille max aux identificateurs?

4) Pour ou contre les abreviations du genre "tab", "tmp"?

5) A propos des majuscules, il en faut :
a) pas du tout
b) une à chaque mot
c) une à chaque mot sauf le premier mot
?

6) Certains prefixent la variable du type de celle ci (ex "int i_numero"), pour ou contre?

Vos avis sur le sujet?

Moi les variables je mets pas de underscore parcontre le premier caractere du deuxieme mot a une majuscule et meme le troisieme mot si il y a en un

Code:

---

int dataRawBuffer;

---

et pour les fonctions je mets des underscores

Code:

---

void array_to_string();

---

Enfin je crois qu'il n'y a pas de règle mais plutot des conventions.

Ca me semble bien, mais les fonctions de la librairie standard du C (et leurs parametres) sont tout en minuscule et en general sans underscore. Pourquoi?

Citation:

---

Envoyé par Gruik

6) Certains prefixent la variable du type de celle ci (ex "int i_numero"), pour ou contre?

---

heu perso, j'avais un prof qui voulait que l'on mette

Code:

---

1 2	int l_ivariable; char l_cvariable;

---

Pour des variables locales fallait mettre l_ pour une variable générale g_,
après la premiere lettre du type et enfin le nom de la variable

Ah, mais sachant qu'on est pas sensé utiliser de variables globales, c'est un peu inutile non?

Citation:

---

Envoyé par Gruik

Ah, mais sachant qu'on est pas sensé utiliser de variables globales, c'est un peu inutile non?

---

Faut arrêter avec les interdits, c'est très fortement déconseillé. On va dire que les variables globales existes.

1). Melanger le francais et anglais ne pose pas de probleme en soit, je pense.
Mais l'anglais étant la langue de l'informatique il vaut mieux tout mettre en anglais.
Une fois je suis tombé sur un code avec des noms de variables en allemand, et ben c'etait pas de la tarte pour comprendre.

2). Voir par exemple les fonctions de Gtk+

Code:

---

1 2	gtk_text_view_new_with_buffer(...)

---

Le nom de la fonction est assez explicite pour savoir ce que fais la fonction.

je trouve que ca fait quand meme un peu long...

3). Tu veux dire une taille max pour le nom d'une variable ou le nom d'une structure par exemple? Oui il faut une taille max mais laquelle alors la je vois pas.

4). Pour les variables j'aime bien donner un nom explicite
Pas de variable type a, b, c.
Et oui pour tmp pour une variable temporaire, ret pour la valeur que l'on va retourner...

Pour les indices j'aime bien le i (comme tout le monde je pense :) :) )

5). Pour les noms avec plusieurs mots, je fais comme gnto.

6). Pour les préfixes, bof bof, encore pour un pointeur, faire preceder de p_ pourquoi pas mais pas pour les types courants comme int char, long... non.

Y'a t'il une limite (fixé par le compilateur) sur la longueur du nom d'une variable ?

Citation:

---

Envoyé par gnto

Y'a t'il une limite (fixé par le compilateur) sur la longueur du nom d'une variable ?

---

Le minimum est fixé par la norme. De mémoire :

• C90 : 8 caractères.
• C99 : 32 caractères.

A vérifier : "google n1124" pour les plus téméraires...

Citation:

---

Envoyé par Gruik

1) Faudrait il ne pas melanger l'anglais et le français dans les noms de variables/fonctions? je crois qu'on peut pas se passer des "set", "get", "print"...
Mais "print_tableau()" est il correct? Faudrait il ecrire "print_array()"? ou "afficher_tableau()" ?

---

Il faut une regle... c'est tout. On peut faire tout en anglais, utiliser le vocabulaire informatique en anglais et celui du domaine en francais (dont print_array mais print_compte_courant), tout en francais sauf ce qui est dans une liste fixee au depart, tout en francais. Le choix va dependre du contexte.

Citation:

---

2) Ensuite, qd un identificateur contient plusieurs mots, faudrait il séparer systematiquement chaque mot d'un underscore?

"set_element_tableau_final()", "url_image_avion"
J'ai plutot tendance à faire "set_cheminvideolarge()"

---

De nouveau, c'est un choix arbitraire. Mais il faudra m'expliquer ta regle qui fait qu'apres set il faut un underscore mais pas apres chemin. Et j'aime pas trop les methodes qui font que les mots ne sont pas visibles, il y a un risque d'ambiguite.

Citation:

---

3) Faudrait il donner une taille max aux identificateurs?

---

Je ne le ferais que si une plateforme cible a une limitation.
En general, plus la portee d'un identificateur est restreinte, plus son nom doit etre court. L'identificateur qui controle une boucle ne doit pas faire 30 caracteres.

Citation:

---

4) Pour ou contre les abreviations du genre "tab", "tmp"?

---

Les abreviations sont a prendre dans une liste officielle pour le projet.

Citation:

---

5) A propos des majuscules, il en faut :
a) pas du tout
b) une à chaque mot
c) une à chaque mot sauf le premier mot
?

---

C'est la meme question que le 2. Note qu'on peut adopter des regles differentes suivant la nature de ce qui est identifie (par exemple les types commencent par une majuscules mais pas les fonctions ni les variables).

Citation:

---

6) Certains prefixent la variable du type de celle ci (ex "int i_numero"), pour ou contre?

---

Si le type est logique (i pour index et pas pour int), ca ne me derange pas trop mais je ne vois pas tres bien ce que ca apporte. Sinon, on arrive aux absurdites du SDK de MS ou par compatibilite on utilise des prefixes qui ne decrivent plus l'etat des choses.

Citation:

---

Envoyé par Emmanuel Delahaye

Le minimum est fixé par la norme. De mémoire : [LIST][*]C90 : 8 caractères.

---

Je suis a peu pres certains que c'est six caracteres sans distinction majucule/minuscule pour les identificateurs a liaison externe (pour pouvoir les mettres dans un mot de 36 bits avec un codage utilisant 6 bits par caracteres).

Comme je l'ai deja ecrit par ailleurs, je ne tiendrais compte de ces limitations que s'il est connu qu'une des cibles l'a.