共用方式為

List.fold2<'T1,'T2,'State> 函式 (F#)

  • 發行項

更新：2010 年 5 月

將函式套用至兩個集合的對應項目，以透過計算建立累計值引數的執行緒。 這些集合的大小必須完全相同。 如果輸入函數為 f 而且項目為 i0...iN 和 j0...jN，則會計算 f (... (f s i0 j0)...) iN jN。

命名空間/模組路徑： Microsoft.FSharp.Collections.List

組件：FSharp.Core (在 FSharp.Core.dll 中)

// Signature:
List.fold2 : ('State -> 'T1 -> 'T2 -> 'State) -> 'State -> 'T1 list -> 'T2 list -> 'State

// Usage:
List.fold2 folder state list1 list2

參數

  • folder
    型別：'State -> 'T1 -> 'T2 -> 'State

    根據指定的輸入項目更新狀態的函式。

  • state
    型別：'State

    初始狀態。

  • list1
    Type: 'T1 list

    第一個輸入清單。

  • list2
    Type: 'T2 list

    第二個輸入清單。

傳回值

最終狀態值。

例外狀況

例外狀況

條件

ArgumentException

會在輸入清單的長度不同時擲回。

備註

這個函式是名為 Fold2中 已編譯的組件。 如果從以.NET 語言，F # 以外，或透過反映存取函式使用這個名稱。

範例

下列程式碼範例說明如何使用 List.fold2。

// Use List.fold2 to perform computations over two lists (of equal size) at the same time.
// Example: Sum the greater element at each list position.
let sumGreatest list1 list2 = List.fold2 (fun acc elem1 elem2 ->
                                              acc + max elem1 elem2) 0 list1 list2

let sum = sumGreatest [1; 2; 3] [3; 2; 1]
printfn "The sum of the greater of each pair of elements in the two lists is %d." sum

輸出

下列程式碼範例會說明如何使用 List.fold2來計算結束的平衡，在銀行帳戶後一系列的 交易。 兩個輸入的清單代表交易類型 (存款或提款) 和交易量。

// Discriminated union type that encodes the transaction type.
type Transaction =
    | Deposit
    | Withdrawal

let transactionTypes = [Deposit; Deposit; Withdrawal]
let transactionAmounts = [100.00; 1000.00; 95.00 ]
let initialBalance = 200.00

// Use fold2 to perform a calculation on the list to update the account balance.
let endingBalance = List.fold2 (fun acc elem1 elem2 ->
                                match elem1 with
                                | Deposit -> acc + elem2
                                | Withdrawal -> acc - elem2)
                                initialBalance
                                transactionTypes
                                transactionAmounts
printfn "%f" endingBalance

輸出

平台

Windows 7、Windows Vista SP2、Windows XP SP3、Windows XP x64 SP2、Windows Server 2008 R2、Windows Server 2008 SP2、Windows Server 2003 SP2

版本資訊

F# 執行階段

支援版本：2.0、4.0

Silverlight

支援版本：3

請參閱

參考

Collections.List 模組 (F#)

Microsoft.FSharp.Collections 命名空間 (F#)

變更記錄

日期

History

原因

2010 年 5 月

加入程式碼範例。

資訊加強。