Funções em Python

módulos

Criar suas funções é a chave para a sucesso.
Vamos ver algumas das opções de parâmetros de entrada de uma função e em outro post vamos falar em criar seus módulos (Conjunto de funções).

Comente suas funções

O exemplo acima é uma função que não tem parâmetros de entrada, apenas imprime uma informação.
Ao comentar suas funções com aspas triplas você poderá consulta-las em help() e poderá gerar a documentação com pydoc.

Valor Default

No exemplo acima nome é um campo não obrigatório que caso não seja informado será atribuído o valor default “Mundo” e imprime o resultado.

Definindo Tipo no parâmetro de entrada

 

Retornando o valor

No exemplo acima a função retornou 5, pois usamos o método return, também definimos que os parâmetros de entrada devem ser do tipo float;

Passando um parâmetro obrigatório e outro opcional em uma função

 

Passando número arbitrários de parâmetros

Passando um Dicionário

 

Dicionário é um tipo de dado mais complexo que farei um post separadamente.
A princípio você deve saber que ele existe, e nele temos campos com propriedades chave e valor.

Retornando um Dicionário

Passando uma Função para outra Função

 

Comentários em Python

Documentação do Projeto

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 gerar documentação e passa a aparecer em help( ) do IDLE que vimos no post sobre print()

Comentário de uma linha

Comentário de multiplas linhas

Comentário usado para gerar documentação

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

Depois deverá executar:

pydoc -p 1234

Que cria uma documentação em html do projeto