Commenti C

Un commento è una sequenza di caratteri che inizia con una combinazione barra/asterisco (/*) considerata come un singolo spazio vuoto dal compilatore e altrimenti ignorata. Un commento può contenere qualsiasi combinazione di caratteri del set di caratteri rappresentabili, inclusi i caratteri di nuova riga, fatta eccezione per il delimitatore di fine commento (*/). I commenti possono occupare più di una riga, ma non possono essere annidati.

I commenti possono trovarsi in qualsiasi punto in cui sia consentito uno spazio vuoto. Poiché il compilatore considera un commento come un singolo carattere di spazio vuoto, non è possibile includere commenti all'interno dei token. In tal caso, i caratteri del commento verrebbero ignorati.

Utilizzare i commenti per documentare il codice. L'esempio seguente rappresenta un commento accettato dal compilatore:

/* Comments can contain keywords such as
   for and while without generating errors. */

I commenti possono essere presenti sulla stessa riga come un'istruzione di codice:

printf( "Hello\n" );  /* Comments can go here */

È possibile anteporre alle funzioni o ai moduli di programma un blocco di commenti descrittivi:

/* MATHERR.C illustrates writing an error routine
* for math functions.
*/

Poiché i commenti non possono contenere commenti annidati, in questo esempio viene generato un errore:

/* Comment out this routine for testing

   /* Open file */
    fh = _open( "myfile.c", _O_RDONLY );
    .
    .
    .
*/

L'errore si verifica perché il compilatore riconosce la prima combinazione */, dopo le parole Open file, come fine del commento. Il compilatore prova a elaborare il testo rimanente e genera un errore quando rileva la combinazione */ all'esterno di un commento.

Sebbene sia possibile utilizzare i commenti per eseguire il rendering di alcune righe di codice inattive a scopo di test, le direttive per il preprocessore #if e #endif e la compilazione condizionale rappresentano un'alternativa utile per questa attività. Per altre informazioni, vedere Direttive per il preprocessore in Preprocessor Reference (Riferimenti al preprocessore).

Specifico di Microsoft

Il compilatore Microsoft supporta anche commenti a riga singola preceduti da due barre (//). Questi commenti non possono estendersi a una seconda riga.

// This is a valid comment

I commenti che iniziano con due barre (//) vengono terminati dal carattere di nuova riga successivo non preceduto da un carattere di escape. Nell'esempio successivo il carattere di nuova riga è preceduto da una barra rovesciata (\), creando una "sequenza di escape". Questa sequenza di escape fa sì che il compilatore consideri la riga successiva come parte della riga precedente. Per altre informazioni, vedere Sequenze di escape.

// my comment \
    i++;

Di conseguenza, l'istruzione i++; viene impostata come commento.

Per impostazione predefinita, in Microsoft C le estensioni Microsoft sono abilitate. Utilizzare l'opzione /Za per disabilitare tali estensioni.

END Microsoft Specific

Vedi anche

Token C