DocStrings 文档字符串是一个��工具,用于解释文档程�,帮助你的程�文档更加简�易懂。

我们�以在函数体的第一行使用一对三个�引� ''' 或者一对三个�引� """ �定义文档字符串。

你�以使用 __doc__(注��下划线)调用函数中的文档字符串属性。

#!/usr/bin/python # -*- coding: UTF-8 -*- def function(): ''' say something here� ''' pass print (function.__doc__) # 调用 doc

输出结果为:

 say something here�
        

DocStrings 文档字符串使用惯例:它的首行简述函数功能,第二行空行,第三行为函数的具体�述。

#!/usr/bin/python # -*- coding: UTF-8 -*- def printMax(x,y): '''打�两个数中的最大值。 两个值必须都是在整形数。''' x=int(x) y=int(y) if x>y: print(x,'最大') else: print(y,'最大') printMax(3,5) print (printMax.__doc__) # 调用 doc

输出结果为:

5 最大
打�两个数中的最大值。
    
    两个值必须都是在整形数。