شرح كامل لمعلمات بايثون: موضعية، مفتاحية، *args و **kwargs

1. ما هو معامل (الوسيط) في بايثون؟

الدور الأساسي للدوال والمعاملات

def greet(name):
    print(f"مرحبًا،{name}！")

greet("佐川")  # الإخراج: مرحبًا، 佐川！

2. أساسيات المعاملات في بايثون

المعاملات الموضعية وأهميتها

def add(a, b):
    return a + b

result = add(5, 3)  # النتيجة: 8

استخدام المعاملات بالكلمة المفتاحية

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

introduce(age=25, name="ساغاوا")  # الإخراج: أنا ساغاوا. عمري 25 سنة.

استخدام المعاملات الافتراضية

def greet(name="ضيف"):
    print(f"مرحبًا، {name}!")

greet()  # الإخراج: مرحبًا، ضيف!

ترتيب المعاملات

3. المتغيرات ذات الطول المتغير في بايثون (*args و **kwargs)

*args طريقة الاستخدام

def print_numbers(*args):
    for number in args:
        print(number)

print_numbers(1, 2, 3)  

**kwargs طريقة الاستخدام

def print_info(**kwargs):
    for key, value in kwargs.items():
        print(f"{key}: {value}")

print_info(name="ساگاوا", age=30, job="كاتب")  

الدمج بين *args و **kwargs

def process_data(*args, **kwargs):
    total = sum(args)
    print(f"المجموع: {total}")
    for key, value in kwargs.items():
        print(f"{key}: {value}")

process_data(1, 2, 3, name="ساگاوا", age=30)

4. تطبيقات المتغيرات واستخداماتها

أمثلة تطبيقية عملية: معالجة معلمات API

def api_call(endpoint, **params):
    print(f"نقطة النهاية API: {endpoint}")
    for key, value in params.items():
        print(f"{key}: {value}")

api_call("/user", id=123, action="view")

تطبيقات معالجة البيانات الضخمة

5. معالجة الأخطاء والتحقق من صحة المعاملات

معالجة الأخطاء المتعلقة بعدد المعاملات

def add_numbers(*args):
    if len(args) < 2:
        raise ValueError("يجب توفير ما لا يقل عن معاملين")
    return sum(args[:2])

التحقق من نوع البيانات

def multiply(a, b):
    if not isinstance(a, (int, float)) or not isinstance(b, (int, float)):
        raise TypeError("المعاملات يجب أن تكون أعدادًا")
    return a * b

معالجة الأخطاء باستخدام try-except

def divide(a, b):
    try:
        result = a / b
    except ZeroDivisionError:
        return "لا يمكن القسمة على الصفر"
    except TypeError:
        return "يرجى إدخال قيمة عددية"
    return result

6. ملخص

النقاط الرئيسية:

• الأساسيات للمعاملات الموضعية، المعاملات المسماة، والمعاملات الافتراضية
• *args و **kwargs لتعريف دوال مرن
• أهمية معالجة الأخطاء والتحقق من صحة المعاملات