المصروف الواحد قيمة. ومصاريف شهر كامل مجموعة (collection). يحتاج Pocket Budget إلى ثلاثة أشكال من المجموعات: قائمة مرتّبة بالمبالغ، وجدول بحث من التصنيف إلى الحدّ الشهري، وكيس من الوسوم الفريدة. تعطيك Swift هذه الثلاثة بالضبط، وكلها محدّدة النوع، فلا يمكن لمصفوفة مبالغ أن تحتوي String بالخطأ.
import Foundation\n\nvar amounts: [Decimal] = [12.5, 4.25, 60]\namounts.append(18)\n\nprint(amounts.count) // 4\nprint(amounts[0]) // 12.5\nprint(amounts.first as Any) // Optional(12.5)تُقرأ [Decimal] «مصفوفة من Decimal». الفهارس تبدأ من 0. لاحظ الفرق بين amounts[0] وamounts.first: الوصول بالفهرس يثق بك ويُسقط التطبيق مع “Index out of range” إذا كانت المصفوفة فارغة، بينما first يعيد optional ويتيح لك التعامل مع الحالة الفارغة بالأدوات التي تعلّمتها في الدرس السابق.
في أغلب الأحيان لا تحتاج إلى الفهارس أصلًا. حلقة for-in تزور كل عنصر:
var total: Decimal = 0\nfor amount in amounts {\n total += amount\n}\nprint(total) // 94.75\n\nfor (index, amount) in amounts.enumerated() {\n print(\"\\(index + 1). \\(amount)\")\n}تعطيك enumerated() أزواجًا من الموضع والقيمة، وهذه هي الطريقة الآمنة لترقيم الصفوف. والنطاقات تعمل مع for-in أيضًا، بنوعين:
for day in 1...30 { } // closed range: 1 through 30\nfor i in 0..<amounts.count { } // half-open: stops before countالنطاق المغلق يشمل حدّه الأعلى؛ أما النطاق نصف المفتوح فيتوقّف قبله بواحد، وهذا بالضبط ما تحتاجه فهارس المصفوفات.
\nالقاموس (dictionary) يربط مفاتيح بقيم. يحتفظ Pocket Budget بحدّ شهري لكل تصنيف:
\nlet limits: [String: Decimal] = [\"Food\": 300, \"Transport\": 120]\nvar spent: [String: Decimal] = [\"Food\": 280]\n\nlet foodLimit = limits[\"Food\"] // Decimal?, Optional(300)\nlet funLimit = limits[\"Fun\"] ?? 0 // Decimal, 0\n\nspent[\"Fun\", default: 0] += 15 // creates \"Fun\": 15كل بحث يعيد optional، لأن المفتاح قد لا يكون موجودًا. إنها فكرة الأمان نفسها مرة أخرى، لكنها هذه المرة مبنية داخل المجموعة. والصيغة default: هي الطريقة المعتادة لحساب المجاميع التراكمية: تقرأ القيمة الموجودة أو تبدأ من القيمة الافتراضية التي حدّدتها، ثم تكتب النتيجة مرة أخرى.
var tags: Set<String> = [\"work\", \"travel\"]\ntags.insert(\"work\") // already there, nothing changes\nprint(tags.count) // 2\nprint(tags.contains(\"travel\")) // trueالمجموعة (Set) لا ترتيب فيها ولا تكرار، ويبقى contains سريعًا مهما كثرت عناصرها. استخدمها للوسوم، والفلاتر المختارة، وفحوصات «هل رأيت هذا المعرّف من قبل؟».
| تحتاج إلى | \nاستخدم | \nمثال من Pocket Budget | \n
|---|---|---|
| ترتيب، والتكرار مسموح، والوصول بالموضع | \nمصفوفة (Array) | \nمصاريف هذا الشهر، الأحدث أولًا | \n
| البحث عن قيمة بمفتاح | \nقاموس (Dictionary) | \nالحدّ الشهري لكل تصنيف | \n
| العضوية والتفرّد، والترتيب لا يهم | \nمجموعة (Set) | \nالوسوم على مصروف واحد | \n
إن تردّدت، فابدأ بمصفوفة. إنها المجموعة التي تعرضها قوائم SwiftUI، وأسهلها قراءةً في الـ debugger. انتقل إلى القاموس حين تجد نفسك تبحث في مصفوفة عن «العنصر الذي يحمل هذا الاسم»، وإلى المجموعة حين تجد نفسك تفحص التكرار قبل كل إضافة.
\nالمجموعات الثلاث كلها قيم، لا كائنات مشتركة. var copy = amounts تعطيك مصفوفة مستقلّة: الإضافة إلى copy لا تمسّ amounts. لهذا السلوك اسم، سلوك القيمة (value semantics)، وله درس خاص في القسم التالي لأنه يحدّد طريقة تصميمك لكل نوع في نموذج بياناتك.
جملة switch في Swift أكثر بكثير من سلسلة فحوصات مساواة. فهي تطابق النطاقات، وتربط القيم، وتضيف الشروط، والـ compiler يصرّ على معالجة كل قيمة ممكنة. هكذا يختار Pocket Budget رسالة الحالة بناءً على النسبة المستهلكة من الميزانية:
func status(percentUsed: Int) -> String {\n switch percentUsed {\n case ..<0:\n return \"Check your numbers\"\n case 0..<50:\n return \"Plenty left\"\n case 50..<90:\n return \"On track\"\n case 90...100:\n return \"Nearly at your limit\"\n default:\n return \"Over budget\"\n }\n}\n\nprint(status(percentUsed: 95)) // Nearly at your limitهناك فرقان عن لغات عائلة C. أولًا، لا يوجد break ولا انتقال عرضي إلى الحالة التالية: متى طابقت حالة، انتهت الـ switch. ثانيًا، احذف default وستفشل الترجمة مع “switch must be exhaustive”، لأن النوع Int له قيم لا تغطّيها حالاتك. يبدو هذا الخطأ مزعجًا مع الأعداد الصحيحة. لكن مع الـ enums، في القسم التالي، يصبح أنفع خطأ في اللغة: أضف حالة جديدة إلى نموذجك، وسيعرض لك الـ compiler كل switch نسيت تحديثها.
يمكن للحالات أيضًا أن تربط القيمة المطابَقة وتختبرها بـ where:
let used: Decimal = 15\nlet limit: Decimal = 10\n\nswitch used {\ncase 0:\n print(\"Nothing spent yet\")\ncase let amount where amount > limit:\n print(\"Over by \\(amount - limit)\")\ndefault:\n print(\"Within budget\")\n}وفي Swift 5.9 صار ممكنًا استخدام switch وif كتعبيرات، فتعمل الصيغة let label = switch percentUsed { … } حين تنتج كل حالة قيمة واحدة. استخدم الصيغة الأوضح قراءةً؛ قاعدة الشمول واحدة في الحالتين.
صار بإمكانك الآن أن تحمل بيانات شهر كامل وتتّخذ قرارات بشأنها. حلقات التكرار في هذا الدرس تعمل، لكنها مكتوبة بالطريقة الطويلة. بعد ذلك ستجمع المنطق في دوال، وتستبدل معظم هذه الحلقات بـ closures مثل filter وmap وreduce.
first وlast وfor-in على الفهارس اليدوية.","البحث في القاموس يعيد دائمًا optional، لأن المفتاح قد لا يكون موجودًا؛ والصيغة dict[key, default: 0] تعطيك قيمة بديلة.","المجموعة (Set) تخزّن قيمًا فريدة، وفحص contains فيها سريع، ولا ترتيب لعناصرها.","جملة switch في Swift يجب أن تغطّي كل قيمة ممكنة، ولا تنتقل ضمنيًا إلى الحالة التالية، ويمكنها مطابقة النطاقات وشروط where."],"further":[{"title":"Collection Types","url":"https://docs.swift.org/swift-book/documentation/the-swift-programming-language/collectiontypes/"},{"title":"Control Flow","url":"https://docs.swift.org/swift-book/documentation/the-swift-programming-language/controlflow/"}],"quiz":[{"q":"لديك let limits = ["Food": 300]. ما نوع limits["Fun"]؟
Int، وقيمته 0","why":"لا تخترع Swift قيمة لمفتاح غير موجود. أنت تطلب القيمة الافتراضية صراحةً باستخدام default:."},{"text":"Int?، وقيمته nil","why":"صحيح. كل بحث في قاموس يعيد optional، لأن أي مفتاح قد يكون غائبًا."},{"text":"يتعطّل التطبيق لأن المفتاح غير موجود.","why":"هذا ما يحدث مع المصفوفات عند فهرس خاطئ. أما القواميس فتعيد nil للمفتاح الغائب."}],"answer":1},{"q":"كتبت switch على تصنيف من النوع String، ووضعت حالتين فقط لـ “Food” و"Transport". ماذا يقول الـ compiler؟
default:.","why":"صحيح. للنوع String عدد لا نهائي من القيم، فلا يغطّي الباقي إلا default."}],"answer":2},{"q":"أيّ مجموعة تناسب «الوسوم التي أضافها المستخدم إلى مصروف، دون تكرار»؟
","options":[{"text":"Set<String>","why":"صحيح. المجموعة تتجاهل الإدخال المكرّر وتجيب عن contains بسرعة؛ وترتيب الوسوم لا يهم."},{"text":"[String]","why":"المصفوفة تسمح بالتكرار، فستضطر إلى الفحص قبل كل إضافة."},{"text":"[String: Bool]","why":"تعمل، لكنها مجموعة متنكّرة. استخدم النوع الذي يقول ما تعنيه."},{"text":"[Int: String]","why":"المفاتيح الرقمية لا تضيف شيئًا هنا؛ ستعيد بناء مصفوفة بخطوات إضافية."}],"answer":0},{"q":"لديك let amounts: [Decimal] = []. ماذا يفعل amounts[0] وقت التشغيل؟
nil.","why":"هذا ما يفعله amounts.first. أما الوصول بالفهرس في المصفوفة فلا يعيد optional أبدًا."},{"text":"يتعطّل التطبيق مع الرسالة “Index out of range”.","why":"صحيح. الوصول بالفهرس يثق بك؛ والمصفوفة الفارغة ليس فيها فهرس 0."},{"text":"يعيد 0.","why":"المصفوفات لا تملأ الفراغات بقيم افتراضية."}],"answer":1}],"exercise":{"kind":"choice","options":["a","b","c","d"],"correct":["c"],"title":"توقّع التقرير الشهري","prompt":"اقرأ هذا المقطع من التقرير الشهري في Pocket Budget وتوقّع بالضبط ما يطبعه. مرّ على كل تصنيف بالترتيب، وتتبّع ما يعيده كل بحث في القاموسين.
\nlet limits: [String: Decimal] = [\"Food\": 300, \"Transport\": 120]\nvar spent: [String: Decimal] = [\"Food\": 280]\nspent[\"Fun\", default: 0] += 15\n\nfor category in [\"Food\", \"Transport\", \"Fun\"] {\n let used = spent[category] ?? 0\n let limit = limits[category] ?? 0\n switch used {\n case 0:\n print(\"\\(category): nothing yet\")\n case let amount where amount > limit:\n print(\"\\(category): over by \\(amount - limit)\")\n default:\n print(\"\\(category): ok\")\n }\n}spent على مفتاحين. ما هما، وما قيمتاهما؟","المفتاح الغائب مع ?? 0 يعطي 0. وهذا ينطبق على spent وlimits معًا.","التصنيف “Fun” ليس له حدّ أصلًا، فحدّه 0. هل 15 أكبر من 0؟"],"explanation":"السطر spent["Fun", default: 0] += 15 يضيف مدخلًا باسم “Fun”، فيصبح spent هو ["Food": 280, "Fun": 15].
default العبارة “Food: ok”.spent، فالمستهلك 0 وتطبع الحالة الأولى “Transport: nothing yet”.limits["Fun"] ?? 0 مساوية لـ 0. و15 > 0 فيُطبع “Fun: over by 15”.السطر الأخير سؤال منتج حقيقي متنكّر: هل يُعدّ التصنيف الذي لا حدّ له «متجاوزًا»؟ الكود يقول نعم لأن ?? 0 اختار هذه القيمة الافتراضية. القيم الافتراضية قرارات.
case 0 أولًا. وليس لـ Fun حدّ، والكود يعامل ذلك على أنه 0."},"b":{"text":"Food: ok / Transport: nothing yet / Fun: nothing yet","why":"الصيغة default: في السطر 3 كتبت 15 في “Fun”، فلم تعد قيمته 0."},"c":{"text":"Food: ok / Transport: nothing yet / Fun: over by 15","why":"صحيح. المفتاح الغائب لـ Transport يصبح 0، والحدّ الغائب لـ Fun يصبح 0، فتُحسب 15 تجاوزًا."},"d":{"text":"Food: over by 20 / Transport: nothing yet / Fun: over by 15","why":"280 أقل من حدّ Food البالغ 300، فلا تطابق الحالة where amount > limit."}}},"words":639,"readMinutes":4}