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');
اگر مقدار یک کلید را بازیابی کنید که در دیکشنری وجود ندارد، دیکشنری مقدار صفرِ نوع مقدار را برمیگرداند.
این میتواند شما را گیج کند، بهویژه اگر مقدار پیشفرض نوع مقدار شما (برای مثال، ۰ برای یک عدد صحیح) یک مقدار معتبر باشد.
این همچنین به این معناست که راهی برای حذف دادهها از یک دیکشنری وجود ندارد.
نکتهای که هنگام گنجاندن این ساختار در کد خود باید در نظر بگیرید.
یکی از دوستانتان یک فروشگاه عمدهفروشی قدیمی به اسم 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 را برگردانید.
کالایی که مقدارش ۰ باشد، در صورت حساب موجود به حساب نمیآید.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است.