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 لعدد صحيح) قيمةً صالحة.
وهذا يعني أيضًا أنه لا يمكنك حذف البيانات من القاموس.
شيء ينبغي أخذه في الاعتبار عند تضمين هذه البنية في الكود.
لدى أحد أصدقائك متجر قديم لبيع الجملة يُدعى 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
لتنفيذ ذلك، ستحتاج إلى:
false إذا لم تكن unit المعطاة موجودة في خريطة units.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.false إذا لم تكن unit المعطاة موجودة في خريطة units.false إذا كانت الكمية الجديدة ستقل عن 0.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.
سجّل في Exercism لتتعلّم وتتقن Cairo عبر 25 مفهومًا68 تمرينًا، وإرشاد بشري حقيقي، وكل ذلك مجانًا.