【Flutter 學習筆記】使用具名參數呼叫函式

【Flutter 學習筆記】線上課程教學影片：連結

【Flutter 學習筆記】系列文章目錄：連結

在 Dart 程式語言中，除了位置參數和預設參數值外，具名參數的使用讓函式的呼叫變得更加清晰且易於理解。特別是在參數較多的情況下，具名參數的優勢尤為明顯。本篇文章將深入探討如何定義和使用具名參數，並透過實際範例來加深讀者的理解。

具名參數的函式結構

定義一個具有具名參數的函式的基本語法如下：

回傳值型別 函式名稱({參數型別 參數名稱, 參數型別 參數名稱}) {
  // 函式主體
  return 回傳值;
}

語法說明

• 回傳值型別：指定函式回傳的資料型別，例如 int、String、double 等。函式名稱：用來呼叫函式的名稱，應具描述性，以便於理解其功能。參數：函式可以接收的輸入值，使用大括號 {} 來定義具名參數。這表示這些參數是可選的，呼叫函式時可以選擇性地提供這些參數。

範例：計算圓形面積的函式

接下來，我們將透過一個簡單的範例來說明具名參數的使用。我們將定義一個計算圓形面積的函式，並使用具名參數來接收半徑和圓周率。

函式定義

以下是計算圓形面積的函式：

double calculateCircleArea({double radius = 1.0, double pi = 3.14}) {
  return pi * radius * radius;
}

在這個範例中：

• double 是回傳值的型別，表示這個函式會回傳一個浮點數。calculateCircleArea 是函式的名稱。{double radius = 1.0, double pi = 3.14} 是函式的參數，radius 表示圓的半徑，pi 表示圓周率，並且都設定了預設值。

函式呼叫

當我們呼叫這個函式時，可以這樣寫：

void main() {
  double area1 = calculateCircleArea(); // 使用預設值
  double area2 = calculateCircleArea(radius: 5.0); // 指定半徑
  double area3 = calculateCircleArea(radius: 5.0, pi: 3.14159); // 指定半徑和圓周率

  print("半徑為 1.0 的圓面積是: $area1"); // 輸出: 半徑為 1.0 的圓面積是: 3.14
  print("半徑為 5.0 的圓面積是: $area2"); // 輸出: 半徑為 5.0 的圓面積是: 78.5
  print("半徑為 5.0，圓周率為 3.14159 的圓面積是: $area3"); // 輸出: 半徑為 5.0，圓周率為 3.14159 的圓面積是: 78.53975
}

程式碼解析

1. 使用預設值：當我們不提供任何參數時，函式會自動使用預設的半徑 1.0 和圓周率 3.14。這樣的設計使得函式在不需要額外輸入的情況下仍然能夠正常運作。指定參數：當我們指定半徑時，例如 calculateCircleArea(radius: 5.0)，可以清楚地看到我們所提供的參數名稱。這樣的設計不僅提高了函式的可讀性，還使得程式碼更加易於維護。靈活性：透過具名參數，我們可以靈活地指定需要的參數，而不必依賴於參數的順序。這在參數較多或有預設值的情況下，特別有助於提高程式碼的可讀性和可維護性。

輸出結果

在 main 函式中，我們呼叫了 calculateCircleArea 三次，並將結果輸出到控制台。以下是每次呼叫的輸出結果：

• 第一個呼叫：使用預設值，計算半徑為 1.0 的圓面積，結果為 3.14。第二個呼叫：指定半徑為 5.0，使用預設的圓周率 3.14，計算結果為 78.5。第三個呼叫：同時指定半徑和圓周率，計算結果為 78.53975。

這些輸出結果清楚地顯示了不同參數設定下的圓面積計算，並且透過具名參數的使用，讓程式碼的意圖更加明確。

結論

具名參數在 Dart 中提供了一種靈活且易於理解的方式來定義和使用函式。透過具名參數，我們可以在呼叫函式時清楚地指定每個參數的意義，這不僅提高了程式碼的可讀性，還使得維護和擴展變得更加簡單。

在實際開發中，當函式的參數數量增多時，具名參數的優勢會更加明顯。