透過 len.__doc__
取得的字串稱為 DocStrings,你可以為 API 定義自帶的文件資訊。例如,試著在互動模式中鍵入以下程式碼:
1
2
3
4
5
|
def max(a, b):
''
'max(a, b) -> value
With two arguments,
return
the largest argument.
''
'
return
a
if
a > b
else
b
|
'''
包括的字串是可以換行的,如果這樣的字串出現在函式的開頭,那它會成為函式物件的 __doc__
屬性值,因此接下來,如果你鍵入 max.__doc__
或 help(max)
,將會看到以下畫面: