Python 函数入参类型提示：Tuple、Optional、Union 和 Sequence

在 Python 中，函数入参的类型提示是提高代码可读性和可维护性的关键因素之一。通过使用类型提示，我们可以更清晰地表达函数的期望输入和输出。在函数入参中，常见的类型提示包括 Tuple、Optional、Union 和 Sequence，让我们深入了解它们。

Tuple：不可变、有序的数据结构

Tuple 是 Python 中的一种不可变的、有序的数据结构，用于表示一组相关的值。通常使用括号 () 表示。

# 例子：接收两个整数作为坐标
def move_to(point: Tuple[int, int]) -> None:
    x, y = point
    print(f"Moving to ({x}, {y})")

# 使用 Tuple 作为参数
move_to((5, 10))  # 输出: Moving to (5, 10)

Tuple 允许我们定义一个包含不同类型元素的有序集合，非常适合用于函数需要接收多个相关值的情况。

Optional：表示可能为 None 的类型

Optional 用于表示一个值可以是某种类型或 None。这对于函数参数或返回类型中可能缺失的值非常有用。

# 例子：接收一个整数，返回其平方根或 None
def square_root(x: Optional[int]) -> Optional[float]:
    if x is not None:
        return x ** 0.5
    else:
        return None

# 使用 Optional 作为参数和返回类型
result = square_root(25)  # 输出: 5.0

Optional 帮助我们清晰地表达可能缺失的值，提高了代码的可读性。

Union：多个类型中的一个

Union 用于表示多个可能的类型中的一个。这在需要接受不同类型参数的函数中很有用。

from typing import Union

# 例子：接收一个字符串或整数
def print_data(data: Union[str, int]) -> None:
    print(data)

# 使用 Union 作为参数类型
print_data("Hello")  # 输出: Hello
print_data(42)       # 输出: 42

Union 允许我们定义函数接受多个类型中的一个，增加了函数的灵活性。

Sequence：可迭代序列

Sequence 用于表示可迭代的序列，如列表、元组等。这在需要接受多个元素的函数中非常有用。

from typing import Sequence

# 例子：接收一个整数列表
def sum_numbers(numbers: Sequence[int]) -> int:
    return sum(numbers)

# 使用 Sequence 作为参数类型
result = sum_numbers([1, 2, 3, 4])  # 输出: 10

Sequence 帮助我们表达接受多个元素的函数，提高了函数的通用性。

结语

Python 中的类型提示为函数的设计和使用提供了更多的可能性。Tuple、Optional、Union 和 Sequence 是其中常见的类型提示，通过灵活运用它们，我们可以编写更具表达力和通用性的代码。

希望这篇博客对你理解 Python 函数入参类型提示有所帮助。如果你有其他关于 Python 类型提示的问题，或想深入了解其他类型提示，请随时留言。