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

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

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

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

def divide(x, y):
    """
    計(jì)算兩個(gè)數(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ù)為零時(shí)拋出。
    """
    if y == 0:
        raise ZeroDivisionError("除數(shù)不能為零")
    return x / y

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

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

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

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

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

def calculate_statistics(data):
    """計(jì)算給定數(shù)據(jù)集的基本統(tǒng)計(jì)量。
    該函數(shù)返回?cái)?shù)據(jù)集的平均值、中位數(shù)和標(biāo)準(zhǔn)差。
    參數(shù)：
    data (list of float): 一個(gè)包含數(shù)值的列表。
    返回：
    dict: 包含'average'，'median'和'std_dev'鍵的字典，分別對(duì)應(yīng)平均值、中位數(shù)和標(biāo)準(zhǔn)差。
    異常：
    ValueError: 當(dāng)數(shù)據(jù)集為空時(shí)拋出。
    """
    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}