Crear funciones en Python: nuestro primer programa

En posts anteriores hablamos sobre la librería estándar en Python. Como explicamos en esa ocasión, dicha librería consiste de varios módulos, donde cada uno contiene una serie de funciones. Luego de haber aprendido cómo utilizarlas, en este post y en el próximo nos dedicaremos a crear funciones en Python. Las mismas estarán incluídas dentro de un módulo que crearemos para tal fin.

Crear funciones en Python

Para empezar, abriremos el IDLE y crearemos un archivo nuevo llamado matematicas.py. Como podemos adivinar, en este archivo agregaremos un par de funciones que serán usadas para realizar operaciones matemáticas. Para hablar más apropiadamente, nos referiremos a este archivo como el módulo matematicas.

El encabezado

Al comienzo del archivo es útil agregar un comentario que provean datos sobre el módulo.

Los comentarios explicativos, al comienzo de un módulo o en la declaración de una función, reciben el nombre de docstrings.

En Python, los comentarios multilínea se pueden indicar entre comillas simples triples, de la siguiente manera:

'''
Nombre del módulo: matematicas
Propósito: realizar funciones matemáticas
Autor: Gabriel
'''

Si ahora guardamos el archivo e importamos el módulo en el IDLE de la siguiente manera

import matematicas

veremos que

help(matematicas)

mostrará el encabezado como se observa en la Fig. 1:

Las funciones

Ahora pasemos a lo más interesante. Podemos pensar en una función como un mini-programa dentro de nuestro programa. El utilizar funciones nos permite evitar errores y la duplicación de código. Al mismo tiempo, nos aseguramos de que el programa sea más fácil de mantener y más corto.

Cada función realizará una serie de pasos u operaciones y regresará un valor, imprimirá un mensaje por pantalla, o no devolverá nada.

Para definir una función utilizaremos la palabra clave def seguida del nombre que deseamos asignarle. A continuación entre paréntesis se deben agregar los parámetros sobre los que se desea actuar. Veamos dos ejemplos en el módulo matematicas, donde los comentarios explican el propósito de cada función:

def Promedio(a, b):
    '''
    Esta función calcula el promedio entre dos números a y b.
    '''
    return (a + b) / 2

def MenorMayor(L):
    '''
    Esta función ordena de menor a mayor los números que aparecen en la lista L.
    '''
    return sorted(L)

Resaltemos algunos puntos:

• Los nombres de las funciones son Promedio y MenorMayor.
• Dentro de paréntesis se indican los parámetros que espera cada función.
• Los parámetros son variables dentro del cuerpo de la función. Al ejecutarla, se debe especificar qué valores se debe asignar a los mismos. Cada valor que se le asigna a un parámetro al llamar una función se denomina argumento.
• La palabra clave return indica qué es lo que debe devolver cada función al ser llamada.

Eso es todo por ahora. En el próximo post mostraremos cómo llamar las funciones que acabamos de crear y cómo mostrar la ayuda que escribimos para las mismas.