Python 文档字符串(DocStrings)

月野氿桃

Python 文档字符串(DocStrings)

分类 编程技术

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 最大
打印两个数中的最大值。
    
    两个值必须都是在整形数。
版权声明:本页面内容旨在传播知识,为用户自行发布,若有侵权等问题请及时与本网联系,我们将第一时间处理。E-mail:284563525@qq.com

目录[+]

取消
微信二维码
微信二维码
支付宝二维码