المسارات
/
Cairo
Cairo
/
التمارين
/
المتجر الإجمالي
المتجر الإجمالي

المتجر الإجمالي

تمرين تعلّمي

مقدمة

Cairo توفّر القواميس كجزء من مكتباتها الأساسية، ويمثّلها النوع Felt252Dict<T>.

نوع مفتاح القاموس في Cairo مقيّد بـ felt252، وهذا يختلف عن لغات أخرى يمكن فيها تعريف نوع المفتاح.

لإنشاء قاموس، يمكنك استخدام الطريقة default من السمة Default، هكذا:

let mut foo: Felt252Dict<u32> = Default::default();

العمليات الأساسية الأكثر استخدامًا هي:

  1. insert(felt252, T) -> () لكتابة القيم في نسخة من القاموس، و
  2. 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

1. خزّن وحدة القياس في برنامجك

لكي تستخدم القياس، تحتاج إلى تخزينه في برنامجك.

let units = units();
// Felt252Dictionary with entries like { 'dozen': 12 }

2. أنشئ فاتورة جديدة للعميل

تحتاج إلى تنفيذ دالة تُنشئ فاتورة جديدة (فارغة) للعميل.

let bill = new_bill();
// Empty Felt252Dictionary

3. أضف عنصرًا إلى فاتورة العميل

لتنفيذ ذلك، ستحتاج إلى:

  • أرجِع 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.

4. أزل عنصرًا من فاتورة العميل

لتنفيذ ذلك، ستحتاج إلى:

  • أرجِع false إذا لم يكن العنصر المعطى غير موجود في الفاتورة. يُعتبر العنصر غير موجود في الفاتورة إذا كانت كميته 0.
  • أرجِع false إذا لم تكن unit المعطاة موجودة في خريطة units.
  • أرجِع false إذا كانت الكمية الجديدة ستقل عن 0.
  • إذا كانت الكمية الجديدة 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.

5. أرجِع كمية عنصر معيّن موجود في فاتورة العميل

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.

تعديل عبر GitHub يفتح الرابط في نافذة أو علامة تبويب جديدة
Cairo Exercism

مستعد لبدء المتجر الإجمالي؟

سجّل في Exercism لتتعلّم وتتقن Cairo عبر 25 مفهومًا68 تمرينًا، وإرشاد بشري حقيقي، وكل ذلك مجانًا.