A instrução, indentação e comentários em Python

a instrução em Python

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

multi-line statement

em Python, o fim de uma instrução é marcado por um caractere newline. Mas podemos fazer uma declaração estendendo-se por várias linhas com o carácter de continuação da linha (\). Por exemplo:

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

esta é uma continuação explícita da linha. Em Python, a continuação da linha está implícita dentro dos parênteses (), parêntesis e chavetas { }. Por exemplo, podemos implementar a declaração multi-linha acima como:

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

Aqui, os parênteses circundantes ( ) fazem a continuação da linha implicitamente. O mesmo acontece com o e { }. Por exemplo:

colors = 

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

a = 1; b = 2; c = 3

Python Indentação

a Maioria das linguagens de programação como C, C++, Java e utilizar chavetas { } para definir um bloco de código. Python, entretanto, usa indentação.

um bloco de código (corpo de uma função, laço, etc.) começa com a indentação e termina com a primeira linha sem indentação. A quantidade de indentação depende de você, mas deve ser consistente ao longo desse bloco.

geralmente, quatro espaços em branco são usados para indentação e são preferidos sobre as páginas. Aqui está um exemplo.

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

a aplicação da indentação em Python faz o código parecer puro e limpo. Isto resulta em programas Python que parecem semelhantes e consistentes.a indentação

pode ser ignorada na continuação da linha, mas é sempre uma boa ideia indentar. 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 fazer a mesma coisa, mas o primeiro estilo é mais clara.

recuo Incorreto resultará em IndentationError.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 tem dificuldade em descobri-lo.

pode esquecer os detalhes chave do programa que acabou de escrever dentro de um mês. Por isso, dar tempo para explicar estes conceitos sob a forma de comentários é sempre frutífero.

em Python, usamos o símbolo hash ( # ) para começar a escrever um comentário.

estende-se até ao carácter da newline. Os comentários são para os programadores entenderem melhor um programa. O interpretador Python ignora os comentários.

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

podemos ter comentários que se estendem até várias linhas. Uma maneira é usar o símbolo 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””.

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

"""This is also aperfect example ofmulti-line comments"""

para saber mais sobre comentários, visite os comentários em Python.

Docstrings in Python

a docstring is short for documentation string.

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

aspas triplas são usadas durante a escrita de documentos. 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 multi-linhas usando aspas triplas.

The docstrings are associated with the object as their __doc__ attribute.

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

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

Saída

Function to double the value

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