ينقر المستخدم على Add Expense، ويكتب “12.50” في حقل المبلغ، ثم ينقر Save. يستقبل كودك String. وتحويلها إلى رقم قد يفشل: ربما الحقل فارغ، أو ربما كتب المستخدم “twelve”. كثير من اللغات تعطيك في هذه الحالة NaN أو صفرًا أو استثناءً. أما Swift فتعطيك optional (قيمة اختيارية)، وتُلزمك بالتعامل مع حالة الغياب قبل أن يُترجَم الكود.
import Foundation\n\nlet typed = \"12.50\"\nlet amount = Decimal(string: typed) // amount is Decimal?, not Decimalعلامة الاستفهام في Decimal? تعني «قيمة Decimal، أو لا شيء». و«لا شيء» تُكتب nil. في الداخل، الـ optional هو enum له حالتان، .some(value) و.none، ولهذا يمكنك أن تتخيّله صندوقًا إما ممتلئًا أو فارغًا.
الـ optional ليس هو القيمة التي في داخله. جرّب amount + 5 وسيوقفك الـ compiler بالرسالة “value of optional type ‘Decimal?’ must be unwrapped to a value of type ‘Decimal’”. هذا الخطأ هو الميزة نفسها. كل مكان قد تغيب فيه القيمة مُعلَّم في النوع، ولن تسمح لك Swift بأن تنساه.
يفحص if let الصندوق، وحين يكون ممتلئًا يعطيك القيمة باسم جديد غير optional:
if let amount = Decimal(string: typed) {\n print(\"Adding \\(amount)\") // amount is a Decimal here\n} else {\n print(\"That isn't a number\")\n}حين يطابق الاسم الجديد اسم optional موجود، تسمح لك Swift 5.7 وما بعدها بحذف الطرف الأيمن: if let amount { … }. الاسم الجديد amount لا يوجد إلا داخل الأقواس، وهذا مثالي حين تهمّك القيمة في فرع صغير واحد.
في أغلب الأحيان، القيمة الغائبة تعني «توقّف هنا». وguard let يقول ذلك بالضبط. هذه هي الدالة التي يستخدمها Pocket Budget للتحقّق من حقل المبلغ:
import Foundation\n\nfunc parseAmount(_ text: String) -> Decimal? {\n let trimmed = text.trimmingCharacters(in: .whitespaces)\n guard let amount = Decimal(string: trimmed), amount > 0 else {\n return nil\n }\n return amount\n}\n\nprint(parseAmount(\"12.50\") as Any) // Optional(12.5)\nprint(parseAmount(\"\") as Any) // nil\nprint(parseAmount(\"-3\") as Any) // nilيجب أن تغادر كتلة else النطاق الحالي باستخدام return أو throw أو break أو continue، والـ compiler يفرض ذلك. وفي المقابل، يبقى amount متاحًا كقيمة Decimal عادية حتى نهاية الدالة. الفاصلة تضيف شرطًا ثانيًا، فيرفض guard واحد الحالتين معًا: «ليس رقمًا» و«صفر أو سالب». الكود المكتوب بهذه الطريقة يُقرأ من الأعلى إلى الأسفل: الفحوصات أولًا، ثم العمل الحقيقي، بلا هرم من جمل if المتداخلة.
أحيانًا يكون للقيمة الغائبة بديل واضح. عامل الدمج مع nil ?? يقدّمه لك:
let note: String? = nil\nlet label = note ?? \"No note\" // \"No note\"\nlet noteLength = note?.count ?? 0 // 0note?.count هو optional chaining (السلسلة الاختيارية): إذا كان note يساوي nil، يصبح التعبير كله nil بدل أن يتعطّل التطبيق، ثم يحوّل ?? ذلك إلى 0. يمكن أن تكون السلاسل طويلة (expense?.category?.name)، وتتوقّف عند أول nil.
والـ optionals قرار تصميمي أيضًا، لا مجرّد شيء تعطيك إيّاه الدوال. في Pocket Budget، لكل مصروف عنوان ومبلغ دائمًا، فهما String وDecimal عاديان. أما الملاحظة فاختيارية فعلًا، لذلك نوعها String?. قاوم إغراء جعل الأشياء optional «من باب الاحتياط»: كل ? تضيفها هي سؤال على كل من يقرأ تلك القيمة أن يجيب عنه. اجعل الخاصية optional فقط حين يكون «لا قيمة» حالة حقيقية لها معنى.
هناك طريقة أخرى لفتح الصندوق: !.
let amount = Decimal(string: typed)!إذا كانت typed تساوي “12.50”، يعمل هذا. وإذا كان الحقل فارغًا، يموت تطبيقك بالرسالة “Fatal error: Unexpectedly found nil while unwrapping an Optional value”. لا رسالة خطأ للمستخدم، ولا فرصة للتعافي.
للعامل ! استخدامات مشروعة، مثل URL(string: "https://example.com")! المبني من قيمة كتبتها بنفسك. هنا، nil تعني خطأً إملائيًا في كودك، والتعطّل أثناء التطوير هو أسرع طريقة لاكتشافه. كن مستعدًا للدفاع عن كل ! أثناء مراجعة الكود.
مع الـ optionals صار بإمكانك التعامل مع قيمة واحدة غائبة بأمان. بعد ذلك ستخزّن قيمًا كثيرة دفعة واحدة في المصفوفات والقواميس والمجموعات، وتتنقّل بينها بحلقات التكرار وswitch.
Decimal? إما أن يحمل قيمة أو يحمل nil، ولن تسمح لك Swift باستخدامه كقيمة عادية حتى تفكّه.","استخدم guard let لفكّ القيمة في أعلى الدالة والخروج مبكرًا، فيعمل باقي الدالة بقيمة حقيقية.","استخدم if let حين تحتاج القيمة داخل فرع واحد فقط، و?? حين توجد قيمة افتراضية منطقية.","الفكّ القسري (!) يُسقط التطبيق في اللحظة التي تكون فيها القيمة nil؛ اعتبر كل ! ادّعاءً يجب أن تستطيع إثباته."],"further":[{"title":"Optionals (The Basics)","url":"https://docs.swift.org/swift-book/documentation/the-swift-programming-language/thebasics/#Optionals"},{"title":"Optional","url":"https://developer.apple.com/documentation/swift/optional"}],"quiz":[{"q":"لديك let note: String? = nil. ما قيمة note?.count ?? 0؟
nil","why":"الـ optional chaining ينتج nil هنا فعلًا، لكن ?? 0 يستبدلها بعد ذلك بالقيمة الافتراضية."},{"text":"0","why":"صحيح. note?.count يتوقّف مبكرًا وينتج nil، ثم يقدّم ?? القيمة 0."},{"text":"يتعطّل البرنامج.","why":"الفكّ القسري (!) وحده يُسقط التطبيق عند nil. أما ?. و?? فهما الصيغتان الآمنتان."},{"text":"لا يُترجَم، لأنك لا تستطيع استدعاء count على optional.","why":"لا تستطيع استدعاءها مباشرة، لكن ?. هي بالضبط الصيغة التي تجعل الاستدعاء مسموحًا."}],"answer":1},{"q":"داخل دالة، بعد guard let amount = parseAmount(text) else { return }، ما الصحيح بشأن amount في السطر التالي؟
Decimal?، فتحتاج إلى فكّه مرة أخرى.","why":"guard let يربط قيمة غير optional؛ هذا هو الهدف منه أصلًا."},{"text":"لا يوجد إلا داخل كتلة else.","why":"داخل else تكون القيمة غائبة، فلا يوجد ما يُربط أصلًا. أما الاسم الذي يربطه guard let فيبقى متاحًا بعد الـ guard حتى نهاية النطاق."},{"text":"صار قيمة Decimal غير optional تستطيع استخدامها حتى نهاية الدالة.","why":"صحيح. فرع else يجب أن يغادر النطاق، لذلك يعرف الـ compiler أن amount له قيمة بعد ذلك."}],"answer":2},{"q":"متى يكون الفكّ القسري مثل URL(string: "https://example.com")! مقبولًا؟
nil خطأً من المبرمج.","why":"صحيح. العطل هنا يشير إلى خطأ إملائي في كودك أنت، لا إلى مدخلات سيئة من المستخدم."},{"text":"كلما جاءت القيمة من المستخدم، لأنه عادةً يكتب نصًا صحيحًا.","why":"مدخلات المستخدم هي بالضبط المكان الذي تظهر فيه nil. فكّها باستخدام guard let أو if let."},{"text":"أبدًا؛ فالعامل ! أصبح مهجورًا في Swift 6.","why":"العامل ! ليس مهجورًا. إنه أداة مقصودة لها حدّ حادّ."},{"text":"كلما أردت كودًا أسرع قليلًا من if let.","why":"لا يوجد فرق يُذكر في السرعة. الاختيار يتعلّق بالأمان."}],"answer":0},{"q":"أيّ سطر يُترجَم حين يكون limit من النوع Int?؟
let doubled = limit * 2","why":"لا يمكنك إجراء عمليات حسابية على optional؛ تحتاج Swift أن تعرف ماذا تفعل حين يكون nil."},{"text":"let doubled = (limit ?? 0) * 2","why":"صحيح. العامل ?? يحوّل Int? إلى Int، فتصبح عملية الضرب واضحة التعريف."},{"text":"let doubled: Int = limit","why":"لا يمكن إسناد Int? إلى Int دون فكّه أولًا."}],"answer":1}],"exercise":{"kind":"spot-bug","language":"swift","code":"import Foundation\n\nfunc addExpense(_ amountText: String, to total: Decimal) -> Decimal {\n let amount = Decimal(string: amountText)!\n return total + amount\n}\n\nvar total: Decimal = 0\ntotal = addExpense(\"12.50\", to: total)\ntotal = addExpense(\"\", to: total) // user tapped Save on an empty field\nprint(total)","bugLines":[4],"title":"اعثر على سبب العطل","prompt":"هذه النسخة المبكرة من منطق إضافة مصروف في Pocket Budget تعمل في كل عرض تجريبي، ثم تتعطّل عند مستخدم حقيقي. اختر السطر الذي يسبّب العطل.
\n","hints":["نفّذ الاستدعاء الثاني في ذهنك: ماذا تعيدDecimal(string: "")؟","ابحث عن الحرف الوحيد الذي يقول «أعدك أن هذه القيمة ليست nil أبدًا».","ستكون رسالة العطل “Unexpectedly found nil while unwrapping an Optional value”."],"explanation":"السطر 4 يفكّ نتيجة Decimal(string:) فكًّا قسريًا. مع نص فارغ تكون النتيجة nil، فيُسقط ! التطبيق. اجعل الدالة تعترف بأنها قد تفشل، واترك القرار لمن يستدعيها:
func addExpense(_ amountText: String, to total: Decimal) -> Decimal? {\n guard let amount = Decimal(string: amountText) else {\n return nil\n }\n return total + amount\n}صار على من يستدعي الدالة أن يفكّ النتيجة، وهذا بالضبط المكان الذي تعرض فيه للمستخدم “Enter an amount” بدل أن يتعطّل التطبيق.
\n","checkLabels":{}},"words":635,"readMinutes":4}