python 函数

函数：

函数是重用的程序段，它们允许你给一块语句一个名称，然后你可以在你的程序的任何地方 使用这个名字任意多次的运行这个语句块。这被称为 调用函数。

函数用def关键字 定义，def关键子后面跟一个函数的标识符，然后跟一对圆括号。圆括号中可以包括一些变量名，该行以冒号(:)结尾。

 

#!/usr/bin/python
#FileName: fun1.py

def sayHello():
    print 'Hello World!'

sayHello() #call the function

 

 

函数形参

函数取得的参数是你提供给函数的值，这样函数就可以利用这些值 做 一些事情。这些参数就像变量一样，只不过它们的值是在我们调用函数的时候定义的，而非在函数本身内赋值。

 

参数在函数定义的圆括号对内指定，用逗号分割。当我们调用函数的时候，我们以同样的方式提供值。注意我们使用过的术语——函数中的参数名称为 形参 而你提供给函数调用的值称为 实参 。

 

#!/usr/bin/python
#filename:func_param.py
def printMax(a,b):
    if a > b:
        print a,'is maximum'
    else:
        print b,'is maximum'

printMax(3,4)#result is 4.

 全局变量：

 

如果你想要为一个定义在函数外面的变量赋值，那么就得告诉 Python这个变量名不是局部的 ，而是全局的。我们使用 global语句完成这个功能，没有global语句，是不可能为定义在函数外的变量赋值的。

你可以使用定义在函数外的变量的值（假设在函数内没有同名的变量）。然而，我并不鼓励你这样做，并且你应该尽量避免这样做，因为这使得程序的读者会不清楚这个变量是在哪里定义的。使用global语句可以清楚地表明变量是在外面的块定义的。

 

#!/usr/bin/python
#filename: func_global.py

def func():
    global x
   
    print 'x is ', x
    x=2
    print 'Changed to local x to ', x

x =50
func()
print 'Value of x is ', x    #x is 2

 

 

默认参数值:

对于一些函数，你可能希望它的一些参数是 可选 的，如果用户不想要为这些参数提供值的话，这些参数就使用默认值。这个 功能借助于默认参数值完成。你可以在函数定义的形参名后面加上赋值运算符(=)和默认值，从而给形参制定默认的值。

只有在形参表末尾的那些参数可以有默认参数值，即你不能在声明函数形参的时候，先声明有默认值的形参而后声明没有默认值的形参。

这是因为赋给形参的值是根据位置而赋值的。例如，def func(a, b=5)是有效的，但是def func(a=5, b)是 无效 的。

#!/usr/bin/python
#filename: fun_default.py
def say(message,times=1):
    print message* times

say('Hello')   #result: Hello
say('Wolrd',5) #result : WorldWorldWorldWorldWorld

 

 关键参数：

 如果你的某个函数有许多参数，而你只想制定其中的一部分，那么你可以通过 命名来为这些参数赋值----这被称为 关键参数，我们使用名字（关键字）而不是位置来给函数制定实参。

这样做有两个优势--第一，我们不用担心参数的顺序，使用函数变得更加简单了。第二，假设其他参数都有默认值，我们可以只给我们想要的那些参数赋值。

 

#!/usr/bin/python
#filename: func_key.py

def func(a,b=5,c=10):
     print 'a is', a, 'and b is ', b, ' and c is ', c

func(3,7)  #a is 3 and b is  7  and c is  10
func(25,c=24) #a is 25 and b is  5  and c is  24
func(c=50,a=100)#a is 100 and b is  5  and c is  50

 

 可变参数：

可变参数就是传入的参数个数是可变的，可以是1个、2个到任意个，还可以是0个.要定义可变参数，必须在 参数前加上*.

def calc(*numbers):
    sum = 0
    for n in numbers:
        sum = sum + n
    return sum
  
print(calc())# 0
print(calc(1,10,100,1000.11))#1111.11

 

DocStrings

Python有一个很奇妙的特性，称为 文档字符串 ，它通常被简称为 docstrings 。DocStrings是一个重要的工具，由于它帮助你的程序文档更加简单易懂，你应该尽量使用它。你甚至可以在程序运行的时候，从函数恢复文档字符串！

 

#!/usr/bin/python
# Filename: func_doc.py

def printMax(x, y):
    '''Prints the maximum of two numbers.

    The two values must be integers.'''
    x = int(x) # convert to integers, if possible
    y = int(y)

    if x > y:
        print x, 'is maximum'
    else:
        print y, 'is maximum'

printMax(3, 5)
print printMax.__doc__

 输出：

 

$ python func_doc.py
5 is maximum
Prints the maximum of two numbers.

        The two values must be integers.

 文档字符串的惯例是一个多行字符串，它的首行以大写字母开始，句号结尾。第二行是空行，从第三行开始是详细的描述。 强烈建议 你在你的函数中使用文档字符串时遵循这个惯例。

 

你可以使用__doc__（注意双下划线）调用printMax函数的文档字符串属性（属于函数的名称）。