Comentários nos códigos

Se você é programador já ouviu falar no termo: "Vou comentar o código". Acredito que o termo correto seria: "Vou transformar o código em comentário", pois é isso exatamente o que acontece. O comentário também é uma importante ferramenta na organização do código.

Se você não é programador, ou é novo nesta área, fique tranquilo que vou explicar. Se você já sabe o que é, te convido a ler sobre esse tema mesmo assim.

O que são comentários nos códigos ?

Comentários são textos que você pode inserir no código que não são reconhecidos nem como comandos nem como objetos e, como o próprio nome já diz, não passam de comentários.

Como utilizar ?

Em ABAP temos duas formas de incluir comentários.

A primeira usando aspas duplas (") no ínicio do texto. Em qualquer lugar do programa, quando você incluir uma aspa dupla, todo texto a direta dela se tornará um comentário.

A segunda usando o asterisco (*) no ínicio da linha. Em qualquer linha do programa, quando você incluir um asterisco no lugar do primeiro caractere da linha, toda linha passa a ser um comentário.

Pra que servem ?

Podem servir para desativar um trecho de código já existente. Então, se existe um trecho de código ativo no programa que não será mais necessário, você pode "comentar" esse trecho para que não seja mais reconhecido.

Serve também para fazer qualquer tipo de marcação ou comentário referente ao um trecho de código. Então, se existe um trecho de código que seria interessante descrever para que serve, você pode usar o comentário pra isso.

Exemplos

Imagine que exista o seguinte trecho de código, fazendo uma seleção na tabela EKKO:

  SELECT ebeln loekz
  INTO TABLE t_ekko
  FROM ekko
  WHERE aedat EQ sy-datum.

Ao comentar este código usando aspas duplas fica da seguinte forma:

  "SELECT ebeln loekz
  "INTO TABLE t_ekko
  "FROM ekko
  "WHERE aedat EQ sy-datum.

Ao comentar este código usando asteriscos fica da seguinte forma:

*  SELECT ebeln loekz
*  INTO TABLE t_ekko
*  FROM ekko
*  WHERE aedat EQ sy-datum.

Ao fazer um comentário com aspa dupla referente ao código, sem desativá-lo, apenas complementando informações, fica da seguinte forma:

  " Seleção de pedidos e eliminação por data
  SELECT ebeln loekz
  INTO TABLE t_ekko
  FROM ekko
  WHERE aedat EQ sy-datum.

Ao fazer um comentário com asterisco referente ao código, sem desativá-lo, apenas complementando informações, fica da seguinte forma:

* Seleção de pedidos e eliminação por data
  SELECT ebeln loekz
  INTO TABLE t_ekko
  FROM ekko
  WHERE aedat EQ sy-datum.


Um grande abraço e até a próxima!