containers-0.6.5.1: Assorted concrete container types
Copyright (c) Daan Leijen 2002
(c) Andriy Palamarchuk 2008
License BSD-style
Maintainer libraries@haskell.org
Portability portable
Safe Haskell Safe
Language Haskell2010

Data.Map

Description

Note: You should use Data.Map.Strict instead of this module if:

  • You will eventually need all the values stored.
  • The stored values don't represent large virtual data structures to be lazily computed.

An efficient implementation of ordered maps from keys to values (dictionaries).

These modules are intended to be imported qualified, to avoid name clashes with Prelude functions, e.g.

 import qualified Data.Map as Map

The implementation of Map is based on size balanced binary trees (or trees of bounded balance ) as described by:

  • Stephen Adams, " Efficient sets: a balancing act ", Journal of Functional Programming 3(4):553-562, October 1993, http://www.swiss.ai.mit.edu/~adams/BB/ .
  • J. Nievergelt and E.M. Reingold, " Binary search trees of bounded balance ", SIAM journal of computing 2(1), March 1973.

Bounds for union , intersection , and difference are as given by

Note that the implementation is left-biased -- the elements of a first argument are always preferred to the second, for example in union or insert .

Warning : The size of the map must not exceed maxBound::Int . Violation of this condition is not detected and if the size limit is exceeded, its behaviour is undefined.

Operation comments contain the operation time complexity in the Big-O notation ( http://en.wikipedia.org/wiki/Big_O_notation ).

Synopsis
  • module Data.Map.Lazy
  • insertWith' :: Whoops "Data.Map.insertWith' is gone. Use Data.Map.Strict.insertWith." => (a -> a -> a) -> k -> a -> Map k a -> Map k a
  • insertWithKey' :: Whoops "Data.Map.insertWithKey' is gone. Use Data.Map.Strict.insertWithKey." => (k -> a -> a -> a) -> k -> a -> Map k a -> Map k a
  • insertLookupWithKey' :: Whoops "Data.Map.insertLookupWithKey' is gone. Use Data.Map.Strict.insertLookupWithKey." => (k -> a -> a -> a) -> k -> a -> Map k a -> ( Maybe a, Map k a)
  • fold :: Whoops "Data.Map.fold is gone. Use foldr." => (a -> b -> b) -> b -> Map k a -> b
  • foldWithKey :: Whoops "Data.Map.foldWithKey is gone. Use foldrWithKey." => (k -> a -> b -> b) -> b -> Map k a -> b

Documentation

insertWith' :: Whoops "Data.Map.insertWith' is gone. Use Data.Map.Strict.insertWith." => (a -> a -> a) -> k -> a -> Map k a -> Map k a Source #

This function is being removed and is no longer usable. Use insertWith .

insertWithKey' :: Whoops "Data.Map.insertWithKey' is gone. Use Data.Map.Strict.insertWithKey." => (k -> a -> a -> a) -> k -> a -> Map k a -> Map k a Source #

This function is being removed and is no longer usable. Use insertWithKey .

insertLookupWithKey' :: Whoops "Data.Map.insertLookupWithKey' is gone. Use Data.Map.Strict.insertLookupWithKey." => (k -> a -> a -> a) -> k -> a -> Map k a -> ( Maybe a, Map k a) Source #

This function is being removed and is no longer usable. Use insertLookupWithKey .

fold :: Whoops "Data.Map.fold is gone. Use foldr." => (a -> b -> b) -> b -> Map k a -> b Source #

This function is being removed and is no longer usable. Use foldr .

foldWithKey :: Whoops "Data.Map.foldWithKey is gone. Use foldrWithKey." => (k -> a -> b -> b) -> b -> Map k a -> b Source #

This function is being removed and is no longer usable. Use foldrWithKey .