في القسم السابق كان تصنيف المصروف String. وهذا يعمل إلى أن يكتب أحدهم "Fod"، أو "food" في مكان و"Food" في مكان آخر، فيُسقط المجموع الشهري نصف مشترياتك من البقالة بصمت. لم يكن في النوع ما يحدّد النصوص الصالحة. أما الـ enum (التعداد) فيقول ذلك بالضبط: هذه هي القائمة الكاملة للقيم الممكنة، ولا شيء غيرها مسموح.
enum Category: String, CaseIterable {\n case food\n case transport\n case housing\n case fun\n\n var title: String {\n rawValue.capitalized\n }\n\n var symbolName: String {\n switch self {\n case .food: \"fork.knife\"\n case .transport: \"bus\"\n case .housing: \"house\"\n case .fun: \"ticket\"\n }\n }\n}صار لـ Category أربع قيم بالضبط. اكتب .fod وستفشل الترجمة. والجزء : String يعطي كل حالة قيمة خام (raw value)، وهي افتراضيًا اسم الحالة كنص (Category.food.rawValue تساوي "food")، وهي ما ستحفظه على القرص وتقرؤه من JSON لاحقًا. أما الاتجاه المعاكس فقابل للفشل، لأن ليس كل نص تصنيفًا: Category(rawValue: "fun") تعطي .fun، وCategory(rawValue: "Fun") تعطي nil.
يطلب CaseIterable من الـ compiler أن يولّد Category.allCases، وهي مصفوفة بكل الحالات بترتيب تعريفها. سيمرّ منتقي التصنيفات في Pocket Budget عليها، فإضافة حالة تضيف صفًا إلى المنتقي دون أي جهد.
يمكن أن تحتوي الـ enums خصائص محسوبة وmethods، تمامًا مثل الـ structs. تربط symbolName كل حالة باسم أيقونة من SF Symbols، والـ switch بداخلها بلا default.
لنفترض أنك أضفت case gifts الشهر القادم. ستفشل الترجمة فورًا عند symbolName مع “switch must be exhaustive”، وعند كل switch أخرى على Category في المشروع. لقد أعدّ الـ compiler قائمة مهامك. قارن ذلك بنسخة النصوص، حيث يقع التصنيف الجديد بهدوء في أي فرع default كان موجودًا، ويعرض الأيقونة الخطأ في الإنتاج.
القيم الخام ثابتة لكل حالة. لكن بعض البيانات تختلف من instance إلى آخر. يسجّل Pocket Budget طريقة دفع المصروف، وكل طريقة تحتاج تفاصيل مختلفة:
\nenum PaymentMethod {\n case cash\n case card(lastFour: String)\n case transfer(bank: String, reference: String?)\n}\n\nlet lunch: PaymentMethod = .cash\nlet groceries: PaymentMethod = .card(lastFour: \"4242\")\nlet rent: PaymentMethod = .transfer(bank: \"Monzo\", reference: \"RENT-10\")لكل حالة شكلها الخاص. الدفع النقدي لا يحمل شيئًا، والدفع بالبطاقة يحمل أربعة أرقام، والتحويل يحمل اسم البنك ومرجعًا اختياريًا. لو استخدمت struct لاحتجت إلى ثلاث خصائص optional وتعليق يشرح أيّها يُملأ ومتى. أما الـ enum فيجعل التركيبات غير الصالحة، مثل دفع نقدي معه اسم بنك، مستحيلة البناء أصلًا.
\nتقرأ القيم المرتبطة عبر مطابقة الأنماط (pattern matching) داخل switch:
func label(for method: PaymentMethod) -> String {\n switch method {\n case .cash:\n return \"Cash\"\n case .card(let lastFour):\n return \"Card ending \\(lastFour)\"\n case .transfer(let bank, let reference?):\n return \"\\(bank) transfer, ref \\(reference)\"\n case .transfer(let bank, nil):\n return \"\\(bank) transfer\"\n }\n}\n\nlabel(for: groceries) // \"Card ending 4242\"تربط let lastFour القيمة المرتبطة بثابت جديد داخل تلك الحالة. وحالتا .transfer تُظهران إلى أي مدى تصل الأنماط: let reference? لا تطابق إلا حين يكون للمرجع الاختياري قيمة، وتفكّه، وnil تطابق حين لا تكون له قيمة. وما زال الـ compiler يتحقّق من أن الحالتين معًا تغطّيان كل الاحتمالات.
حين تهمّك حالة واحدة فقط، تكون if case أقصر من switch كاملة:
if case .card(let lastFour) = groceries {\n print(\"Remind me to check card \\(lastFour)\")\n}الـ enums هي الأداة الصحيحة كلما كانت القيمة «واحدة بالضبط من هذه». المثال الكلاسيكي هو تحميل البيانات. المسوّدة الأولى تبدو عادةً كثلاث خصائص منفصلة: isLoading وrates وerrorMessage. لا شيء يمنع أن تُضبط الثلاث معًا، فتضطر كل شاشة إلى تخمين أيّها يفوز. enum واحد يُلغي التخمين:
enum LoadState {\n case idle\n case loading\n case loaded([String: Decimal])\n case failed(String)\n}صارت الأسعار موجودة فقط في الحالة .loaded، والرسالة فقط في .failed، وتعالج switch واحدة في الـ view كل حالة مرة واحدة. ستبني هذا بالضبط حين يبدأ Pocket Budget بجلب أسعار الصرف. استخدم enum كلما وجدت نفسك تقارن نصوصًا أو تتلاعب بقيم منطقية لا يجب أن تكون صحيحة معًا أبدًا.
صارت أنواعك الآن قادرة على وصف بيانات Pocket Budget بدقة. بعد ذلك ستمنحها قدرات مشتركة عبر الـ protocols، مثل «قابل للمقارنة» أو «له معرّف ثابت»، وتضيف سلوكًا إلى أنواع موجودة عبر الـ extensions.
\n","toc":[{"id":"sec-1","text":"الـ enums ذات القيم الخام","level":2},{"id":"sec-2","text":"جمل switch الشاملة ميزة","level":2},{"id":"sec-3","text":"القيم المرتبطة: حالات تحمل بيانات","level":2},{"id":"sec-4","text":"استخراج البيانات من جديد","level":2},{"id":"sec-5","text":"enums بدل فوضى القيم المنطقية","level":2}],"takeaways":["الـ enum يسرد كل القيم الصالحة لنوع ما، فيتحوّل خطأ إملائي مثل “Fod” إلى خطأ ترجمة بدل أن يكون خطأً صامتًا.","القيم الخام (enum Category: String) تعطي كل حالة نصًا أو رقمًا مخزّنًا للحفظ وفكّ الترميز.","القيم المرتبطة تُرفق بيانات مختلفة بحالات مختلفة، مثل آخر أربعة أرقام في .card.","اكتب جمل switch على الـ enums بلا default، فإضافة حالة جديدة تجعل الـ compiler يسرد كل switch يجب أن تحدّثها."],"further":[{"title":"Enumerations","url":"https://docs.swift.org/swift-book/documentation/the-swift-programming-language/enumerations/"},{"title":"CaseIterable","url":"https://developer.apple.com/documentation/swift/caseiterable"}],"quiz":[{"q":"لديك enum Category: String { case food, transport }. ماذا تعيد Category(rawValue: "Food")؟
.food، لأن مطابقة القيم الخام تتجاهل حالة الأحرف.","why":"مطابقة القيم الخام دقيقة حرفيًا. القيمة الخام للحالة food هي “food” بأحرف صغيرة."},{"text":"يتعطّل التطبيق، لأن “Food” ليست قيمة خام صالحة.","why":"المُهيِّئ القابل للفشل موجود تحديدًا لتجنّب التعطّل عند المدخلات السيئة."},{"text":"nil","why":"صحيح. init(rawValue:) قابل للفشل ويعيد Category?؛ و"Food" لا تطابق “food”."}],"answer":2},{"q":"أضفت case gifts إلى Category. كل جملة switch على Category تستخدم حالات صريحة دون default. ماذا يحدث في الترجمة التالية؟
.gifts.","why":"صحيح. فحص الشمول يحوّل مهمة «اعثر على كل مكان يحتاج تحديثًا» إلى قائمة أخطاء."},{"text":"تنجح الترجمة، وتقع .gifts في آخر حالة وقت التشغيل.","why":"لا توجّه Swift أبدًا حالة غير معالَجة إلى أي مكان بصمت."},{"text":"تنجح الترجمة، ويتعطّل التطبيق حين يصادف .gifts.","why":"بدون default، تُكتشف الفجوة وقت الترجمة، لا وقت التشغيل."}],"answer":0},{"q":"أيّ تعريف يصف «مدفوع بالبطاقة، ونعرف آخر أربعة أرقام منها»؟
","options":[{"text":"case card = "4242"","why":"القيمة الخام ثابتة للحالة؛ فكل دفعة بالبطاقة ستنتهي بـ 4242."},{"text":"case card(lastFour: String)","why":"صحيح. القيمة المرتبطة تُخزَّن لكل instance، فتحمل كل دفعة أرقامها الخاصة."},{"text":"case card; var lastFour: String","why":"الـ enums لا يمكن أن تحتوي خصائص مخزّنة للـ instance؛ والقيم المرتبطة هي طريقة الحالات لحمل البيانات."},{"text":"case card(String) = "card"","why":"لا تسمح Swift بالقيم الخام في enum لحالاته قيم مرتبطة."}],"answer":1}],"exercise":{"kind":"fill","language":"swift","template":"enum Category: String, {{0}} {\n case food, transport, fun\n}\nprint(Category.{{1}}.count) // 3\n\nenum PaymentMethod {\n case cash\n case card(lastFour: String)\n}\n\nfunc label(for method: PaymentMethod) -> String {\n switch method {\n case .cash:\n return \"Cash\"\n case .card({{2}} lastFour):\n return \"Card ending \\(lastFour)\"\n }\n}","blanks":[{"answers":["CaseIterable"]},{"answers":["allCases"]},{"answers":["let"]}],"title":"صمّم التصنيفات وطرق الدفع","prompt":"أكمل الـ enums الاثنين في Pocket Budget. يجب أن يوفّر Category قائمة بكل حالاته حتى يعرضها المنتقي، ويجب أن تقرأ label(for:) آخر أربعة أرقام من الدفع بالبطاقة.
Category.____.","داخل نمط case، الكلمة المفتاحية التي تربط القيمة المرتبطة بثابت جديد هي نفسها التي تعرّف بها الثوابت."],"explanation":"يجعل CaseIterable الـ compiler يولّد Category.allCases، وهي مصفوفة بكل الحالات بترتيب تعريفها، فتكون count مساوية لـ 3. وفي الـ switch، تطابق case .card(let lastFour) الدفعات بالبطاقة وتربط القيمة المرتبطة بالثابت lastFour داخل ذلك الفرع.
لاحظ أن الـ switch بلا default. إن أضفت case transfer(bank: String) لاحقًا، ستتوقّف هذه الدالة عن الترجمة حتى تعالج الحالة الجديدة، وهذا بالضبط ما تريده.