Swift Academy · درس

متى تضيف التعليقات التوضيحية الصريحة

أضف تعليقًا توضيحيًا لإزالة الالتباس وتوثيق القصد.

متى تضيف التعليقات التوضيحية الصريحة درس مجاني في Swift Academy على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Swift Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Swift Academy 4 دروس في المجموع.

لماذا نحدد النوع

مع أن الاستنتاج قوي، فإن تحديد النوع صراحةً يحسن الوضوح، ويزيل الغموض، ويوثق المقصود.

let temperature: Double = 36
print(temperature)
print(type(of: temperature))

فرض النوع Double

من دون تحديد النوع، تكون let x = 5 من النوع Int. حدّدوا النوع ليكون Double عندما تحتاجون لاحقًا إلى حسابات كسرية.

let count: Double = 5
let average = count / 2
print(average)

المجموعات الفارغة

لا تحتوي القيمة الحرفية الفارغة على عناصر يمكن الاستنتاج منها، لذا يجب عليكم تحديد النوع صراحةً.

var scores: [Int] = []
scores.append(10)
print(scores)

القاموس الفارغ

تنطبق القاعدة نفسها على القواميس الفارغة: حدّدوا نوعي المفتاح والقيمة.

var ages: [String: Int] = [:]
ages["Ada"] = 36
print(ages)

إزالة الغموض بين التحميلات الزائدة

عندما يمكن أن يطابق الاستدعاء عدة مُهيئات، يخبر تحديد النوع المترجمَ أيّها تقصدون.

let small: Int8 = 100
let big: Int64 = 100
print(type(of: small), type(of: big))

توثيق القيم المخزنة

تكون الأنواع الصريحة مطلوبة في الخصائص المخزنة، كما تعمل توثيقًا لقرّاء الشيفرة.

struct Account {
    var balance: Double = 0
    var owner: String = "Unknown"
}
let a = Account()
print(a.balance, a.owner)

تحديد النوع لتحسين سهولة القراءة

في التعبيرات الطويلة أو غير الواضحة، يساعد تحديد النوع القرّاء على معرفة نوع النتيجة من النظرة الأولى.

let ratio: Double = 22 / 7
print(ratio)

الأنواع الاختيارية

غالبًا ما تحددون الأنواع الاختيارية صراحةً، لأن nil وحدها لا تملك نوعًا يمكن استنتاجه.

var nickname: String? = nil
nickname = "Ace"
print(nickname ?? "none")

Closures التي لا تعيد قيمة

عندما تكون closure مخزنة وقد تكون غامضة، حدّدوا نوعها الكامل.

let action: () -> Void = {
    print("ran")
}
action()

تحويلات القيم الحرفية الرقمية

يتيح تحديد النوع للقيمة الحرفية الواحدة أن تنتمي إلى أنواع رقمية مختلفة من دون استدعاءات تحويل يدوية.

let cpu: UInt8 = 255
let wide: UInt32 = 255
print(cpu, wide)

الموازنة بين الاستنتاج وتحديد النوع

قاعدة عامة: دعوا الاستنتاج يتولى الحالات الواضحة، وحددوا النوع عندما يكون غامضًا، أو عندما يحسن الوضوح، أو عندما يكون مطلوبًا، مثل المجموعات الفارغة والخصائص والمعاملات.

let obvious = "clear"       // inference is fine
let precise: Double = 9     // annotation needed
print(obvious, precise)

اختبار سريع

متى يكون تحديد النوع مطلوبًا؟

مراجعة

أضيفوا تحديدات صريحة للنوع لفرض نوع رقمي محدد، ولتعريف المجموعات الفارغة والأنواع الاختيارية، ولإزالة الغموض بين التحميلات الزائدة، ولتوثيق الخصائص وواجهات برمجة التطبيقات. وفي الحالات الأخرى، دعوا الاستنتاج يحافظ على نظافة الشيفرة.

var list: [String] = []
let rate: Double = 5
print(list, rate)

الأسئلة الشائعة

هل درس «متى تضيف التعليقات التوضيحية الصريحة» مجاني؟

نعم — نص درس «متى تضيف التعليقات التوضيحية الصريحة» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Swift Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Swift Academy 4 دروس في المجموع.

ماذا ستتعلم في «متى تضيف التعليقات التوضيحية الصريحة»؟

أضف تعليقًا توضيحيًا لإزالة الالتباس وتوثيق القصد. تتمرن على Swift Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Swift Academy؟

لا تُشترط خبرة سابقة. Swift Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.

كم من الوقت يستغرق درس «متى تضيف التعليقات التوضيحية الصريحة»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Swift Academy هذا؟

نعم. كل درس في Swift Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى Swift Academy