المعاملات في الدوال بايثون (Parameters)

# name هو Parameter (معامل)
def greet(name):
    print(f"مرحباً يا {name}!")

# "أحمد" هو Argument (وسيط)
greet("أحمد")

def create_profile(name, age, city):
    """إنشاء ملف تعريفي"""
    print("=" * 35)
    print("      الملف الشخصي")
    print("=" * 35)
    print(f"   الاسم: {name}")
    print(f"   العمر: {age} سنة")
    print(f"   المدينة: {city}")
    print("=" * 35)

# الترتيب مهم جداً!
create_profile("أحمد", 25, "القاهرة")

print()

# إذا غيرت الترتيب، ستحصل على نتائج خاطئة
create_profile(30, "الرياض", "سارة")  # خطأ منطقي!

def create_profile(name, age, city):
    print(f"الاسم: {name} | العمر: {age} | المدينة: {city}")

# استخدام المعاملات المسماة (الترتيب لا يهم)
create_profile(name="أحمد", age=25, city="القاهرة")
create_profile(city="الرياض", name="سارة", age=30)
create_profile(age=28, city="دبي", name="محمد")

# يمكن المزج بين الموضعية والمسماة
# لكن الموضعية يجب أن تأتي أولاً
create_profile("فاطمة", city="جدة", age=22)

def greet(name, greeting="مرحباً", punctuation="!"):
    """ترحيب مع خيارات افتراضية"""
    print(f"{greeting} يا {name}{punctuation}")

# استخدام كل القيم الافتراضية
greet("أحمد")

# تغيير قيمة واحدة
greet("سارة", "أهلاً وسهلاً")

# تغيير كل القيم
greet("محمد", "صباح الخير", ".")

# تغيير قيمة محددة باستخدام الاسم
greet("فاطمة", punctuation="...")

def calculate_sum(*numbers):
    """جمع عدد غير محدد من الأرقام"""
    total = sum(numbers)
    print(f"الأرقام: {numbers}")
    print(f"المجموع: {total}")
    return total

# استدعاء بأعداد مختلفة من القيم
calculate_sum(1, 2)
print()
calculate_sum(1, 2, 3, 4, 5)
print()
calculate_sum(10, 20, 30, 40, 50, 60, 70)

def create_user(**user_info):
    """إنشاء مستخدم بمعلومات متنوعة"""
    print("-" * 40)
    print("   معلومات المستخدم:")
    print("-" * 40)
    
    for key, value in user_info.items():
        print(f"   {key}: {value}")
    
    print("-" * 40)

# استدعاء بمعلومات مختلفة
create_user(name="أحمد", age=25)

create_user(
    name="سارة",
    age=30,
    city="الرياض",
    job="مهندسة",
    email="sara@email.com"
)

def complete_function(pos1, pos2, *args, default="قيمة", **kwargs):
    print(f"موضعي 1: {pos1}")
    print(f"موضعي 2: {pos2}")
    print(f"args: {args}")
    print(f"افتراضي: {default}")
    print(f"kwargs: {kwargs}")

complete_function("أ", "ب", 1, 2, 3, default="جديد", x=10, y=20)