変数

導入

VEXcode AIRの変数ブロックを使用すると、プロジェクトで後で使用できる情報を保存できます。変数は、数値、ブール値、アイテムのリストなどの値を保持するラベル付きコンテナのようなものです。

プロジェクトの実行中に何かを記憶させておきたい場合は、変数を使用します。たとえば、変数を使って、ドローンが移動した回数、カウントした物体の数、目標が達成されたかどうかなどを追跡できます。

プロジェクトの情報が変化する可能性がある場合、変数は非常に役立ちます。同じ数値や答えを複数の場所に記述する代わりに、変数に格納してプロジェクトの実行中に更新することができます。これにより、プロジェクトの変更、確認、理解が容易になります。

VEXcode AIRでは、変数ブロックは数値、真偽値などのブール値、リスト、2Dリストなど、さまざまな種類の情報を格納できます。これらのブロックは、プロジェクトでカウント、意思決定、進捗状況の追跡、情報の整理が必要な場合に役立ちます。

利用可能なブロックの一覧は以下のとおりです。

数値変数 - 数値を格納および変更します。

• 数値変数 — 数値変数の値を報告します。

• 数値変数を設定 — 数値変数に値を割り当てます。

• 数値変数の変更 — 数値変数を指定した量だけ増減します。

ブール変数 — True または 、False 値を格納します。

• ブール変数 — ブール変数の値を報告します。

• ブール変数を設定 — ブール変数にTrueまたはFalseの値を割り当てます。

リスト — 値の集合を保存および管理します。

• リスト項目 — リストの位置に基づいてリストから値を報告します。

• リスト項目の置換 — リスト内の特定の項目を更新します。

• set list items — リストに値を割り当てます。

• リストの長さ — リスト内の項目の数を報告します。

2Dリスト — 値の集合をグリッド形式で保存および管理します。

• 2D リスト項目 — 2D リストの特定の行と列の値を返します。

• 2Dリスト項目の置換 — 2Dリスト内の特定の項目を更新します。

• 2Dリスト項目を設定する — 2Dリストに値を割り当てます。

• 2Dリストの長さ — 2Dリストの行数または列数を報告します。

数値変数

数値変数

数値変数レポーターブロックは、変数に割り当てられた数値を報告します。

数値変数レポーターブロック。

(my_variable)

パラメータ	説明
	このブロックにはパラメータがありません。

例

開始したとき
[Use a variable to fly forward and back the same distance.]
[fly_distance v] を [90] に設定
[500] [mm v] の高さへ離陸 ▶
[前進 v] へ (fly_distance) [mm v] 移動 ▶
(1) 秒待つ
[backward v] へ (fly_distance) [mm v] 移動 ▶
(1) 秒待つ
着陸 ▶

数値変数を設定する

数値変数の設定スタックブロックは、数値変数に値を代入します。

パラメータ	説明
変数	値を割り当てる数値変数。ユーザーは既存の変数を選択したり、名前を変更したり、削除したりできます。
価値	変数に割り当てられた数値（整数、小数、または数値ブロックのいずれか）。

例

開始したとき
[Set a variable to fly forward and back the same distance.]
[fly_distance v] を [90] に設定
[500] [mm v] の高さへ離陸 ▶
[前進 v] へ (fly_distance) [mm v] 移動 ▶
(1) 秒待つ
[backward v] へ (fly_distance) [mm v] 移動 ▶
(1) 秒待つ
着陸 ▶

数値変数を変更する

数値変数の変更スタックブロックは、変数の値を指定された量だけ増減させます。

数値変数変更スタックブロック。

[my_variable v] を (1) 変える

パラメータ	説明
変数	変更する数値変数。既存の変数を選択したり、名前を変更したり、削除したりできます。
価値	変数を増減させる量。

例

開始したとき
[Fly forward for 50, 150, and 250mm.]
[fly_distance v] を [50] に設定
[500] [mm v] の高さへ離陸 ▶
(3) 回繰り返す
[前進 v] へ (fly_distance) [mm v] 移動 ▶
(1) 秒待つ
[fly_distance v] を (100) 変える
終わり
着陸 ▶

ブール変数

ブール変数

ブール変数ブールブロックは、TrueまたはFalseのいずれかの値を返します。

ブール変数レポーターブロック。

<my_boolean>

パラメータ	説明
	このブロックにはパラメータがありません。

例

開始したとき
[Display a message if the variable is set to True.]
[my_boolean v] を <true v> に設定
もし <my_boolean> なら
[Boolean is True!] をスクリーンに表示 ▶
終わり

ブール変数を設定する

set Boolean variableスタックブロックは、ブール変数にTrueまたはFalseの値を割り当てます。

セットブール変数スタックブロック。

[my_boolean v] を <true v> に設定

パラメータ	説明
変数	値を割り当てるブール変数。ユーザーは既存の変数を選択したり、名前を変更したり、削除したりできます。
価値	ブール値（真または偽）。

例

開始したとき
[Repeat until 3 deliveries are made.]
[500] [mm v] の高さへ離陸 ▶
[finished v] を <false v> に設定
[deliveries v] を [0] に設定
<finished> まで繰り返す
[前進 v] へ (100) [mm v] 移動 ▶
[deliveries v] を [1] 変える

もし <(deliveries) [math_equal v] [3]> なら
[finished v] を <true v> に設定
終わり
終わり
着陸 ▶

リスト

リスト項目

リスト項目レポーターブロックは、リスト内の項目の値を報告します。リストは、同じ型の複数の変数を格納できる変数です。

リストアイテムのレポーターブロック。

([my_list v] の (1) 番目)

パラメータ	説明
索引	リスト内における項目の位置（1から始まる）。
変数	報告対象となる項目のリスト変数。ユーザーは既存のリストを選択したり、名前を変更したり、削除したりできます。

例

開始したとき
[Display the delivery locations.]
[500] [mm v] の高さへ離陸 ▶
[delivery_spots v] を [Red House] [Green House] [Blue House]
[前進 v] へ (100) [mm v] 移動 ▶
([delivery_spots v] の (1) 番目) をスクリーンに表示 ▶
[前進 v] へ (100) [mm v] 移動 ▶
([delivery_spots v] の (2) 番目) をスクリーンに表示 ▶
[前進 v] へ (100) [mm v] 移動 ▶
([delivery_spots v] の (3) 番目) をスクリーンに表示 ▶
着陸 ▶

リスト項目を置き換える

リスト項目の置換スタックブロックは、リスト内の特定の項目を更新します。

リスト項目置換スタックブロック。

[my_list v] の (1) 番目を (1) に置き換える

パラメータ	説明
変数	変更する項目を含むリスト変数。ユーザーは既存のリストを選択したり、名前を変更したり、削除したりできます。
索引	リスト内における項目の位置（1から始まる）。
価値	指定されたリスト項目に割り当てられた新しい値。

例

開始したとき
[Replace the first item in a list with "AprilTag".]
[my_list v] を [Drone] [Controller] [Headset]
[my_list v] の (1) 番目を [AprilTag] に置き換える
([my_list v] の (1) 番目) をスクリーンに表示 ▶

セットリスト項目

set list itemsスタックブロックは、リスト内のすべての項目を、入力された値に設定します。

セットリストアイテムのスタックブロック。

[my_list v] を [0] [0] [0]

パラメータ	説明
変数	リスト変数に値が割り当てられます。ユーザーは既存のリストを選択したり、名前を変更したり、削除したりできます。
値	リストに格納する値を、個別の項目として入力します。

例

開始したとき
[Display the last item in a list.]
[my_list v] を [Red] [Green] [Blue]
([my_list v] の (3) 番目) をスクリーンに表示 ▶

リストの長さ

リストの長さレポーターブロックは、リスト内の項目の数を報告します。

リストの長さレポーターブロック。

([my_list v] の長さ :: list)

パラメータ	説明
変数	長さを表示するリスト変数。ユーザーは既存のリストを選択したり、名前を変更したり、削除したりできます。

例

開始したとき
[Display how many items are in a list.]
[my_list v] を [Red] [Green] [Blue]
([my_list v] の長さ :: list) をスクリーンに表示 ▶

2Dリスト

2Dリストアイテム

2D リスト項目 レポーター ブロックは、2D リスト内の項目の値を報告します。2D リストは、複数の list 変数を格納する変数です。

2Dリストアイテムレポーターブロック。

([my_2d_list v] の (1)(1) 番目)

パラメータ	説明
行	アイテムの行番号（1から始まる）。
カラム	項目の列（1から始まる）。
変数	アイテムを報告するための2次元リスト変数。ユーザーは既存の2次元リストを選択したり、名前を変更したり、削除したりできます。

例

開始したとき
[Display an item from a 2D list.]
[my_2d_list v] を ([1] [Drone]) ([4] [Propeller])
([my_2d_list v] の (2)(2) 番目) をスクリーンに表示 ▶

2Dリストアイテムを置き換える

2Dリスト項目の置換スタックブロックは、2Dリスト内の特定の項目を更新します。

2Dリストアイテムの置換スタックブロック。

[my_2d_list v] の (1)(1) 番目を (1) に置き換える

パラメータ	説明
行	項目の行インデックス（1から始まります）。
カラム	項目の列インデックス（1から始まります）。
変数	変更する項目を含む2次元リスト変数。ユーザーはドロップダウンメニューから既存の2次元リストを選択したり、名前を変更したり、削除したりできます。
価値	指定された2Dリスト項目に割り当てられた新しい値。

例

開始したとき
[Replace a value in a 2D list and print the updated item.]
[my_2d_list v] を ([1] [Drone]) ([4] [Propeller])
[my_2d_list v] の [2][2] 番目を [Headset] に置き換える
([my_2d_list v] の (2)(2) 番目) をスクリーンに表示 ▶

2Dリストアイテムを設定する

2Dリスト項目の設定スタックブロックは、2Dリスト内のすべての項目を、入力された値に設定します。

2Dリストアイテムの置換スタックブロック。

[my_2d_list v] を ([0] [0]) ([0] [0])

パラメータ	説明
変数	2Dリスト変数に値が割り当てられます。ユーザーは既存の2Dリストを選択したり、名前を変更したり、削除したりできます。
値	2次元リストに格納する値を、行ごとに入力します。

例

開始したとき
[Display an item from a 2D list.]
[my_2d_list v] を ([1] [Drone]) ([4] [Propeller])
([my_2d_list v] の (1)(2) 番目) をスクリーンに表示 ▶

2Dリストの長さ

2Dリストの長さレポーターブロックは、2Dリストの行数または列数を報告します。

2Dリストレポーターブロックの長さ。

([my_2d_list v] の [行 v] の長さ)

パラメータ	説明
変数	長さを確認する2次元リスト変数。ユーザーは既存の2次元リストを選択したり、名前を変更したり、削除したりできます。
行/列	行数を報告するか、列数を報告するか。

例

開始したとき
[Set a 2D list and print the number of rows it has.]
[my_2d_list v] を ([1] [Drone]) ([4] [Propeller])
([my_2d_list v] の [行 v] の長さ) をスクリーンに表示 ▶