L’aggiunta di un blocco di commenti all’inizio di un metodo è utile per aggiungere una nota su ciò che fa un metodo, nonché un elenco di parametri di input/output. Inoltre, alcune righe di testo leggibile all’interno di una sezione complicata di codice possono essere utili per aiutare l’utente e gli altri a ricordare lo scopo di questa particolare sezione di codice. A partire da 4D v18, l’esperienza di programmazione è migliorata grazie all’aggiunta dei blocchi di commento!
I commenti sono testi (note, descrizioni, promemoria, ecc.) nel codice sorgente, indicati con caratteri speciali in modo da essere ignorati dal compilatore durante l’esecuzione del codice. I commenti possono essere su una singola riga o su più righe. Ora, invece di avere molte righe precedute da //, si può semplicemente usare /* all’inizio di un commento e */ alla fine per commentare un intero blocco. È anche possibile comprimere ed espandere i commenti! E non è tutto: è possibile aggiungere commenti a qualsiasi parte di una riga, anche all’interno di una condizione if o di un ciclo:
Perché i commenti sono importanti
- In un team con più sviluppatori che lavorano allo stesso progetto, un codice ben commentato è utile agli altri che ci lavorano, in modo che possano capire meglio il codice e facilitare il processo di revisione/debug del codice.
- Siamo umani e dimenticare le cose è del tutto normale. Se si rivede o si modifica il codice in un secondo momento, i commenti possono aiutare a ricordare la logica utilizzata durante la scrittura del codice. Anche se scrivete del codice molto semplice, provate a leggerlo mesi o anni dopo. Vi sembrerà ancora semplice o vorreste aver aggiunto dei commenti?