Declaração Python, Recuo e Comentários

Declaração, recuo e comentários do Python

Neste tutorial, você aprenderá sobre instruções Python, por que a indentação é importante e o uso de comentários na programação.

Declaração do Python

As instruções que um interpretador Python pode executar são chamadas de instruções. Por exemplo, a = 1 é uma instrução de atribuição. if declaração, for declaração, while declaração, etc. são outros tipos de declarações que serão discutidas mais tarde.

Instrução de várias linhas

Em Python, o final de uma instrução é marcado por um caractere de nova linha. Mas podemos fazer uma declaração se estender por várias linhas com o caractere de continuação de linha (\). Por exemplo:

a = 1 + 2 + 3 + \
    4 + 5 + 6 + \
    7 + 8 + 9

Esta é uma continuação de linha explícita. Em Python, a continuação de linha está implícita entre parênteses ( ) , colchetes [ ] , e chaves { } . Por exemplo, podemos implementar a instrução de várias linhas acima como:

a = (1 + 2 + 3 +
    4 + 5 + 6 +
    7 + 8 + 9)

Aqui, os parênteses ao redor ( ) faça a continuação de linha implicitamente. O mesmo é o caso com [ ] e { } . Por exemplo:

colors = ['red',
          'blue',
          'green']

Também podemos colocar várias instruções em uma única linha usando ponto e vírgula, como segue:

a = 1; b = 2; c = 3

---

Recuo Python

A maioria das linguagens de programação como C, C++ e Java usa chaves { } para definir um bloco de código. Python, no entanto, usa recuo.

Um bloco de código (corpo de uma função, loop, etc.) começa com recuo e termina com a primeira linha não recuada. A quantidade de recuo depende de você, mas deve ser consistente ao longo desse bloco.

Geralmente, quatro espaços em branco são usados ​​para recuo e são preferidos em relação a tabulações. Aqui está um exemplo.

for i in range(1,11):
    print(i)
    if i == 5:
        break

A aplicação de recuo em Python faz com que o código pareça limpo e organizado. Isso resulta em programas Python que parecem semelhantes e consistentes.

O recuo pode ser ignorado na continuação da linha, mas é sempre uma boa ideia recuar. Isso torna o código mais legível. Por exemplo:

if True:
    print('Hello')
    a = 5

e

if True: print('Hello'); a = 5

ambos são válidos e fazem a mesma coisa, mas o estilo anterior é mais claro.



O recuo incorreto resultará em IndentationError .

---

Comentários do Python

Os comentários são muito importantes ao escrever um programa. Eles descrevem o que está acontecendo dentro de um programa, de modo que uma pessoa olhando para o código-fonte não tenha dificuldade em descobrir.

Você pode esquecer os principais detalhes do programa que acabou de escrever em um mês. Portanto, dedicar um tempo para explicar esses conceitos na forma de comentários é sempre proveitoso.

Em Python, usamos o hash (# ) para começar a escrever um comentário.

Ele se estende até o caractere de nova linha. Os comentários são para os programadores entenderem melhor um programa. Python Interpreter ignora comentários.

#This is a comment
#print out Hello
print('Hello')

---

Comentários de várias linhas

Podemos ter comentários que se estendem até várias linhas. Uma maneira é usar o hash(# ) no início de cada linha. Por exemplo:

#This is a long comment
#and it extends
#to multiple lines

Outra maneira de fazer isso é usar aspas triplas, seja ''' ou """ .

Essas aspas triplas são geralmente usadas para strings de várias linhas. Mas eles também podem ser usados ​​como um comentário de várias linhas. A menos que não sejam docstrings, eles não geram nenhum código extra.

"""This is also a
perfect example of
multi-line comments"""

Para saber mais sobre comentários, visite Comentários do Python.

---

Docstrings em Python

Uma docstring é a abreviação de string de documentação.

Python docstrings (strings de documentação) são os literais de string que aparecem logo após a definição de uma função, método, classe ou módulo.

Aspas triplas são usadas ao escrever docstrings. Por exemplo:

def double(num):
    """Function to double the value"""
    return 2*num

Docstrings aparecem logo após a definição de uma função, classe ou módulo. Isso separa docstrings de comentários de várias linhas usando aspas triplas.

As docstrings estão associadas ao objeto como seu __doc__ atributo.

Assim, podemos acessar as docstrings da função acima com as seguintes linhas de código:

def double(num):
    """Function to double the value"""
    return 2*num
print(double.__doc__)

Saída

Function to double the value

Para saber mais sobre docstrings em Python, visite Python Docstrings.