Cairo는 코어 라이브러리의 일부로, Felt252Dict<T> 타입으로 표현되는 딕셔너리를 제공해요.
Cairo에서 딕셔너리의 키 타입은 felt252로 제한돼요. 키의 타입을 직접 정의할 수 있는 다른 언어들과는 다른 부분이에요.
딕셔너리를 만들려면 Default 트레이트의 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 값을 반환해요.
이 때문에 헷갈릴 수 있어요. 특히 값 타입의 기본값(예를 들어 정수라면 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예요.