Python

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

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

VEXcodeのPythonプロジェクトではPythonコマンドを使用します。ブロックプロジェクトでは、代わりにブロックAPIのセクションを参照してください。

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

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

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

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

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

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

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

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

一般的なPython API要素

要素	それはどういう意味か
方法	オブジェクトに対して呼び出されるコマンドは、例えば arm.move_inc(…)。
関数	wait(…) または print(…)のように直接呼び出されるコマンド。
パラメータ	メソッドや関数に渡される値で、その動作を制御するために使用されます。
オプションパラメータ	省略可能なパラメータで、省略するとデフォルトの動作が使用されます。
戻り値	コマンドが返す値。数値、テキスト、ブール値など。

Pythonの基本用語

学期	それはどういう意味か
変数	値を格納する名前。例: x_target = 120。
弦	引用符内のテキスト、例: “Hello”。
整数	90のような正または負の数。
フロート	小数点を含む数値、例: 25.5。
ブール値	True または Falseのいずれかの値。
口論	メソッドまたは関数呼び出しに渡される値。たとえば、 arm.move_inc(0, 100, 0)の 100 など。

メソッドエントリの例

ムーブインク

move_inc は、6軸アームをx、y、z軸に沿って指定された距離だけ移動させます。

このメソッドは、6軸アームが要求された位置に到達したかどうかを示すブール値を返します。

• True - 6軸アームが要求された位置に到達しました。

• False - 6軸アームは要求された位置に到達できません。

Usage:
arm.move_inc(x, y, z, wait)

パラメータ	説明
x	x軸方向に移動する距離（ミリメートル単位）。
y	y軸方向に移動する距離（ミリメートル単位）。
z	z軸方向に移動する距離（ミリメートル単位）。
wait	オプション。 wait=True (デフォルト) - プロジェクトは、次のコード行を実行する前に、 move_inc が完了するまで待機します。 wait=False - プロジェクトは、アクションを開始し、 move_inc 完了を待たずに、すぐに次のコード行に進みます。

# Move the Arm +100 millimeters on the y-axis
arm.move_inc(0, 100, 0)