الدوال

# تعريف دالة — Define a function
def greet():
    print("مرحباً بالعالم!")

# استدعاء الدالة — Call the function
greet()   # مرحباً بالعالم!

# دالة بمعاملات — Function with parameters
def greet(name):
    print(f"مرحباً يا {name}!")

greet("فاطمة")   # مرحباً يا فاطمة!
greet("خالد")    # مرحباً يا خالد!

def introduce(name, age, city):
    print(f"اسمي {name}، عمري {age} سنة، وأسكن في {city}.")

introduce("نورة", 24, "الرياض")
introduce("عمر", 30, "جدة")

# دالة ترجع قيمة — Function that returns a value
def add(a, b):
    return a + b

result = add(10, 5)
print(result)   # 15

# يمكن استخدام القيمة المُرجعة في تعبير
total = add(10, 5) + add(3, 7)
print(total)    # 25

def calculate_vat(price, rate=0.15):
    return price * rate

# الآن يمكنني استخدام النتيجة بأي طريقة
vat = calculate_vat(200)
total = 200 + vat
print(f"الضريبة: {vat:.2f} ريال")
print(f"الإجمالي: {total:.2f} ريال")

def greet(name, language="ar"):
    if language == "ar":
        return f"مرحباً يا {name}!"
    else:
        return f"Hello {name}!"

print(greet("سارة"))          # مرحباً يا سارة! — يستخدم الافتراضي
print(greet("Sara", "en"))    # Hello Sara!

# خطأ — Error
def bad(name="x", age):  # SyntaxError!
    pass

# صحيح — Correct
def good(age, name="مجهول"):
    pass

def create_user(username, email, role="user", active=True):
    return f"أنشأت: {username} ({role})"

# بالترتيب — Positional
result1 = create_user("ahmed", "[email protected]")

# بالاسم — Keyword (أوضح)
result2 = create_user(
    username="sara",
    email="[email protected]",
    role="admin",
    active=True
)

# *args — عدد غير محدد من الأرقام
def sum_all(*numbers):
    total = 0
    for n in numbers:
        total += n
    return total

print(sum_all(1, 2, 3))         # 6
print(sum_all(10, 20, 30, 40))  # 100

# **kwargs — معاملات مسماة غير محدودة
def print_info(**details):
    for key, value in details.items():
        print(f"  {key}: {value}")

print_info(name="عزيز", city="المدينة", role="مطور")

# نطاق المتغيرات — Variable scope
name = "عالمي"  # متغير عام — Global variable

def show():
    name = "محلي"   # متغير محلي — Local variable
    print(name)     # "محلي" — يرى المحلي أولاً

show()          # محلي
print(name)     # عالمي — لم يتغير الخارجي

def calculate_vat(price, rate=0.15):
    """
    احسب ضريبة القيمة المضافة.

    price: السعر قبل الضريبة (float)
    rate: نسبة الضريبة، الافتراضي 15% (float)
    returns: مبلغ الضريبة (float)
    """
    return price * rate