توابع (Functions)

# بدون تابع - هر بار باید کد رو تکرار کنی
r = 5
area1 = 3.14 * r * r
print(area1)

r = 7
area2 = 3.14 * r * r
print(area2)

r = 10
area3 = 3.14 * r * r
print(area3)

def area_of_circle(radius):
    return 3.14 * radius * radius

print(area_of_circle(5))
print(area_of_circle(7))
print(area_of_circle(10))

def name_of_function(parameters):
    """توضیح کوتاه دربارهٔ تابع (Docstring)"""
    # بدنهٔ تابع
    return value  # اختیاری

def greet():
    """یه سلام ساده چاپ می‌کنه."""
    print("سلام! خوش اومدی به دنیای پایتون.")

greet()  # صدا زدن تابع
greet()  # هر چند بار که بخوای

def greet_person(name):
    """به شخص خاصی سلام می‌کنه."""
    print(f"سلام {name} جان! حالت چطوره؟")

greet_person("سارا")   # سلام سارا جان! حالت چطوره؟
greet_person("امیر")   # سلام امیر جان! حالت چطوره؟

def introduce(name, age, city):
    print(f"من {name} هستم، {age} سالمه، اهل {city}.")

introduce("نرگس", 25, "شیراز")

introduce(age=25, city="تهران", name="بهار")
# من بهار هستم، 25 سالمه، اهل تهران.

introduce("بهار", city="تهران", age=25)  # درسته
# introduce(name="بهار", 25, "تهران")   # خطا! موقعیتی نباید بعد از کلیدواژه‌ای بیاد

def order_coffee(size="medium", sugar=True):
    """سفارش قهوه با تنظیمات پیش‌فرض"""
    sugar_text = "با شکر" if sugar else "بدون شکر"
    print(f"قهوهٔ {size}، {sugar_text}.")

order_coffee()                    # قهوهٔ medium، با شکر.
order_coffee("large")             # قهوهٔ large، با شکر.
order_coffee("small", False)      # قهوهٔ small، بدون شکر.
order_coffee(sugar=False)         # قهوهٔ medium، بدون شکر.

# غلط
def add_item(item, my_list=[]):
    my_list.append(item)
    return my_list

# درست
def add_item(item, my_list=None):
    if my_list is None:
        my_list = []
    my_list.append(item)
    return my_list

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

result = add(5, 3)
print(result)          # 8
print(add(10, 20))     # 30

# تابع بدون return، None برمی‌گردونه
def no_return():
    print("من چیزی برنمی‌گردونم")

x = no_return()  # "من چیزی برنمی‌گردونم" چاپ می‌شه
print(x)         # None

def min_max(nums):
    return min(nums), max(nums)

low, high = min_max([5, 2, 9, 1, 7])  # Unpacking
print(low, high)   # 1 9

global_var = "من همه جا هستم"

def my_func():
    local_var = "من فقط اینجام"
    print(global_var)   # دسترسی به متغیر سراسری
    print(local_var)

my_func()
# print(local_var)      # خطا! NameError: local_var وجود نداره

counter = 0

def increment():
    global counter
    counter += 1

increment()
print(counter)   # 1

def sum_all(*args):
    """هر چندتا عدد بدی، جمع می‌کنه"""
    total = 0
    for num in args:
        total += num
    return total

print(sum_all(1, 2, 3))           # 6
print(sum_all(5, 10, 15, 20))     # 50
print(sum_all())                  # 0

def print_info(**kwargs):
    """هر چی مشخصات بدی، چاپ می‌کنه"""
    for key, value in kwargs.items():
        print(f"{key}: {value}")

print_info(name="رضا", job="برنامه‌نویس", age=28)
# name: رضا
# job: برنامه‌نویس
# age: 28

def universal_function(*args, **kwargs):
    print("آرگومان‌های موقعیتی:", args)
    print("آرگومان‌های کلیدواژه‌ای:", kwargs)

universal_function(1, 2, 3, name="پایتون", version=3.12)

lambda arguments: expression

# تابع معمولی
def square(x):
    return x * x

# معادل لامبدا
square_lambda = lambda x: x * x

print(square(5))        # 25
print(square_lambda(5)) # 25

 students = [("سارا", 18), ("امیر", 15), ("نرگس", 20)]
# مرتب‌سازی بر اساس نمره (عنصر دوم)
sorted_students = sorted(students, key=lambda student: student[1])
print(sorted_students)  # [('امیر', 15), ('سارا', 18), ('نرگس', 20)]

def calculate_bmi(weight_kg, height_m):
    """محاسبهٔ شاخص تودهٔ بدنی (BMI).
    
    Args:
        weight_kg: وزن به کیلوگرم
        height_m: قد به متر
    
    Returns:
        عدد BMI
    """
    return weight_kg / (height_m ** 2)

help(calculate_bmi)

 MENU = {
    "پیتزا": 80_000,
    "همبرگر": 65_000,
    "سالاد": 45_000,
    "نوشابه": 15_000
}

def show_menu():
    """منوی رستوران رو چاپ می‌کنه."""
    print("🍕 منوی رستوران:")
    for item, price in MENU.items():
        print(f"  - {item}: {price:,} تومان")
    print("-" * 30)

def take_order(*items):
    """سفارش‌ها رو دریافت می‌کنه و قیمت کل رو برمی‌گردونه.
    
    Args:
        *items: نام غذاهای سفارش داده شده
    
    Returns:
        tuple: (لیست سفارش‌های معتبر، قیمت کل)
    """
    valid_orders = []
    total = 0
    for item in items:
        price = MENU.get(item)
        if price:
            valid_orders.append(item)
            total += price
        else:
            print(f"⚠️ ببخشید، {item} نداریم!")
    return valid_orders, total

def apply_discount(total, is_member=False, coupon=None):
    """تخفیف روی قیمت اعمال می‌کنه.
    
    Args:
        total: مبلغ کل
        is_member: آیا مشتری عضو ویژه‌ست؟
        coupon: کد تخفیف (اختیاری)
    
    Returns:
        مبلغ نهایی
    """
    discount = 0
    if is_member:
        discount += 0.1  # ۱۰٪ تخفیف عضویت
    if coupon == "TAVON20":
        discount += 0.2  # ۲۰٪ تخفیف کوپن
    return total * (1 - discount)

# اجرای رستوران
show_menu()

order_items, price = take_order("پیتزا", "همبرگر", "سوشی", "نوشابه")
print(f"سفارش‌های شما: {', '.join(order_items)}")
print(f"قیمت کل: {price:,} تومان")

final_price = apply_discount(price, is_member=True, coupon="TAVON20")
print(f"💰 مبلغ نهایی بعد از تخفیف: {final_price:,.0f} تومان")