Python def語法指南

一、函數定義

在Python中，使用def關鍵字定義函數，函數結構如下：

def function_name(parameters):
    """函數文檔字符串"""
    function_body

其中function_name為函數名，parameters為函數參數列表，可以為空；函數體使用縮進表示。

例如，下面的函數計算兩個數的和：

def add(x, y):
    """
    計算兩數之和
    x: 第一個加數
    y: 第二個加數
    """
    return x + y

該函數的調用方式為：

result = add(1, 2)
print(result)
# 輸出為：3

二、函數參數

1. 必需參數

必需參數是指在調用函數時必須傳入的參數，如果沒有傳入或者傳入個數錯誤，會報錯。

例如，下面的函數計算一個數的平方：

def square(x):
    """
    計算一個數的平方
    x: 要計算的數
    """
    return x ** 2

函數調用示例：

result = square(3)
print(result)
# 輸出為：9

2. 關鍵字參數

關鍵字參數是指在調用函數時使用參數名來傳遞參數值，可以不按照定義順序傳遞，且能夠給參數提供默認值。

例如，下面的函數計算一個數的n次方：

def power(x, n=2):
    """
    計算一個數的n次方
    x: 要計算的數
    n: 冪次數，默認為2次方
    """
    return x ** n

函數調用示例：

result1 = power(3)
result2 = power(x=3, n=3)
print(result1)
print(result2)
# 輸出為：9和27

3. 可變參數

可變參數是指可以傳入任意個數參數的一種參數形式。在函數定義時，在參數名稱前面加一個 * 號即可定義可變參數。

例如，下面的函數計算多個數的和：

def add(*nums):
    """
    計算多個數的和
    nums: 需要計算的數，可以傳任意個數
    """
    result = 0
    for num in nums:
        result += num
    return result

函數調用示例：

result1 = add(1, 2, 3)
result2 = add(1, 2, 3, 4, 5)
print(result1)
print(result2)
# 輸出為：6和15

三、函數返回值

函數可以返回一個值或者多個值。使用return關鍵字來返回函數值，可以返回任意類型的值。

例如，下面的函數計算兩個數的商和餘數：

def divide(x, y):
    """
    計算兩個數的商和餘數
    x: 被除數
    y: 除數
    """
    quotient = x // y  # 整除，得到商
    remainder = x % y  # 取模，得到餘數
    return quotient, remainder

函數調用示例：

result = divide(10, 3)
print(result)
# 輸出為：(3, 1)

四、函數文檔字符串

函數文檔字符串是對函數功能、參數、返回值等信息的文本描述，可以通過help()函數獲取。

例如，下面的函數帶有文檔字符串：

def square(x):
    """
    計算一個數的平方
    x: 要計算的數
    """
    return x ** 2

可以通過help()函數獲取文檔字符串的內容：

help(square)
# 輸出為：
# Help on function square in module __main__:
# 
# square(x)
#     計算一個數的平方
#     
#     x: 要計算的數

五、函數嵌套

在Python中，函數可以嵌套定義，即在函數內部再定義一個函數。

例如，下面的函數實現了兩個數組的對應元素相加：

def add_array(a, b):
    """
    實現兩個數組的對應元素相加
    a: 第一個數組
    b: 第二個數組
    """
    # 定義一個函數，用於求兩個數之和
    def add(x, y):
        return x + y
    
    # 對應元素相加，並返回結果數組
    result = []
    for i in range(len(a)):
        result.append(add(a[i], b[i]))
    return result

函數調用示例：

result = add_array([1, 2, 3], [4, 5, 6])
print(result)
# 輸出為：[5, 7, 9]

六、總結

本篇文章主要介紹了Python中函數的定義、參數、返回值、文檔字符串和嵌套等概念，通過代碼示例和說明進行了深入淺出的講解，希望對Python初學者有所幫助。