如其他答案所述,函数顶部的字符串用作文档,如下所示:>>> def fact(n):
... """Calculate the factorial of a number.
...
... Return the factorial for any non-negative integer.
... It is the responsibility of the caller not to pass
... non-integers or negative numbers.
...
... """
... if n == 0:
... return 1
... else:
... return fact(n-1) * n
...
要查看Python解释器中函数的文档,请使用help:
^{pr2}$
许多从代码生成HTML文档的工具将第一行用作函数的摘要,而字符串的其余部分则提供了其他详细信息。因此,第一行应该保持简短,以便很好地适合生成文档中的函数列表。在