لطالما جريتَ من أجل الإثارة وحدها: بلا جداول، بلا مؤقتات، فقط صوت قدميك على الإسفلت. لكن بعد أن انضممت إلى فريق جري تنافسي، أصبحت الأمور جادة. فالحصص التدريبية تُوقَّت بالثانية، وكل جزء من الثانية مهم. ولكي تواكب الإيقاع، اقتنيت ساعة الإيقاف اللحظية، جهازًا أنيقًا عالي التقنية على وشك أن يصبح صديقك المفضل الجديد.
مهمتك هي بناء ساعة إيقاف لتتبع أوقات اللفات بدقة.
تستخدم ساعة الإيقاف أربعة أوامر (start، stop، lap، reset) لتتبع:
تعتمد الأوامر التي يمكن استخدامها على الحالة التي تكون فيها ساعة الإيقاف:
| الأمر | حالة البداية | حالة النهاية | التأثير |
|---|---|---|---|
| Start | Ready | Running | بدء تتبع الوقت |
| Start | Stopped | Running | استئناف تتبع الوقت |
| Stop | Running | Stopped | إيقاف تتبع الوقت |
| Lap | Running | Running | إضافة اللفة الحالية إلى اللفات السابقة، ثم إعادة ضبط اللفة الحالية |
| Reset | Stopped | Ready | إعادة ضبط اللفة الحالية ومسح اللفات السابقة |
from_quote
تحوّل دالة Time.from_quote سلسلة نصية منسّقة بالصيغة "HH:MM:SS" إلى قيمة من النوع Time.
وهذا يتيح كتابة كود مثل هذا:
time : Time
time = "00:01:23"
يستدعي هذا الكود Time.from_quote("00:01:23") ضمنيًا في وقت الترجمة.
وتشغيل الكود في وقت الترجمة بهذه الطريقة (أو بطرق أخرى مشروحة أدناه) قد يسرّع البرنامج لأنه لم يعد بحاجة إلى معالجة التحليل والتحقق من صحة البيانات في وقت التشغيل.
علاوة على ذلك، يضمن أن البيانات غير الصالحة (مثل صيغة تاريخ غير صحيحة) تُرفض في وقت الترجمة بدلًا من وقت التشغيل، مما يجعل تطبيقك أكثر متانة.
وأخيرًا، يجعل الكود جميلًا وسهل القراءة.
على سبيل المثال، إليك أحد الاختبارات في هذا التمرين:
## start initiates time tracking for current lap
expect {
result = Stopwatch.create()
.start()?
.advance_time("00:00:05")
|> expect_current_lap("00:00:05")
result.is_ok()
}
لكن من يقرأ هذا الكود قد يفترض أن دالة advance_time تأخذ Str بينما هي في الحقيقة تأخذ Time.
وقد يؤدي هذا إلى ارتباك وأخطاء.
لهذا السبب، قد تفضّل الصيغة الأطول قليلًا لكن الأوضح: "00:00:05".Time وهي أيضًا تستدعي from_quote في وقت الترجمة.
في برامجك الخاصة، قد تفضّل استخدام from_str بدلًا من ذلك:
Time := { ... }.{
from_str : Str -> Try(Time, [InvalidTime])
from_str = |time_str| ...
}
يمكنك أيضًا استدعاء from_str (أو أي دالة نقية أخرى) في وقت الترجمة، هكذا:
Ok(time) = Time.from_str("00:01:23")
ملاحظة: وضع هذا التعريف في المستوى الأعلى يجعله يعمل في وقت الترجمة (لأن الدالة نقية ومدخلها معروف في وقت الترجمة). أما داخل دالة، فيمكنك استخدام from_str في وقت التشغيل.
سجّل في Exercism لتتعلّم وتتقن Roc عبر 139 تمرينًا، وإرشاد بشري حقيقي، وكل ذلك مجانًا.