quarta-feira, 19 de julho de 2017

03 - Escrevendo comentários

Muitas vezes ao escrevermos um programa é necessário que sejam adicionados comentários. Essa é uma boa prática porque os comentários:

  • Ajudam a identificar o programa;
  • Explicam para que serve o programa;
  • Explicam detalhadamente linhas do programa cujo código não esteja muito claro.
Adicionamos comentários em Python colocando o sinal do jogo da velha (#) e escrevendo após ele. Por exemplo:

print("Adoro Físca!")  # Esta é a matéria de que mais gosto.

Digite este o código acima na nossa página de testes: https://repl.it/languages/python3 

Não se esqueça de dar um espaço após o parenteses antes de digitar o símbolo #

Note que ao rodar o programa o que foi escrito após o # não  apareceu na tela de saída; isso por que o sinal # avisa ao Python que ele não precisa executar o que vem depois do #.

Abaixo temos o exemplo de um programa que calcula a soma de dois números, a e b com os seus comentários explicativos. Não é necessário ainda que você entenda o código. Atente apenas para os comentários nele inseridos.


# Cálculo da soma de dois números a e b.

a = 1     # valor de a

b = 2     # valor de b

soma = a + b     # cálculo da soma de a + b.

print (soma)     # imprimindo o valor da soma.


Outra forma de escrever comentários e colocando - os entre três aspas: """ da seguinte maneira:

"""
Este é um programa que calcula a velocidade média.
Para calcularmos a velocidade média de um móvel devemos 
calcular a variação de espaço e o intervalo de tempo ...

"""

Tudo o que estivar entre as """ é considerado um comentário e o Python irá ignorar essas linhas ao rodar o programa.











Nenhum comentário:

Postar um comentário