创新互联Python教程：python入门：文档字符串

上篇我们说到了能够帮助程序员理解程序编写者的代码的方式是添加注释，可是你知道吗？想写出易于理解的优秀代码，文档字符串也是可以的。这时可能有人就有疑惑了，注释起到解释说明的作用大家通过字面意思可以明白，那文档字符串是什么？怎么起解释的作用呢？别急，下面，我们来介绍以下文档字符串。

成都创新互联坚持“要么做到，要么别承诺”的工作理念，服务领域包括：成都网站制作、成都网站设计、企业官网、英文网站、手机端网站、网站推广等服务，满足客户于互联网时代的衢州网站设计、移动媒体设计的需求，帮助企业找到有效的互联网解决方案。努力成为您成熟可靠的网络建设合作伙伴！

一、文档字符串定义

文档字符串（documentation string），通常也称作：docstring。
在函数体的第一行，我们可以使用一对三个单引号（'''）或者一对三个双引号（"""）来定义文档字符串，文档字符串通常第一行以大写字母开头，以句号（.）结束，第二行是空行，第三行开始是详细描述，简单的说就是给函数一个描述。

def add(a,b):

    """this a function to additon"""   #文档字符串

    sum = a+b

    return sum

二、文档字符串的用法

1、模块开头，作为整个模块的文档说明；
2、函数/方法的def语句定义后到函数体之间，用于函数/方法说明；
3、类定义的class语句后到类体之间，用于类说明。

三、使用__doc__访问文档字符串

字符串在给函数描述的过程中，需要添加函数功能说明。这个说明可以使用.__doc__（注意前后都是双_）属性，将DocString特性print打印出来。

def inputxy():  
    '''''this is my first test doc'''
    print "hello the word"
inputxy()  
print inputxy.__doc__# print pirntXY's doc

输出内容:

hello the world  
this is my first test doc  
  
Process finished with exit code 0

以上向大家介绍了文档字符串的定义、函数描述、用法和使用__doc__访问文档字符串的方法，小伙伴们应该对文档字符串有一定的了解了吧。python入门并不难，关键是要把基础打实，加油哦~更多python学习推荐：python学习网python基础。

网页题目：创新互联Python教程：python入门：文档字符串
文章网址：http://www.gawzjz.com/qtweb2/news14/7014.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源：创新互联

猜你还喜欢下面的内容