Funciones

Introducción

Las funciones son un componente fundamental de la programación de Python, ya que empaquetan fragmentos de código en secciones de código reutilizables y eficientes diseñadas para realizar una tarea específica. Las funciones se pueden llamar varias veces dentro de un programa, lo que facilita la organización del código y ayuda a evitar la repetición del código. Las funciones también hacen que el código sea más fácil de depurar.

Importante: Definir una función por sí sola no hace que se ejecute. Use vr_thread para iniciar una función en un nuevo subproceso para que comience a ejecutarse de inmediato al comienzo del proyecto, en lugar de esperar un evento o una devolución de llamada.

• def define una función.

• return envía la salida de la función al programa principal.

Uso:

def function_name(parameters):
    # Code to execute when the function is called
    return result  # Optional, used to return a value

Parámetros	Descripción
function_name	Un nombre que le das a tu función.
parameters	Opcional. Variables que aceptan valores de entrada cuando se llama a la función, permitiendo que los datos se pasen a la función.
result	Opcional. Permite que la función envíe un resultado a la persona que llama. Si una función no incluye una declaración de devolución, devolverá None de forma predeterminada.

Nota: Una función debe definirse siempre antes de que se llame.

Definición y funciones de llamada

Functions with No Parameters

Si una función no requiere entrada, puede definirla sin parámetros.

# Define a function to display a message
def greeting():
    brain.print("Hello!")

def main():
    # Call the function to display the message
    greeting()

# VR threads — Do not delete
vr_thread(main)

Functions with Parameters

También puede agregar parámetros a las funciones, que le permiten pasar la información que la función necesita para funcionar.

# Define a function with a parameter
def named_greeting(name):
    brain.print("Hello, " + name + "!")

def main():
    named_greeting("Stranger")

# VR threads — Do not delete
vr_thread(main)

Functions with Default Arguments

Un argumento predeterminado es un parámetro que asume un valor predeterminado si no se proporciona un valor en la llamada a la función para ese argumento.

# Define a function with a parameter and a default argument
def named_greeting(name = "Stranger"):
    brain.print("Hello, " + name + "!")

def main():
    # Use the default argument
    named_greeting()
    brain.new_line()
    # Change the parameter to a different name
    named_greeting("VR")

# VR threads — Do not delete
vr_thread(main)

Return Values from Functions

Las funciones pueden enviar datos a la persona que llama utilizando la palabra clave return. Esto le permite capturar y usar la salida en su programa.

# Define a function that multiplies numbers by 2
def times_two(number):
    return number * 2

def main():
    # Display the return value
    brain.print(times_two(2))

# VR threads — Do not delete
vr_thread(main)

vr_thread

La función VR Thread debe usarse para llamar a funciones a nivel global del script.

Puedes tomar cualquier función que hayas realizado anteriormente y pasársela a vr_thread() a nivel global. Se requiere llamar al menos a una función dentro de esto para ejecutar un programa. No es necesario hacer todas las llamadas de función con vr_thread(), solo las que están a nivel global.

Si se realiza más de una llamada vr_thread(), las funciones se ejecutarán en paralelo.

Las funciones se ejecutarán, en general, en el orden en que se denominen. Sin embargo, si una función espera, pasará la ejecución a la siguiente función y continuará cuando la otra función termine o cuando la otra función también espere.

Usage:
vr_thread(function)

Parámetro	Descripción
function	El nombre de una función previamente definida.

# Define the function "main".
def main():
    drivetrain.drive_for(FORWARD, 400, MM)

# Call VR thread for any previously defined functions.
vr_thread(main)