reduce()

自 DataTables 1.10 起：

針對 API 結果集中的累加器和每個元素（從左到右）套用回呼函式。

說明

此方法可用於將結果集中的資料累加為單一值。一個很好的例子是加總資料欄中的值。Array reduce 方法（此方法以此為基礎）的更完整定義可在 Mozilla MDN 文件中找到關於 reduce 的說明。

請注意，此方法中結果集中元素的遍歷是從左到右（即 0 到 length）。reduceRight() 可用於反向遍歷。

此方法利用了 DataTables API 物件是「類陣列」的事實，因為它們繼承了許多 JavaScript Array 類型的能力和方法。

在此情況下，此方法是 JavaScript Array.prototype.reduce 方法的代理，並作為 DataTables API 的實用方法提供。有關原始方法的更多資訊，請參閱 Mozilla MDN 文件中關於 reduce 的說明。在不原生支援 reduce 的瀏覽器中，會提供一個 polyfill，以使此 DataTables 方法能夠如預期般運作。

類型

function reduce( fn [, initialValue ] )

說明

針對 API 結果集中的累加器和每個元素套用回呼函式。

參數

	名稱	類型	可選
1	`fn`	`函式`	否
	為 API 實例結果集中的每個項目呼叫的回呼函式。該回呼函式會被傳遞四個參數目前的累加器值，如果第一次回呼中提供了 `initialValue` 則為其值目前元素值結果集中的元素索引正在遍歷的 API 實例回呼函式應傳回要在下一個迴圈中用作累加器的值（回呼函式中的第一個參數）。
2	`initialValue`	`任何`	是 - 預設值
	用作第一次呼叫 `fn` 回呼函式的第一個引數的值。

傳回

任何

最後一次呼叫 fn 回呼函式所得的結果。

範例

加總欄中的資料

var table = new DataTable('#myTable');

var sum = table
	.column(0)
	.data()
	.reduce(function (a, b) {
		return a + b;
	});