變數

介紹

VEXcode 123 中的變數模組可讓您儲存專案稍後可以使用的資訊。變數就像一個帶有標籤的容器，用於保存值，例如數字、布林值或項目清單。

當你想讓專案在運行過程中記住某些資訊時，就可以使用變數。例如，變數可以記錄機器人移動的次數、計數的物體數量，或者是否達到了目標。

當項目中的信息可能會發生變化時，變數就非常有用。與其在多個重複寫入相同的數字或答案，不如將其儲存在變數中，並在專案運行時進行更新。這樣一來，專案的修改、檢查和理解就變得更加容易。

在 VEXcode 123 中，變數模組可以儲存不同類型的信息，包括數字、布林值（例如真或假）、列表和二維列表。當專案需要進行計數、做出決策、追蹤進度或組織資訊時，這些模組非常有用。

以下是可用模組列表：

數值變數——儲存和修改數字。

• 數值變數 – 報告數值變數的值。

• 設定數值變數 – 為數值變數賦值。

• 更改數值變數 – 將數值變數增加或減少一個設定的值。

布林變數－儲存真或假值。

• 布林變數 – 報告布林變數的值。

• 設定布林變數 – 將 True 或 False 值賦給布林變數。

列表——儲存和管理值的集合。

• 清單項目 – 根據清單中的位置報告該值。

• 取代清單項目 – 更新清單中的特定項目。

• 設定清單項目 – 為清單賦值。

• 列表長度 – 報告清單中的項目數。

二維列表－以網格形式儲存和管理值集合。

• 2D 清單項目 – 報告 2D 清單中特定行和列的值。

• 取代二維列表項目 – 更新二維清單中的特定項目。

• 設定二維列表項目 – 為二維列表賦值。

• 二維列表長度 – 報告二維列表中的行數或列數。

數值變數

數值變數

數值變數報告區塊報告指派給變數的數值。

數值變數報告模組。

(myVariable)

範圍	描述
	此程式碼區塊沒有參數。

例子

當開始時
[Display the value of the variable.]
設定 [deliveries v] 為 [2]
列印 (deliveries) ▶

設定數值變數

設定數值變數堆疊區塊為數值變數賦值。

設定數值變數報告器模組。

設定 [myVariable v] 為 [1]

範圍	描述
多變的	要賦值的數值變數。使用者可以選擇現有變數、重新命名或刪除它。
價值	分配給變數的數字（可以是整數、小數或數字塊）。

例子

當開始時
[Display the value of the variable.]
設定 [deliveries v] 為 [2]
列印 (deliveries) ▶

更改數值變數

更改數值變數堆疊塊將變數的值增加或減少給定的量。

更改數值變數堆疊塊。

將 [myVariable v] 改變 (1)

範圍	描述
多變的	要修改的數值變數。使用者可以選擇現有變量，對其進行重新命名或刪除。
價值	變數增加或減少的量。

例子

當開始時
[Deliver a package twice.]
設定 [deliveries v] 為 [0]
行駛 [前方 v] (1) [步 v]
將 [deliveries v] 改變 [1]
行駛 [前方 v] (1) [步 v]
將 [deliveries v] 改變 [1]
列印 (deliveries) ▶

布林變數

布林變數

布林變數 布林區塊報告 True 或 False 值。

布林變數報告器模組。

<myBoolean>

範圍	描述
	此程式碼區塊沒有參數。

例子

當開始時
[Display a message if the variable is set to True.]
設定 [my_boolean v] 為 <true v>
如果 <my_boolean> 則
列印 [Boolean is True!] ▶
結束

設定布林變數

設定布林變數堆疊區塊將True或False值賦給布林變數。

設定布林變數棧塊。

設定 [myBoolean v] 為 <true v>

範圍	描述
多變的	要賦值的布林變數。使用者可以選擇現有變數、重新命名或刪除它。
價值	布林值（真或假）。

例子

當開始時
[Repeat until 3 deliveries are made.]
設定 [finished v] 為 <false v>
設定 [deliveries v] 為 [0]
重複直到 <finished>
行駛 [前方 v] (1) [步 v]
將 [deliveries v] 改變 [1]

如果 <(deliveries) [math_equal v] [3]> 則
設定 [finished v] 為 <true v>

清單

清單項

列表項報告區塊用於報告清單中某項的值。列表是一種變量，可以儲存多個相同類型的變數。

列表項報告器模組。

([myList v] 的第 (1) 項)

範圍	描述
指數	該項在清單中的位置（從 1 開始）。
多變的	要從中報告項目的列表變數。使用者可以選擇現有清單、重新命名清單或刪除清單。

例子

當開始時
[Display the delivery locations.]
將 [delivery_spots v] 設定為 [Red House] [Green House] [Blue House]
行駛 [前方 v] (1) [步 v]
列印 ([delivery_spots v] 的第 (1) 項) ▶
行駛 [前方 v] (1) [步 v]
列印 ([delivery_spots v] 的第 (2) 項) ▶
行駛 [前方 v] (1) [步 v]
列印 ([delivery_spots v] 的第 (3) 項) ▶

替換列表項

替換清單項目堆疊區塊用於更新清單中的特定項目。

替換列表項堆疊塊。

將 [myList v] 第 (1) 項替換為 (1)

範圍	描述
多變的	包含要修改項目的列表變數。使用者可以選擇現有清單、重新命名清單或刪除清單。
指數	該項在清單中的位置（從 1 開始）。
價值	指派給指定清單項目的新值。

例子

當開始時
[Replace the first item in a list with "Robot".]
將 [my_list v] 設定為 [Red] [Green] [Blue]
將 [my_list v] 第 (1) 項替換為 [Robot]
列印 ([my_list v] 的第 (1) 項) ▶

歌單項目

設定清單項目堆疊區塊將清單中的每個項目設定為輸入的值。

設定列表項堆疊塊。

將 [myList v] 設定為 (0) (0) (0)

範圍	描述
多變的	列表變數正在被賦值。使用者可以選擇現有清單、重新命名清單或刪除清單。
值	若要儲存在清單中的值，以單一項目的形式輸入。

例子

當開始時
[Display a delivery locations.]
將 [delivery_spots v] 設定為 [Red House] [Green House] [Blue House]
行駛 [前方 v] (1) [步 v]
列印 ([delivery_spots v] 的第 (2) 項) ▶

列表長度

清單長度 報告區塊報告清單中的項目數。

列表報告區塊的長度。

([myList v] 的長度 :: list)

範圍	描述
多變的	用於報告列表長度的列表變數。使用者可以選擇現有清單、重新命名清單或刪除清單。

例子

當開始時
[Display how many items are in a list.]
將 [my_list v] 設定為 [Red] [Green] [Blue]
列印 ([my_list v] 的長度 :: list) ▶

二維列表

二維列表項

二維清單項目報告區塊用於報告二維清單中某項的值。二維列表是儲存多個list變數的變數。

二維列表項報告模組。

([my2DList v] 的第 (1)(1) 項)

範圍	描述
排	該項所在的行（從 1 開始）。
柱子	項目的列（從 1 開始）。
多變的	要從中報告項目的二維列表變數。使用者可以選擇現有的二維列表，對其進行重新命名或刪除。

例子

當開始時
[Display an item from a 2D list.]
將 [my_2d_list v] 設定為 ([1] [10]) ([2] [20])
列印 ([my_2d_list v] 的第 (2)(2) 項) ▶

替換二維列表項

取代二維列表項目堆疊區塊用於更新二維列表中的特定項目。

取代二維列表項目堆疊塊。

將 [my2DList v] 第 (1)(1) 項替換為 (1)

範圍	描述
排	該項的行索引（從 1 開始）。
柱子	項目的列索引（從 1 開始）。
多變的	包含要修改項目的二維列表變數。使用者可以從下拉式選單中選擇現有的二維列表，對其進行重新命名或刪除。
價值	指派給指定二維列表項的新值。

例子

當開始時
[Replace a value in a 2D list and print the updated item.]
將 [my_2d_list v] 設定為 ([1] [2]) ([3] [4])
將 [my_2d_list v] 第 [2][2] 項替換為 [50]
列印 ([my_2d_list v] 的第 (2)(2) 項) ▶

設定二維列表項

設定 2D 清單項目 堆疊區塊將 2D 清單中的每個項目設定為輸入的值。

取代二維列表項目堆疊塊。

將 [my2DList v] 設定為 ([0] [0]) ([0] [0])

範圍	描述
多變的	正在為二維列表變數賦值。使用者可以選擇現有的二維列表，對其進行重新命名或刪除。
值	若要儲存在二維列表中的值，逐行輸入。

例子

當開始時
[Display an item from a 2D list.]
將 [my_2d_list v] 設定為 ([1] [10]) ([2] [20])
列印 ([my_2d_list v] 的第 (2)(2) 項) ▶

二維列表的長度

二維列表長度報告區塊報告二維列表中的行數或列數。

二維列表報告區塊的長度。

[my2DList v] 的 [列 v] 長度

範圍	描述
多變的	用於檢查二維列表長度的變數。使用者可以選擇現有的二維列表，對其進行重新命名或刪除。
列/列	是報告行數還是列數。

例子

當開始時
[Set a 2D list and print the number of rows it has.]
將 [my_2d_list v] 設定為 ([1] [2]) ([3] [4])
列印 ([my_2d_list v] 的 [列 v] 長度) ▶