Variável Local e Global, comentários e documentação em Python

Veremos neste post variável local e global, comentários e documentação em Python

Declaração de Variáveis

Representa uma posição na memória, onde pode ser armazenado um dado
Possui um nome e um valor
Durante a execução do algoritmo, pode ter seu valor alterado

Nome de variável

Dê nome significativo e sucinto a sua variável;
Variáveis de uma única letra como a variável ‘i’ é aceitável apenas para contadores
O nome deve iniciar por letra ou _ (sublinhado ou underscore)
Para separar palavras podemos fazer com _ (underscore) ou letra maiúscula.
Exemplos: retornaNomeObjeto, retorna_nome_objeto
Python é case sesitive pois difere nome de variável que tem letras maiúsculas e minúsculas.
Somos impedidos de usar palavras reservadas da linguagem para nomes de variáveis.
São elas: False, class, finally, is, return, None, continue, for, lambda, try, True, def, from, nonlocal, while, and, del, global, not, with, as, elif, if, or, yield, assert, else, import, pass, break, except, in, raise

Local

Observe que a variável valorAdicional como foi declarada dentro de uma função fica restringida dentro da função somaTres().

Global

O uso de variáveis globais em Python não é recomendado na maioria dos casos, os principais motivos são problemas no paralelismo e funções que dependem de variáveis globais são menos reutilizáveis, já que têm dependências externas implícitas, o que, reduz a modularidade do código.

Atribuindo valores as variáveis na mesma linha

Comentários e Documentação em Python

Comentários

Os comentários no código é importante para ajudar a compreender o seu código e de outros colegas programadores.
O comentário com aspas triplas pode permite gerar documentação e passa a aparecer em help( ).
No IDLE do python podemos executar help(print) que apresenta informações sobre esta função solicitada.

Uma linha

Multiplas linhas

Documentação a partir de comentários

Para gerar documentação deverá instalar a biblioteca pydoc

Depois deverá executar:
pydoc -p 1234
Que cria uma documentação em html do projeto com base nos comentários de três aspas em suas funções e objetos.

imprimir

Função Print

Para imprimir uma informação em Python, se utiliza a função embutida print( ).
Você pode informar diretamente o texto ou pode passar variáveis.

retornando uma string

Separador com espaço em branco e quebra de linha ao final

Formatando uma String com F-String e Format

Dica:

No IDLE do Python você pode consultar as funções nativas da linguagem com help( )
Veja:

Vimos hoje, variável local e global, comentários e documentação em Python, continue nos acompanhando !

Interno:

Deixe um comentário