Функции#

Введение#

Функции — это фундаментальный компонент программирования на Python, позволяющий упаковывать фрагменты кода в многократно используемые, эффективные разделы, предназначенные для выполнения конкретной задачи. Функции могут вызываться несколько раз в программе, что упрощает организацию кода и помогает избежать повторного использования кода. Функции также упрощают отладку кода.

Важно: Определение функции само по себе не гарантирует её выполнение. Используйте vr_thread, чтобы запустить функцию в новом потоке, и она начнёт выполняться сразу же при запуске проекта, вместо того чтобы ждать события или обратного вызова.

  • def определяет функцию.

  • return , после чего результат функции отправляется обратно в основную программу.

Применение:

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

Параметры

Описание

function_name

Название, которое вы даете своей функции.

parameters

Необязательный параметр. Переменные, принимающие входные значения при вызове функции, позволяющие передавать данные в функцию.

result

Необязательно. Позволяет функции отправить результат обратно вызывающей стороне. Если функция не содержит оператора return, она по умолчанию вернет None.

Примечание: Функция всегда должна быть определена до её вызова.

Определение и вызов функций#

Functions with No Parameters#

Если функция не требует входных данных, её можно определить без параметров.

# 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#

Также можно добавлять параметры к функциям, позволяющие передавать информацию, необходимую функции для работы.

# 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#

Аргумент по умолчанию — это параметр, который принимает значение по умолчанию, если значение для этого аргумента не указано в вызове функции.

# 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#

Функции могут отправлять данные обратно вызывающей стороне, используя ключевое слово `return ). Это позволяет перехватывать и использовать выходные данные в вашей программе.

# 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#

Для вызова функций на глобальном уровне скрипта необходимо использовать функцию VR Thread.

You can take any function you have made previously, and pass it to vr_thread() at the global level. Calling at least one function inside of this is required to run a program. You do not need to do all function calls with vr_thread(), just ones that are at the global level.

Если будет сделано более vr_thread() (), функции будут выполняться параллельно.

Функции, как правило, выполняются в порядке их вызова. Однако, если функция ожидает завершения, она передаёт выполнение следующей функции и продолжает работу после завершения предыдущей функции или после того, как предыдущая функция также ожидает завершения.

Usage:
vr_thread(function)

Параметр

Описание

function

Название ранее определенной функции.

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

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