funciones.py

# Funciones en python

# Definición
# Una función es un bloque de código que realiza una tarea específica.
# Para definir una función en Python, se utiliza la palabra reservada def seguida del nombre de la función y paréntesis ().

# Sintaxis
# def nombre_de_la_funcion(parametros):
#     # Código de la función
#     return valor_de_retorno
#
# nombre_de_la_funcion(parametros)

# Ejemplo

def saludar():
    print("Hola, mundo!")

saludar()

# Parámetros

# Los parámetros son valores que se pasan a la función para que realice una tarea específica.
# Los parámetros se definen entre los paréntesis de la función.
# Los parámetros pueden ser de cualquier tipo de datos.
# Los parámetros son opcionales.

# Ejemplo

def saludar(nombre):
    print(f"Hola, {nombre}!")


saludar("Juan")

# Importante

# Los parámetros se pasan por valor, lo que significa que si se modifica el valor de un parámetro dentro de la función, no se modifica el valor original.   
# Los parámetros solo existen dentro de la función, por lo que no se pueden acceder desde fuera de la función.  
# Los argumentos son los valores que se pasan a la función cuando se llama a la función.

# Sobre la sobrecarga de funciones:
# Python no soporta la sobrecarga de funciones, es decir, no se pueden definir dos funciones con el mismo nombre y diferente número de parámetros.  
# Si se definen dos funciones con el mismo nombre, la última función definida reemplaza a la primera función definida.  

# Ejemplo

def sumar(a, b):
    return a + b

def sumar(a, b, c):
    return a + b + c

resultado = sumar(5, 3, 2)
print(resultado)
# TypeError: sumar(2,3) takes 3 positional arguments but 2 were given

# Parámetros por defecto

# Los parámetros por defecto son parámetros que tienen un valor predeterminado.
# Los parámetros por defecto se definen con un valor asignado en la definición de la función.   
# Los parámetros por defecto son opcionales, es decir, si no se pasan valores a los parámetros, se utilizan los valores por defecto.    

# Ejemplo

def saludar(nombre="mundo"):
    print(f"Hola, {nombre}!")

saludar()
saludar("Juan")

# Parámetros con nombre

# Los parámetros con nombre son parámetros que se pasan a la función utilizando el nombre del parámetro.
# Los parámetros con nombre se definen con el nombre del parámetro seguido de un signo igual y el valor del parámetro.  
# Los parámetros con nombre se pueden pasar en cualquier orden.

# Ejemplo

def saludar(nombre, apellido):
    print(f"Hola, {nombre} {apellido}!")

saludar(apellido="Pérez", nombre="Juan")

# Parámetros variables

# Los parámetros variables son parámetros que pueden tener un número variable de valores.
# Los parámetros variables se definen con un asterisco (*) antes del nombre del parámetro.
# Los parámetros variables se pasan como una tupla. 

# Ejemplo

def sumar(*numeros):
    suma = 0
    for numero in numeros:
        suma += numero
    return suma

resultado = sumar(5, 3, 2)
print(resultado)

# Nota: Una tupla es una secuencia inmutable de elementos, hablaremos de ellas más adelante.

# Parámetros con nombre variables

# Los parámetros con nombre variables son parámetros que pueden tener un número variable de valores con nombre. 
# Los parámetros con nombre variables se definen con dos asteriscos (**) antes del nombre del parámetro.    
# Los parámetros con nombre variables se pasan como un diccionario.

# Ejemplo

def saludar(**nombres):
    for nombre, valor in nombres.items():
        print(f"{nombre}: {valor}")

saludar(nombre="Juan", apellido="Pérez")

# Nota: Un diccionario es una colección desordenada de elementos, hablaremos de ellos más adelante.

# Parámetros por posición y por nombre

# Los parámetros por posición son los parámetros que se pasan a la función en el orden en que se definen los parámetros.    
# Los parámetros por nombre son los parámetros que se pasan a la función utilizando el nombre del parámetro.    

# Ejemplo

def saludar(nombre, apellido):
    print(f"Hola, {nombre} {apellido}!")

saludar("Juan", "Pérez")
saludar(apellido="Pérez", nombre="Juan")

# Parámetros por posición y por nombre variables

# Los parámetros por posición y por nombre variables son los parámetros que se pasan a la función en el orden en que se definen los parámetros y utilizando el nombre del parámetro.    

# Ejemplo

def saludar(nombre, apellido, **otros):
    print(f"Hola, {nombre} {apellido}!")
    for otro, valor in otros.items():
        print(f"{otro}: {valor}")

saludar("Juan", "Pérez", edad=30, ciudad="Madrid")

# Parámetros por tipo de datos

# Los parámetros por tipo de datos son los parámetros que se pasan a la función con un tipo de datos específico.    
# Los parámetros por tipo de datos se definen utilizando la anotación de tipo de datos.
# Estas anotaciones son opcionales y no afectan el comportamiento de la función.
# Las anotaciones de tipo de datos se definen con dos puntos (:) después del nombre del parámetro y el tipo de datos.   

# Ejemplo

def sumarEnteros(a: int, b: int):
    return a + b

resultado = sumarEnteros(5, 3)
print(resultado)
print(sumarEnteros("Hola", " esto funciona igualmente, pero podría no ser lo esperado"))

# Retorno de valores

# Una función puede devolver un valor utilizando la palabra reservada return.
# El valor de retorno puede ser de cualquier tipo de datos.
# Una función puede devolver múltiples valores utilizando una tupla.

# Ejemplo

def sumar(a, b):
    return a + b

resultado = sumar(5, 3)
print(resultado)

# Retorno de valores indicando el tipo de datos

# El tipo de datos de retorno de una función se puede indicar utilizando la anotación de tipo de datos.
# La anotación de tipo de datos se define con una flecha (->) después de los paréntesis de la función y el tipo de datos de retorno.
# Estas anotaciones son opcionales y no afectan el comportamiento de la función.

# Ejemplo

def sumar(a: int, b: int) -> int:
    return a + b

resultado = sumar(5, 3)
print(resultado)
print(sumar("Hola", " esto funciona igualmente, pero podría no ser lo esperado"))

# Retorno de valores múltiples

# Una función puede devolver múltiples valores utilizando una tupla.
# Para devolver múltiples valores, se utiliza la palabra reservada return seguida de los valores separados por comas.

# Ejemplo

def sumar_y_restar(a, b):
    suma = a + b
    resta = a - b
    return suma, resta

resultado = sumar_y_restar(5, 3)
print(resultado)

# Nota: Una tupla es una secuencia inmutable de elementos, hablaremos de ellas más adelante.

# Funciones predefinidas

# Python tiene muchas funciones predefinidas que se pueden utilizar sin necesidad de importar ningún módulo.

# Ejemplo

print(abs(-5)) # Valor absoluto
print(max(5, 3, 8)) # Valor máximo
print(min(5, 3, 8)) # Valor mínimo
print(pow(2, 3)) # Potencia
print(round(3.14159, 2)) # Redondeo

# Módulos

# Un módulo es un archivo que contiene funciones, clases y variables.
# Python tiene muchos módulos predefinidos que se pueden importar y utilizar en un programa.
# Para importar un módulo se utiliza la palabra reservada import seguida del nombre del módulo.

# Ejemplo

import math

print(math.pi)
print(math.sqrt(25))

# Ejemplo

from math import pi, sqrt

print(pi)
print(sqrt(25))

# Ejemplo

from math import * # Importa todas las funciones del módulo

print(pi)
print(sqrt(25))

# Ejemplo

import math as m # Importa el módulo con un alias

print(m.pi)
print(m.sqrt(25))

# Ejemplo

from math import pi as p, sqrt as s # Importa funciones con alias

print(p)
print(s(25))

# Ejemplo

import random

print(random.randint(1, 10)) # Número aleatorio entre 1 y 10
print(random.choice(["a", "b", "c"])) # Elemento aleatorio

# Ejemplo

import datetime

print(datetime.datetime.now()) # Fecha y hora actual

# Ejemplo

import os

print(os.getcwd()) # Directorio actual
print(os.listdir()) # Lista de archivos y directorios

# Ejemplo

import sys

print(sys.argv) # Argumentos de la línea de comandos

# Ejemplo

import platform

print(platform.system()) # Sistema operativo
print(platform.release()) # Versión del sistema operativo