python的__doc__

直接问GPT的回答如下,但是提供的例子不够好。

__doc__ 是 Python 中用于保存对象(模块、类、函数等)文档字符串的特殊属性。

文档字符串(docstring)是编写在代码中用于文档自述的字符串。它通常用于提供关于代码目的、用法示例、参数说明等详细信息,以便用户或其他开发者可以理解并正确使用代码。文档字符串是对代码功能和使用的重要说明,也是代码可读性和可维护性的一部分。

Python 为每个对象(模块、类、函数等)都提供了一个 __doc__ 属性,用于存储与该对象相关的文档字符串。

自己写了一个模块,类和模型的示例,更好理解:

"""
define: test.py
"""
class a(object):
    """
    function: 测试文件
    input: None
    output: None
    """
    def main():
        """
        function: main函数
        """
        pass
    
if __name__ == '__main__':
    print(__doc__)				# 对于模块, 直接 print __doc__
    print(a().__doc__)			# 对于实例化的类 classA(), 当作一个属性print classA().__doc__
    print(a().main.__doc__)		# 对于函数 function(), 直接 print function.__doc__

第一个 print 输出

define: test.py

第二个 print 输出

    function: 测试文件
    input: None
    output: None

第二个 print 输出

        function: main函数

要注意到其实连空格都按照格式原封不动打印了。

  • 6
    点赞
  • 7
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

piukaty

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值