القيم الافتراضية للمعاملات

جزء من قسم مقدمة إلى Luau في رحلة Lua على Coddy. الدرس 26 من 73.

المعلمات الاختيارية تترك لك قيمة nil للتعامل معها. في كثير من الأحيان، ما تريده حقًا هو قيمة احتياطية (fallback value) — "إذا لم يحدد المتصل، افترض X". لا تحتوي Luau على بناء جملة افتراضي في التوقيع (لا يوجد greeting: string = "Hello")؛ بدلاً من ذلك، تستخدم أسلوب Lua الكلاسيكي (idiom)، ولكن الآن مع الأنواع:

function greet(name: string, greeting: string?): string
    greeting = greeting or "Hello"
    return `{greeting}, {name}`
end

print(greet("Alice"))            -- مرحباً، أليس
print(greet("Alice", "Howdy"))   -- أهلاً، أليس

تم توشيح المعلمة كاختيارية (string?)، والسطر الأول من نص الدالة يستبدل nil بالقيمة الافتراضية. يعمل هذا لأن nil يعتبر زائفًا (falsy) — حيث يتم تقييم nil or "Hello" إلى "Hello". بعد ذلك السطر، يعلم أداة فحص الأنواع أن greeting لم يعد من الممكن أن يكون nil.

تنبيه واحد تعرفه من Lua: المعامل or يستبدل أيضًا false! بالنسبة لمعلمة من نوع boolean?، فإن flag = flag or true ستتجاوز القيمة الصريحة false دون إظهار أي خطأ. استخدم تحققًا صريحًا من الـ nil بدلاً من ذلك:

function ship(weight: number, expedited: boolean?): number
    if expedited == nil then
        expedited = false
    end
    -- ...
end

التحدي

سهل

أنشئ دالة باسم calculateTax تأخذ price: number (إجباري) و rate: number? بقيمة افتراضية 0.05. أرجع قيمة الضريبة (price * rate) كـ number.

أنشئ دالة باسم formatGreeting تأخذ name: string (إجباري) و timeOfDay: string? بقيمة افتراضية "Hello". أرجع "[timeOfDay], [name]!" كـ string.

أنشئ دالة باسم calculateShipping تأخذ weight: number، و distance: number (كلاهما إجباري) و expedited: boolean? بقيمة افتراضية false — استخدم فحصًا صريحًا لـ nil في هذه الدالة! احسب (weight * 0.5) + (distance * 0.1)، وإذا كانت expedited تساوي true، اضرب النتيجة في 2. أرجع number.

قم بالاستدعاء والطباعة، كل منها في سطر منفصل:

calculateTax(100)
calculateTax(200, 0.08)
formatGreeting("Alice")
formatGreeting("Bob", "Good morning")
calculateShipping(5, 100)
calculateShipping(3, 50, true)

جرّب بنفسك

-- اكتب الكود هنا
-- calculateTax(price: number, rate: number?) -- المعدل الافتراضي 0.05
-- formatGreeting(name: string, timeOfDay: string?) -- الافتراضي "Hello"
-- calculateShipping(weight, distance, expedited: boolean?) -- الافتراضي false
-- ثم اطبع النتائج الست