• 技术文章 >Python技术 >Python基础教程

    python docstring是什么

    爱喝马黛茶的安东尼爱喝马黛茶的安东尼2019-10-09 10:36:22原创8446

    Docstring是一种文档字符串,用于解释构造的作用。我们在函数、类或方法中将它放在首位来描述其作用。我们用三个单引号或双引号来声明docstring。

    >>> def sayhi():
     """
    用该函数打印Hi
    """
     print("Hi") 
    >>> sayhi()
    Hi

    要想获取一个函数的docstring,我们使用它的_doc_属性

    >>> sayhi.__doc__
    ‘
      This function prints Hi
    ’

    相关推荐:《Python基础教程

    docstring,不仅可以编写代码,同时也能写出文档,保持代码和文档的一致。

    docstring说白了就是一堆代码中的注释。

    Python的docstring可以通过help函数直接输出一份有格式的文档。

    编写test.py

    def printMax(x, y):
        '''Prints the maximum of two numbers.
        The two values must be integers.'''
        x = int(x) # convert to integers, if possible
        y = int(y)
        if x > y:
             print (x, 'is maximum')
        else:
             print (y, 'is maximum')
    printMax(3, 5)
    print (printMax.__doc__)

    命令行输入 help(test)

    import test
    5 is maximum
    Prints the maximum of two numbers.
        The two values must be integers.
    help(test)
    Help on module test:
    NAME
        test - Created on Sat Jun  2 19:05:08 2018
    DESCRIPTION
        @author: linzhiwei02
    FUNCTIONS
        printMax(x, y)
            Prints the maximum of two numbers.
            The two values must be integers.
    FILE
        /Users/linzhiwei02/Desktop/test.py
    专题推荐:python docstring
    上一篇:python divmod怎么用 下一篇:python graph什么意思

    相关文章推荐

    • python bytes是什么• python中input是什么• python complex是什么

    全部评论我要评论

    © 2021 Python学习网 苏ICP备2021003149号-1

  • 取消发布评论
  • 

    Python学习网