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

3.7 Declaración de variables
Se debe colocar cada variable en una línea, incluso siendo del mismo tipo.
int x, y; // Es necesaria una segunda mirada para fijarse en 'y'
int main()
{
int x;
int y;
char c;
char toret[128];
}
// más cosas ...
return 0;
C permite minimizar muchísimo ciertas expresiones. Por ejemplo, el siguiente bucle copiaría
una cadena de caracteres de C (un vector de char), en otra de destino:
void copiaCadena(char cadDestino[], const char cadOrigen[])
{
int i = 0;
while( cadDestino[ i ] = cadOrigen[ i++ ] );
}
Esto es bueno en cuanto a espaciado vertical, desde luego, pero debe valorarse cuándo el
ahorro de espaciado merma la legibilidad del código.
void copiaCadena(char cadDestino[], const char cadOrigen[])
{
int i = 0;
for(; cadOrigen[ i ] != 0; ++i) {
cadDestino[ i ] = cadOrigen[ i ];
}
}
La anterior función realiza la misma tarea que la predecesora. Sin embargo, está
perfectamente claro cuándo el bucle termina (al llegar a la marca de fin de cadena de la cadena de
origen), cuándo se hace explícitamente una copia y también cuándo, después, se incrementan ambos
contadores. Es una función que se puede comprender de un vistazo, mientras que la anterior, aún
para un programador con experiencia, supondrá invertir unos cuantos segundos. Finalmente, la
calidad del código máquina generada es la misma en ambos casos, si bien es cierto que el primer
ejemplo podría generar, según el compilador, un número de instrucciones máquina algo menor.
4 Comentarios
Un comentario debe ser siempre clarificador, útil, y, en cambio, cuanto más corto mejor. En
particular, debe cuidarse en no insultar la inteligencia del lector en determinadas ocasiones,
comentando secuencias de código obvias y desesperarlo al encontrarse con construcciones
complejas que no tienen ningún comentario.