Différences

Ci-dessous, les différences entre deux révisions de la page.

--- faq:livre_blanc [2023/10/19 12:02] – [Conventions de nommage] CrazyCat
+++ faq:livre_blanc [2023/10/19 13:32] (Version actuelle) – [Conventions de nommage] CrazyCat
@@ Ligne 4: / Ligne 4: @@
 Que ce soit en TCL ou dans n'importe quel autre langage, vous devez vous créer et respecter des conventions de nommage, que ce soit pour les variables ou les procédures.
 <WRAP center round info 80%>
-Privilégiez l'anglais pour nommer vos variables et procédures, cela peut éviter certains problèmes
+Privilégiez l'anglais pour nommer vos variables et procédures, cela peut éviter certains problèmes. Mais prenez garde à ne pas utiliser de noms déjà existants, car TCL ne provoquera pas d'erreur.
 </WRAP>
 ==== Variables ====
@@ Ligne 29: / Ligne 29: @@
 Vous constaterez que le CamelCase n'est pas utilisé dans ce bout de code: les variables sont suffisamment simple pour que l'on s'en passe. Mais nous aurions pu appeler la variable //lfriends// `lnicksInMyChans`.
 ==== Procédures ====
+Comme pour les variables, les noms des procédures doivent être à la fois concis et explicites. Certains préconisent de les préfixer par le type de la donnée retournée, mais comme il est fréquent que les procédures ne renvoient rien (//void//) ou que le type soit variable, nous ne souscrivons pas à cette idée.
+Par contre vous pouvez tout à fait //regrouper//((entendez par là d'avoir des préfixes identiques)) les procédures de manière à mieux identifier leur champ d'actions.
+Ainsi, une procédure réagissant à un [[:scripts:binds#pub]] commencera par **pub.** (comme `pub.logMsg`) alors qu'une procédure agissant sur une base de données commencera par **db.** (comme `db.connect`). Notez aussi l'utilisation du <kbd>.</kbd> (point) comme séparateur plutôt que <kbd>:</kbd> (deux points). En effet, les <kbd>::</kbd> (double deux points) sont utilisés pour séparer les [[:tcl:namespace|espaces de nom]] et peuvent prêter à confusion, voir créer une erreur.
 {{tag> F.A.Q. Scripts}}