Komentáře v jazyce C

"komentář" je posloupnost znaků začínající lomítkem nebo hvězdičkou (/*), která je považována za jediný prázdný znak kompilátorem a jinak se ignoruje. Komentář může obsahovat libovolnou kombinaci znaků ze reprezentovatelné znakové sady, včetně znaků nového řádku, ale s výjimkou oddělovače "end comment" (*/). Komentáře můžou zabírat více než jeden řádek, ale nedají se vnořit.

Komentáře se mohou vyskytovat kdekoliv, kde je povolen prázdný znak. Vzhledem k tomu, že kompilátor považuje komentář za jediný prázdný znak, nemůžete do tokenů zahrnout komentáře. Kompilátor ignoruje znaky v komentáři.

Komentáře lze použít k dokumentaci kódu. Tento příklad je komentář, který kompilátor přijímá:

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

Komentáře se mohou vyskytovat na stejném řádku, na kterém se vyskytuje příkaz kódu:

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

Funkcím nebo modulům programu mohou předcházet popisné bloky komentáře:

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

Vzhledem k tomu, že komentáře nemohou obsahovat vnořené komentáře, tento příklad způsobí chybu:

/* Comment out this routine for testing

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

K této chybě dochází, protože kompilátor rozpozná první znak */ za slovy Open file jako konec komentáře. Pokusí se zpracovat zbývající text a po nalezení znaku */ mimo komentář vygeneruje chybu.

Ačkoli lze komentáře použít k deaktivaci určitých řádků kódu za účelem testování, jsou užitečnou alternativou pro tento úkol direktivy preprocesoru #if a #endif a podmíněné kompilace. Další informace naleznete v tématu Direktivy preprocesoru v referenčních informacích preprocesoru.

Specifické pro Microsoft

Kompilátor Microsoftu také podporuje jednořádkové komentáře před dvěma lomítky (//). Tyto komentáře se nedají rozšířit na druhý řádek.

// This is a valid comment

Komentáře začínající dvěma lomítky (//) jsou ukončeny dalším znakem nového řádku, který není před řídicím znakem. V dalším příkladu předchází znak nového řádku zpětné lomítko (\), čímž se vytvoří řídicí sekvence. Tato řídicí sekvence způsobí, že kompilátor považuje další řádek za součást předchozího řádku. Další informace naleznete v tématu Řídicí sekvence.

// my comment \
    i++;

Příkaz i++; je proto zakomentován.

Výchozí hodnota pro Microsoft C je, že jsou povolená rozšíření Microsoftu. Chcete-li tato rozšíření zakázat, použijte možnost /Za.

END Specifikace Microsoftu

Viz také

Tokeny jazyka C