一、 函数的说明文档

　　函数的说明文档也叫函数的文档说明。

　　1.1 语法

　　定义函数的说明文档

　　def 函数名(参数）：

　　　　"""说明文档的位置"""

　　　　代码

　　查看函数的说明文档

　　help(函数名）

　　5.2 体验

# help(len)  help函数作用：查看函数的说明文档（函数的解释说明的信息）

def sum_num(a, b):
    """求和函数"""
    return a + b

help(sum_num)

# 函数的说明文档的高级使用
def sum_num1(a, b):
    """
    求和函数
    :param a:参数1
    :param b:参数2
    :return:返回值
    """
    return a + b

help(sum_num1)

二、 函数嵌套调用

　　所谓函数嵌套调用指的是一个函数里面又调用了另一个函数。

　　示例：

def testB():
    print('--- testB start ---')
    print('这里是testB函数执行的代码...(省略)...')
    print('--- testB end ---')

def testA():
    print('--- testA start ---')
    # 嵌套调用B
    testB()
    print('--- testA end ---')

testA()

　　如果函数A中，调用了另一个函数B，那么先把函数B中的任务都执行完毕之后才会回到上次 函数A执行的位置。

 三、 函数应用

　　3.1 打印图形

# 1.打印一条横线
def print_one():
    print('-' * 20)

# print_one()

# 2.函数嵌套调用实现多条横线
def print_tow(num):
    i = 0
    while i < num:
        print_one()
        i += 1

print_tow(6)

 　　3.2 函数计算

# 求任意三个数之和
def sum_num(a,b,c):
    return a + b + c

saa = sum_num(2, 5, 9)
print(saa)

# 任意三个数求平均值
def sum_num1(a,b,c):
    sumreturn = sum_num(a,b,c)
    return sumreturn/3

sumsaa = sum_num1(6,4,5)
print(sumsaa)

四、总结

　　1. 函数的作用：封装代码，高效的代码重用

　　2. 函数的使用步骤

　　　　定义函数

　　　　　　def 函数名():

　　　　　　　　代码1

　　　　　　　　代码2

　　　　调用函数

　　　　　　函数名()

　　3. 函数的参数：函数调用的时候可以传入真实数据，增大函数的使用灵活性

　　　　形参：函数定义时书写的参数（非真实数据）

　　　　实参：函数调用时书写的参数（真是数据）

　　4. 函数的返回值

　　　　作用：函数调用后，返回需要计算结果

　　　　写法：

　　　　　　return 表达式

　　5. 函数的说明文档

　　　　作用：保存函数解释说明信息

　　　　写法：

　　　　　　def 函数名():

　　　　　　　　"""函数说明文档"""

　　6. 函数嵌套调用：一个函数内部嵌套另一个函数