python3.11的functools模块中@functools.wraps函数的作用？以列表方式写出该函数必传参数和所有可选参数并说明含义？一个简单的案例并加上注释？

`functools.wraps` 是一个装饰器，用于将一个函数的元信息（如函数名、参数列表）复制到另一个函数中，从而使得这个新函数也具有相同的元信息。

必传参数：
- `wrapped`：被包装的函数，必须是一个可调用对象。

可选参数：
- `assigned`：将指定的属性从 `wrapped` 复制到包装的函数中，默认为所有属性。
- `updated`：将指定的字典更新到包装的函数的 `__dict__` 属性中，默认为 `None`。

一个简单的案例：

import functools

def my_decorator(func):
    # 使用 functools.wraps 复制元信息
    @functools.wraps(func)
    def wrapper(*args, **kwargs):
        """这是一个装饰器的示例"""
        print('Calling decorated function')
        return func(*args, **kwargs)
    return wrapper

@my_decorator
def example():
    """这是一个示例函数"""
    print('Called example function')

print(example.__name__)  # 输出 example
print(example.__doc__)   # 输出 这是一个示例函数

在上面的例子中，我们定义了一个装饰器 `my_decorator`，它使用 `functools.wraps` 来复制被装饰函数 `func` 的元信息，并将其应用到包装函数 `wrapper` 上。然后我们使用 `@my_decorator` 将装饰器应用到函数 `example` 上，从而实现了在调用 `example` 函数时打印一行提示信息的效果。注意，在这个例子中，我们可以看到 `example` 函数的元信息（如函数名和文档字符串）已经被正确地复制到了包装函数 `wrapper` 上，这是通过使用 `functools.wraps` 装饰器实现的。