Compartilhar via


C comentários

"Comentário" é uma seqüência de caracteres, começando com uma combinação de barra/asterisco direta (/ *) que é tratado como um único caractere de espaço em branco pelo compilador e caso contrário é ignorado.Um comentário pode incluir qualquer combinação de caracteres do conjunto de caracteres representáveis, incluindo caracteres de nova linha, mas excluindo o delimitador "encerrar o comentário" (* /).Comentários podem ocupar mais de uma linha, mas não podem ser aninhados.

Os comentários podem aparecer em qualquer lugar que um caractere de espaço em branco é permitido.Desde que o compilador trata um comentário como um único caractere de espaço em branco, você não pode incluir comentários em tokens.O compilador ignora os caracteres no comentário.

Use os comentários para documentar o seu código.Esse exemplo é um comentário aceito pelo compilador:

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

Os comentários podem aparecer na mesma linha como uma instrução de código:

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

Você pode optar por preceder funções ou módulos de programa com um bloco de comentário descritivo:

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

Uma vez que os comentários não podem conter comentários aninhados, este exemplo faz com que um erro:

/* Comment out this routine for testing 

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

O erro ocorre porque o compilador reconhece o primeiro */, após as palavras Open file, como o final do comentário.Ele tenta processar o texto restante e produz um erro quando encontrar o */ fora de um comentário.

Embora seja possível usar comentários para processar determinadas linhas de código inativo para fins de teste, as diretivas de pré-processamento #if e #endif e compilação condicional são uma alternativa útil para essa tarefa.Para obter mais informações, consulte Diretivas do pré-processador na Referência do pré-processador.

Específicos do Microsoft

O compilador da Microsoft também oferece suporte a comentários de linha única, precedidos por duas barras (/ /).Se você compilar com /Za (ANSI padrão), esses comentários geram erros.Esses comentários não podem estender para uma segunda linha.

// This is a valid comment

Comentários começam com duas barras (/ /) são finalizados pelo próximo caractere de nova linha não é precedido por um caractere de escape.No próximo exemplo, o caractere de nova linha é precedido por uma barra invertida (\), criando uma "seqüência de escape". Essa seqüência de escape faz com que o compilador a tratar a próxima linha como parte da linha anterior.(Para obter mais informações, consulte Seqüências de Escape.)

// my comment \
    i++; 

Portanto, o i++; instrução está comentada.

O padrão Microsoft C é que as extensões do Microsoft estão habilitadas.Use /Za para desativar essas extensões.

Específicos do Microsoft final

Consulte também

Referência

Tokens c