Home Library Learn Samples Downloads Support Community Forums
MSDN Library
Development Tools and Languages
Visual Studio 2012
Visual F#
F# Core Library Reference
Microsoft.FSharp.Collections Namespace
List Module
List.append<'T> Function
List.average<^T> Function
List.averageBy<'T,^U> Function
List.choose<'T,'U> Function
List.collect<'T,'U> Function
List.concat<'T> Function
List.empty<'T> Type Function
List.exists<'T> Function
List.exists2<'T1,'T2> Function
List.filter<'T> Function
List.find<'T> Function
List.findIndex<'T> Function
List.fold<'T,'State> Function
List.fold2<'T1,'T2,'State> Function
List.foldBack<'T,'State> Function
List.foldBack2<'T1,'T2,'State> Function
List.forall<'T> Function
List.forall2<'T1,'T2> Function
List.head<'T> Function
List.init<'T> Function
List.isEmpty<'T> Function
List.iter<'T> Function
List.iter2<'T1,'T2> Function
List.iteri<'T> Function
List.iteri2<'T1,'T2> Function
List.length<'T> Function
List.map<'T,'U> Function
List.map2<'T1,'T2,'U> Function
List.map3<'T1,'T2,'T3,'U> Function
List.mapi<'T,'U> Function
List.mapi2<'T1,'T2,'U> Function
List.max<'T> Function
List.maxBy<'T,'U> Function
List.min<'T> Function
List.minBy<'T,'U> Function
List.nth<'T> Function
List.ofArray<'T> Function
List.ofSeq<'T> Function
List.partition<'T> Function
List.permute<'T> Function
List.pick<'T,'U> Function
List.reduce<'T> Function
List.reduceBack<'T> Function
List.replicate<'T> Function
List.rev<'T> Function
List.scan<'T,'State> Function
List.scanBack<'T,'State> Function
List.sort<'T> Function
List.sortBy<'T,'Key> Function
List.sortWith<'T> Function
List.sum<^T> Function
List.sumBy<'T,^U> Function
List.tail<'T> Function
List.toArray<'T> Function
List.toSeq<'T> Function
List.tryFind<'T> Function
List.tryFindIndex<'T> Function
List.tryPick<'T,'U> Function
List.unzip<'T1,'T2> Function
List.unzip3<'T1,'T2,'T3> Function
List.zip<'T1,'T2> Function
List.zip3<'T1,'T2,'T3> Function
Expand Minimize
This topic has not yet been rated - Rate this topic

List.forall2<'T1,'T2> Function (F#)

Visual Studio 2012

Tests if all corresponding elements of the collection satisfy the given predicate pairwise.

Namespace/Module Path: Microsoft.FSharp.Collections.List

Assembly: FSharp.Core (in FSharp.Core.dll)

Copy 
// Signature:
List.forall2 : ('T1 -> 'T2 -> bool) -> 'T1 list -> 'T2 list -> bool

// Usage:
List.forall2 predicate list1 list2
predicate

Type: 'T1 -> 'T2 -> bool

The function to test the input elements.

list1

Type: 'T1 list

The first input list.

list2

Type: 'T2 list

The second input list.

Exception

Condition

ArgumentException

Thrown when the input lists differ in length.

true if all of the pairs of elements satisfy the predicate. Otherwise, returns false.

The predicate is applied to matching elements in the two collections. If any application returns false then the overall result is false and no further elements are tested. Otherwise, if one collection is longer than the other then the ArgumentException exception is raised. Otherwise, true is returned.

This function is named ForAll2 in compiled assemblies. If you are accessing the function from a .NET language other than F#, or through reflection, use this name.

The following code example illustrates the use of List.forall2.

F#
Copy 
let listEqual list1 list2 = List.forall2 (fun elem1 elem2 -> elem1 = elem2) list1 list2
printfn "%b" (listEqual [0; 1; 2] [0; 1; 2])
printfn "%b" (listEqual [0; 0; 0] [0; 1; 0])

Output 

true
false

Windows 8, Windows 7, Windows Server 2012, Windows Server 2008 R2

F# Core Library Versions

Supported in: 2.0, 4.0, Portable

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.
|
Site Feedback
© 2013 Microsoft. All rights reserved.