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。
这个名字来自这家店出售商品的数量:它们全都以罗为单位。
朋友请你为他的店实现一个销售点(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。