Commentare il codice | Quando un commento ti cambia la giornata

Commentare, al giorno d’oggi (quanto mi sento vecchio quando parlo così), è diventato uno sport nazionale 😅

Commentiamo le notizie, gli status degli amici, le foto su Instagram. Se non si esprime la propria, ormai non si è più contenti.

In questo caso, per fortuna, c’è ancora un luogo in cui “commentare” ha un’importanza notevole.

Un luogo in cui un commento può cambiare le sorti della tua esistenza. Ovviamente parlo dello sviluppo delle applicazioni.

Stiamo scrivendo in una lingua che non conosciamo, cioè il linguaggio Swift, e più andrai avanti e più aumenteranno le keyword e le combinazioni tra queste che riuscirai ad utilizzare.

Potrai mai ricordarle tutte?

No ed è anche inutile che impari il codice a memoria (è contro producente, basta ricordarsi la logica).

Ed è qui che si inseriscono i commenti.

Esiste una componente all’interno del nostro Editor, cioè il Playground, che ti permette di aggiungere delle note al codice che stai scrivendo.

Note che serviranno a te stesso o ai membri del tuo team per spiegare ciò che hai scritto (I commenti li ritroverai anche su Xcode e su tutti gli altri linguaggi e programmi).

Vediamo come si fa!

Commento su singola linea

Ti basterà aggiungere due slash // e subito dopo il testo del tuo commento.

Tutto ciò che c’è dopo questo simbolo verrà considerato come commento:

print("ciao mondo!") // il print è la keywords che mi permette di scrivere in console un messaggio

Puoi aggiungere il commento anche a seguito di un’istruzione. Per esempio l’avrei potuto mettere dopo l’istruzione print:

print("Ciao, mondo!") 
// questo è un commento

Il commento su singola linea, come la stessa parola suggerisce, considera solamente il testo che c’è sulla stessa linea del simbolo //.

Se dovessi mandare a capo, quel testo non varrà più come commento (infatti lo vedrai di un altro colore) e ti verrà generato un errore da Xcode/Playground.

Ovviamente se dovessi mettere un’istruzione dentro il commento, questa non verrà mai eseguita perché si trova dentro una zona considerata come commento.

Commento multi linee

Se vuoi scrivere i tuoi commenti con più ordine, sopratutto quando diventano lunghi, puoi utilizzare i commenti multi linee. Ti basterà mettere il commento tra i simboli /* e */

/*   
Questo è un commento   
su più linee 
*/ 
print("ciao")/* 
 E anche questo
 lo è
*/

Servono davvero?

Se stai cominciando adesso a programmare, si! Sono utilissimi e ti esorto ad utilizzarli sempre.

Non fare lo sbruffoncello credendo di ricordare il significato del codice. certe volte non lo ricordo io, figuriamoci tu 😂.

Quando ho imparato a programmare, più o meno all’età di 15 anni (facevo cose losche, ti arriverà un’email con la mia storia se sei iscritto al corso) usavo i commenti come esercizio per provare a vedere se mi ricordavo cosa effettivamente faceva il codice che avevo scritto.

Questo esercizio puoi e devi farlo anche tu.

Quando scrivi un codice, scrivi sempre un commento provando a spiegare cosa hai scritto, parola per parola:

var età = 25 /* 
 - La keyword var mi permette di dichiarare una nuova variabile 
 - Dopo var devo aggiungere un'etichetta, che sarà il nome
   della variabile che dovrò usare per utilizzarla (posso usare
   due notazioni principali: camelCase e snake_case)
 - Il simbolo uguale è il simbolo di assegnazione 
   -- cioè prende il valore che c'è a destra e lo mette nella
      var/let che c'è a sinistra 
*/

Più cose scriverai, di senso compiuto, e più auto dimostrerai a te stesso di conoscere l’argomento.

È un esercizio formidabile e, nel mio caso, ha letteralmente aumentato la mia capacità di capire e comprendere il linguaggio che stavo imparando.

Considerazioni

Arriverà il giorno in cui qualcuno, io sono fra questi, ti diranno: “I commenti non servono quasi a niente niente”.

Quel momento arriverà quando avrai una conoscenza tale e, sopratutto, un modo di scrivere il codice talmente auto esplicativo che ti eviterà di scrivere commenti così lunghi.

Ma prima di arrivarci, più o meno, dovrai macinare decine di migliaia di righe di commenti.

Fino a quel momento fai quell’esercizio che ti ho consigliato poco fa e ti assicuro che la tua capacità di imparare a scrivere codice con il linguaggio Swift, e con gli altri, schizzerà alle stelle.

Buona Programmazione!