Python#

Справочник по API Python для VEX IQ (2-го поколения) объясняет, что делает каждая команда, метод и функция, какие входные данные они используют, что они возвращают и как их можно использовать в проекте.

Используйте этот справочник, если хотите понять, что представляет собой команда, прежде чем добавлять её в проект, проверить, какие значения она принимает или возвращает, или сравнить связанные команды в категории.

В проектах VEXcode IQ (2-го поколения) на Python используются команды Python. В проектах на C++ для блоков используются другие разделы API.

Примечание: В среде IQ (2-го поколения) Python запускается через виртуальную машину с ограниченным объемом памяти. Хотя существует максимальный размер исходного кода, возможность запуска программы также зависит от ее сложности (например, от количества используемых функций, переменных и логики). В результате, большие или сложные программы могут не скомпилироваться или не запуститься, даже если их размер не превышает установленный лимит. Программы на C/C++ в среде IQ (2-го поколения) обычно менее подвержены этим ограничениям.

Как читать описание метода ввода#

Большинство статей по Python содержат следующие части:

Имя команды — Официальное название команды, метода или функции.
Описание - Объясняет, что делает команда и когда она полезна.
Использование - Отображает синтаксис, используемый для написания команды в коде.
Параметры — Список входных параметров, принимаемых командой, и объяснение назначения каждого из них.
Возвращаемое значение — поясняет, что команда возвращает, если она возвращает какое-либо значение.
Пример кода — демонстрирует один из способов использования команды в проекте.

Общие элементы API Python#

Элемент	Что это значит
Метод	Команда, вызываемая для объекта, например, `drivetrain.drive(…)`.
Функция	Команда, вызываемая напрямую, например, `wait(…)` или `print(…)`.
Параметр	Значение, передаваемое в метод или функцию для управления их действием.
Необязательный параметр	Параметр, который можно опустить, чтобы использовалось поведение по умолчанию.
Возвращаемое значение	Значение, которое возвращает команда, например, число, текст или логическое значение.

Базовый словарь Python#

Срок	Что это значит
Переменная	Имя, хранящее значение, например, `speed = 50`.
Нить	Текст внутри кавычек, например `“Hello”`.
Целое число	Положительное или отрицательное число, например `90`.
Плавать	Число с десятичной запятой, например, `25.5`.
Логическое значение	Значение, равное либо `True` , либо `False`.
Аргумент	Значение, передаваемое в вызов метода или функции, например, `REVERSE` in `drivetrain.drive(REVERSE, 20, PERCENT)`.

Пример ввода метода#

водить машину#

Привод drive перемещает робота вперед или назад бесконечно. Робот будет продолжать движение, пока ему не будет дано другое действие, например, поворот или остановка.

Usage:
drivetrain.drive(direction, velocity, units)

Параметры	Описание
`direction`	Направление движения робота: `FORWARD` или `REVERSE`.
`velocity`	Необязательно. Скорость вращения от 0% до 100% при использовании `PERCENT`, от 0 до 120 об/мин при использовании `RPM`или от 0 до 720 градусов в секунду при использовании `VelocityUnits.DPS`Это может быть целое число `integerfloat`). Если скорость не указана, робот вращается с текущей скоростью вращения.
`units`	Необязательно. Единица измерения скорости: `PERCENT` (по умолчанию), `RPM` (оборотов в минуту) или `VelocityUnits.DPS` (градусов в секунду).

# Drive forward then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()

# Drive slowly in reverse then stop
drivetrain.drive(REVERSE, 20, PERCENT)
wait(2, SECONDS)
drivetrain.stop()