Python学习-第2课（函数，函数文档）

一、函数

1.定义

• 代码的一种组织形式
• 一个函数一般完成一项特定的功能
• 函数使用
  • 函数需要先定义
  • 使用函数，俗称调用

2.函数的参数和返回值

• 参数： 负责给函数传递一些必要的数据或者信息
  • 形参（形式参数）： 在函数定义的时候用到的参数没有具体值，只是一个占位的符号，成为形参
  • 实参（实际参数）： 在调用函数的时候输入的值
• 返回值： 函数的执行结
  • 使用return关键字
  • 如果没有return，默认返回一个None
  • 函数一旦执行return语句，则无条件返回，即结束函数的执行

 

3.参数详解

• 参数分类

  • 普通参数
  • 默认参数
  • 关键字参数
  • 收集参数

• 普通参数

  • 参见上例
  • 定义的时候直接定义变量名
  • 调用的时候直接把变量或者值放入指定位置

            def 函数名（参数1， 参数2，....):
                函数体

            # 调用
            函数名（value1, value2,.......)

            # 调用的时候，具体值参考的是位置，按位置赋值

• 默认参数

  • 形参带有默认值

  • 调用的时候，如果没有对相应形参赋值，则使用默认值

          def  func_name(p1=v1, p2=v2..........):
              func_block
    
          #调用1
          func_name()
    
          # 调用2
          value1= 100
          value2=200
          func_name(value1,value2)

二、四类参数

• 普通参数
• 默认参数
• 关键字参数
• 收集参数

1.关键字参数

• 语法

    def func(p1=v1, p2=v2.....):
        func_body
  
    调用函数：
    func(p1=value1, p2=value2.......)

• 比较麻烦，但也有好处：
  • 不容易混淆， 一般实参和形参只是按照位置一一对应即可，容易出错
  • 使用关键字参数，可以不考虑参数位置

2.收集参数

• 把没有位置，不能和定义时的参数位置相对应的参数，放入一个特定的数据结构中

• 语法

    def func(*args):
        func_body
        按照list使用方式访问args得到传入的参数
  
    调用：
    func(p1, p2, p3, .....)

• 参数名args不是必须这么写，但是，我们推荐直接用args，约定俗成
• 参数名args前需要由星号
• 收集参数可以和其他参数共存

3.收集参数之关键字收集参数

• 把关键字参数按字典格式存入收集参数

• 语法：

    def func( **kwargs):
        func_body
  
    # 调用：
    func(p1=v1, p2=v2, p3=v3........)

  • kwargs一般约定俗成
  • 调用的时候，把多余的关键字参数放入kwargs
  • 访问kwargs需要按字典格式访问

4.收集参数混合调用的顺序问题

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

5.收集参数的解包问题

• 把参数放入list或者字典中，直接把list/dict中的值放入收集参数中
• 语法：参看案例

6.同理，dict类型收集参数一样可以解包，但是

• 对dict类型进行解包
• 需要用两个星号进行解包

 7.返回值

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

三、函数文档

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