È molto probabile che gli argomenti di tesi che propongo richiedano di scrivere del codice. Per questo motivo elenco alcuni suggerimenti per la scrittura di codice, che sebbene siano orientati principalmente al codice in linguaggio C, si possono applicare anche ad altri linguaggi.

I programmi devono compilare correttamente senza warning (e ovviamente senza errori). Nel caso di programmi in C/C++ compilati con gcc, ciò significa che i programmi devono compilare senza warning passando i flag -Wall -Wpedantic. È sempre opportuno inoltre specificare lo standard che si vuole rispettare; ad esempio, se il proprio programma è scritto in C99, suggerisco di compilare con:

gcc -std=c99 -Wall -Wpedantic prova.c

Se invece si programma in ANSI C, suggerisco di usare:

gcc -std=ansi -Wall -Wpedantic prova.c

(esistono parametri analoghi per le varie versioni del C++).

L'uso di nomi inappropriati rende il codice difficile da comprendere e da valutare). Per rendersi conto di ciò, chi direbbe che questa funzione:

int cancella( double trovato, double tentativo[], int n, int terzo, int quarto )
{
    int box = (terzo + quarto) / 2;
    if ( tentativo[box] == trovato ) {
        return box;
    } else {
        if ( tentativo[box] > trovato ) {
            return cancella( trovato, tentativo, n, terzo, box – 1);
        } else {
            return cancella( trovato, tentativo, n, box + 1, quarto );
        }
    }    
}

in realtà non cancella nulla ma implementa la ricerca binaria? (Sì, mi è capitato di ricevere codice del genere…).

È buona norma commentare adeguatamente il codice. Ciascuna funzione dovrebbe avere una intestazione che ne spiega il funzionamento, il significato dei parametri e il significato del risultato (se presenti). Non è indispensabile essere troppo dettagliati (anche se male non fa). Esempio:

/**
 * Restituisce l'indice della prima occorrenza del valore
 * k all'interno dell'array a[] di lunghezza n; se k
 * non è presente in a[], restituisce -1.
 */
int prima_occ(int a[], size_t n, int k)
{
   /* ... */
}

Il corpo delle funzioni o metodi va commentato quando necessario per chiarire i punti che potrebbero risultare ostici. Si evitino accuratamente commenti inutili o ridondanti.

v = v + 1;    // incrementa v
if ( v>10 ) { // se v e' maggiore di 10
   v = 0;     // setta v a zero
}
G.Kruskal(v); // esegui l'algoritmo di Kruskal

// Individua la posizione i del primo valore
// negativo nell'array a[]; al termine si ha
// i == a.length se non esiste alcun
// valore negativo.
int i = 0;
while ( i < a.length && a[i] >= 0 ) {
    i++;
}

Il codice deve essere indentato correttamente e in modo consistente. Per alcuni linguaggi esistono diversi stili di indentazione, e ciascuno di noi ha il suo preferito. Nel codice scritto da me tendo a seguire lo stile K&R, settando l'indentazione a multipli di 4 spazi. Tuttavia, sentitevi liberi di utilizzare il vostro stile preferito, purché venga seguito in modo consistente. Gli ambienti di sviluppo moderni (e anche quelli meno moderni…) consentono di indentare in modo automatico: consiglio di sfruttare questa caratteristica.

Se il proprio editor consente di scegliere, suggerisco di indentare usando spazi anziché caratteri di tabulazione. In questo modo il codice risulterà indentato allo stesso modo anche se viene visualizzato da qualcuno che ha impostato le tabulazioni in punti diversi.

Il codice dovrebbe essere leggibile su una finestra larga 80 caratteri. I monitor moderni sono molto più larghi, ed è facile lasciarsi prendere la mano utilizzando tutta la larghezza dello schermo. Così facendo, però, le righe di codice e i commenti risultano troncati, o vengono mandati a capo, se il codice viene leggo usando una finestra più stretta.

L'ampiezza di 80 caratteri è un retaggio del passato che però risulta comodo. Personalmente, trovo difficile leggere codice sorgente scritto usando linee troppo lunghe, e per questo mi attengo sempre alla regola tacita degli 80 caratteri.