Python学习5（函数）

一、函数及其参数和返回值

1、函数相关概念

函数：
需要在程序中多次执行同一项任务时，你无需反复编写完成该任务的代码，而只需调用执行该任务的函数，让Python运行 其中的代码。你将发现，通过使用函数，程序的编写、阅读、测试和修复都将更容易。

定义函数的格式：

def 函数名():
    代码

实例：

# ##定义函数
def greet_user():
    """显示简单的问候语"""
    print("HELLO!")

# 调用函数
greet_user()

2、函数参数

概念：

• 形参：定义时小括号中的参数，用来接收参数用的。
• 实参：调用时小括号中的参数，用来传递给函数用的。

def greet_user(username):
    """显示简单的问候语"""
    print("Hello, " + username.title() + "!")


greet_user('mary')

其中，username为形参，‘mary’ 为实参。

传递实参：
鉴于函数定义中可能包含多个形参，因此函数调用中也可能包含多个实参。向函数传递实参的方式很多，可使用位置实参，这要求实参的顺序与形参的顺序相同；也可使用关键字实参 ，其中每个实参都由变量名和值组成；还可以使用列表和字典。下面来依次介绍这些方式。

• 位置实参：是基于实参的顺序，来关联到函数定义中的一个形参。

# 定义函数
def describe_pet(animal_type, pet_name):
    """显示宠物的信息"""
    print("\nI have a " + animal_type + ".")
    print("My " + animal_type + "'s name is " + pet_name.title())

# 调用函数
describe_pet('dog', '狗蛋')
describe_pet('cat', 'maomao')

• 关键字实参：是传递给函数的名称—值对。

# 在上述定义过的函数条件下，使用下述语句调用函数
describe_pet(pet_name='harry', animal_type='bird')

• 默认值：编写函数时，可给每个形参指定默认值。

在调用函数中给形参提供了实参时，Python将使用指定的实参值；否则，将使用形参的默认值。因此，给形参指定默认值后，可在函数调用中省略相应的实参。使用默认值可简化函数调用，还可清楚地指出函数的典型用法。

# 定义函数
def describe_pet(pet_name, animal_type='dog'):  #需要将有默认形参的放后面(必须）
"""显示宠物的信息"""
print("\nI have a " + animal_type + ".")
print("My " + animal_type + "'s name is " + pet_name.title())

#调用函数
describe_pet(pet_name='herry')

注意： 我们在定义函数时需要将有默认形参的放后面(必须）。

这样，调用这个函数时，如果没有给animal_type 指定值，Python将把这个形参设置为’dog’。 Python依然将这个实参视为位置实参，因此如果函数调用中只包含宠物的名字，这个实参将关联到函数定义中的第一个形参。

因此在该条件下，下面几种调用方式等价。

# 一条名为Willie的小狗 
describe_pet('willie') 
describe_pet(pet_name='willie') 
# 一只名为Harry的仓鼠 
describe_pet('harry', 'hamster') 
describe_pet(pet_name='harry', animal_type='hamster')
describe_pet(animal_type='hamster', pet_name='harry')

3、函数返回值

概念：
函数并非总是直接显示输出，相反，它可以处理一些数据，并返回一个或一组值。函数返回的值被称为返回值 。

• 返回简单值：（让部分实参变成可选的）

# #返回简单值
def get_formatted_name(first_name, last_name, middle_name=''):
    """返回整洁的姓名"""
    if middle_name:
        full_name = first_name + ' ' + middle_name + ' ' + last_name
    else:
        full_name = first_name + ' ' + last_name
    return full_name.title()


musician1 = get_formatted_name('jimi', 'hendrix')
print(musician1)

musician2 = get_formatted_name('join', 'hooker', 'lee')
print(musician2)

• 返回字典：

# #返回字典
def build_person(first_name, last_name, age=''):
    """返回一个字典"""
    person = {'first': first_name, 'last': last_name}
    if age:
        person['age'] = age
    return person


musician3 = build_person('jimi', 'hendrix', age=27)
print("musician3:" + str(musician3))

结果：

Test：
结合使用函数和while循环:

# #结合使用函数和while循环
while True:
    print("\nPlease tell me your name:")
    print("(Enter q at any time to quit)")

    f_name = input("First name: ")
    if f_name == 'q':
        break

    l_name = input("Last name: ")
    if l_name == 'q':
        break

    formatted_name = get_formatted_name(f_name, l_name)
    print("\nHellO, " + formatted_name + "!")

二、传递特殊的参数

1、传递列表

以一个题目为例：一家为用户提交的设计制作3D打印模型的公司。需要打印的设计存储在一个列表中，打印后移到另一个列表中。

# 打印模型的函数
def print_models(unprinted_designs, completed_models):
    """
    模拟打印每个设计，直到没有未打印的设计为止
    打印每个设计后，都将其移到列表completed_models中
    """

    while unprinted_designs:
        current_design = unprinted_designs.pop()

        # 模拟根据设计制作3D打印模型的过程
        print("Printing model: " + current_design)
        completed_models.append(current_design)


# 显示函数
def show_completed_models(completed_models):
    """显示打印好的所有模型"""
    print("\nThe following models have been printed:")
    for completed_model in completed_models:
        print(completed_model)


unprinted_designs = ['iphone case', 'robot pendant', 'dodecahedron']
completed_models = []

print_models(unprinted_designs[:], completed_models)  # 该语句([:])不会更改原列表内容，只是创建了一个副本
show_completed_models(completed_models)

print("原始列表:" + str(unprinted_designs))  # 列表和文字一起输出需加str（）

结果：

2、递任意数量的实参

如果我们需要传递任意数量的实参，在形参前加一个 * 即可（相当于传进去一个列表)。

例子：

def make_pizza(*toppings):
    """概述要制作的披萨"""
    print("\nMaking a pizza with the following toppings:")
    for topping in toppings:
        print("- " + topping)


make_pizza('mushrooms')
make_pizza('potatoes', 'spicy', 'extra cheese')

其中，形参名*toppings 中的星号让Python创建一个名为toppings的空元组，并将收到的所有值都封装到这个元组中。
注意，Python将实参封装到一个元组中，即便函数只收到一个值也如此。

2、结合使用位置实参和任意数量实参

如果要让函数接受不同类型的实参，必须在函数定义中将接纳任意数量实参的形参放在最后。Python先匹配位置实参和关键字实参，再将余下的实参都收集到最后一个形参中。

例如：

def make_pizza(size, *toppings):
...
...

3、使用任意数量的关键字实参

有时候，需要接受任意数量的实参，但预先不知道传递给函数的会是什么样的信息。在这种情况下，可将函数编写成能够接受任意数量的键—值对——调用语句提供了多少就接受多少。

如果我们需要传递任意数量的关键字实参，在形参前加 ** 即可(相当于传进去一个字典)

例如：
创建用户简介：你知道你将收到有关用户的信息，但不确定会是什么样的信息。

def build_profile(first, last, **user_info):
    """创建一个字典，其中包含我们知道的有关用户的一切"""
    profile = {}
    profile['first_name'] = first
    profile['last_name'] = last
    for key, value in user_info.items():
        profile[key] = value
    return profile


user_profile = build_profile('albert', 'einstein',
                             location='princeton',
                             field='physics')
print(user_profile)

三、将函数存储在模块中

函数的优点之一是，使用它们可将代码块与主程序分离。通过给函数指定描述性名称，可让主程序容易理解得多。你还可以更进一步，将函数存储在被称为模块的独立文件中， 再将模块导入到主程序中。import 语句允许在当前运行的程序文件中使用模块中的代码。

1、导入整个模块

要让函数是可导入的，得先创建模块。模块是扩展名为.py的文件，包含要导入到程序中的代码。

语法格式：

module_name.function_name()

实例：
代码行import pizza 让Python打开文件pizza.py，并将其中的所有函数都复制到这个程序中。你看不到复制的代码，因为这个程序运行时，Python在幕后复制这些代码。你只需知道，在making_pizzas.py中，可以使用pizza.py中定义的所有函数。

2、导入特定的函数

我么还可以导入模块中的特定函数。

语法格式：

from module_name import function_name

实例：
对于前面的例子，我们使用：

from pizza import make_pizza 
make_pizza(16, 'pepperoni') 
make_pizza(12, 'mushrooms', 'green peppers', 'extra cheese')

其中，from pizza import make_pizza即可使用模块中的函数。

3、使用as给函数或者模块定别名

如果要导入的函数或者模块的名称可能与程序中现有的名称冲突，或者它们的名称太长，可指定简短而独一无二的别名——另一个名称，类似于外号。

语法格式：

# 使用as给函数定别名
from module_name import function_name as fn

# 使用as给模块定别名
import module_name as mn

实例：

# 使用as给函数定别名
from pizza import make_pizza as mp 
mp(16, 'pepperoni') 
mp(12, 'mushrooms', 'green peppers', 'extra cheese')

# 使用as给模块定别名
import pizza as p 
p.make_pizza(16, 'pepperoni') 
p.make_pizza(12, 'mushrooms', 'green peppers', 'extra cheese')

4、导入模块中所有函数

使用星号（* ）运算符可让Python导入模块中的所有函数。

语法格式：

from module_name import * 

实例：

from pizza import * 
make_pizza(16, 'pepperoni') 
make_pizza(12, 'mushrooms', 'green peppers', 'extra cheese')

注意：

import 语句中的星号让Python将模块pizza 中的每个函数都复制到这个程序文件中。由于导入了每个函数，可通过名称来调用每个函数，而无需使用句点表示法。然而，使用并非自己编写的大型模块时，最好不要采用这种导入方法：如果模块中有函数的名称与你的项目中使用的名称相同，可能导致意想不到的结果：Python可能遇到多个名称相同的函数或变量，进而覆盖函数，而不是分别导入所有的函数。
最佳的做法是： 要么只导入你需要使用的函数，要么导入整个模块并使用句点表示法。这能让代码更清晰，更容易阅读和理解。这里之所以介绍这种导入方法，只是想让你在阅读别人编写的代码时，如果遇到类似的import 语句，能够理解它们。

三、函数编写指南

1、应给函数指定描述性名称，且只在其中使用小写字母和下划线。给模块命名时也应遵循上述约定。
2、每个函数都应包含简要地阐述其功能的注释，该注释应紧跟在函数定义后面，并采用文档字符串格式。
3、给形参指定默认值时，等号两边不要有空格。对于函数调用中的关键字实参，也应遵循这种约定：

eg：

def function_name(parameter_0, parameter_1='default value')

function_name(value_0, parameter_1='value')

4、如果程序或模块包含多个函数，可使用两个空行将相邻的函数分开。
5、所有的import 语句都应放在文件开头，唯一例外的情形是，在文件开头使用了注释来描述整个程序。

具体编写指南可以参考: Python代码风格指南.