• [^] # Re: Je commente mon code :

    Posté par (site web personnel) . En réponse au sondage Je commente mon code :. Évalué à 2.

    Quand les noms de variables et de fonctions deviennent trop longs, le code devient difficile à comprendre. Dans le cas d'un nom de variable court, c'est plus facile à lire et plus difficile à comprendre.
    Exemple court :
    if( A > B) Traiter;
    Exemple long :
    if(NombreElementsDisponiblesEnMagasin > NombreElementsDemandesParLeClient) TraiterLaCommande;

    Je pense qu'il vaut mieux déclarer explicitement toutes les variables en donnant leur signification et des noms assez courts. Le code devient ainsi lisible, compréhensible et aéré.

    Exemple :
    int NbDispo; /* Nombre d'éléments disponibles en magasin */
    int NbDem; /* Nombre d'éléments demandés par le client */

    if( NbDispo > NbDem ) TraiterLaCommande;

    J'utilise généralement les variables en français de façon à reconnaitre du premier coup d'oeil ce qui appartient au programme et ce qui vient d'ailleurs. Bien entendu, ce n'est pas valable si on veut exporter son travail hors des pays francophones.