《Python编程：从入门到实践》 第十天

第八章 函数
函数是带名字的代码块，用于完成具体的工作。
如何将函数存储在被称为模块的独立文件中，让主程序文件的组织更为有序。
8.1 定义函数
使用关键字def来告诉Python你要定义一个函数。这是函数定义，向Python指出了函数名，还可能在括号内指出函数为完成其任务需要什么样的信息。最后，定义以冒号结尾
所有的缩进行构成函数体。“”“”“”被称为 文档字符串的注释（docstring）,Python使用它们来生成有关程序中函数的文档。

def greet_user():
“”“显示简单的问候语”""
print(“Hello!”)
greet_user()
8.1.1 向函数传递信息

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

8.1.2 实参和形参
实参是调用函数时传递给函数的信息。

8.2 传递实参
向函数传递实参的方式很多，可使用位置实参，这要求实参的顺序与形参的顺序相同；也可使用关键字实参，其中每个实参都由变量名和值组成；还可使用列表和字典。

8.2.1 位置实参
最简单的关联方式是基于实参的顺序。
1、调用函数多次
2、位置实参的顺序很重要

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('hamster','harry')

8.2.2 关键字实参
关键字实参是传递给函数的名称—值对。关键字实参让你无需考虑函数调用中的实参顺序，还清楚地指出了函数调用中各个值的用途。

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(animal_type='hamster', pet_name='harry')**

关键字实参的顺序无关紧要
8.2.3 默认值
编写函数时，可给每个形参指定默认值。

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='willie') #如果没有给定animal_type的实参，那么默认为默认值

python依然将这个实参视为位置实参，因此如果函数调用中只包含宠物的名字，这个实参将关联到函数定义中的第一个形参。这就是需要将pet_name放在形参列表开头的原因所在。
使用默认值时，在形参列表中必须先列出没有默认值的形参，再列出有默认值的实参。这让Python依然能够正确地解读位置实参。

8.2.4 等效的函数调用
鉴于可混合使用位置实参、关键字实参和默认值，通常有多种等效的函数调用方式。
定义：def describe_pet(pet_name, animal_type=‘dog’):
调用：
#一条名为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’)

8.2.5 避免实参错误
你提供的实参多于或少于函数完成其工作所需的信息时，将出现实参不匹配错误。

8.3 返回值
在函数中，可使用return语句将值返回到调用函数的代码行。
8.3.1 返回简单值

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

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

8.3.2 让实参变成可选的
有时候，需要让实参变成可选的，这样使用函数的人就只需在必要时才提供额外的信息。可使用默认值来让实参变成可选的。
为让中间名变成可选的，可给实参middle_name指定一个默认值——空字符串。并在用户没有提供中间名时不使用这个实参。

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()

musician = get_formatted_name('john','lee','hooker')
print(musician)
musician = get_formatted_name('jimi','hendrix')
print(musician)

Python将非空字符串解读为True。
8.3.3 返回字典
函数可返回任何类型的值，包括列表和字典等较复杂的数据结构。

def build_person(first_name,last_name):
    """返回一个字典，其中包含有关一个人的信息"""
    person = {'first':first_name,'last':last_name}
    return person
musician = build_person('jimi','hendrix')
print(musician)

#修改存储年龄：

def build_person(first_name,last_name,age = ''):
    """返回一个字典，其中包含有关一个人的信息"""
    person = {'first':first_name,'last':last_name}
    if age:
        person['age'] = age
    return person
musician = build_person('jimi','hrndrix',age = 27)
print(musician)

8.3.4 结合使用函数和while循环

#结合使用函数和while循环
def get_formatted_name1(first_name, last_name):
    """返回整洁的姓名"""
    full_name = first_name + ' ' + last_name
    return full_name.title()
#这是一个无限循环！
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_name1(f_name, l_name)
    print("\nHello, " + formatted_name + "!")

8.4 传递列表
将列表传递给函数后，函数就能直接访问其内容。

# 8.4 向函数传递列表，函数可以直接访问列表中的内容
#问候用户列表中的每位用户
def greet_users(names) :
    """向列表中的每位用户都发出简单的问候"""
    for name in names:
        msg = "Hello, " + name.title() + "!"
        print(msg)
usernames = ['hannah', 'ty', 'margot']
greet_users(usernames)

8.4.1 在函数中修改列表
将列表传递给函数后，函数就可对其进行修改。在函数中对这个列表所做的任何修改都是永久性的，这让你能够高效地处理大量的数据。
不使用函数的情况下的代码：

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

#模拟打印每个设计，直到没有未打印的设计为止
#打印每个设计后，都将其移到列表completed_models中
while unprinted_designs:
    current_design = unprinted_designs.pop()

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

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

使用函数的代码：

#第一个函数负责处理打印设计的工作，第二个将概诉打印了哪些设计：
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)

8.4.2 禁止函数修改列表
有时候，需要禁止函数修改列表。你可能会做出这样的决定：即便打印所有设计后，也要保留原来的未打印的设计列表，以供备案。
为解决这个问题，可向函数传递列表的副本而不是原件；
8.5 传递任意数量的实参
Python允许函数从调用语句中收集任意数量的实参。
形参名*toppings中的星号让Python创建一个名为toppings的空元组，并将收到的所有值都封装到这个元组中。

def make_pizza(*toppings):
    """打印顾客点的所有配料"""
    print(toppings)

make_pizza('pepperoni')
make_pizza('mushrooms', 'green_peppers', 'exter_cheese')

#改进函数，加上循环

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

8.5.1 结合使用位置实参和任意位置实参
如果要让函数接受不同类型的实参，必须在函数定义中将接纳任意数量实参的形参放在最后。

def make_pizza (size,*toppings):
    """概述要制作的披萨"""
    print("\nMaking a " + str(size) +
          "-inch pizza with the following toppings: ")
    for topping in toppings:
        print("- " + topping)
make_pizza(16, 'pepperoni')
make_pizza(12, 'mushrooms', 'green peppers', 'extra cheese')

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

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_ptofile = build_profile('albert','einstein',
                             location = 'princetion',
                             field = 'physics' )
print(user_ptofile)

形参**user_info中的两个星号让Python创建一个名为user_info的空字典，并将收到的所
有名称—值对都封装到这个字典中。

8.6 将函数存储在模块中
将函数存储在被称为模块的独立文件中，再将模块导入到主程序中。
import语句允许在当前运行的程序文件中使用模块中的代码**
通过将函数存储在独立的文件中，可隐藏程序代码的细节，将重点放在程序的高层逻辑上。
8.6.1 导入整个模块
模块是扩展名为.py的文件，包含要导入到程序中的代码。
方法一：
要调用被导入的模块中的函数，可指定导入的模块的名称pizza和函数名make_pizza()，并用句点分隔它们。pizza.make_pizza((16, ‘pepperoni’)
建立pizza.py文件：

#创建一个包含函数make_pizza()的模块
def make_pizza(size,*toppings):
    """概述要制作的披萨"""
    print("\nMaking a " + str(size) +
          "-inch pizza with the following toppings: ")
    for topping in toppings:
        print("- " + topping)

再创建一个making_pizzas.py文件：

  import pizza

pizza.make_pizza(16,'pepperoni')
pizza.make_pizza(12,'mushrooms','green peppers','exter cheese')

这就是一种导入方法：只需编写一条import语句并在其中指定模块名，就可在程序中使用该模块中的所有函数。如果你使用这种import语句导入了名为module_name.py的整个模块，就可使用下面的语法来使用其中任何一个函数：
module_name.function_name()

8.6.2 导入特定的函数
8.6.3 使用as给函数指定别名
如果要导入的函数的名称可能与程序中现有的名称冲突，或者函数的名称太长，可指定简短而独一无二的别名——函数的另一个名称，类似于外号。
在导入的时候这么做。
下面给函数make_pizza()指定了别名mp()。这是在import语句中使用make_pizza as mp实现的，关键字as将函数重命名为你提供的别名：

from pizza import make_pizza as mp

mp(16,'pepperoni')
mp(12,'mushrooms','green peppers','exter cheese')

**

指定别名的通用语法如下：
from module_name import function_name as fn

**
8.6.4 使用as给模块指定别名

import pizza as p 
p.make_pizza(16, 'pepperoni') 
p.make_pizza(12, 'mushrooms', 'green peppers', 'extra cheese')

将pizza的别名指定为p，但该模块中所有函数的名称都没变。

给模块指定别名的通用语法如下：
import module_name as mn

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

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

import语句中的星号让Python将模块pizza中的每个函数都复制到这个程序文件中。
可通过名称调用函数，不需要使用句点表示法。使用并非自己编写的大型模块时，最好不要采用这种导入方法。
最佳的做法是，要么只导入你需要使用的函数，要么导入整个模块并使用句点表示法。

8.7 函数编写指南
1、给函数指定描述性名称，且只在其中使用小写字母和下划线。
2、每个函数都应包含简要地阐述其功能的注释，该注释应紧跟在函数定义后面，并采用文档字符串格式。
3、

给形参指定默认值时，等号两边不要有空格：
def function_name(parameter_0, parameter_1='default value') 
对于函数调用中的关键字实参，也应遵循这种约定：
function_name(value_0, parameter_1='value')

4、缩进

5、如果程序或模块包含多个函数，可使用两个空行将相邻的函数分开，这样将更容易知道前一个函数在什么地方结束，下一个函数从什么地方开始。
6、所有的import语句都应放在文件开头，唯一例外的情形是，在文件开头使用了注释来描述整个程序。