1 定義函式

def greet_user():
    """顯示簡單的問候語"""
    print("Hello!")
greet_user()

1. 第一行的程式碼行使用關鍵字def來告訴Python你要定義一個函式，這是函式定義。
2. 第二行的文字是被稱為文件字串
   （docstring）的註釋，描述了函式是做什麼的。
3. 程式碼行print(“Hello!”)是函式體內的唯一一行程式碼， greet_user()只做一項工作：
   列印Hello!
4. 要呼叫函式，可依次指定函式名以及用括號括起的必要資訊，如第四行所示。

1.1 向函式傳遞資訊

def greet_user(username)
 
:
    """顯示簡單的問候語"""
    print("Hello, " + username.title() + "!")
greet_user('jesse')

通過在這裡新增username，
就可讓函式接受你給username指定的任何值。

2 傳遞實參

2.1 位置實參

你呼叫函式時，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('hamster', 'harry')

呼叫describe_pet()時，需要按順序提供一種動物型別和一個名字。例如，在前面的函式呼叫中，實參’hamster’儲存在形參animal_type中，而實參’harry’儲存在形參pet_name中。
注意：位置實參的順序很重要，請確認函式呼叫中實參的順序與函式定義中形參的順序一致。

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

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

這裡修改了函式describe_pet()的定義，在其中給形參animal_type指定了預設值’dog’。這
樣，呼叫這個函式時，如果沒有給animal_type指定值， Python將把這個形參設定為’dog’：

I have a dog.
My dog's name is Willie

注意：Python依然將這個實參視為位置實參，因此如果函式呼叫中只包含寵物的名字，這個實參將關聯到函式定義中的第一個形參。這就是需要將pet_name放在形參列表開頭的原因所在。

3 返回值

在函式中，可使用return語句將值返回到呼叫函式的程式碼行。

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)

結果：

Jimi Hendrix

函式可返回任何型別的值，包括==列表==和==字典==等較複雜的資料結構。

4 傳遞列表

def greet_users(names):
    """向列表中的每位使用者都發出簡單的問候"""
    for name in names:
        msg = "Hello, " + name.title() + "!"
        print(msg)

usernames = ['hannah', 'ty', 'margot']
greet_users(usernames)

結果：

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

4.1 在函式中修改列表

將列表傳遞給函式後，函式就可對其進行修改。在函式中對這個列表所做的任何修改都是永久性的，這讓你能夠高效地處理大量的資料。

4.2 禁止函式修改列表

為解決這個問題，可向函式傳
遞列表的副本而不是原件；這樣函式所做的任何修改都隻影響副本，而絲毫不影響原件。
要將列表的副本傳遞給函式，可以像下面這樣做：

function_name(list_name[:])

5 傳遞任意數量的實參

def make_pizza(*toppings):
    """列印顧客點的所有配料"""
    print(toppings)

make_pizza('pepperoni')
make_pizza('mushrooms', 'green peppers', 'extra cheese')

形參名*toppings中的星號讓Python建立一個名為toppings的空元組，並將收到的所有值都封裝到這個==元組==中。

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

結果：

Making a 16-inch pizza with the following toppings:
- pepperoni
Making a 12-inch pizza with the following toppings:
- mushrooms
- green peppers
- extra cheese

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_profile = build_profile('albert', 'einstein',location='princeton',field='physics')
print(user_profile)

形參**user_info中的兩個星號讓Python建立一個名為user_info的空字典，並將收到的所
有名稱—值對都封裝到這個字典中。在這個函式中，可以像訪問其他字典那樣訪問user_info中的名稱—值對。
結果：

{'first_name': 'albert', 'last_name': 'einstein',
'location': 'princeton', 'field': 'physics'}

6 將函式儲存在模組中

6.1 匯入整個模組

要讓函式是可匯入的，得先建立模組。模組是副檔名為.py的檔案，包含要匯入到程式中的程式碼。

pizza.py

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', 'extra cheese')

6.2 匯入特定的函式

making_pizzas2.py

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

若使用這種語法，呼叫函式時就無需使用句點。由於我們在import語句中顯式地匯入了函式
make_pizza()，因此呼叫它時只需指定其名稱。

6.3 使用 as 給函式指定別名

making_pizzas3.py

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

6.4 使用 as 給模組指定別名

making_pizzas4.py

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

6.5 匯入模組中的所有函式（不建議）

使用星號（*）運算子可讓Python匯入模組中的所有函式：
making_pizzas5.py

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

如果模組中有函式的名稱與你的專案中使用的名稱相同，可能導致意想不到的結果：Python可能遇到多個名稱相同的函式或變數，進而覆蓋函式，而不是分別匯入所有的函式。

7 函式編寫指南

1. 每個函式都應包含簡要地闡述其功能的註釋，該註釋應緊跟在函式定義後面，並採用文件字串格式；
2. 給形參指定預設值時，等號兩邊不要有空格；
3. 如果程式或模組包含多個函式，可使用兩個空行將相鄰的函式分開;
4. 所有的import語句都應放在檔案開頭，唯一例外的情形是，在檔案開頭使用了註釋來描述整個程式.