Python系列9-Python函数介绍

一.函数介绍

函数是带名字的代码块，用于完成具体的工作。
要执行函数定义的特定任务，可调用该函数。需要在程序中多次执行同一项任务时，你无需反复编写完成该任务的代码，而只需调用执行该任务的函数，让Python运行其中的代码。你将发现，通过使用函数，程序的编写、阅读、测试和修复都将更容易。

1.1 定义函数

列举一个欢迎的函数

代码:

def greet_user():
    """显示简单的问候语"""
    print("Hello!")

greet_user()

测试记录:

>>> def greet_user():
...     """显示简单的问候语"""
...     print("Hello!")
...
>>> greet_user()
Hello!
>>>

这个示例演示了最简单的函数结构。
第一行关键字def 来告诉Python你要定义一个函数，这是函数定义 ，向Python指出了函数名，还可能在括号内指出函数为完成其
任务需要什么样的信息。在这里，函数名为greet_user() ，它不需要任何信息就能完成其工作，因此括号是空的（即便如此，括号也必不可少）。最后，定义以冒号结尾。

第二行和第三行缩进的代码，就是函数具体要做的事情。
第二行文本是被称为文档字符串 （docstring）的注释，描述了函数是做什么的。文档字符串用三引号括起，Python使用它们来生成有关程序中函数的文档。
第三行是函数体内的唯一一行代码，greet_user() 只做一项工作：打印Hello!

要使用这个函数，可调用它。函数调用 让Python执行函数的代码。要调用函数，可依次指定函数名以及用括号括起的必要信息，如第四行所示。由于这个函数不需要任何信息，因此调用它时只需输入greet_user() 即可。和预期的一样，它打印Hello! 。

1.1.1 向函数传递信息

只需稍作修改，就可以让函数greet_user() 不仅向用户显示Hello! ，还将用户的名字用作抬头。为此，可在函数定义def greet_user() 的括号内添加username 。通过在这里添加username ，就可让函数接受你给username 指定的任何值。现在，这个函数要求你调用它时给username 指定一个值。调用greet_user() 时，可将一个名字传递给它。

代码:

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

greet_user('World')

测试记录:

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

1.1.2 实参和形参

前面定义函数greet_user() 时，要求给变量username 指定一个值。调用这个函数并提供这种信息（人名）时，它将打印相应的问候语。

在函数greet_user() 的定义中，变量username 是一个形参 ——函数完成其工作所需的一项信息。在代码greet_user(‘World’) 中，值’World’ 是一个实参 。实参是调用函数时传递给函数的信息。我们调用函数时，将要让函数使用的信息放在括号内。在greet_user(‘World’) 中，将实参’World’ 传递给了函数greet_user() ，这个值被存储在形参username 中。

1.2 传递实参

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

1.2.1 位置实参

你调用函数时，Python必须将函数调用中的每个实参都关联到函数定义中的一个形参。为此，最简单的关联方式是基于实参的顺序。这种关联方式被称为位置实参 。

现在有一个需求，输入数据库及排名，然后再进行输出

代码:

def db_rank(db_name,rank):
    print("You selected database is "+ db_name + ";")
    print("Database "+ db_name + " rank is "+ str(rank) + ";")

db_rank('Oracle',1)

测试记录:

>>> def db_rank(db_name,rank):
...     print("You selected database is "+ db_name + ";")
...     print("Database "+ db_name + " rank is "+ str(rank) + ";")
...
>>> db_rank('Oracle',1)
You selected database is Oracle;
Database Oracle rank is 1;
>>>

函数定义后，可以多次调用函数
代码:

db_rank('MySQL',2)
db_rank('SQL Server',3)

测试记录:

>>> db_rank('MySQL',2)
You selected database is MySQL;
Database MySQL rank is 2;
>>> db_rank('SQL Server',3)
You selected database is SQL Server;
Database SQL Server rank is 3;
>>>

1.2.2 关键字实参

位置实参对于参数较多的情况下，需要根据函数定义的形参的顺序传入实参，如果顺序错误，会导致一些不必要的错误，此时可以考虑使用关键字实参。

关键字实参 是传递给函数的名称-值对。你直接在实参中将名称和值关联起来了，因此向函数传递实参时不会混淆（不会得到名为Hamster的harry这样的结果）。关键字实参让你无需考虑函数调用中的实参顺序，还清楚地指出了函数调用中各个值的用途。

代码:

def db_rank(db_name,rank):
    print("\nYou selected database is "+ db_name + ";")
    print("\nDatabase "+ db_name + " rank is "+ str(rank) + ";")

db_rank(db_name = 'Oracle' , rank = 1 )

测试记录:

>>> def db_rank(db_name,rank):
...     print("\nYou selected database is "+ db_name + ";")
...     print("\nDatabase "+ db_name + " rank is "+ str(rank) + ";")
...
>>> db_rank(db_name = 'Oracle' , rank = 1 )

You selected database is Oracle;

Database Oracle rank is 1;
>>>

1.2.3 默认值

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

例如，如果不知道输入数据库的默认值，可以给一个默认值’Unknown’

代码:

def db_rank(db_name,rank='Unknown'):
    print("\nYou selected database is "+ db_name + ";")
    print("\nDatabase "+ db_name + " rank is "+ str(rank) + ";")

db_rank('Oracle')
db_rank(db_name = 'Oracle'  )

测试记录:

>>> def db_rank(db_name,rank='Unknown'):
...     print("\nYou selected database is "+ db_name + ";")
...     print("\nDatabase "+ db_name + " rank is "+ str(rank) + ";")
...
>>> db_rank('Oracle')

You selected database is Oracle;

Database Oracle rank is Unknown;
>>> db_rank(db_name = 'Oracle'  )

You selected database is Oracle;

Database Oracle rank is Unknown;
>>>

1.3 返回值

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

1.3.1 返回简单值

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

代码:

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

formatted_name = get_formatted_name('bill', 'gates')
print(formatted_name)

测试记录:

>>> def get_formatted_name(first_name, last_name):
...     """返回整洁的姓名"""
...     full_name = first_name + ' ' + last_name
...     return full_name.title()
...
>>> formatted_name = get_formatted_name('bill', 'gates')
>>> print(formatted_name)
Bill Gates
>>>

1.3.3 让实参变成可选的

有时候，需要让实参变成可选的，这样使用函数的人就只需在必要时才提供额外的信息。可使用默认值来让实参变成可选的。
例如，假设我们要扩展函数get_formatted_name() ，使其还处理中间名。为此，可将其修改成类似于下面这样。

代码:

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

formatted_name = get_formatted_name('bill', 'gates','no.1')
print(formatted_name)

测试记录:

>>> def get_formatted_name(first_name, middle_name, last_name):
...     """返回整洁的姓名"""
...     full_name = first_name + ' ' + middle_name + ' ' + last_name
...     return full_name.title()
...
>>> formatted_name = get_formatted_name('bill', 'gates','no.1')
>>> print(formatted_name)
Bill Gates No.1
>>>
>>>

然而，并非所有的人都有中间名，但如果你调用这个函数时只提供了名和姓，它将不能正确地运行。为让中间名变成可选的，可给实参middle_name 指定一个默认值——空字符串，并在用户没有提供中间名时不使用这个实参。为让get_formatted_name() 在没有提供中间名时依然可行，可给实参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()

formatted_name = get_formatted_name('bill','no.1', 'gates')
print(formatted_name)

formatted_name = get_formatted_name('bill', 'gates')
print(formatted_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()
...
>>> formatted_name = get_formatted_name('bill','no.1', 'gates')
>>> print(formatted_name)
Bill Gates No.1
>>>
>>> formatted_name = get_formatted_name('bill', 'gates')
>>> print(formatted_name)
Bill Gates
>>>
>>>

1.3.3 返回字典

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

代码:

def return_dbs(db1, db2, db3):
    """返回一个包含数据库的字典"""
    db = {'db1': db1,'db2': db2,'db3': db3}
    return db

musician = return_dbs('Oracle', 'MySQL', 'SQL Server')
print(musician)

测试记录:

>>> def return_dbs(db1, db2, db3):
...     """返回一个包含数据库的字典"""
...     db = {'db1': db1,'db2': db2,'db3': db3}
...     return db
...
>>> musician = return_dbs('Oracle', 'MySQL', 'SQL Server')
>>> print(musician)
{'db1': 'Oracle', 'db2': 'MySQL', 'db3': 'SQL Server'}
>>>
>>>

1.3.4 结合使用函数和while 循环

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

代码:

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

while True:
    print("\nPlease tellme 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 + "!")

测试记录:

python.exe C:/Users/Administrator/PycharmProjects/untitled2/test3.py

Please tellme your name:
(enter 'q' at any time to quit)
First name: bill
Last name: gate

Hello, Bill Gate!

Please tellme your name:
(enter 'q' at any time to quit)
First name: kobe
Last name: bryant

Hello, Kobe Bryant!

Please tellme your name:
(enter 'q' at any time to quit)
First name: q

Process finished with exit code 0

1.4 传递列表

你经常会发现，向函数传递列表很有用，这种列表包含的可能是名字、数字或更复杂的对象（如字典）。将列表传递给函数后，函数就能直接访问其内容。下面使用函数来提高
处理列表的效率。
假设有一个用户列表，我们要问候其中的每位用户。下面的示例将一个名字列表传递给一个名为greet_users() 的函数，这个函数问候列表中的每个人.

代码:

def greet_users(names):
    """想列表中的每个用户都发出简单的问候"""
    for name in names:
        msg = "Hello, " + name.title() + "!"
        print(msg)

usernames = ['Kobe', 'James','Durant']
greet_users(usernames)

测试记录:

>>> def greet_users(names):
...     """想列表中的每个用户都发出简单的问候"""
...     for name in names:
...         msg = "Hello, " + name.title() + "!"
...         print(msg)
...
>>> usernames = ['Kobe', 'James','Durant']
>>> greet_users(usernames)
Hello, Kobe!
Hello, James!
Hello, Durant!
>>>

1.4.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', 'root pendant', 'dodecahedron']
completed_models = []

print_models(unprinted_designs, completed_models)
show_completed_models(completed_models)

1.4.2 禁止函数修改列表

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

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

function_name(list_name[:])

代码:

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', 'root pendant', 'dodecahedron']
completed_models = []


print_models(unprinted_designs, completed_models)
show_completed_models(completed_models)

print("\n" +  str(unprinted_designs))
print(completed_models)

# 不允许修改列表
print("\n")
unprinted_designs = ['iphone case', 'root pendant', 'dodecahedron']
completed_models = []

print_models(unprinted_designs[:], completed_models)
show_completed_models(completed_models)

print("\n" +  str(unprinted_designs))
print(completed_models)

测试记录:

Python36\python.exe C:/Users/Administrator/PycharmProjects/untitled2/test3.py
Printing model:dodecahedron
Printing model:root pendant
Printing model:iphone case

The following models have been printed:
dodecahedron
root pendant
iphone case

[]
['dodecahedron', 'root pendant', 'iphone case']


Printing model:dodecahedron
Printing model:root pendant
Printing model:iphone case

The following models have been printed:
dodecahedron
root pendant
iphone case

['iphone case', 'root pendant', 'dodecahedron']
['dodecahedron', 'root pendant', 'iphone case']

Process finished with exit code 0

1.5 传递任意数量的实参

有时候，你预先不知道函数需要接受多少个实参，好在Python允许函数从调用语句中收集任意数量的实参。

例如，来看一个输出数据库名称的函数，数据库有很多种，可能输入1个，也可能输入多个。下面的函数只有一个形参*databases ，但不管调用语句提供了多少实参，这个形参都将它们统统收入囊中：

代码:

def print_database(*databases):
    """打印数据库名称"""
    print(databases)

print_database('Oracle')
print_database('Oracle', 'MySQL', 'SQL Server', 'PostgreSQL')


def print_database(*databases):
    """打印数据库名称"""
    print("\n开始打印数据库名称:")
    for database in databases:
        print(database)

print_database('Oracle')
print_database('Oracle', 'MySQL', 'SQL Server', 'PostgreSQL')

测试记录:

python.exe C:/Users/Administrator/PycharmProjects/untitled2/test3.py
('Oracle',)
('Oracle', 'MySQL', 'SQL Server', 'PostgreSQL')

开始打印数据库名称:
Oracle

开始打印数据库名称:
Oracle
MySQL
SQL Server
PostgreSQL

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

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

代码:

def print_database(db_num,*databases):
    """打印数据库名称"""
    print("\n开始打印数据库名称:")
    print("你输入了" + str(db_num) + "个数据库名称.")
    for database in databases:
        print(database)

print_database(1,'Oracle')
print_database(4,'Oracle', 'MySQL', 'SQL Server', 'PostgreSQL')

测试记录:

>>> def print_database(db_num,*databases):
...     """打印数据库名称"""
...     print("\n开始打印数据库名称:")
...     print("你输入了" + str(db_num) + "个数据库名称.")
...     for database in databases:
...         print(database)
...
>>> print_database(1,'Oracle')

开始打印数据库名称:
你输入了1个数据库名称.
Oracle
>>> print_database(4,'Oracle', 'MySQL', 'SQL Server', 'PostgreSQL')

开始打印数据库名称:
你输入了4个数据库名称.
Oracle
MySQL
SQL Server
PostgreSQL
>>>

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

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

代码:

def get_userinfo(f_name, l_name, **user_info):
    """创建一个字典，其中包含我们知道的有关用户的一切"""
    userinfo = {}

    userinfo['first_name'] = f_name
    userinfo['last_name'] = l_name

    for key, value in user_info.items():
        userinfo[key] = value
    return userinfo


user_1 = get_userinfo('Kobe', 'Bryant',
                      job='basketball',
                      age='42',
                      location='American')

print(user_1)

测试记录:

python.exe C:/Users/Administrator/PycharmProjects/untitled2/test3.py
{'first_name': 'Kobe', 'last_name': 'Bryant', 'job': 'basketball', 'age': '42', 'location': 'American'}

Process finished with exit code 0

1.6 将函数存储在模块中

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

通过将函数存储在独立的文件中，可隐藏程序代码的细节，将重点放在程序的高层逻辑上。这还能让你在众多不同的程序中重用函数。将函数存储在独立文件中后，可与其他程序员共享这些文件而不是整个程序。知道如何导入函数还能让你使用其他程序员编写的函数库。

导入模块的方法有多种，下面对每种都作简要的介绍。

1.6.1 导入整个模块

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

下面来创建一个userinfo.py,内容如下:

E:\>more E:\python\userinfo.py
def get_userinfo(f_name, l_name, **user_info):
    """创建一个字典，其中包含我们知道的有关用户的一切"""
    userinfo = {}

    userinfo['first_name'] = f_name
    userinfo['last_name'] = l_name

    for key, value in user_info.items():
        userinfo[key] = value
    return userinfo

E:\>

接下来，我们在userinfo.py所在的目录创建一个list_userinfo.py,内容如下:

E:\>more E:\python\list_userinfo.py
import userinfo

user_1 = userinfo.get_userinfo('Kobe', 'Bryant',
                      job='basketball',
                      age='42',
                      location='American')

print(user_1)

E:\>

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

要调用被导入的模块中的函数，可指定导入的模块的名称userinfo 和函数get_userinfo()

测试记录:

E:\python >python list_userinfo.py
{'first_name': 'Kobe', 'last_name': 'Bryant', 'job': 'basketball', 'age': '42', 'location': 'American'}

1.6.2 导入特定的函数

你还可以导入模块中的特定函数，这种导入方法的语法如下：

from module_name import function_name
from module_name import function_0, function_1, function_2

对于前面的list_userinfo.py示例，如果只想导入要使用的函数，代码将类似于下面这样：

代码:
userinfo.py

def get_userinfo(f_name, l_name, **user_info):
    """创建一个字典，其中包含我们知道的有关用户的一切"""
    userinfo = {}

    userinfo['first_name'] = f_name
    userinfo['last_name'] = l_name

    for key, value in user_info.items():
        userinfo[key] = value
    return userinfo

list_userinfo.py

from userinfo import get_userinfo

user_1 = get_userinfo('Kobe', 'Bryant',
                      job='basketball',
                      age='42',
                      location='American')

print(user_1)

测试记录:

C:\>python E:\python\learn_python1\list_userinfo.py
{'first_name': 'Kobe', 'last_name': 'Bryant', 'job': 'basketball', 'age': '42', 'location': 'American'}

C:\>

1.6.3 使用as 给函数指定别名

如果要导入的函数的名称可能与程序中现有的名称冲突，或者函数的名称太长，可指定简短而独一无二的别名 ——函数的另一个名称，类似于外号。要给函数指定这种特殊外
号，需要在导入它时这样做。

语法:

from module_name import function_name as fn

代码:
userinfo.py

def get_userinfo(f_name, l_name, **user_info):
    """创建一个字典，其中包含我们知道的有关用户的一切"""
    userinfo = {}

    userinfo['first_name'] = f_name
    userinfo['last_name'] = l_name

    for key, value in user_info.items():
        userinfo[key] = value
    return userinfo

list_userinfo.py

from userinfo import get_userinfo as gui

user_1 = gui('Kobe', 'Bryant',
             job='basketball',
             age='42',
             location='American')

print(user_1)

测试记录:

C:\>python E:\python\learn_python1\list_userinfo.py
{'first_name': 'Kobe', 'last_name': 'Bryant', 'job': 'basketball', 'age': '42', 'location': 'American'}

C:\>

1.6.4 使用as 给模块指定别名

你还可以给模块指定别名。通过给模块指定简短的别名（如给模块userinfo 指定别名ui ），让你能够更轻松地调用模块中的函数。

语法:

import module_name as mn

代码:
userinfo.py

def get_userinfo(f_name, l_name, **user_info):
    """创建一个字典，其中包含我们知道的有关用户的一切"""
    userinfo = {}

    userinfo['first_name'] = f_name
    userinfo['last_name'] = l_name

    for key, value in user_info.items():
        userinfo[key] = value
    return userinfo

list_userinfo.py

import userinfo as ui

user_1 = ui.get_userinfo('Kobe', 'Bryant',
                         job='basketball',
                         age='42',
                         location='American')

print(user_1)

测试记录:

C:\>python E:\python\learn_python1\list_userinfo.py
{'first_name': 'Kobe', 'last_name': 'Bryant', 'job': 'basketball', 'age': '42', 'location': 'American'}

C:\>

1.6.5 导入模块中的所有函数

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

语法:

from module_name import *

1.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 语句都应放在文件开头，唯一例外的情形是，在文件开头使用了注释来描述整个程序。

参考:

1.Python编程:从入门到实践