Reglas Para Programas En C++

Sumario de reglas y recomendaciones del documento "Programming in C++, Rules and Recommendations"

Este es el sumario de reglas y recomendaciones de programación del documento Programming in C++, Rules and Recommendations (Programando en C++, Reglas y Recomendaciones) de Mats Henricson y Erik Nyquist para el buen estilo en la codificación. Aunque son específicas para C++, muchas de ellas puedenaplicarse a C estándar (ANSI C) y a otros lenguajes como Java y JavaScript.

Sumario de Reglas
Regla 0 Cada vez que se rompa una regla, debe ser claramente documentado.

Regla 1 Los archivos de inclusión (#include) en C++ siempre tienen la extensión de nombre de archivo ".hh".

Regla 2 Los archivos de implementación en C++ siempre tienen la extensión de nombre de archivo ".cc".

Regla 3Los archivos de definición siempre tienen la extensión de nombre de archivo ".icc".

Regla 4 Cada archivo que contenga código fuente debe ser documentado con un comentario introductorio que provea información sobre el nombre de archivo y su contenido.

Regla 5 Todos los nombres de archivo deben incluir información de copyright.

Regla 6 Todos los comentarios deben ser escritos en idiomainglés. (Nota: Esta regla aplica en el caso de desear compartir software por Internet).

Regla 7 Cada archivo de inclusión debe contener un mecanismo que prevenga múltiples inclusiones del archivo.

Regla 8 Cuando se usen los siguientes tipos de definiciones (en archivos de implementación o en otros archivos de inclusión), deben ser incluidas como archivos separados:
* Las clases que sonusadas como clases base,
* Las clases que son usadas como variables miembros,
* Las clases que aparezcan como tipo de retorno o como tipos de argumentos en prototipos de función miembro o función
* Prototipos de funciones para funciones/funciones miembros usadas en funciones miembro inline que están definidas en el archivo.
Regla 9 Las definiciones de clases que son acezadas solamentevía punteros (*) o referencias (&) no deberían ser incluidas como archivos de inclusión.

Regla 10 Nunca especifiques nombres de rutas relativa de UNIX en directivas #include.

Regla 11 Cada archivo de implementación debe incluir los archivos relevantes que contengan:
* declaraciones de tipos y funciones usadas en las funciones que son implementadas en el archivo.
*declaraciones de variables y funciones miembro usadas en las funciones que son implementadas en el archivo.
Regla 12 El identificador de cada clase, tipo de enumeración, definición de tipo, función, constante, y variable en una biblioteca de clases que sea globalmente visible debe empezar con un prefijo que sea único para la biblioteca.

Regla 13 Los nombres de variables, constantes, y funciones debenempezar con una letra minúscula.

Regla 14 Los nombres de tipos de datos abstractos, estructuras, definiciones de tipos, y tipos enumerados deben empezar con una letra mayúscula.

Regla 15 En nombres que consistan de más de una palabra, las palabras se escriben juntas y cada palabra que sigue a la primera se empieza con una letra mayúscula.

Regla 16 No uses identificadores que empiecen con unoo más caracteres de subrayado ('_' o '__').

Regla 17 Un nombre que empiece con una letra mayúscula debe aparecer directamente después de su prefijo.

Regla 18 Un nombre que empiece con una letra minúscula debe estar separado de su prefijo usando un carácter de subrayado ('_').

Regla 19 Un nombre debe separarse de su sufijo usando un carácter de subrayado ('_').

Regla 20 Las seccionespublic, protected, y private de una clase deben estar declaradas en ese orden (la sección public se declara antes de la sección protected la cual se declara antes de la sección private).

Regla 21 Ninguna función miembro debe ser definida dentro de la definición de la clase.

Regla 22 Nunca especifiques datos miembros públicos o protegidos en una clase.

Regla 23 Una función miembro que no...