030-创建和调用函数

创建函数

def [函数名](函数参数)
'''
函数文档
'''
return 返回值

如果用户想要读取函数文档，那么只需要输入：

函数名__(双下划线)doc__(双下划线)

即可。例：

>>> def test(name):    #name 就是一个形参
    '''这是一个函数文档'''
    return 'Kiss%s' % (name)

>>> test('Thomas')#Thomas就是一个实参
'KissThomas'
>>> test.__doc__
'这是一个函数文档'

>>> help(test)
Help on function test in module __main__:

test(name)
    这是一个函数文档

如以上代码块所示，“函数名.__doc__”可以显示函数文档。而help(函数名)也可以显示函数的内容，以及文档。

不管是否涉及到跟他人协作，给函数添加正确的文档是一个好习惯。

位置参数和关键字参数

位置参数就是定义函数的时候，直接把形参的名字放在那里的，就叫位置参数。
而关键字参数是指在定义函数的时候，用一个变量去指定具体的形参的情形。

例如，上一个例子中，test(name)就是一个位置参数，而如果改成test（a='name'），那么name就变成了一个关键字参数，关键字是a。

默认参数

默认参数就是当用户没有给它赋值的情况下，它就会返回默认值的一个参数。

# 在没有默认参数的情况下，用户使用函数时，少输入了一个参数，导致函数报错
>>> def hanshu(name,behavior,noun):
    return '%s%s了%s' % (name,behavior,noun)

>>> hanshu('张三','吃')

#Traceback (most recent call last):
  #File "", line 1, in 
    #hanshu('张三','吃')
#TypeError: hanshu() missing 1 required positional argument: 'noun'

>>> hanshu('张三','吃','蛋糕')
'张三吃了蛋糕'
>>> 

#而当定义了默认参数，用户未输入默认参数时，就会自动将默认参数补全，函数正常运行。

>>> def hanshu(name,behavior,noun='蛋糕'):
    return '%s%s了%s' % (name,behavior,noun)

>>> hanshu('张三','玩弄')
'张三玩弄了蛋糕'
>>> 

注意：如果存在默认参数和位置参数，那么位置参数必须在默认参数的前面出现。否则会报错！！

收集参数（可变参数）

在这里“收集”不是一个动词。当定义函数的人也不知道用户到底可能要输入多少个参数时，就需要用到收集参数。

收集参数用*+普通参数名 的方式来表示。

>>> def test(*params):
    print('一共有%d个参数' % len(params))
    print('第2个参数的值是：%s' % params[1])

    
>>> test('金','木','水','火','土')
一共有5个参数
第2个参数的值是：木
>>> 

注意：如果可变参数后面还有其他的参数，那么后面的参数只能使用关键字参数，不能使用位置参数。因为如果使用了位置参数，会被python当成前面一个可变参数的一部分。

*在形参中的作用是打包，而在实参的作用中则是解包。

>>> str = '上海自来水来自海上'
>>> print(str)
上海自来水来自海上
>>> print(*str)
上 海 自 来 水 来 自 海 上