06-函数参数和文档

# 四类参数
- 普通参数
- 默认参数
- 关键字参数
- 收集参数

## 关键字参数开始
- 语法
    
        def func(p1=v1, p2=v2.....):
            func_body
            
        调用函数：
        func(p1=value1, p2=value2.......)
- 比较麻烦，但也有好处：
    - 不容易混淆， 一般实参和形参只是按照位置一一对应即可，容易出错
    - 使用关键字参数，可以不考虑参数位置

## 收集参数
- 把没有位置，不能和定义时的参数位置相对应的参数，放入一个特定的数据结构中
- 语法
    
        def func(*args):
            func_body
            按照list使用方式访问args得到传入的参数
            
        调用：
        func(p1, p2, p3, .....)
- 参数名args不是必须这么写，但是，我们推荐直接用args，约定俗成
- 参数名args前需要由星号
- 收集参数可以和其他参数共存

 ### 收集参数之关键字收集参数
 - 把关键字参数按字典格式存入收集参数
 - 语法：
     
         def func( **kwargs):
             func_body
             
         # 调用：
         func(p1=v1, p2=v2, p3=v3........)
- kwargs一般约定俗成
- 调用的时候，把多余的关键字参数放入kwargs
- 访问kwargs需要按字典格式访问

### 收集参数混合调用的顺序问题
- 收集参数，关键字参数，普通参数可以混合使用
- 使用规则就是，普通参数和关键字参数优先
- 定义的时候一般找普通参数，关键字参数，收集参数tuple，收集参数dict

### 收集参数的解包问题
- 把参数放入list或者字典中，直接把list/dict中的值放入收集参数中
- 语法：参看案例


### 同理，dict类型收集参数一样可以解包，但是
- 对dict类型进行解包
- 需要用两个星号进行解包

# 返回值
- 函数和过程的区别
    - 有无返回值
- 需要用return显示返回内容，
- 如果没有返回，则默认返回None
- 推荐写法，无论有无返回值，最后都要以return 结束

# 函数文档
- 函数的文档的作用是对当前函数提供使用相关的参考信息
- 文档的写法：
    - 在函数内部开始的第一行使用三引号字符串定义符
    - 一般具有特定格式
    - 参看案例
- 文档查看
    - 使用help函数，形如 help(func)
    - 使用__doc__, 参看案例