Comentários? Sim, comentários hehe.
Antes de pegar direto na parte da programação vamos tentar comparar comentários de programação com algo da vida real.
Imagine a seguinte situação, você esta em uma reunião da empresa, e durante a reunião um engenheiro faz um obervação importante no produto, por exemplo, o botão reset nunca deve ser pressionado antes de ligar o equipamento, e você precisa lembra disso, o que você faz? Se você tem o projeto na mão ou o que seja do produto você faz um seta próximo a isso que ele comentou e coloca este lembre, coloca este comentário. Depois quando você for realizar o manual você irá ler isso e já vai lembra “Ah este botão não deve ser pressionado antes de ligar o equipamento”.
Em linguagem de programação, qualquer que seja (Java, C, C++, C#, Visual Basic, Pascal, Python, Perl, …), você usa e muito comentários, chega horas em que você esta programando que você irá escrever funções, rotinas, estruturas de repetição e que se você não comentar o que foi feito ou que não deve ser alterado pode comprometer o código, e outro lado bom é que se está sendo feito em equipe comentários ajudam a compreensão do código por outras pessoas.
Hoje estamos com um código-fonte de 15 linhas em C, mas por exemplo este semestre na faculdade entreguei um trabalho de uma agenda usando arquivos e métodos de ordenação (QuickSort) que deu próximo a 600 linhas, se você não comentar algumas etapas fica difícil até entender as etapas do programa.
Bom, chega de papo e vamos a os exemplos de comentários, vamos usar o código-fonte do artigo anterior:
//Bibliotecas
#include<stdio.h>
//Inicio do programa
int main(){
/* Abaixo declaração das variáveis que serão usadas pelo
programa */
int numero1, numero2, mult;
int resultado1, resultado2;
/*Leitura dos numero
e do multiplicador
*/
printf(“Digite o numero 1:”);
scanf(“%d”,&numero1);
printf(“Digite o numero 2:”);
scanf(“%d”,&numero2);
printf(“Digite um multiplicador:”);
scanf(“%d”,&mult);
printf(“Voce digitou o numero %d e o numero %d e o multiplicador %d”,numero1,numero2,mult);
/* Aqui é realizado a multiplicação e o armazenamento
do resultado nas variáveis resultado */
resultado1 = numero1*mult;
resultado2 = numero2*mult;
printf(“nn”);
//Saida do programa após realizar a multiplicação
printf(“Numero %d x %d = %d e Numero %d x %d = %d”,numero1,mult,resultado1,numero2,mult,resultado2);
getch();
}
//Fim do programa
Tipo de comentários da linguagem C/C++:
// Este deve ser usado para comentários curtos de apenas 1 linha
/* */ Este deve ser para comentários mais longo que passe de 1 linha e deve ficar entre /* e */
OBS: Comentários são “ignorados” pelo compilador, não faz parte do código-fonte em termos de programação, seria apenas comentários sobre etapas do código.
É claro que no nosso código acima nem de comentário precisaria, foi apenas para demonstração, mas no decorrer do artigos quando for necessários irei inserir alguns comentários para melhor compreensão.
Até a próxima!
Programação C – Comentários by Cleiton Bueno is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.