Guía de estilo de programación en C++ estructurado

1 Introducción
En este documento se explica brevemente, y con ejemplos, cómo escribir programas más legibles.
A lo largo de su vida profesional, cualquier programador se plantea la pregunta de cómo escribir sus
programas de manera que sean más legibles, y por tanto que puedan ser mantenidos (corrección de
errores, ampliación de funcionalidad) con facilidad, tanto por él mismo como por otros
programadores (una situación típica en cualquier empresa).
Dado que la misma situación en cuanto a legibilidad de código suele ser resuelta por
distintos programadores de la misma forma, pero con distintos matices de diferenciación, es
interesante seguir una guía de estilo que nos explique como otros resolvieron ese mismo problema,
hasta que dicha solución se convirtió en un estándar.
2 Indicaciones generales
El propósito de seguir una norma de estilo es hacer que el código fuente de un programa sea tan
legible como sea posible. Así, hay tres puntos básicos que se deben cuidar: el espaciado horizontal,
el espaciado vertical y la indentación. El espaciado horizontal consiste en que las líneas en las que
esté dividido el código fuente deben ser de una longitud máxima lo más próxima posible a 80
caracteres, ya que al imprimir el código en papel cualquier línea superior a 80 columnas se descarta
automáticamente.
Uno de los problemas que se puede encontrar al codificar es la manera más correcta para
dividir una línea muy larga. Respuestas comunes a esta pregunta son: antes de una subexpresión,
antes de un operador, o antes de un paréntesis. Por ejemplo:
int x = ( (a * b + c ) / ( c * d * d ) )
+ ( a / ( b * c ) )
+ ( ( 3.1451927 * b ) + d )
;
Los operadores deben separarse mediante espacios para mayor claridad, a excepción hecha
de operadores unarios como el incremento o decremento, tanto postfijo como prefijo, que suelen
colocarse pegados al operando al que modifican (lo más típico, por claridad), pero también pueden
colocarse espaciados, a elección del programador.
int x = ++ i;
int y = j++ + ++ x;
El espaciado vertical consiste en cuántas líneas ocupa una función o una estructura, en el
código fuente. En general, es útil autoimponerse un límite de una hoja por cada función o
procedimiento. Es extraño, siempre que la misma no consista en multitud de acciones repetitivas
(como escribir en un archivo), que una función bien diseñada ocupe más allá de un folio. En caso
contrario, será conveniente considerar que posiblemente sea interesante subdividirlo en varias
subfunciones (probablemente de acceso privado).
Además, en el espaciado vertical intervienen las llaves que se emplean para marcar el
comienzo y fin del cuerpo de una función, de un bucle, ... cada una de esas llaves puede llegar a
consumir una línea por sí sola, incluso dos. Así, para salvar algo de espacio vertical, se suelen
mantener las llaves de apertura y cierre, cada una en una línea, para el cuerpo de las funciones, y en
cambio colocar la llave de apertura en la misma línea para bucles y estructuras de decisión. Por
ejemplo: