python:浅析函数文档
相信大家都有这样的体会,当在学习的过程中,看别人的代码不知道是什么意思,是干什么的,所以,为了解决这种问题python退出了函数文档,这大大提高了开发的效率,让别人一看你这个函数,就马上知道这个函数的功能,以及需要什么类型的参数。
1、什么是函数文档
所谓函数文档不过就是对一个函数进行解释说明,并没有其他实质性的意义
2、作用
- 解释说明该函数是干什么的,实现什么功能,让别人一看就知道你这个函数实现的功能
- 可以看出参数的个数,以及参数的类型
- 并且可以看出该函数是否返回一个值,返回了什么值
3、如何查看函数文档
# 以下是自己写的一个小小的案例
def average(a, b, c):
""" 该函数用于计算三个数的平均值,并返回一个结果 :param a: int_第一个数 :param b: int_第二个数 :param c: int_第三个数 :return: 返回一个计算结果 """
d = (a + b + c) // 3
print("平均数为:", d)
return d
- 快捷键(Ctrl+Q)
- help函数
help(average)
# help方式会直接输出到控制台
# 并且你的函数不能带括号,直接函数名就可以了
- doc
print(average.__doc__)
# 首先函数不能再括号
# 其次要调用__doc__ (前后都是两个下划线)
# doc不会自动输出,需要使用输出语句
以上均为自己在昨天的学习中掌握的一点点小知识,并通过自己的实践总结,将这些方法罗列出来,如果本篇文章有不完善的地方,还请各位朋友能够指教,谢谢!
今天的文章python:浅析函数文档分享到此就结束了,感谢您的阅读。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。
如需转载请保留出处:https://bianchenghao.cn/63240.html