四面全是埋伏，宋江和眾人一直繞圈跑不出去。正在慌亂之時，石秀及時趕到，教大家碰到白楊樹就轉彎走。走了一段時間，發現圍的人越來越多，原來祝家莊以燈籠指揮號令。花榮一箭射下來紅燈龍，伏兵自己就亂起來了。

宋江叫石秀引路，帶大軍到了村口，與山寨的第二波馬軍林沖、秦明匯合。第二天天亮，發現鎮三山黃信被抓了。

宋江同花榮楊雄石秀帶李家莊請李應幫忙。李應以有箭傷為由沒有出來見面，拒收了禮物。杜興說因為祝家莊打傷了我們，我們不會再去幫他。你們要提防扈家莊的一丈青扈三娘。另外祝家莊有兩座莊門，要一起打才行。

這是宋江第一次帶兵打仗，很好很強大，戰術也靈活主動，就像Python編程里的修飾器一樣，強大而靈活。

強大而靈活的python裝飾器

一、概述

在Python中，裝飾器是一種特殊類型的函數，它允許我們修改或增強其他函數的功能，而無需修改其源代碼。裝飾器在函數定義之后立即調用，并以函數對象作為參數。裝飾器返回一個新的函數對象，這個新函數對象通常會“包裝”或“裝飾”原函數，并在調用時執行額外的操作。

二、基本用法

裝飾器的基本語法是使用@符號，后面緊跟裝飾器函數的名稱。裝飾器函數通常接收一個函數作為參數，并返回一個新的函數。

@decorator_function  
def my_function():  pass

在上面的代碼中，decorator_function是一個裝飾器，它接收my_function作為參數，并返回一個新的函數對象。這個新的函數對象在調用時會執行decorator_function中定義的代碼，并在適當的時候調用my_function。

三、裝飾器函數

裝飾器函數通常接收一個函數作為參數，并返回一個新的函數。裝飾器函數內部的新函數通常會調用原函數，并在調用前后執行額外的操作。

def decorator_function(func):  def wrapper(*args, **kwargs):  # 在原函數執行前執行的代碼  print("Before function call")  # 調用原函數  result = func(*args, **kwargs)  # 在原函數執行后執行的代碼  print("After function call")  return result  return wrapper

四、使用裝飾器

使用裝飾器非常簡單，只需在函數定義之前加上@符號和裝飾器函數的名稱即可。

@decorator_function  
def my_function():  print("Inside function")  # 調用被裝飾的函數  
my_function()

五、使用裝飾器的測試示例

下面是一個使用裝飾器來實現基準測試的示例：

import time  
from functools import wraps  def benchmark(func):  """  基準測試裝飾器，用于測量函數的執行時間。  參數:  func (callable): 要測試的函數。  返回:  callable: 裝飾后的函數，它會打印原始函數的執行時間。  """  @wraps(func)  def wrapper(*args, **kwargs):  start_time = time.time()  result = func(*args, **kwargs)  end_time = time.time()  elapsed_time = end_time - start_time  print(f"執行 {func.__name__} 花費了 {elapsed_time:.6f} 秒")  return result  return wrapper  # 示例函數，我們將對其應用基準測試裝飾器  
@benchmark  
def example_function(n):  sum = 0  for i in range(n):  sum += i  return sum  # 調用示例函數，裝飾器會自動打印執行時間  
print(example_function(1000000))

在這個例子中，benchmark 是一個裝飾器函數，它接受一個函數作為參數，并返回一個新的函數 wrapper。wrapper 函數會記錄開始和結束時間，然后調用原始函數并打印出執行時間。@wraps(func) 是一個內置裝飾器，用于保留原始函數的元信息（如函數名、文檔字符串等）。

通過在 example_function 定義之前使用 @benchmark 裝飾器，我們告訴Python在調用 example_function 時實際上要調用的是 wrapper 函數，而 wrapper 函數會記錄并打印出 example_function 的執行時間。

使用裝飾器的好處是你可以在不修改原始函數的情況下輕松添加新功能，例如基準測試。這使得代碼更加模塊化且易于維護。

六、裝飾器的高級用法

1、多個裝飾器：

一個函數可以同時使用多個裝飾器，只需在函數定義前依次列出它們即可。

@decorator1  
@decorator2  
def my_function():  pass

2、帶參數的裝飾器

裝飾器本身也可以接收參數，并在內部定義裝飾器函數。

def outer_decorator(param):  def decorator_function(func):  def wrapper(*args, **kwargs):  print(f"Before function call with param: {param}")  result = func(*args, **kwargs)  print(f"After function call with param: {param}")  return result  return wrapper  return decorator_function  @outer_decorator("hello")  
def my_function():  print("Inside function")  my_function()

七、注意事項

• 裝飾器會改變函數的名稱和文檔字符串，除非使用@wraps裝飾器來保留這些信息。
• 裝飾器會改變函數的簽名，這可能會影響依賴于函數簽名的工具或庫。
• 裝飾器可能會增加函數的調用開銷，因為每次調用被裝飾的函數時，都會執行額外的代碼。

八、總結

裝飾器是Python中一種強大而靈活的工具，它允許我們在不修改函數源代碼的情況下，為函數添加額外的功能。通過正確使用裝飾器，我們可以提高代碼的可讀性、可維護性和可擴展性。

宋江親自做前鋒去打頭陣。扈三娘從西邊殺來，王矮虎迎戰，被扈三娘抓了。秦明鄧飛也被抓了，一丈青扈三娘來抓宋江，這時候楊雄石秀小李廣花榮都趕到，大家混戰在一起。一丈青緊追宋江，被林沖抓住了。

宋江讓把扈三娘連夜送上梁山，由宋太公收管。宋江正發愁，吳用帶領三阮和呂方、郭盛帶五百人馬趕到。吳用說恰好有個機會，打敗祝家莊小菜一碟。

欲知后事如何，且聽下回分解。