C/Estrutura e estilo: Diferenzas entre revisións

Nas vindeiras seccións, tratarase de explicar as técnicas de "boa programación" que farán os teus programas máis efectivos.

 

Os seguintes dous bloques de código son basicamente o mesmo: ambos os dous conteñen exactamente o mesmo código, e compilaranse e executaranse co mesmo resultado. Aínda así, hai unha diferencia esencial.

 

Este libro centrarase no anterior fragmento de código, e como melloralo. Nótese que durante o transcurso do titorial, aparecerán moitos anacos de código aparentemente redundantes. Estes están simplemente para servir de exemplo de técnicas que serán explicadas, sen romper co fluxo global de código que o programa logra.

 

Engadir espazos en branco no teu código podería dicirse que é a parte máis importante da boa estrutura de código. O seu uso efectivo pode crear un indicador visual de como flúe o teu código, o cal pode resultar moi importante á hora de volver ao código para o seu mantemento e revisión.

 

<source lang="c">

#include <stdio.h>

En lugar de pór todo nunha soa liña, sería moito máis lexible se se fixesen saltos de liña de xeito que cada función e cada declaración tivese a súa propia liña.

 

As liñas baleiras deberías de usalas en tres partes fundamentais do teu código:

<source lang="c">

#include <stdio.h>

Isto fará o código móito máis fácil de ler que antes. Pero aínda pode ser máis lexible.

 

Aínda que engadir saltos de liña entre bloques de código importantes pode facer o código máis lexible, non dá unha idea do fluxo do programa. O uso do tabulador pode sermos moi útil nestes momentos: as tabulacións separan visualmente as rutas de código ao mover os puntos onde estes comezan a unha nova columna na liña. Esta práctica tan sinxela fará moito máis doado ler o código. As tabulacións seguen unha regra moi simple:

 

 

Así que apliquémolo ao código co que estamos a traballar:

É preciso comentar que algúns editores de texto xa automáticamente realizan as tabulacións ao premer na tecla intro.

 

Os comentarios poden ser moi útiles nun código para diversos propósitos. Son o modo máis doado para explicar o funcionamento e propósito de partes específicas dun programa, e mesmo supoñen unha separación visual entre varias partes do código. Comentar correctamente o teu código fará moito máis doado recordar para que servían moitas partes específicas do código.

 

Este capítulo centrarase nos diversos usos de cada un deles.

 

 

Os comentarios dunha soa liña son o máis útil para comentarios na marxe que expliquen o que fan certas partes do código. O mellor lugar para situar estes comentarios é a continuación das declaracións de variables, e anacos de código que poidan precisar dunha explicacións.

}

</source>

Os comentarios de máis dunha liña son o máis útil para grandes explicacións de código. Poden utilizarse para notas relativas aos dereitos de autor ou a licenza, e tamén para explicar o propósito de toda unha ruta de código. Isto é dobremente útil: por unha banda, facilita a comprensión das funcións, e pola outra, facilita o descubrimento de erros (se sabes o que unha ruta de código debería facer, serache máis doado atopar a parte do código culpable).

 

A descrición dunha función debería de ser algo semellante a isto:

<source lang="c">

Entrada : int i (número de liñas), int l (número de instancias por liña)

Saída : 0 (se todo vai ben)

 

<!-- Categorías: -->

[[Categoría:C|Estrutura e estilo]]