第十九节 函数2

8.3 返回值

函数并非总是直接显示输出，它还可以处理一些数据，并返回一个或一组值。函数返回的值称为返回值 。在函数中，可使用return语句将值返回到调用函数的代码行。返回值让你能够将程序的大部分繁重工作移到函数中去完成，从而简化主程序。

8.3.1 返回简单值

下面来看一个函数，它接受名和姓并返回整洁的姓名：

formatted_name.py

def get_formatted_name(first_name, last_name):❶
    """返回整洁的姓名。"""
    full_name = f"{first_name} {last_name}"❷
    return full_name.title()❸    
musician = get_formatted_name('jimi', 'hendrix')❹
print(musician)

函数get_formatted_name()的定义通过形参接受名和姓（见❶）。它将姓和名合而为一，在中间加上一个空格，并将结果赋给变量full_name（见❷）。然后， 将full_name的值转换为首字母大写格式，并将结果返回到函数调用行（见❸）。

调用返回值的函数时，需要提供一个变量，以便将返回的值赋给它。在这里，将返回值赋给了变量musician（见❹）。输出为整洁的姓名：

Jimi Hendrix

原本只需编写下面的代码就可输出整洁的姓名，相比于此，前面做的工作好像太多了：

print("Jimi Hendrix")

但在需要分别存储大量名和姓的大型程序中，像get_formatted_name()这样的函数非常有用。可以分别存储名和姓，每当需要显示姓名时都调用这个函数。

8.3.2 让实参变成可选的

有时候，需要让实参变成可选的，这样使用函数的人就能只在必要时提供额外的信 息。可使用默认值来让实参变成可选的。

例如，假设要扩展函数get_formatted_name() ，使其同时处理中间名。为此， 可将其修改成类似于下面这样：

def get_formatted_name(first_name, middle_name,last_name):
    """返回整洁的姓名。"""
    full_name = f"{first_name} {middle_name} {last_name}"
    return full_name.title()
    
musician = get_formatted_name('john', 'lee', 'hooker')
print(musician)

只要同时提供名、中间名和姓，这个函数就能正确运行。它根据这三部分创建一个 字符串，在适当的地方加上空格，并将结果转换为首字母大写格式：

John Lee Hooker

并非所有的人都有中间名，但如果调用这个函数时只提供了名和姓，它将不能正确运行。为了让中间名变成可选的，可给形参middle_name 指定一个空的默认值， 并在用户没有提供中间名时不使用这个形参。为让get_formatted_name() 在没有提供中间名时依然可行，可将形参middle_name 的默认值设置为空字符串，并将其移到形参列表的末尾：

def get_formatted_name(first_name,last_name, middle_name = " "):❶
    """返回整洁的姓名。"""
    if middle_name: ❷
        full_name = f"{first_name} {middle_name} {last_name}"
    else: ❸
        full_name = f"{first_name} {last_name}"
    return full_name.title()
    
musician = get_formatted_name('jimi', 'hendrix')
print(musician)
musician = get_formatted_name('john', 'hooker', 'lee') ❹
print(musician)

在本例中，姓名是根据三个可能提供的部分创建的。由于人都有名和姓，因此在函数定义中首先列出了这两个形参。中间名是可选的，因此在函数定义中最后列出该形参，并将其默认值设置为空字符串（见❶）。

在函数体中，检查是否提供了中间名。Python将非空字符串解读为True ，因此如果函数调用中提供了中间名，if middle_name 将为True（见❷）。如果提供了中间名，就将名、中间名和姓合并为姓名，再将其修改为首字母大写格式，并返回到函数调用行。在函数调用行，将返回的值赋给变量musician，然后这个变量的值被打印出来。如果没有提供中间名，middle_name 将为空字符串，导致if测试未通过，进而执行else代码块（见❸）：只使用名和姓来生成姓名，并将格式设置好的姓名返回给函数调用行。在函数调用行，将返回的值赋给变量musician ，然后这个变量的值被打印出来。

调用这个函数时，如果只想指定名和姓，调用起来将非常简单。如果还要指定中间名，就必须确保它是最后一个实参，这样Python才能正确地将位置实参关联到形参（见❹）。

这个修改后的版本不仅适用于只有名和姓的人，而且适用于还有中间名的人：

Jimi   Hendrix
John Lee Hooker

可选值让函数能够处理各种不同的情形，同时确保函数调用尽可能简单。

8.3.3 返回字典

函数可返回任何类型的值，包括列表和字典等较复杂的数据结构。例如，下面的函数接受姓名的组成部分，并返回一个表示人的字典：

person.py

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

musician = build_person('jimi', 'hendrix')
print(musician) ❸

函数build_person() 接受名和姓，并将这些值放到字典中（见❶）。存储first_name 的值时，使用的键为'first' ，而存储last_name 的值时，使用的键为'last' 。最后，返回表示人的整个字典（见❷）。在❸处，打印这个返回的值，此时原来的两项文本信息存储在一个字典中：

{'first': 'jimi', 'last': 'hendrix'}

这个函数接受简单的文本信息，并将其放在一个更合适的数据结构中，让你不仅能打印这些信息，还能以其他方式处理它们。当前，字符串'jimi' 和'hendrix' 被标记为名和姓。你可以轻松地扩展这个函数，使其接受可选值，如中间名、年   龄、职业或其他任何要存储的信息。例如，下面的修改让你能存储年龄：

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

musician = build_person('jimi', 'hendrix',age = 27)
print(musician)

在函数定义中，新增了一个可选形参age ，并将其默认值设置为特殊值None （表示变量没有值）。可将None 视为占位值。在条件测试中，None 相当于False 。如果函数调用中包含形参age 的值，这个值将被存储到字典中。在任何情况下，这个函数都会存储人的姓名，但可进行修改，使其同时存储有关人的其他信息。

8.3.4 结合使用函数和while 循环

可将函数同本书前面介绍的任何Python结构结合起来使用。例如，下面将结合使用 函数get_formatted_name() 和while 循环，以更正式的方式问候用户。下面尝试使用名和姓跟用户打招呼：

formatted_name.py

def get_formatted_name(first_name, last_name):
    """返回整洁的姓名。"""
    full_name = f"{first_name} {last_name}"
    return full_name.title()
# 这是一个无限循环！
while True:
    print("\nPlease tell me your name:")❶
    f_name = input("First name: ")
    l_name = input("Last name: ")
    
    formatted_name = get_formatted_name(f_name, l_name)
    print(f"\nHello, {formatted_name}!")

在本例中，使用的是get_formatted_name() 的简单版本，不涉及中间名。while 循环让用户输入姓名：依次提示用户输入名和姓（见❶）。

但这个while 循环存在一个问题：没有定义退出条件。请用户提供一系列输入时， 该在什么地方提供退出途径呢？要让用户能够尽可能容易地退出，因此每次提示用  户输入时，都应提供退出途径。每次提示用户输入时，都使用break 语句提供退出循环的简单途径：

def get_formatted_name(first_name, last_name):
    """返回整洁的姓名。"""
    full_name = f"{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(f"\nHello, {formatted_name}!")

我们添加了一条消息来告诉用户如何退出，然后在每次提示用户输入时，都检查他输入的是否是退出值。如果是，就退出循环。现在，这个程序将不断地问候，直到用户输入的姓或名为'q' ：

Please tell me your name:
(enter 'q' at any time to quit)
First name: yd
Last name: sun

Hello, Yd Sun!

Please tell me your name:
(enter 'q' at any time to quit)
First name: q
>>> 

动手试一试

练习8-6：城市名

编写一个名为city_country() 的函数，它接受城市的名称及其所属的国家。这个函数应返回一个格式类似于下面的字符串：

"Santiago, Chile"

至少使用三个城市国家对来调用这个函数，并打印它返回的值。

def city_country(city,country):
    result = f"{city.title()},{country.title()}"
    return result
message = city_country('santiago','chile')
print(message)

练习8-7：专辑

编写一个名为make_album() 的函数，它创建一个描述音乐专辑的字典。这个函数应接受歌手的名字和专辑名，并返回一个包含这两项信息的字典。使用这个函数创建三个表示不同专辑的字典，并打印每个返回的值，以核实字典正确地存储了专辑的信息。

def make_album(singer,song):
    album = {'singer':singer,'song':song}
    return album
album1 = make_album('周杰伦','七里香')
print(album1)

给函数make_album() 添加一个默认值为None 的可选形参，以便存储专辑包含的歌曲数。如果调用这个函数时指定了歌曲数，就将该值添加到表示专辑的  字典中。调用这个函数，并至少在一次调用中指定专辑包含的歌曲数。

def make_album(singer,song,num = None):
    album = {'singer':singer,'song':song}
    if num:
        album['num'] = num
    return album
album1 = make_album('周杰伦','七里香')
print(album1)
album2 = make_album('孙燕姿','绿光',8)
print(album2)

练习8-8：用户的专辑

在为完成练习8-7编写的程序中，编写一个while 循环，让用户输入专辑的歌手和名称。获取这些信息后，使用它们来调用函数make_album() 并将创建的字典打印出来。在这个while 循环中，务必提供退出途径。

def make_album(singer,song,num = None):
    album = {'singer':singer,'song':song}
    if num:
        album['num'] = num
    return album
while True:
    singer1 = input("请输入歌手名字(输入‘q’退出)：")
    if singer1 == 'q':
        break
    song1 = input("请输入专辑名字(输入‘q’退出)：")
    if song1 == 'q':
        break
    album1 = make_album(singer1,song1)
    print(album1)

8.4 传递列表

你经常会发现，向函数传递列表很有用，其中包含的可能是名字、数或更复杂的对 象（如字典）。将列表传递给函数后，函数就能直接访问其内容。下面使用函数来 提高处理列表的效率。

假设有一个用户列表，我们要问候其中的每位用户。下面的示例将包含名字的列表 传递给一个名为greet_users() 的函数，这个函数问候列表中的每个人：

greet_users.py

def greet_users(names):
    """向列表中的每位用户发出简单的问候。"""
    for name in names:
        msg = f"Hello, {name.title()}!"
        print(msg)
usernames = ['hannah', 'ty', 'margot']
greet_users(usernames)

我们将greet_users()定义为接受一个名字列表，并将其赋给形参names。这个函数遍历收到的列表，并对其中的每位用户打印一条问候语。❶处定义了一个用户列表usernames ，然后调用greet_users() 并将该列表传递给它：

Hello, Hannah!
Hello, Ty!
Hello, Margot!

输出完全符合预期。每位用户都看到了一条个性化的问候语。每当需要问候一组用 户时，都可调用这个函数。

8.4.1 在函数中修改列表

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

来看一家为用户提交的设计制作3D打印模型的公司。需要打印的设计存储在一个列 表中，打印后将移到另一个列表中。下面是在不使用函数的情况下模拟这个过程的代码：

printing_models.py

# 首先创建一个列表，其中包含一些要打印的设计。
unprinted_designs = ['phone case', 'robot pendant', 'dodecahedron']
completed_models = []
# 模拟打印每个设计，直到没有未打印的设计为止。
# 打印每个设计后，都将其移到列表completed_models中。
while unprinted_designs:
    current_design = unprinted_designs.pop()
    print(f"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)

这个程序首先创建一个需要打印的设计列表，以及一个名为completed_models 的空列表，每个设计打印后都将移到其中。只要列表unprinted_designs 中还有设计，while  循环就模拟打印设计的过程：从该列表末尾删除一个设计，将其赋给变量current_design ，并显示一条消息指出正在打印当前的设计，然后将该设计加入到列表completed_models 中。循环结束后，显示已打印的所有设计：

Printing model: dodecahedron
Printing model: robot pendant
Printing model: phone case

The following models have been printed:
dodecahedron
robot pendant
phone case

为重新组织这些代码，可编写两个函数，每个都做一件具体的工作。大部分代码与原来相同，只是效率更高。第一个函数负责处理打印设计的工作，第二个概述打印 了哪些设计：

def print_models(unprinted_designs, completed_models):❶
    """
    模拟打印每个设计，直到没有未打印的设计为止。
    打印每个设计后，都将其移到列表completed_models中。
    """
    while unprinted_designs:
        current_design = unprinted_designs.pop()
        print(f"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 = ['phone case', 'robot pendant', 'dodecahedron']
completed_models = []

print_models(unprinted_designs, completed_models)
show_completed_models(completed_models)
❶处定义了函数print_models() ，它包含两个形参：一个需要打印的设计列

❶处定义了函数print_models() ，它包含两个形参：一个需要打印的设计列表和一个打印好的模型列表。给定这两个列表，该函数模拟打印每个设计的过程：将设计逐个从未打印的设计列表中取出，并加入打印好的模型列表中。❷处定义了函数show_completed_models() ，它包含一个形参：打印好的模型列表。给定这个列表，函数show_completed_models() 显示打印出来的每个模型的名称。

这个程序的输出与未使用函数的版本相同，但组织更为有序。完成大部分工作的代 码都移到了两个函数中，让主程序更容易理解。只要看看主程序，就会发现这个程 序的功能清晰得多：

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

print_models(unprinted_designs, completed_models)
show_completed_models(completed_models)

我们创建了一个未打印的设计列表，还创建了一个空列表，用于存储打印好的模型。接下来，由于已经定义了两个函数，只需调用它们并传入正确的实参即可。我 们调用print_models() 并向它传递两个列表。像预期一样，print_models() 模拟打印设计的过程。接下来，调用show_completed_models() ，并将打印好的模型列表传递给它，让其能够指出打印了哪些模型。描述性的函数名让别人阅读 这些代码时也能明白，尽管没有任何注释。

相比于没有使用函数的版本，这个程序更容易扩展和维护。如果以后需要打印其他 设计，只需再次调用print_models() 即可。如果发现需要对打印代码进行修改，只需修改这些代码一次，就能影响所有调用该函数的地方。与必须分别修改程 序的多个地方相比，这种修改的效率更高。

该程序还演示了这样一种理念：每个函数都应只负责一项具体的工作。第一个函数打印每个设计，第二个显示打印好的模型。这优于使用一个函数来完成这两项工作。编写函数时，如果发现它执行的任务太多，请尝试将这些代码划分到两个函数中。别忘了，总是可以在一个函数中调用另一个函数，这有助于将复杂的任务划分 成一系列步骤。

8.4.2 禁止函数修改列表

有时候，需要禁止函数修改列表。例如，假设像前一个示例那样，你有一个未打印的设计列表，并编写了一个函数将这些设计移到打印好的模型列表中。你可能会做出这样的决定：即便打印好了所有设计，也要保留原来的未打印的设计列表，以供备案。但由于你将所有的设计都移出了unprinted_designs ，这个列表变成了空的，原来的列表没有了。为解决这个问题，可向函数传递列表的副本而非原件。这样，函数所做的任何修改都只影响副本，而原件丝毫不受影响。

要将列表的副本传递给函数，可以像下面这样做：

function_name(list_name_[:])

切片表示法[:] 创建列表的副本。在printing_models.py中，如果不想清空未打印的设计列表，可像下面这样调用print_models() ：

print_models(unprinted_designs[:], completed_models)

这样函数print_models() 依然能够完成工作，因为它获得了所有未打印的设计的名称，但使用的是列表unprinted_designs 的副本，而不是列表unprinted_designs 本身。像以前一样，列表completed_models 也将包含打印好的模型的名称，但函数所做的修改不会影响到列表unprinted_designs 。

虽然向函数传递列表的副本可保留原始列表的内容，但除非有充分的理由，否则还 是应该将原始列表传递给函数。这是因为让函数使用现成的列表可避免花时间和内 存创建副本，从而提高效率，在处理大型列表时尤其如此。

动手试一试

练习8-9：消息

创建一个列表，其中包含一系列简短的文本消息。将该列表 传递给一个名为show_messages() 的函数，这个函数会打印列表中的每条文本消息。

messages = ['Hello','How are you','Nice to meet you']
def show_messages():
    for message in messages:
    print(message)
show_messages()

练习8-10：发送消息

在你为完成练习8-9而编写的程序中，编写一个名为send_messages() 的函数，将每条消息都打印出来并移到一个名为sent_messages 的列表中。调用函数send_messages() ，再将两个列表都打印出来，确认正确地移动了消息。

def send_messages(messages,sent_messages):
    while messages:
        current_message = messages.pop()
        sent_messages.append(current_message)
        print(current_message)
messages = ['Hello','How are you','Nice to meet you']
sent_messages = []
send_messages(messages,sent_messages)
print(messages,sent_messages)

练习8-11：消息归档

修改你为完成练习8-10而编写的程序，在调用函数send_messages() 时，向它传递消息列表的副本。调用函数send_messages() 后，将两个列表都打印出来，确认保留了原始列表中的消息。

def send_messages(messages,sent_messages):
    while messages:
        current_message = messages.pop()
        sent_messages.append(current_message)
        print(current_message)
messages = ['Hello','How are you','Nice to meet you']
sent_messages = []
send_messages(messages[:],sent_messages)
print(messages,sent_messages)