Map.add<'Key,'T> Function (F#)

Returns a new map with the binding added to the given map.

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

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

// Signature:
Map.add : 'Key -> 'T -> Map<'Key,'T> -> Map<'Key,'T> (requires comparison)

// Usage:
Map.add key value table

Parameters

• key
  Type: 'Key

  The input key.

• value
  Type: 'T

  The input value.

• table
  Type: Map<'Key,'T>

  The input map.

Return Value

The resulting map.

Remarks

This function is named Add 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 example shows how to use Map.add.

Map.ofList [ (1, "one"); (2, "two"); (3, "three") ]
|> Map.add(0) "zero"
|> Map.iter (fun key value -> printfn "key: %d value: %s" key value)

Output

key: 0 value: zero
key: 1 value: one
key: 2 value: two
key: 3 value: three

Platforms

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

Version Information

F# Core Library Versions

Supported in: 2.0, 4.0, Portable

See Also

Reference

Collections.Map Module (F#)

Microsoft.FSharp.Collections Namespace (F#)