Estilo de programación

[Puck2099]

Buenas,

Antes de empezar a tirar código "en serio" para mi trabajo fin de carrera me estaba planteando seguir algunas reglas de estilo estandar.

Mi problema es que, acostumbrado a leer y modificar programas de otras personas, dependiendo del día, mi estado de ánimo o cualquier cosa puedo pasar de escribir de una forma a otra y así el código no queda muy homogéneo que digamos.

No tengo problemas con la identación, pero sí con cosas como poner el nombre de funciones con la inicial en minúsculas o mayúsculas, separar palabras con subrayado o poniendo la segunda pegada en mayúscula, etc.

En mis inicios con la programación sé que vi que había distintas reglas de estilo, incluso tenían nombres diferentes (supongo que de la gente que las propuso), pero ya ni me acuerdo.

¿Sabéis decirme links o al menos el nombre de reglas para aplicarlas a programación orientada a objetos con C++? :brindis:

[juanvvc]

Algunos links:

- En castellano, un resumen del estilo más usado en C/C++ por las unis de Vigo y Valencia: http://informatica.uv.es/iiguia/AED/laboratorio/Estilocpp.pdf y http://trevinca.ei.uvigo.es/~jgarcia/TO/guiaestilocpp.pdf
- La guía GNU coding standards, de lectura tan farragosa como obligatoria: http://www.gnu.org/prep/standards/ Linus Torvalds hace un comentario sobre esta guía: "Imprímela y quémala. Es un magnífico ejercicio simbólico" Estoy medio de acuerdo con él, pero hay que leerla antes de quemarla :)
- La guía de estilo del kernel Linux, muy amena como todo lo que escribe Mr. Torvalds: http://lxr.linux.no/linux/Documentation/CodingStyle Cuidado porque es ligeramente distinta a las otras y más fiel al espíritu K&R. Es la que yo prefiero, excepto en los switches.
- El estilo que a ti más te guste, pero siendo consecuente. Sobretodo con la indentación.

[Ñuño Martínez]

Pues hombre, no es que siga un método concreto, pero por si te inspira, yo más o menos lo hago como sigue (no es C++ pero casi):


/* Archivo: nombre.c
* Descripción: Tampoco hay que alargarse, pero no hay que olvidar
* cosas importantes.
* Autor: El menda (pero lo pongo siempre por si las moscas).
*
* Aquí, la licencia si se tercia (GPL, MIT, BSD,...)
*/



int VariableVariante, /* Las variables las suelo comentar así. */
OtraVariable; /* Siempre pongo nombres "con significado". */

char *EstaVariableNoNecesitaExplicacion;



/* NombreFuncionOProcedimiento:
* Una descripción corta de lo que hace y los parámetros. */
void NombreFuncionOProcedimiento (int Parametro)
{
/* Dentro pongo comentarios, al inicio de cada "sección", para
no perderme. De indexar, como dices que no tienes problemas,
pues a tu gusto. */
}



/* OtraFuncion:
* Como ves, dejo tres líneas en blanco entre función y función. Lo mismo con
* las "structs", clases, "enums" y tal. */
int OtraFuncion (void)
{
/* Te enseño un "if" porque me gusta esta forma de hacerlo. */
if (EsVerdaderoYTal) {
TalYcualPascual ();
}
else {
}
}

Tampoco te mates. Con ser constante y no cambiar cada dos por tres el estilo vale.

[Puck2099]

Gracias a los dos, después de leer vuestras sugerencias creo que me quedo con ésta (http://trevinca.ei.uvigo.es/~jgarcia/TO/guiaestilocpp.pdf) que es la más parecida a "mi estilo" y con la que más cómodo me siento :brindis: