具有两个或多个返回参数的函数注释

Question

当我为返回一个参数的函数编写注释时，我没有问题。

def func() -> str:
    return "ok"

但是，当我编写带有两个或更多参数的注释时，我的 PyCharm 给了我SyntaxError: invalid syntax。

def func() -> str, str:
    return "ok - 1", "ok - 2"

我认为参数可以与tuple 组合，但我认为这不是最好的方法。

我的问题是：如何正确地注释具有两个或多个返回参数的函数？

请在您的回复中包含 PEP 链接（如果有）。我在PEP 484 和PEP 3107 寻找答案，但找不到。

Answer 1

使用typing.Tuple:

from typing import Tuple

def func() -> Tuple[str, str]:
    return 'a', 'b'

这是合适的，因为从概念上讲，您实际上是返回一个包含这些值的 tuple。注意：

print(type(func()))

输出：

<class 'tuple'>

除了空的tuple (())，parentheses are not necessary to define a tuple，这意味着'a', 'b' 被创建为tuple，而不是被return 语句收集到一个单独的值。