Python#

VEX V5 Python APIリファレンスでは、各コマンド、メソッド、関数が何をするのか、どのような入力を使用するのか、何を返すのか、そしてプロジェクトでどのように使用できるのかを説明しています。

このリファレンスは、コマンドをプロジェクトに追加する前にその内容を理解したい場合、コマンドが受け入れる値や返す値を確認したい場合、またはカテゴリ内の関連コマンドを比較したい場合に使用します。

VEXcode V5のPythonプロジェクトでは、Pythonコマンドが使用されます。ブロックプロジェクトやC++プロジェクトでは、代わりに他のAPIセクションが使用されます。

メソッドエントリの読み方#

ほとんどのPythonのエントリには、以下の部分が含まれています。

  • コマンド名 - コマンド、メソッド、または関数の正式名称。

  • 説明 - コマンドの機能と、それが役立つ場面について説明します。

  • 使用方法 - コマンドをコードに記述するための構文を表示します。

  • パラメータ - コマンドが受け入れる入力の一覧と、それぞれの機能について説明します。

  • 戻り値 - コマンドが値を返す場合、そのコマンドが何を返すかを説明します。

  • サンプルコード - プロジェクト内でコマンドを使用する1つの方法を示します。

一般的なPython API要素#

要素

それはどういう意味か

方法

drivetrain.drive(…)のようなオブジェクトに対して呼び出されるコマンド。

関数

wait(…) または print(…)のように直接呼び出されるコマンド。

パラメータ

メソッドや関数に渡される値で、その動作を制御するために使用されます。

オプションパラメータ

省略可能なパラメータで、省略するとデフォルトの動作が使用されます。

戻り値

コマンドが返す値。数値、テキスト、ブール値など。

Pythonの基本用語#

学期

それはどういう意味か

変数

値を格納する名前。例: speed = 50。

弦

引用符内のテキスト、例: “Hello”。

整数

90のような正または負の数。

フロート

小数点を含む数値、例: 25.5。

ブール値

True または Falseのいずれかの値。

口論

メソッドまたは関数呼び出しに渡される値。たとえば、 drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)の 360.0。

メソッドエントリの例#

ドライブ#

ドライブdrive ロボットを永久に前進または後退させます。ロボットは、旋回や停止などの別の動作が与えられるまで動き続けます。回転数(RPM)または角度/秒の場合、制限は駆動系のギア比によって変わります。

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

パラメータ

説明

direction

ロボットの移動方向: FORWARD または REVERSE。

velocity

Optional. The velocity to drive with from 0% to 100% when using PERCENT, from 0 to 600 rpm when using RPM, or from 0 to 3600 degrees per second when using VelocityUnits.DPS. This can be an integer or decimal (float). If no velocity is provided, the robot drives at the current drive velocity.

units

オプション。速度単位: RPM (1分あたりの回転数、デフォルト)、 PERCENT、または VelocityUnits.DPS (1秒あたりの角度)。

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

# Drive forward at 360 degrees per second
drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)