笔记----注释

1、和绝大多数脚本和Unix-shell一样，python用单个#来表示单行注释，从#开始，直到该行结束都为注释。

# 这是随便找的代码，无需知道
x_direction = choice([1, -1]) # 决定向左还是向右。正为右边，负数为左边
x_distance = choice([0, 1, 2, 3, 4]) # 随机移动0到4之间的步数

2、注释有单行注释也有多行注释，单行注释用单个#表示如上例，Python PEP8 建议一行不要超过79个字符，当我们需要注释的文字过长会给我们造成阅读不便，我们就需要多行字符，用 三对双引号表示如："""这样表示""" 或者三对单引号表示如： ''' 这样表示 ''' 。

"""

提示用户提供数值输入时，常出现的一个问题是，用户提供的是文本而不是数字。
在这种情况下，当你尝试将输入转换为整数时，将引发TypeError 异常。
编写一个程序，提示用户输入两个数字，再将它们相加并打印结果。
在用户输入的任何一个值不是数字时都捕获TypeError 异常，并打印一条友好的错误消息。
对你编写的程序进行测试：先输入两个数字，再输入一些文本而不是数字。

"""

3、在开发过程中，我需要涉及到很多函数，虽然在开始阶段我们都知道每个函数功能，但过了几天后我们还知道该函数的功能吗？难道要仔细阅读该函数的每行代码，NO！这样会导致你浪费大量时间，你只需要在定义函数的下方用三对引号之间说明该函数的说明文字，通过几种方法查看该注释。

    1）、第一种方法

            在函数调用出使用Ctrl+ Q产看函数注释的说明文字。

    2）、第二种方法

                通过调用__doc__的方法来查看函数注释的说明文字，注：doc前后面各两个_

                示例：函数名字.__doc__    注意：函数后面没有括号

def roll(self):   

     """随机roll出1~6的值"""  

      return randint(1, self.num_sides)   

     dd = roll.__doc__    

    print(dd)

输出：

随机roll出1~6的值