I commenti e la loro importanza – #4 linguaggio C

Se ti sei perso la guida precedente clicca qui: Introduzione al linguaggio C.

In questa guida analizzeremo la prima riga del sottostante codice. Vi ricordo che il programma svolge l’operazione di somma tra due numeri inseriti dall’utente da tastiera e ne stampa il risultato a video.

1 /*Somma di due numeri*/
2 #include <stdio.h>
3 main(){
4      int a, b, s;
5      scanf("%d %d", &a, &b);
6      s = a + b;
7      printf("%d", s);
8 }

Una cosa che i programmatori, sopratutto quelli “amatoriali”, sottovalutano, sono i commenti. I commenti non servono assolutamente a niente ai fini della risoluzione del problema, hanno semplicemente uno scopo documentativo. Perciò quelle parole delimitate dalla coppia di caratteri /* e */, che indicano l’inizio e la fine del commento, non verranno eseguite dal programma ma serviranno semplicemente a chi leggerà il codice per aiutarne la comprensione. Nell’esempio da noi analizzato, il commento /*Somma di due numeri*/ serve semplicemente per capire che il pezzo di codice sottostante svolge l’operazione di somma di due numeri. Ora vedremo alcune ragioni per cui i commenti sono molto importanti ai fini della programmazione:

• Un motivo molto importante è senza dubbio quello di far comprendere il codice del programma a una persona diversa da quella che lo ha progettato;
• I commenti servono anche al programmatore stesso che ha realizzato il codice per poterlo comprendere al meglio anche a distanza di tempo. Questa seconda esigenza può nascere anche dalla necessità di dover modificare, ampliare o migliorare in momenti successivi il lavoro realizzato. Ovviamente il segmento di codice da noi preso in esame si commenta da solo essendo formato da pochissime righe di codice, provate a pensare ad un programma lungo centinaia di righe, come potete ben immaginare senza un minimo di documentazione ci sarebbe da impazzire, soprattutto in presenza di errori nel codice;

Un alto modo per creare commenti in C è il seguente:

//somma di due numeri

Questo tipo di commento viene aperto dai caratteri // e termina alla fine della riga. Perciò tutto ciò che scriveremo a destra delle due barre, sulla medesima riga, comparirà come commento e non verrà considerato come codice vero e proprio.

Esempi di errori:

//somma di
due numeri

Questa sintassi è errata, perchè nel commento comparirà sol “somma di” essendo “due numeri” in una riga diversa rispetto a quella delle due barre

somma // di due numeri

Anche questa sintassi è sbagliata proprio perchè i commenti devono comparire a destra delle due barre.

Passiamo ora all’analisi della seconda riga del codice: Le librerie.

Lasciate un like alla nostra pagina Facebook per rimanere sempre aggiornati. 😉

Staff Melabu