Python typing 模块中的 Callable 类型介绍

qq_27390023

于 2025-03-23 14:29:28 发布

阅读量350

点赞数 4

文章标签： python 算法开发语言

本文链接：https://blog.youkuaiyun.com/qq_27390023/article/details/146455813

版权

typing 模块中的 Callable 类型用于在 Python 中对可调用对象进行类型提示。可调用对象是指那些可以像函数一样被调用的对象，包括函数、方法、类以及实现了 __call__ 方法的类实例等。借助 Callable 类型，能让代码的类型更加明确，提高代码的可读性和可维护性，同时也有助于静态类型检查工具（如 mypy）发现潜在的类型错误。

基本语法

Callable 的语法如下：

from typing import Callable

# 定义一个可调用对象的类型
Callable[[Arg1Type, Arg2Type, ...], ReturnType]

Arg1Type, Arg2Type, ...：表示参数的类型。
ReturnType：表示返回值的类型。

如果不需要指定参数类型或返回类型，可以使用 Any 或省略它们：

from typing import Callable, Any

# 不指定参数类型
Callable[..., ReturnType]

# 不指定返回类型
Callable[[Arg1Type, Arg2Type, ...], Any]

# 完全不指定
Callable

示例代码

示例 1：函数作为可调用对象

from typing import Callable

# 定义一个接受两个整数并返回它们之和的函数
def add_numbers(a: int, b: int) -> int:
    return a + b

# 定义一个函数，它接受一个可调用对象和两个整数作为参数
def apply_operation(operation: Callable[[int, int], int], x: int, y: int) -> int:
    return operation(x, y)

# 调用 apply_operation 函数，传入 add_numbers 函数和两个整数
result = apply_operation(add_numbers, 3, 5)
print(result)

在这个示例中：

add_numbers 是一个普通的函数，它接受两个整数并返回它们的和。
apply_operation 函数接受一个可调用对象 operation，该可调用对象需要接受两个整数参数并返回一个整数，同时还接受两个整数 x 和 y，最后调用 operation 函数对 x 和 y 进行操作并返回结果。

示例 2：类作为可调用对象

from typing import Callable

# 定义一个类，实现 __call__ 方法，使其成为可调用对象
class Multiplier:
    def __call__(self, a: int, b: int) -> int:
        return a * b

# 定义一个函数，它接受一个可调用对象和两个整数作为参数
def apply_operation(operation: Callable[[int, int], int], x: int, y: int) -> int:
    return operation(x, y)

# 创建 Multiplier 类的实例
multiplier = Multiplier()

# 调用 apply_operation 函数，传入 multiplier 实例和两个整数
result = apply_operation(multiplier, 3, 5)
print(result)

在这个示例中：

Multiplier 类实现了 __call__ 方法，这使得该类的实例可以像函数一样被调用。
apply_operation 函数与示例 1 中的相同，它接受一个可调用对象和两个整数作为参数，并调用该可调用对象对两个整数进行操作。

示例 3：接受任意数量参数的可调用对象

from typing import Callable, Any

# 定义一个接受任意数量参数并返回 None 的可调用对象
def print_all(*args: Any) -> None:
    for arg in args:
        print(arg)

# 定义一个函数，它接受一个可调用对象和任意数量的参数
def call_with_args(func: Callable[..., None], *args: Any) -> None:
    func(*args)

# 调用 call_with_args 函数，传入 print_all 函数和一些参数
call_with_args(print_all, 1, 2, 3, "hello")

在这个示例中：