Python有个特性叫做文档字符串,即DocString,这个特性可以让你的程序文档更加清晰易懂,在python的系统文件里,也都在使用这个特性。因此推荐每个Python爱好者都使用它。
DocString是有自己的格式的。一般是放在自己函数定义的第一行,用‘’符号指示,在这‘’里面添加函数功能说明就可以了。这个说明可以使用.__doc__(注意前后都是双_)属性,将DocString特性print打印出来。如下:
def inputxy():
'''this is my first test doc'''
print "hello the world"
inputxy()
print inputxy.__doc__# print pirntXY's doc输出内容如下:
hello the world
this is my first test doc
Process finished with exit code 0DocSting的典型用法就是help()调用,它抓取DocString属性,清晰的给你展示出来。
本文介绍了 Python 中 DocString 的使用方法及其重要性。通过实例展示了如何在函数中添加 DocString 以及如何通过 .__doc__ 属性访问这些文档字符串。此外,还提到了 DocString 在 help() 函数中的应用。
824

被折叠的 条评论
为什么被折叠?



