الدوال في بايثون (Functions)

# الصيغة العامة:
# def function_name():
#     code_block

# مثال: دالة ترحيب بسيطة
def greet():
    print("=" * 30)
    print("   مرحباً بك في البرنامج!")
    print("=" * 30)

# استدعاء الدالة (تنفيذها)
greet()

print("\nيمكنك استدعاء الدالة عدة مرات:\n")

greet()
greet()

# دالة مع معامل واحد
def greet_user(name):
    print(f"مرحباً يا {name}!")
    print(f"سعيد بلقائك.")

# استدعاء الدالة مع قيم مختلفة
greet_user("أحمد")
print()
greet_user("سارة")
print()

# دالة مع عدة معاملات
def display_info(name, age, city):
    print("-" * 35)
    print(f"   الاسم: {name}")
    print(f"   العمر: {age} سنة")
    print(f"   المدينة: {city}")
    print("-" * 35)

display_info("محمد", 25, "القاهرة")
display_info("فاطمة", 30, "الرياض")

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

# استدعاء بدون القيمة الافتراضية
greet("أحمد")                    # سيستخدم "مرحباً"

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

# دالة تحسب مربع رقم وترجع النتيجة
def square(number):
    result = number ** 2
    return result

# استخدام القيمة المرجعة
x = 5
squared = square(x)
print(f"مربع {x} هو {squared}")

# يمكن استخدام الدالة مباشرة في تعبيرات
print(f"مربع 7 هو {square(7)}")
print(f"مجموع مربعي 3 و 4 هو {square(3) + square(4)}")

# دالة تحسب إحصائيات قائمة أرقام
def calculate_stats(numbers):
    total = sum(numbers)
    count = len(numbers)
    average = total / count
    minimum = min(numbers)
    maximum = max(numbers)
    
    return total, count, average, minimum, maximum

# استخدام الدالة
grades = [85, 92, 78, 95, 88, 76, 90]

total, count, avg, min_val, max_val = calculate_stats(grades)

print("إحصائيات الدرجات:")
print("-" * 30)
print(f"المجموع: {total}")
print(f"العدد: {count}")
print(f"المتوسط: {avg:.2f}")
print(f"أدنى درجة: {min_val}")
print(f"أعلى درجة: {max_val}")

# متغير عام (Global)
program_name = "نظام الإدارة"

def show_info():
    # متغير محلي (Local)
    version = "1.0"
    
    # يمكن الوصول للمتغير العام من داخل الدالة
    print(f"البرنامج: {program_name}")
    print(f"الإصدار: {version}")

show_info()

# يمكن الوصول للمتغير العام هنا
print(f"\nاسم البرنامج: {program_name}")

# لكن لا يمكن الوصول للمتغير المحلي هنا
# print(version)  # سيسبب خطأ!

counter = 0  # متغير عام

def increment():
    global counter  # الإعلان عن استخدام المتغير العام
    counter += 1
    print(f"العداد الآن: {counter}")

increment()
increment()
increment()
print(f"\nالقيمة النهائية: {counter}")

def calculate_area(length, width):
    """
    تحسب مساحة المستطيل.
    
    المعاملات:
        length (float): طول المستطيل
        width (float): عرض المستطيل
    
    القيمة المرجعة:
        float: مساحة المستطيل
    
    مثال:
        >>> calculate_area(5, 3)
        15
    """
    return length * width

# عرض التوثيق
print(calculate_area.__doc__)

# استخدام الدالة
area = calculate_area(10, 5)
print(f"\nالمساحة: {area}")

# نظام إدارة المكتبة
library = []

def add_book(title, author, year):
    """إضافة كتاب جديد للمكتبة"""
    book = {
        "title": title,
        "author": author,
        "year": year,
        "available": True
    }
    library.append(book)
    print(f"[+] تمت إضافة: {title}")

def display_books():
    """عرض جميع الكتب"""
    print("\n" + "=" * 50)
    print("           قائمة الكتب")
    print("=" * 50)
    
    if not library:
        print("   المكتبة فارغة!")
        return
    
    for i, book in enumerate(library, 1):
        status = "متاح" if book["available"] else "معار"
        print(f"{i}. {book['title']}")
        print(f"   المؤلف: {book['author']} | السنة: {book['year']}")
        print(f"   الحالة: [{status}]")
        print("-" * 50)

def search_book(keyword):
    """البحث عن كتاب"""
    results = []
    for book in library:
        if keyword.lower() in book["title"].lower():
            results.append(book)
    return results

def borrow_book(title):
    """استعارة كتاب"""
    for book in library:
        if book["title"].lower() == title.lower():
            if book["available"]:
                book["available"] = False
                return True, "تمت الاستعارة بنجاح"
            else:
                return False, "الكتاب معار حالياً"
    return False, "الكتاب غير موجود"

# استخدام النظام
print("=" * 50)
print("        نظام إدارة المكتبة")
print("=" * 50)

# إضافة كتب
add_book("Python للمبتدئين", "أحمد محمد", 2023)
add_book("تعلم البرمجة", "سارة علي", 2022)
add_book("Python المتقدم", "محمد حسن", 2024)

# عرض الكتب
display_books()

# البحث
print("\nالبحث عن 'Python':")
results = search_book("Python")
for book in results:
    print(f"   - {book['title']}")

# استعارة
print("\nمحاولة استعارة 'Python للمبتدئين':")
success, message = borrow_book("Python للمبتدئين")
print(f"   {message}")