Python：如何使用epytext记录返回多个值时的返回值？

Question

一个简单的函数：

def foo():
    a = 1
    b = 2
    return a, b

如何使用epytext样式记录（多个）返回值？你知道吗

作为一个元组？你知道吗

def foo():
    """
    This function
    @return (a, b): a tuple of a and b representing...
    """
    a = 1
    b = 2
    return a, b

或者每个变量都有单独的@return标记？（这是否“合法”？）你知道吗

def foo():
    """
    This function
    @return a: a int representing...
    @return b: a int representing...
    """
    a = 1
    b = 2
    return a, b

Answer 1

在Python中，元组文本是由逗号而不是paren创建的（除了空元组文本()，这是一种特殊情况），因此return a, b首先创建一个tuple，然后返回它。你不是“返回多个值”，而是一个tuple对象，所以答案很明显。你知道吗