List.tail<'T> Function (F#)

Switch View :
ScriptFree
Visual Studio 2010 - Visual F#
List.tail<'T> Function (F#)

Updated: August 2010

Returns the list without the first element.

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

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

// Signature:
List.tail : 'T list -> 'T list

// Usage:
List.tail list
Parameters

list

Type: 'T list

Return Value

The tail of the list, that is, the list without the first element.

Remarks

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

Example

The following code shows how to use List.tail.

F#

let list1 = [1; 2; 3]
let list2 = []
// The following line prints [2; 3].
printfn "%A" (List.tail list1)
// The following line throws System.ArgumentException.
printfn "%A" (List.tail list2)


Abbreviated Output

[2; 3]
System.ArgumentException: The input list was empty.

Platforms

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

Version Information

F# Runtime

Supported in: 2.0, 4.0

Silverlight

Supported in: 3

See Also

Reference

Change History

Date

History

Reason

August 2010

Added code example.

Information enhancement.