def greet(name):
    """返回一個問候信息。
    參數(shù)：
    name (str): 被問候者的名字。
    返回：
    str: 問候信息。
    """
    return f"Hello, {name}!"

def calculate_area(radius):
    """計算圓的面積。
    這是一個多行docstring示例。
    可以在這里詳細描述函數(shù)的行為和注意事項。
    參數(shù)：
    radius (float): 圓的半徑。
    返回：
    float: 圓的面積。
    """
    import math
    return math.pi * radius ** 2

def add(x, y):
    """計算兩個數(shù)的和。
    Args:
        x (int or float): 第一個數(shù)。
        y (int or float): 第二個數(shù)。
    Returns:
        int or float: 兩個數(shù)的和。
    """
    return x + y

def multiply(a, b):
    """
    計算兩個數(shù)的乘積。
    Parameters
    ----------
    a : int or float
        第一個數(shù)。
    b : int or float
        第二個數(shù)。
    Returns
    -------
    int or float
        兩個數(shù)的乘積。
    """
    return a * b

def divide(x, y):
    """
    計算兩個數(shù)的商。
    :param x: 被除數(shù)。
    :type x: int or float
    :param y: 除數(shù)。
    :type y: int or float
    :return: 商。
    :rtype: float
    :raises ZeroDivisionError: 當(dāng)除數(shù)為零時拋出。
    """
    if y == 0:
        raise ZeroDivisionError("除數(shù)不能為零")
    return x / y

"""
math_operations模塊
這個模塊提供了簡單的數(shù)學(xué)運算函數(shù)，包括加法、減法、乘法和除法。
"""
 
def add(x, y):
    """計算兩個數(shù)的和。"""
    return x + y
 
def subtract(x, y):
    """計算兩個數(shù)的差。"""
    return x - y

class Calculator:
    """一個簡單的計算器類。
    這個類提供了基本的數(shù)學(xué)運算功能，包括加法和減法。
    """
 
    def add(self, x, y):
        """計算兩個數(shù)的和。"""
        return x + y
 
    def subtract(self, x, y):
        """計算兩個數(shù)的差。"""
        return x - y

def multiply(x, y):
    """計算兩個數(shù)的乘積。
    參數(shù)：
    x (int or float): 第一個數(shù)。
    y (int or float): 第二個數(shù)。
    返回：
    int or float: 兩個數(shù)的乘積。
    """
    return x * y

def subtract(x, y):
    """計算兩個數(shù)的差。"""
    return x - y
 
help(subtract)

def divide(x, y):
    """計算兩個數(shù)的商。"""
    return x / y
 
print(divide.__doc__)

def calculate_statistics(data):
    """計算給定數(shù)據(jù)集的基本統(tǒng)計量。
    該函數(shù)返回數(shù)據(jù)集的平均值、中位數(shù)和標(biāo)準(zhǔn)差。
    參數(shù)：
    data (list of float): 一個包含數(shù)值的列表。
    返回：
    dict: 包含'average'，'median'和'std_dev'鍵的字典，分別對應(yīng)平均值、中位數(shù)和標(biāo)準(zhǔn)差。
    異常：
    ValueError: 當(dāng)數(shù)據(jù)集為空時拋出。
    """
    if not data:
        raise ValueError("數(shù)據(jù)集不能為空")
 
    average = sum(data) / len(data)
    median = sorted(data)[len(data) // 2]
    variance = sum((x - average) ** 2 for x in data) / len(data)
    std_dev = variance ** 0.5
 
    return {"average": average, "median": median, "std_dev": std_dev}