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.choose<'T,'U> Function (F#)

Visual Studio 2012

Applies the given function f to each element x of the list. Returns the list comprised of the results for each element where the function returns Some(f(x)).

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

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

Copy 
// Signature:
List.choose : ('T -> 'U option) -> 'T list -> 'U list

// Usage:
List.choose chooser list
chooser

Type: 'T -> 'U option

The function to generate options from the elements.

list

Type: 'T list

The input list.

The list comprising the values selected from the chooser function.

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

The following code demonstrates the use of List.choose to select capitalized words out of a list of words.

F#
Copy 
let listWords = [ "and"; "Rome"; "Bob"; "apple"; "zebra" ]
let isCapitalized (string1:string) = System.Char.IsUpper string1.[0]
let results = List.choose (fun elem ->
    match elem with
    | elem when isCapitalized elem -> Some(elem + "'s")
    | _ -> None) listWords
printfn "%A" results

Output 

["Rome's"; "Bob's"]

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.