Funciones en Profundidad
Documentación de Funciones
Es importante documentar cada función para saber qué hace, qué parámetros recibe y qué devuelve:
def hola(alguien):
"""Devuelve un saludo dirigido a la persona indicada por parámetro."""
return "Hola " + alguien + "! Estoy programando en Python."
La documentación se escribe entre triple comillas al inicio de la función. Puedes acceder a ella usando help(hola).
Devolver vs. Imprimir
Hay dos formas de mostrar resultados:
- Devolver con
return: permite reutilizar el resultado en otras operaciones.
- Imprimir con
print(): solo muestra el resultado en pantalla.
Comparemos estas dos funciones:
def devolver_segundos(horas, minutos, segundos):
"""Transforma en segundos una medida de tiempo."""
return 3600 * horas + 60 * minutos + segundos
def imprimir_segundos(horas, minutos, segundos):
"""Imprime una medida de tiempo en segundos."""
print(3600 * horas + 60 * minutos + segundos)
Con la primera podemos hacer:
s1 = devolver_segundos(1, 10, 10)
s2 = devolver_segundos(2, 32, 20)
print(s1 + s2) # Podemos operar con los resultados
💡 Una función es más reutilizable si devuelve un resultado (con return) en lugar de imprimirlo directamente, y si recibe parámetros en lugar de leer datos con input().