Convention de nommage des noms de fonctions

Discussion dans 'Développement d'un site Web ou d'une appli mobile' créé par dorian53, 16 Février 2011.

?

Quelle convention préférez-vous

  1. 1 Au pluriel

    0 vote(s)
    0.0%
  2. 2 Le type en suffixe

    0 vote(s)
    0.0%
  3. 3 Un suffixe générique

    0 vote(s)
    0.0%
  4. 4 Autrement

    0 vote(s)
    0.0%
  1. dorian53
    dorian53 WRInaute passionné
    Inscrit:
    10 Avril 2005
    Messages:
    1 886
    J'aime reçus:
    1
    Bonjour,

    Lorsque que vous créez une fonction qui retourne un utilisateur on peut imaginer :
    - getUser()
    - getUtilisateur()


    Mais lorsque que vous retourner une série d'utilisateurs comment nommez-vous votre fonction ?

    1/ Avec la règle du "s" ?
    - getUsers()
    - getUtilisateurs()


    Ok mais si vous utilisez un outils qui génère vos métodes automatiquement avec la règle du "s", les exceptions françaises deviennent ridicules.
    - getChevals()

    2/ Au singulier avec le type en suffixe ?
    - getUserArray()
    - getUtilisateurArray()


    Pourquoi pas, mais je n'aime pas !
    Si demain on vient à modifier le type retourné, le nom de la fonction n'est plus bon (ok faudra changer les traitements qui en découlent).
    Et je n'aime pas, car c'est comme si on venait à écrire...
    - getIdInterger()

    3/ Au singulier avec un suffixe explicite ?
    - getUserAll()
    - getUserCol() pour collection (mais c'est aussi un type)
    - ...

    J'ai une préférence pour la convention 3, et vous ?
    Vous posez vous ce genre de question ?

    Merci,
    Dorian
     
  2. Axiso
    Axiso WRInaute passionné
    Inscrit:
    8 Avril 2004
    Messages:
    1 203
    J'aime reçus:
    0
    Au pluriel, quitte à avoir des getStatuss(). Contrairement à ce qu'ils disent chez Wordpress, pour moi le code ce n'est pas de la poésie.
     
  3. dorian53
    dorian53 WRInaute passionné
    Inscrit:
    10 Avril 2005
    Messages:
    1 886
    J'aime reçus:
    1
    Aïe, oui, c'est moche :)
    Je n'avais pas pensé à ce cas
     
  4. spout
    spout WRInaute accro
    Inscrit:
    14 Mai 2003
    Messages:
    9 169
    J'aime reçus:
    346
  5. dorian53
    dorian53 WRInaute passionné
    Inscrit:
    10 Avril 2005
    Messages:
    1 886
    J'aime reçus:
    1
    Merci pour cette réponse spout.
    C'est justement avec Doctrine ORM que j'avais rencontré ce soucis de pluriel qui revient fréquemment même sur des fonctions écrites à la main.
    Cela me permet de confirmer mon choix (du suffixe) car je ne veux pas m'embêter à gérer des exceptions grammaticales.
    Les exceptions sont causes de problèmes et pertes de temps.
     
  6. screuscreu
    screuscreu WRInaute impliqué
    Inscrit:
    14 Janvier 2008
    Messages:
    687
    J'aime reçus:
    0
    Moi j'utilise CakePHP intensivement et oui cela marche bien ... mais au final pour gagner du temps je' n'hésite plus à faire du getStatuss ... tant pis pour les poètes ;)
     
  7. spout
    spout WRInaute accro
    Inscrit:
    14 Mai 2003
    Messages:
    9 169
    J'aime reçus:
    346
    Ahhh un autre utilisateur de CakePHP sur WRI :D
    Avec la convention (over configuration) ça devrait être getStatuses()
     
  8. poulpe
    poulpe WRInaute discret
    Inscrit:
    29 Juin 2004
    Messages:
    88
    J'aime reçus:
    0
    Pour ma part, j ajoute que je n'ecris jamais du code en FR, tous les commentaires, noms de methodes, variables etc sont en anglais, c est plus simple pour les projets d equipes ou tout le monde ne parle pas francais. Si on se retrouve avec chaque dev qui ecrit dans sa propre langue ca devient complique...
     
Chargement...
Similar Threads - Convention nommage noms Forum Date
Recherche convention de nommage / codage PHP et MySQL Développement d'un site Web ou d'une appli mobile 14 Décembre 2007
Méthodes de référencement peu conventionnelles Référencement Google 14 Mai 2018
Le salaire d'un référenceur (convention syntec) Droit du web (juridique, fiscalité...) 25 Février 2011
Création de sites & Conventions collectives Droit du web (juridique, fiscalité...) 29 Avril 2009
Facebook n'accepte pas le renommage de ma page Facebook 18 Octobre 2017
renommage des photos Débuter en référencement 5 Octobre 2013
Nommage des images, leur taille (en pixels) et attribut ALT Débuter en référencement 6 Février 2012
Renommage de site Débuter en référencement 26 Janvier 2012
Règles nommage url et pages Débuter en référencement 8 Mars 2011
Nommage Bilingue de mes images Référencement international (langues, pays) 5 Novembre 2010
Changement du système de nommage des images Problèmes de référencement spécifiques à vos sites 11 Mars 2010
Stratégie de nommage site / blog Noms de domaine et référencement 12 Février 2008
Nommage des pages html en miniscules/majuscules Débuter en référencement 4 Janvier 2007
Url RW et nommage URL Rewriting et .htaccess 12 Décembre 2006
Pb de règle de renommage ou pb technique ? URL Rewriting et .htaccess 14 Janvier 2006
Question pour nommage fichier base de données pour Google Référencement Google 26 Juillet 2005
Nommage de ma page Débuter en référencement 5 Juillet 2005
Renommage de pages, impact sur le référencement Débuter en référencement 27 Janvier 2005