Funções

Introdução

As funções são uma componente fundamental da programação em Python, agrupando excertos de código em secções reutilizáveis ​​eficientes, concebidas para executar uma tarefa específica. As funções podem ser chamadas várias vezes dentro de um programa, facilitando a organização do código e ajudando a evitar repetições. Além disso, as funções facilitam a depuração do código.

Importante: A definição de uma função por si só não a faz executar. Utilize vr_thread para iniciar uma função num novo thread, de modo a que comece a ser executada imediatamente no início do projeto, em vez de esperar por um evento ou callback.

• def define uma função.

• return envia a saída da função de volta para o programa principal.

Utilização:

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

Parâmetros	Descrição
function_name	Um nome que dá à sua função.
parameters	Opcional. Variáveis ​​que aceitam valores de entrada quando a função é chamada, permitindo que os dados sejam passados ​​para a função.
result	Opcional. Permite que a função envie um resultado de volta para o chamador. Se uma função não incluir uma instrução de retorno, esta irá devolver None por defeito.

Nota: Uma função deve ser sempre definida antes de ser chamada.

Definir e Chamar Funções

Functions with No Parameters

Se uma função não necessitar de entrada, pode defini-la sem 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

Pode também adicionar parâmetros às funções, o que permite passar informação necessária para que a função funcione.

# 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

Um argumento por defeito é um parâmetro que assume um valor por defeito no caso de não ser fornecido qualquer valor na chamada da função para esse 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

As funções podem enviar dados de volta para quem as chamou usando a palavra-chave return . Isto permite capturar e utilizar a saída no seu 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

A função VR Thread deve ser utilizada para chamar funções ao nível global do script.

Pode pegar em qualquer função que tenha criado anteriormente e passá-la para vr_thread() a nível global. A chamada de pelo menos uma função dentro deste bloco é necessária para executar um programa. Não precisa de fazer todas as chamadas de funções com vr_thread(), apenas as que estão no nível global.

Se for feita mais do que uma chamada vr_thread() , as funções serão executadas em paralelo.

Em geral, as funções serão executadas pela ordem em que são chamadas. No entanto, se uma função estiver em espera, passará a execução para a função seguinte e continuará quando a outra função terminar ou quando esta também estiver em espera.

Usage:
vr_thread(function)

Parâmetro	Descrição
function	O nome de uma função 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)