Cairoは、コアライブラリの一部として、Felt252Dict<T>型で表される辞書を提供しています。
Cairoでは辞書のキーの型はfelt252に限られており、キーの型を定義できる他の言語とは異なります。
辞書を作成するには、Defaultトレイトのdefaultメソッドを次のように使います。
let mut foo: Felt252Dict<u32> = Default::default();
よく使われる基本的な操作は、次の2つです。
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です。