Uno de los dones divinos y seguramente innatos que debe tener un programador que se precie, en mi opinión, es el de saber poner nombre a las funciones/métodos/clases que escribe.
Mi experiencia de estudiante ( es decir, corta) me ha llevado a múltiples situaciones en las que tengo que ayudar/pedir ayuda para solucionar algún problemilla con un código. La situación que suele darse es la siguiente:
- ¿¿¿Qué hace el método descubrirCosaLocal(String cadena) ???
- Busca la ruta a un fichero.
- Entiendo, ¿¿y qué guarda el atributo foo ??
- Un string con el resultado.
- Vale, entoces estas guardando en foo el resultado de descubrirCosaLocal() y luego…
- No no, descubrirCosaLocal() llama al método esEste() que va guardando el nombre del fichero que coge en cada iteración en la variable yaVeremos para después compararlos. Si la comparación devuelve un true entonces devuelvo el valor de yaVeremos y lo guardo en foo. ¿Entiendes?.
- Claro, ¿puedes prestarme tu DesertEagle y una bala?
¿Somos todos tan malos dando nombres a las cosas o solo me pasa a mí? ¿Alguien más invierte 15 minutos pensando cómo llamar a una clase?
4 Noviembre, 2007 a las 7:53 am
Yo no programo, así que entiendo que a mi no me pasa :lol:
4 Noviembre, 2007 a las 1:33 pm
Yo siempre he intentado poner nombres muy claros a todo lo que programo, aunque sí solía usar bastante las abreviaturas o los acrónimos. Eso mientras hacía MIS programas: prácticas o programitas chorras para colgar en Internet.
Ahora que trabajo con más gente programando, me toca ser muy estricto con ese punto, porque si los nombres no son claros luego no se entera ni $DEITY. Cuando manejas unos quince proyectos de código, y uno sólo puede tener varias decenas de paquetes y casi 200 ficheros de código fuente, es muuuuuy importante que los nombres estén claritos.
Claro que, eso puede llevar a líneas de código monstruosas, en plan:
PiticlinMetadataFactoryImplementation.getNosecuantosNavigationalQueryManager(creationParameters);
He llegado a tener líneas que ocupan hasta la columna 280… y lo más gracioso es que “por normas de estilo” luego toca ajustarlo a 80 columnas para que se pueda imprimir bien, de forma que una “línea” se convierte en cinco o seis… un show xD
4 Noviembre, 2007 a las 2:32 pm
No sabes lo que me consuela eso.
6 Noviembre, 2007 a las 12:50 am
[...] 6th, 2007 by Death Master El otro día leía esta entrada en el blog de Root Zero, en la que nuestro amigo lanza a la blogsfera una interesante pregunta [...]
6 Noviembre, 2007 a las 9:03 pm
Me pasa a mi también, ya lo he comentado en el blog de Death_Master pero ya puestos…
En el tema de nombres, al menos yo, suelo ser bastante abreviado sobretodo para proyectos propios y pruebas de código, en cuanto a proyectos en los que intervenga otra persona a parte de yo ya suelo emplear nombres más largos y descriptivos (sin demasiado lujo de detalles tampoco) pero lo suficientemente claros para no tener que estar rebuscando en el código.