Cairo 的核心程式庫提供字典,並以Felt252Dict<T>型別表示。
Cairo 字典的鍵型別僅限於felt252,這與其他語言不同,其他語言可以自行定義鍵的型別。
若要建立字典,可以使用Default trait 的default方法,例如:
let mut foo: Felt252Dict<u32> = Default::default();
最常使用的基本操作有:
insert(felt252, T) -> (),用來把值寫入字典實例,以及get(felt252) -> T,用來從中讀取值。以下是這些操作的使用方式:
let mut foo: Felt252Dict<u32> = Default::default();
// Add a value to the dictionariy
foo.insert('bar', 42);
// Here we update the element of 'bar'
foo.insert('bar', 73);
// To retrieve a dictionary value, you can use
baz = foo.get('bar');
如果你試著取得字典中某個不存在的鍵所對應的值,它會回傳該值型別的零值。
這可能會讓你混淆,特別是當你的值型別的預設值(例如整數的 0)本身就是有效的值時。
這也代表你無法從字典中刪除資料。
將這個結構融入你的程式碼時,這點值得留意喔。
你的一位朋友開了一家老字號的批發店,叫做Gross Store。
這個名字來自店裡販售的商品數量:全部都是以 gross 單位 來計算。
你的朋友請你幫他的店實作一套銷售時點系統(POS)。
首先,你要先為它建立一個雛型。
在你的雛型中,系統只會記錄數量。
你的朋友給了你一份測量單位清單,方便你參考:
| 單位 | 數值 |
|---|---|
| quarter_of_a_dozen | 3 |
| half_of_a_dozen | 6 |
| dozen | 12 |
| small_gross | 120 |
| gross | 144 |
| great_gross | 1728 |
為了使用這些測量單位,你需要先把單位儲存在程式中。
let units = units();
// Felt252Dictionary with entries like { 'dozen': 12 }
你需要實作一個函式,為客戶建立一張新的(空的)帳單。
let bill = new_bill();
// Empty Felt252Dictionary
要實作這個功能,你需要:
unit不在units對照表中,回傳false。bill,然後回傳true。unit所屬的數量增加它的數量。let bill = new_bill();
let units = units();
let ok = add_item(bill, units, 'carrot', 'dozen');
println!(ok);
// Output: true (since dozen is a valid unit)
注意,回傳值的型別是
bool。
要實作這個功能,你需要:
false。
如果項目的數量是 0,就視為不在帳單中。unit不在units對照表中,回傳false。false。bill移除該項目,因此可以回傳true。true。let bill = new_bill();
let units = units();
let ok = remove_item(bill, units, 'carrot', 'dozen');
println!(ok);
// Output: false (because there are no carrots in the bill)
注意,回傳值的型別是
bool。
let mut bill: Felt252Dict<u32> = Default::default();
bill.insert('carrot', 12);
bill.insert('grapes', 3);
let qty = get_item(bill, 'carrot');
println!(qty);
// Output: 12
注意,回傳值的型別是
u32。