一、函数的声明

1.什么是函数
1）函数的定义
函数就是对实现某一特定功能的代码的封装

2）函数的分类
a.系统函数 - 系统(语言系统)已经声明好，程序员可以直接使用的函数。

b.自定义函数 - 开发者自己声明的函数

2.函数的声明(定义函数)
1）语法：
def 函数名(参数列表):
函数说明文档
函数体
2）说明：
def - 关键字，固定写法
函数名 - 和变量名的要求一样
(): - 固定写法
参数列表 - 又叫形参列表；以'参数名1, 参数名2, 参数名3,...'的形式存在，参数名就是变量名
作用：将函数外面的数据传到函数里面
函数说明文档 - 本质是一段注释，位置必须在第一行有效代码的前面，必须使用三个双引号引起来的注释
函数体 - 和def保持一个缩进的一条或者多条语句；实现函数功能的代码

3）初学者声明函数的步骤
a.确定函数的功能
b.根据功能确定函数名
c.确定参数，看实现函数的功能需不需要额外的数据，需要几个就设置几个参数
d.实现函数的功能
e.写说明文档

注意：声明函数的时候不会执行函数！！（重要）

# 声明一个函数，打印两个数的和
def sum1(num1, num2):
    """
    求a和b的和
    :param num1:提供第一个数；数字
    :param num2:提供第二个数；数字
    :return:
    """
    print(num1 + num2)


# 声明一个函数，求n的阶乘
def factorial(n):
    """
    求n的阶乘
    :param n:数字n的值
    :return:阶乘后的结果
    """
    sum1 = 1
    for i in range(1, n + 1):
        sum1 *= i
    return sum1


print(factorial(5))

3.函数的调用
1）语法：
函数(实参列表)

2）说明：
函数 - 已经声明的函数
() - 固定写法
实参列表 - 多个数据用逗号隔开；需要传递到函数中具体使用的数据，用来给形参赋值的

3）函数的调用过程
a.回到函数声明的位置
b.传参，用实参给形参赋值(必须保证每个形参都有值)
c.执行函数体
d.确定返回值
e.回到函数调用的位置，接着执行

二、函数的参数

1.根据实参的传值方式将实参分为：位置参数，关键字参数
1）位置参数 - 直接让实参的值和形参一一对应
2）关键字参数 - 调用函数的时候以'形参名1=值1,形参名2=值2,...'的形式传递
3）位置参数和关键字参数关键字混用 - 混用的时候必须保证位置参数在关键字参数的前面，同时保证每个参数都有值

def func1(a, b, c):
    print('a:{},b:{},c:{}'.format(a, b, c))


# 位置参数
func1(10, 20, 30)  # a:10,b:20,c:30

# 关键参数
func1(a=100, b=200, c=300)  # a:100,b:200,c:300

# 混用
func1(100, c=300, b=200)  # a:100,b:200,c:300
# func1(b=200,a=100,33)   # positional argument follows keyword argument
# func1(10,20,b=30)   # func1() got multiple values for argument 'b'

形参
2.参数默认值(形参)
声明函数的时候，可以通过'参数名=值'的形式给参数默认值；有默认值的参数在调用的时候可以不传参
注意：有默认值的参数必须放在没有默认值参数的后面、

关键字参数的使用场景：想要跳过前面有默认值的参数，直接给后面参数赋值的时候，必须使用关键字参数

def func2(a=1, b=2, c=3):
    print('a:{},b:{},c:{}'.format(a, b, c))


func2()  # a:1,b:2,c:3
func2(10, 20)  # a:10,b:20,c:3
func2(b=20)  # a:1,b:20,c:3

3.参数类型说明
1）给参数赋默认值
2）形参: 类型名
3）返回值类型说明 -> 类型

def func4(z: list, y: str, x=10):
    """
    :param z:
    :param y:
    :param x:
    :return:
    """

    pass

4.不定长参数
声明函数的时候，参数个数不确定(不定长参数)

1）声明函数的时候在参数名前加*，这个参数就会变成一个元组，元组中的元素就是对应的多个参数
注意：
a.调用的时候只能使用位置参数，
b.不定长参数后面如果有其他参数，那么他后面的参数必须使用关键字参数传参

2）声明函数的时候在参数名前加**，这个参数就会变成一个字典，字典中的元素：关键字:实参值
注意：
a.调用的时候只能使用关键字参数
b.同时使用*和**(*必须放**前面)时这个函数参数个数还是不确定，更加灵活，可以不传，可以位置参数传，可以关键字传，可以两个一起传

# 写一个函数，求多个数的和
def wx_sum(*x):  # x变成一个元组
    sum1 = 0
    for num in x:
        sum1 += num
    print(sum1)


def func5(name, *score, gender):
    print(name, score, gender)


# gender必须使用关键字传参
func5('asd', 12, 34, gender='nan')  # asd (12, 34) nan


def func6(**x):
    print(x)


func6(a=1, b=2, c=3)  # {'a': 1, 'b': 2, 'c': 3}
# 同时使用*和**(*必须放前面),更加灵活，可以不传，可以位置参数传，可以关键字传，可以两个一起传
# def func(*args, **kwargs)