def 函數名(參數列表):
    """函數說明文檔（可選，建議寫）"""
    函數體（要執(zhí)行的代碼）
    return 返回值（可選）

# 定義函數：打印歡迎語
def print_welcome():
    """打印歡迎信息"""
    print("歡迎學習Python函數！")
# 調用函數（必須調用才會執(zhí)行）
print_welcome()  # 輸出：歡迎學習Python函數！

# 定義函數：計算兩個數的和
def add_num(a, b):
    """計算兩個數的和，返回結果"""
    result = a + b
    return result  # 返回求和結果
# 調用函數，接收返回值
sum1 = add_num(5, 3)
print(sum1)  # 輸出：8
sum2 = add_num(10.5, 20.3)
print(sum2)  # 輸出：30.8

# 定義：參數a、b為位置參數
def print_info(name, age):
    print(f"姓名：{name}，年齡：{age}")
# 調用：按順序傳入“張三”（對應name）、20（對應age）
print_info("張三", 20)  # 輸出：姓名：張三，年齡：20
# ? 錯誤：參數數量不一致（少傳/多傳都會報錯）
# print_info("李四")  # 報錯：缺少1個位置參數

# 定義：age設置默認值18
def print_info(name, age=18):
    print(f"姓名：{name}，年齡：{age}")
# 調用1：省略age，使用默認值18
print_info("王五")  # 輸出：姓名：王五，年齡：18
# 調用2：傳入age，覆蓋默認值
print_info("趙六", 22)  # 輸出：姓名：趙六，年齡：22

# 定義：3個位置參數
def print_info(name, age, gender):
    print(f"姓名：{name}，年齡：{age}，性別：{gender}")
# 調用：指定參數名，順序可亂
print_info(gender="男", name="孫七", age=25)  # 輸出：姓名：孫七，年齡：25，性別：男

# *args：接收任意數量的位置參數，打包成元組
def sum_all(*args):
    total = 0
    for num in args:
        total += num
    return total
print(sum_all(1,2,3))  # 輸出：6
print(sum_all(10,20,30,40))  # 輸出：100
# **kwargs：接收任意數量的關鍵字參數，打包成字典
def print_detail(**kwargs):
    for key, value in kwargs.items():
        print(f"{key}：{value}")
print_detail(name="周八", age=30, address="北京")
# 輸出：
# 姓名：周八
# 年齡：30
# 地址：北京

# 返回單個值
def get_max(a, b):
    if a > b:
        return a
    else:
        return b
print(get_max(10, 20))  # 輸出：20
# 返回多個值
def get_info():
    name = "吳九"
    age = 28
    return name, age  # 等價于返回 (name, age)
name, age = get_info()  # 解包接收
print(name, age)  # 輸出：吳九 28