# 8.1 定义函数
# 8.1.1 向函数传递信息
# 下面是一个打印问候的简单函数，名为great_user():
'''
def greet_user(username): # 代码行使用关键字def来告诉Python你要定义一个函数。这是函数定义。
""" 显示简单的问候语""" # 文本是被称为文档字符串的注释，描述了函数是做什么的。文档字符串用三引号括起来，Python使用它们来生成有关程序中函数的文档。
print("Hello, " + username.title() + "!")
greet_user('jesse') #函数调用 函数调用 让Python执行函数的代码。要调用 调用 函数，可依次指定函数名以及用括号括起的必要信息
'''
# 8.1.2 实参和形参
# 在函数greet_user() 的定义中，变量username 是一个形参 形参 ——函数完成其工作所需的一项信息。在代码greet_user('jesse') 中，值'jesse' 是一个实参 实参 。实参是 调用函数时传递给函数的信息。我们调用函数时，将要让函数使用的信息放在括号内
# 注意 大家有时候会形参、实参不分，因此如果你看到有人将函数定义中的变量称为实参或将函数调用中的变量称为形参，不要大惊小怪。
# 8.2 传递参数
# 鉴于函数定义可能包含多个形参，因此函数调用中也可能包含多个实参。向函数传递实参的方式很多，可使用位置实参，这要求实参的顺序与形参相同；也可使用关键字实参，其中每个实参都由变量名和值组成；还可使用列表和字典。下面来依次介绍这些方式：
# 8.2.1 位置实参
# 你调用函数时，Python必须将函数调用中的每个实参都关联到函数定义中的一个形参。为此，最简单的关联方式是基于实参顺序。这种关联方式被称为位置实参。
# pets.py
'''
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')
# 1, 调用函数多次
# 你可以根据需要调用函数任意次。要再描述一个宠物，只需再次调用describe_pet() 即可：
describe_pet('dog', 'willie')
'''
# 在函数中，可根据需要使用任意数量的位置实参，Python将按顺序将函数调用中的实参关联到函数定义中相应的形参。
# 2.位置实参的顺序很重要。
# 使用位置实参来调用函数时，如果实参的顺序不正确，结果可能出乎意料：
# 8.2.2 关键字实参
# 关键字实参是传递函数的名称——值对。你直接在实参中将名称和值关联起来了，因此向函数传递时不会混淆。关键字实参让你无需考虑函数调用中的实参顺序，还清楚地指出了函数调用中各个值的用途。
# 关键字实参顺序无关紧要，因为Python 知道各个值该存储到哪个形参中。下面两个函数是等效的：
'''
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')
describe_pet(pet_name='harry', animal_type='hamster')
'''
# 8.2.3 默认值
# 编写函数时，可给每个形参指定默认值。在调用函数中给形参提供了实参时，
# 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='willie')
'''
# 注意 使用默认值时，在形参列表中必须先列出没有默认值的形参，再列出有默认值的实参。这让Python依然能够正确地解读位置实参。
# 8.2.4 等效的函数调用
# 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('Maxwell','Pan')
print(musician)
'''
'''
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('Maxwell', 'Pan')
print(musician)
musician = get_formatted_name('Maxwell', 'Pan', 'catecorne')
print(musician)
'''
# 8.3.3 返回字典
# 函数可返回任何类型的值，包括列表和字典等较复杂的数据结构。
'''
def build_person(first_name, last_name):
"""返回一个字典，其中包含有关一个人的信息"""
person = {'first': first_name, 'last': last_name}
return person
musician = build_person('Maxwell', 'Pan')
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('Maxwell', 'Pan', age = 28)
print(musician)
'''
# 在函数定义中，我们新增了一个可选形参age，并将其默认值设置为空字符串。如果函数调用中包含这个形参的值，这个值将存储到字典中。 在任何情况下， 这个函数都会存储人的姓名，但可对其中进行修改，使其也存储有关人的其他信息。
# 8.3.4 结合使用函数和while 循环
'''
def get_formatted_name(first_name,last_name):
"""返回整洁的姓名"""
full_name = first_name + ' ' + last_name
return full_name.title()
# 这是一个无限循环！
while True:
print("\n Please tell me your name: ")
f_name = input("First name:")
l_name = input("Last name:")
formatted_name = get_formatted_name(f_name, l_name)
print("\nHello, " + formatted_name + "!")
'''
'''
def get_formatted_name(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_name(f_name,l_name)
print("\nHello, " + formatted_name + "!")
'''
# 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)
unprint_designs = ['iphone case', 'robot pendant', 'dodecahedron']
completed_models = []
print_models(unprint_designs, completed_models)
show_completed_models(completed_models)
'''
# 8.4.2 禁止函数修改列表
# 有时候，需要禁止函数修改列表。例如，假设像前一个示例那样，
# 你有一个未打印的设计列表，并编写了一个将这些设计移到打印好的模型列表中的函数。
# 你可能会做出这样的 决定：即便打印所有设计后，也要保留原来的未打印的设计列表，以供备案。
# 但由于你将所有的设计都移出了unprinted_designs ，这个列表变成了空的，原来的列表没有 了。
# 为解决这个问题，可向函数传递列表的副本而不是原件；
# 这样函数所做的任何修改都只影响副本，而丝毫不影响原件
# 要将列表的副本传递给函数，可以像下面这样做：
# function_name(list_name[:])
# 切片表示法[:] 创建列表的副本。在print_models.py中，如果不想清空未打印的设计列表，可像下面这样调用print_models() ：
# print_models(unprinted_designs[:], completed_models)
# 8.5 传递任意数量的实参
# 有时候，你预先不知道函数需要接受多少个实参，好在Python允许函数从调用语句中收集任意数量的实参。
# 例如，来看一个制作比萨的函数，它需要接受很多配料，但你无法预先确定顾客要多少种配料。
# 下面的函数只有一个形参*toppings ，但不管调用语句提供了多少实参，这个 形参都将它们统统收入囊中：
'''
def make_pizza(*toppings):
"""打印顾客点所有配料"""
print(toppings)
make_pizza('pepperoni')
make_pizza('mushrooms', 'green peppers', 'extra cheese')
'''
# 形参名*toppings 中的星号让Python创建一个名为toppings 的空元组，并将收到的所有值都封装到这个元组中。
# 函数体内的print 语句通过生成输出来证明Python能够处理 使用一个值调用函数的情形，也能处理使用三个值来调用函数的情形。
# 它以类似的方式处理不同的调用，注意，Python将实参封装到一个元组中，即便函数只收到一个值也如此：
# 现在，我们可以将这条print语句替换为一个循环，对配料列表进行遍历，并对顾客点的比萨进行描述：
'''
def make_pizza(*toppings):
"""概述要制作的比萨"""
print("\n Making a pizza with the following toppings:")
for topping in toppings:
print("-" + topping)
make_pizza('pepperoni')
make_pizza('mushrooms', 'green peppers', 'extra cheese')
'''
# 8.5.1 结合使用位置实参和任意数量实参
# 如果要让函数接受不同类型的实参，必须在函数定义中将接纳任意数量实参的形参放在最后。Python先匹配位置实参和关键字实参，再将余下的实参都收集到最后一个形参中。
# 例如，如果前面的函数还需要一个表示比萨尺寸的实参，必须将该形参*toppings 的前面：
'''
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 使用任意数量的关键字实参
# 有时候，需要接受任意数量的实参，但预先不知道传递给函数的会是什么样的信息。
# 在这种情况下，可将函数编写成能够接受任意数量的键—值对——调用语句提供了多少就接 受多少。
# 一个这样的示例是创建用户简介：你知道你将收到有关用户的信息，但不确定会是什么样的信息。
# 在下面的示例中，函数build_profile() 接受名和姓，同时还接受 任意数量的关键字实参
'''
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', filed= 'phisics')
print(user_profile)
'''
# 8.6 将函数存储在模块中
# 函数的优点之一是，使用它们可将代码块与主程序分离。
# 通过给函数指定描述性名称，可让程序容易理解得多。
# 你还可以更进一步，将函数存储在被称为模块的独立文件中。
# 再将模块导入到主程序中。import语句允许在当前
# 运行的程序文件中使用模块中的代码。
# 通过将函数存储在独立的文件中，可隐藏程序代码的细节，将重点放在程序的高层逻辑上。
# 这还能让你在众多不同的程序中重用函数。将函数存储在独立文件中后，
# 可与其他程 序员共享这些文件而不是整个程序。知道如何导入函数还能让你使用其他程序员编写的函数库。
# 导入模块的方法有多种，下面对每种都作简要的介绍。
# 8.6.1 导入整个模块
# 要让函数是可导的，得先创建模块。模块是扩展名为.py的文件，包含要导入到程序中的代码。
# 下面来创建一个包含函数make_pizza()的模块。为此，我们将文件pizza.py中除函数make_pizza()之外的其他代码都删除。
'''
pizza.py
def make_pizza(size, *toppings):
"""概述要制作的比萨"""
print("\nMaking a " + str(size) + "-inch pizza with the following toppings:")
for topping in toppings:
print("-" + topping)
'''
'''
import pizza
pizza.make_pizza(16, 'pepperoni')
pizza.make_pizza(12, 'mushrooms', 'green peppers', 'extra cheese')
'''
# 8.6.2 导入特定的函数
# 你还可以导入模块中的特定函数，这种导入方法的语法如下
# from module_name import function_name
# 通过用逗号分隔函数名，可根据需要从模块中导入任意数量的函数：
# from module_name import function_0, function_1, function_2
'''
from pizza import make_pizza
make_pizza(16, 'pepperoni')
make_pizza(12, 'mushrooms', 'green peppers', 'extra cheese')
'''
# 若使用这种语法，调用函数时就无需使用句点。由于我们在import 语句中显式地导入了函数make_pizza() ，因此调用它时只需指定其名称。
'''
from pizza import make_pizza as mp
mp(16, 'pepperoni')
mp(12, 'mushrooms', 'green peppers', 'extra cheese')
'''
# 指定别名的通用语法如下
# from module_name import function_name as fn
# 8.6.4 使用 使用as 给模块指定别名 给模块指定别
# 你还可以给模块指定别名。通过给模块指定简短的别名（如给模块pizza 指定别名p ），
# 让你能够更轻松地调用模块中的函数。相比于pizza.make_pizza() ，p.make_pizza() 更为简洁：
'''
import pizza as p
p.make_pizza(16, 'pepperoni')
p.make_pizza(12, 'mushrooms', 'green peppers', 'extra cheese')
'''
# 给模块指定别名的通用语法如下
# 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 中的每个函数都复制到这个程序文件中。
# 由于导入了每个函数，可通过名称来调用每个函数，而无需使用句点表示法。
# 然而，使用 并非自己编写的大型模块时，最好不要采用这种导入方法：
# 如果模块中有函数的名称与你的项目中使用的名称相同，可能导致意想不到的结果：
# Python可能遇到多个名称相同的函 数或变量，进而覆盖函数，而不是分别导入所有的函数。
# 最佳的做法是，要么只导入你需要使用的函数，要么导入整个模块并使用句点表示法。
# 这能让代码更清晰，更容易阅读和理解。这里之所以介绍这种导入方法，
# 只是想让你在阅 读别人编写的代码时，如果遇到类似于下面的import 语句，能够理解它们:
'''
from module_name import *
'''
# 8.7 函数编写指南
# 编写函数时，需要牢记几个细节。应给函数指定描述性名称，且只在其中使用小写字母和下划线。描述性名称可帮助你和别人明白代码想要做什么。给模块命名时也应遵循上述约定。
# 每个函数都应包含简要地阐述其功能的注释，该注释应紧跟在函数定义后面，并采用文档字符串格式。
# 文档良好的函数让其他程序员只需阅读文档字符串中的描述就能够使用 它：他们完全可以相信代码如描述的那样运行；
# 只要知道函数的名称、需要的实参以及返回值的类型，就能在自己的程序中使用它
# 给形参指定默认值时，等号两边不要有空格：
# def function_name(parameter_0, parameter_1='default value')
# 对于函数调用中的关键字实参，也应遵循这种约定
# function_name(value_0, parameter_1='value')
# PEP 8（https://www.python.org/dev/peps/pep-0008/ ）建议代码行的长度不要超过79字符，
# 这样只要编辑器窗口适中，就能看到整行代码。如果形参很多，导致函数定义的长度超过了 79字符，
# 可在函数定义中输入左括号后按回车键，并在下一行按两次Tab键，从而将形参列表和只缩进一层的函数体区分开来。
# 大多数编辑器都会自动对齐后续参数列表行，使其缩进程度与你给第一个参数列表行指定的缩进程度相同：
def function_name(
parameter_0, parameter_1, parameter_2,
parameter_3, parameter_4, parameter_5):
function body...
# 如果程序或模块包含多个函数，可使用两个空行将相邻的函数分开，
# 这样将更容易知道前一个函数在什么地方结束，下一个函数从什么地方开始。
# 所有的import 语句都应放在文件开头，唯一例外的情形是，在文件开头使用了注释来描述整个程序
# 8.8 小结
# 在本章中，你学习了：如何编写函数，以及如何传递实参，让函数能够访问完成其工作所需的信息；
# 如何使用位置实参和关键字实参，以及如何接受任意数量的实参；显示输出 的函数和返回值的函数；
# 如何将函数同列表、字典、if 语句和while 循环结合起来使用。
# 你还知道了如何将函数存储在被称为模块 模块 的独立文件中，让程序文件更简单、更易于 理解。
# 最后，你学习了函数编写指南，遵循这些指南可让程序始终结构良好，并对你和其他人来说易于阅读。
# 程序员的目标之一是，编写简单的代码来完成任务，而函数有助于你实现这样的目标。
# 它们让你编写好代码块并确定其能够正确运行后，就可置之不理。确定函数能够正确地完 成其工作后，你就可以接着投身于下一个编码任务。
# 函数让你编写代码一次后，想重用它们多少次就重用多少次。需要运行函数中的代码时，只需编写一行函数调用代码，就可让函数完成其工作。
# 需要修改函数的行为时，只需修 改一个代码块，而所做的修改将影响调用这个函数的每个地方。
# 使用函数让程序更容易阅读，而良好的函数名概述了程序各个部分的作用。相对于阅读一系列的代码块，阅读一系列函数调用让你能够更快地明白程序的作用。
# 函数还让代码更容易测试和调试。如果程序使用一系列的函数来完成其任务，而其中的每个函数都完成一项具体的工作，
# 测试和维护起来将容易得多：你可编写分别调用每个函 数的程序，并测试每个函数是否在它可能遇到的各种情形下都能正确地运行。
# 经过这样的测试后你就能信心满满，深信你每次调用这些函数时，它们都将正确地运行。
# 8-1 消息 消息 ：编写一个名为display_message() 的函数，它打印一个句子，指出你在本章学的是什么。调用这个函数，确认显示的消息正确无误
'''
def display_message(username):
"""本章学习函数"""
print(username.title() + " 在本章学习函数")
display_message('MAXWELL')
'''
# 8-2 喜欢的图书 喜欢的图书 ：编写一个名为favorite_book() 的函数，
# 其中包含一个名为title 的形参。这个函数打印一条消息，
# 如One of my favorite books is Alice in Wonderland 。
# 调用这个函数，并将一本图书的名称作为实参传递给它。
'''
def favorite_book(bookname):
print('One of my favorite books is '+ bookname.title())
favorite_book("Harry Potter")
'''
# 8-3 T恤 恤 ：编写一个名为make_shirt() 的函数，它接受一个尺码以及要印到T恤上的字样。这个函数应打印一个句子，概要地说明T恤的尺码和字样
'''
def make_shirt(size_to, sample_to):
print("This is belong to your size: %s"%size_to)
print("This is belong to your sample: %s"%sample_to)
make_shirt(30, 'blue')
'''
# 8-4 大号 大号T恤 恤 ：修改函数make_shirt() ，
# 使其在默认情况下制作一件印有字样“I love Python”的大号T恤。
# 调用这个函数来制作如下T恤：一件印有默认字样的大号T 恤、
# 一件印有默认字样的中号T恤和一件印有其他字样的T恤（尺码无关紧要）。
'''
def make_shirt(size_to, sample_to ='I love Python'):
print("This is belong to your size: %s"%size_to)
print("This is belong to your sample: %s"%sample_to)
make_shirt(60)
make_shirt(40, 'google')
'''
# 8-5 城市 城市 ：编写一个名为describe_city() 的函数，
# 它接受一座城市的名字以及该城市所属的国家。
# 这个函数应打印一个简单的句子，如Reykjavik is in Iceland 。
# 给用于存储国家的形参指定默认值。
# 为三座不同的城市调用这个函数，且其中至少有一座城市不属于默认国家
'''
def describe_city(city_name, country_name = 'China'):
print("%s" % city_name + " is in %s" % country_name + ".")
describe_city(city_name='SuZhou')
describe_city(city_name='HangZhou',country_name="China")
describe_city(city_name='Toyko', country_name='Japan')
'''
# 8-6 城市名 城市名 ：编写一个名为city_country() 的函数，
# 它接受城市的名称及其所属的国家。这个函数应返回一个格式类似于下面这样的字符串
'''
def city_country(city_name,country_name):
print("%s, " % city_name.title() + "%s" % country_name)
city_country('xuancheng', 'China')
city_country('suzhou', 'China')
city_country('dongjing', 'Japan')
'''
========pizza.py===============================================================================
def make_pizza(size, *toppings):
"""概述要制作的比萨"""
print("\nMaking a " + str(size) + "-inch pizza with the following toppings:")
for topping in toppings:
print("-" + topping)
==========================================================================
