25/09/2024, 14:09 01 - Funcoes
FUNÇÕES
BEHRMAN, Kennedy R.Fundamentos de Python
para Ciência de Dados. Porto Alegre: Bookman,
2023, p. 67-75
Definindo Funções
Trata-se de uma declaração composta
As funções fornecem uma forma de nomear um bloco de código integrado como um
objeto
Esse código pode ser chamado usando esse nome, o que permite que o mesmo código
seja chamado diversas vezes e em vários lugares
Assim, a definição de uma função estabelece um objeto função, que integra um bloco
executável
Os blocos de construção de uma função são a declaração de controle, uma docstring
opcional, o bloco de código controlado e uma declaração de retorno (return)
Declaração de controle
A primeira linha de uma definição é a declaração de controle: def Nome Função
(Parâmetros):
In [5]: #Exemplo:
def soma(a,b):
resultado = a + b
return resultado
soma(5,2)
Out[5]: 7
Docstring
É a string de documentação (docstring), que contém a documentação da função
A docstring comunica a suas intenções ao escrever uma função, o que faz e como deve
ser chamada
Ela consiste em uma linha ou diversas linhas entre três pares de aspas duplas que
seguem imediatamente a declaração de controle
file:///C:/Users/Usuário/Downloads/01 - Funcoes.html 1/7
25/09/2024, 14:09 01 - Funcoes
In [14]: #Exemplo:
def soma(a,b):
"""
Esta função efetua a soma de duas variáveis e retorna o resultado
parâmetros:
a - variável numérica (float, int ou complexo)
b - variável numérica (float, int ou complexo)
Retorna o resultado de acordo com o tipo de variável numérica
"""
resultado = a + b
return resultado
print(soma(15.5, 23.7))
print(soma(2 + 10j,15 + 2j))
print(soma(13, 15))
39.2
(17+12j)
28
In [15]: help(soma)
Help on function soma in module __main__:
soma(a, b)
Esta função efetua a soma de duas variáveis e retorna o resultado
parâmetros:
a - variável numérica (float, int ou complexo)
b - variável numérica (float, int ou complexo)
Retorna o resultado de acordo com o tipo de variável numérica
Parâmetros
Os parâmetros permitem passar valores para a função, que podem ser usados no bloco
de código dessa função
Uma função não precisa aceitar nenhuma parâmetro
Os valores do parâmetro podem ser definidos com base na posição em que são
passados ou com base em palavras-chave. Não é possível usar uma atribuição de
palavra-chave à esquerda de uma atribuição posicional
In [2]: #Exemplo:
def multiplicacao(x,y):
"""
Função que recebe dois parâmetros e efetua a multiplicação entre eles
Parâmetros:
x - variável numérica tipo int
y - variável numérica tipo int
A função não aceita como parâmetro valores complexos, retornando um Type
file:///C:/Users/Usuário/Downloads/01 - Funcoes.html 2/7
25/09/2024, 14:09 01 - Funcoes
Mas aceita valores tipo float, retornando, porém, um resultado numérico
Ao se passar valores tipo float, a função os transforma em int, arredond
returna o resultado da multiplicação x * y
"""
mult = int(x) * int(y)
return mult
multiplicacao(2.6,1.7)
Out[2]: 2
In [28]: multiplicacao(2j,5.6)
---------------------------------------------------------------------------
TypeError Traceback (most recent call last)
Cell In[28], line 1
----> 1 multiplicacao(2j,5.6)
Cell In[27], line 19, in multiplicacao(x, y)
3 def multiplicacao(x,y):
4 """
5 Função que recebe dois parâmetros e efetua a multiplicação entre eles
6
(...)
17
18 """
---> 19 mult = int(x) * int(y)
20 return mult
TypeError: int() argument must be a string, a bytes-like object or a real number,
not 'complex'
In [4]: multiplicacao(y=6, x=30)
Out[4]: 180
In [5]: def multiplicacao(a,b,c):
resultado = a*b*c
return resultado
In [8]: multiplicacao(a=2, b=3, c=4)
Out[8]: 24
In [9]: multiplicacao(c=10, a=-1, b=4)
Out[9]: -40
In [10]: multiplicacao(c=2, 2, 3)
Cell In[10], line 1
multiplicacao(c=2, 2, 3)
^
SyntaxError: positional argument follows keyword argument
file:///C:/Users/Usuário/Downloads/01 - Funcoes.html 3/7
25/09/2024, 14:09 01 - Funcoes
Pode-se requerer que um parâmetro seja chamado apenas usando o método da palavra-
chave colocando * à esquerda da definição da função
Todos os parâmetros à direita do asterisco podem ser chamados apenas usando palavra-
chave
In [1]: #Exemplo
def does_keyword(first, second, *, third):
print(f'First: {first}')
print(f'Second: {second}')
print(f'Third: {third}')
In [2]: does_keyword(1,2, third=3)
First: 1
Second: 2
Third: 3
In [3]: does_keyword(1,2,3)
---------------------------------------------------------------------------
TypeError Traceback (most recent call last)
Cell In[3], line 1
----> 1 does_keyword(1,2,3)
TypeError: does_keyword() takes 2 positional arguments but 3 were given
É possível tornar opcional um parâmetro atribuindo um valor padrão a ele na definição
da função
Esse valor será uasdo se nenhum valor for fornecido para o parâmetro durante a
chamada da função
Não é possível definir uma função com um parâmetro de valor padrão à esquerda de um
parâmetro de valor não padrão
In [4]: #Exemplo
def soma(a,b,c=3):
resultado = a + b + c
return resultado
In [5]: soma(1,2,4)
Out[5]: 7
In [6]: soma(1,2)
Out[6]: 6
In [7]: #Exemplo2
def soma(a=2,b,c):
resultado = a + b + c
return resultado
file:///C:/Users/Usuário/Downloads/01 - Funcoes.html 4/7
25/09/2024, 14:09 01 - Funcoes
Cell In[7], line 3
def soma(a=2,b,c):
^
SyntaxError: non-default argument follows default argument
O uso de objetos mutáveis (lista ou dicionários) para valores padrão pode gerar
problemas
In [8]: def funcao_default(lista=[]):
lista.append(1)
print(lista)
In [9]: funcao_default()
[1]
In [10]: funcao_default()
[1, 1]
In [11]: funcao_default()
[1, 1, 1]
Sempre que a função é chamada, a lista mantém os valores das chamadas anteriores
Recomenda-se não usar objetos mutáveis como parâmetros padrão para evitar erros
difíceis de rastrear e confunsão
Uma forma de solucionar é definir o valor padrão como None
In [17]: def funcao_default(lista=None):
lista = lista or []
lista.append(1)
print(lista)
In [18]: funcao_default()
[1]
In [19]: funcao_default()
[1]
É possível restringir os parâmetros à atribuição posicional apenas
Um parâmetro à esquerda da barra (/) em uma definição de função é restrito à atribuição
posicional
In [20]: def does_positional(first, /, second, third):
print(f'First: {first}')
print(f'Second: {second}')
print(f'Third: {third}')
In [21]: does_positional(1,2,3)
First: 1
Second: 2
Third: 3
file:///C:/Users/Usuário/Downloads/01 - Funcoes.html 5/7
25/09/2024, 14:09 01 - Funcoes
In [22]: does_positional(first=1, second=2, third=3)
---------------------------------------------------------------------------
TypeError Traceback (most recent call last)
Cell In[22], line 1
----> 1 does_positional(first=1, second=2, third=3)
TypeError: does_positional() got some positional-only arguments passed as keyword
arguments: 'first'
O parâmetro first é posicional apenas
In [24]: does_positional(1,2,third=3)
First: 1
Second: 2
Third: 3
In [25]: does_positional(1,third=3, second=2)
First: 1
Second: 2
Third: 3
In [26]: does_positional(1,second=2, 3)
Cell In[26], line 1
does_positional(1,second=2, 3)
^
SyntaxError: positional argument follows keyword argument
O parâmetro first é posicional apenas
O parâmetro second pode ser definido usando a atribuição posicional ou de palavra-
chave. O third é palavra-chave apenas
In [2]: def does_positional(first, /, second, *, third):
print(f'First: {first}')
print(f'Second: {second}')
print(f'Third: {third}')
does_positional(1,2,third=3)
First: 1
Second: 2
Third: 3
É possível passar curingas nas definições da função para aceitar um número indefinido
de argumentos posicionais ou palavras-chave
Parâmetros curinga posicionais (*args) e de palavra-chave (**kwargs) podem ser usados
na mesma função, bastando definir os parâmetros posicionais primeiro e os parâmetros
de palavra-chave depois.
In [3]: def does_wildcard_positions(*args):
for item in args:
print(item)
does_wildcard_positions('Marcos', 'Cesar', 'Botelho', 49)
file:///C:/Users/Usuário/Downloads/01 - Funcoes.html 6/7
25/09/2024, 14:09 01 - Funcoes
Marcos
Cesar
Botelho
49
In [4]: does_wildcard_positions(1,10, '14', 9.6, 1+20j, True)
1
10
14
9.6
(1+20j)
True
In [5]: def does_wildcard_keywords(**kwargs):
for key, value in kwargs.items():
print(f'{key} : {value}')
does_wildcard_keywords(number=49, name='Marcos', bool=True)
number : 49
name : Marcos
bool : True
In [6]: def does_wildcards(*args, **kwargs):
print(f'Posicional: {args}')
print(f'Keyword: {kwargs}')
In [7]: does_wildcards(1,2,a='a', b=3)
Posicional: (1, 2)
Keyword: {'a': 'a', 'b': 3}
file:///C:/Users/Usuário/Downloads/01 - Funcoes.html 7/7
