C-kommentarer

En "kommentar" är en sekvens med tecken som börjar med en snedstrecks-/asteriskkombination (/*) som behandlas som ett enda blankstegstecken av kompilatorn och som annars ignoreras. En kommentar kan innehålla valfri kombination av tecken från den representerande teckenuppsättningen, inklusive nya radtecken, men exklusive avgränsaren "slutkommentaren" (*/). Kommentarer kan uppta mer än en rad men kan inte kapslas.

Kommentarer kan visas var som helst där ett blankstegstecken tillåts. Eftersom kompilatorn behandlar en kommentar som ett enda blankstegstecken kan du inte ta med kommentarer i token. Kompilatorn ignorerar tecknen i kommentaren.

Använd kommentarer för att dokumentera koden. Det här exemplet är en kommentar som godkänts av kompilatorn:

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

Kommentarer kan visas på samma rad som en kodsats:

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

Du kan välja att föregå funktioner eller programmoduler med ett beskrivande kommentarsblock:

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

Eftersom kommentarer inte kan innehålla kapslade kommentarer orsakar det här exemplet ett fel:

/* Comment out this routine for testing

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

Felet uppstår eftersom kompilatorn identifierar den första */, efter orden Open file, som slutet av kommentaren. Den försöker bearbeta den återstående texten och skapar ett fel när den */ hittar en kommentar utanför.

Du kan använda kommentarer för att göra vissa kodrader inaktiva i testsyfte, men förprocessordirektiven #if och #endif villkorlig kompilering är ett användbart alternativ för den här uppgiften. Mer information finns i Preprocessor-direktiv i preprocessorreferensen.

Microsoft-specifik

Microsoft-kompilatorn stöder också enradskommentarer som föregås av två snedstreck (//). Dessa kommentarer kan inte utökas till en andra rad.

// This is a valid comment

Kommentarer som börjar med två snedstreck (//) avslutas med nästa nya radtecken som inte föregås av ett escape-tecken. I nästa exempel föregås det nya tecknet av ett omvänt snedstreck (\), vilket skapar en "escape-sekvens". Den här escape-sekvensen gör att kompilatorn behandlar nästa rad som en del av föregående rad. Mer information finns i Escape-sekvenser.

// my comment \
    i++;

Därför kommenteras -instruktionen i++; ut.

Standardvärdet för Microsoft C är att Microsoft-tilläggen är aktiverade. Använd /Za för att inaktivera dessa tillägg.

Avsluta Microsoft Specifik

Se även

C-token