Home My Page Projects Code Snippets Project Openings SML/NJ
Summary Activity Forums Tracker Lists Tasks Docs Surveys News SCM Files

SCM Repository

[smlnj] Annotation of /smlnj-lib/branches/rt-transition/Util/ord-map-sig.sml
ViewVC logotype

Annotation of /smlnj-lib/branches/rt-transition/Util/ord-map-sig.sml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 412 - (view) (download)
Original Path: sml/trunk/src/smlnj-lib/Util/ord-map-sig.sml

1 : monnier 2 (* ord-map-sig.sml
2 :     *
3 :     * COPYRIGHT (c) 1996 by AT&T Research. See COPYRIGHT file for details.
4 :     *
5 :     * Abstract signature of an applicative-style finite maps (dictionaries)
6 :     * structure over ordered monomorphic keys.
7 :     *)
8 :    
9 :     signature ORD_MAP =
10 :     sig
11 :    
12 :     structure Key : ORD_KEY
13 :    
14 :     type 'a map
15 :    
16 :     val empty : 'a map
17 :     (* The empty map *)
18 :    
19 : monnier 289 val isEmpty : 'a map -> bool
20 :     (* Return true if and only if the map is empty *)
21 :    
22 : monnier 411 val singleton : (Key.ord_key * 'a) -> 'a map
23 :     (* return the specified singleton map *)
24 :    
25 : monnier 29 val insert : 'a map * Key.ord_key * 'a -> 'a map
26 :     val insert' : ((Key.ord_key * 'a) * 'a map) -> 'a map
27 :     (* Insert an item. *)
28 : monnier 2
29 :     val find : 'a map * Key.ord_key -> 'a option
30 :     (* Look for an item, return NONE if the item doesn't exist *)
31 :    
32 : monnier 411 val inDomain : ('a map * Key.ord_key) -> bool
33 :     (* return true, if the key is in the domain of the map *)
34 :    
35 : monnier 2 val remove : 'a map * Key.ord_key -> 'a map * 'a
36 :     (* Remove an item, returning new map and value removed.
37 :     * Raises LibBase.NotFound if not found.
38 :     *)
39 :    
40 : monnier 289 val first : 'a map -> 'a option
41 :     val firsti : 'a map -> (Key.ord_key * 'a) option
42 :     (* return the first item in the map (or NONE if it is empty) *)
43 :    
44 : monnier 2 val numItems : 'a map -> int
45 :     (* Return the number of items in the map *)
46 :    
47 :     val listItems : 'a map -> 'a list
48 :     val listItemsi : 'a map -> (Key.ord_key * 'a) list
49 : monnier 411 (* Return an ordered list of the items (and their keys) in the map. *)
50 : monnier 2
51 : monnier 411 val listKeys : 'a map -> Key.ord_key list
52 :     (* return an ordered list of the keys in the map. *)
53 :    
54 : monnier 2 val collate : ('a * 'a -> order) -> ('a map * 'a map) -> order
55 :     (* given an ordering on the map's range, return an ordering
56 :     * on the map.
57 :     *)
58 :    
59 :     val unionWith : ('a * 'a -> 'a) -> ('a map * 'a map) -> 'a map
60 :     val unionWithi : (Key.ord_key * 'a * 'a -> 'a) -> ('a map * 'a map) -> 'a map
61 :     (* return a map whose domain is the union of the domains of the two input
62 :     * maps, using the supplied function to define the map on elements that
63 :     * are in both domains.
64 :     *)
65 :    
66 :     val intersectWith : ('a * 'b -> 'c) -> ('a map * 'b map) -> 'c map
67 :     val intersectWithi : (Key.ord_key * 'a * 'b -> 'c) -> ('a map * 'b map) -> 'c map
68 :     (* return a map whose domain is the intersection of the domains of the
69 :     * two input maps, using the supplied function to define the range.
70 :     *)
71 :    
72 :     val app : ('a -> unit) -> 'a map -> unit
73 :     val appi : ((Key.ord_key * 'a) -> unit) -> 'a map -> unit
74 :     (* Apply a function to the entries of the map in map order. *)
75 :    
76 :     val map : ('a -> 'b) -> 'a map -> 'b map
77 :     val mapi : (Key.ord_key * 'a -> 'b) -> 'a map -> 'b map
78 :     (* Create a new map by applying a map function to the
79 :     * name/value pairs in the map.
80 :     *)
81 :    
82 :     val foldl : ('a * 'b -> 'b) -> 'b -> 'a map -> 'b
83 :     val foldli : (Key.ord_key * 'a * 'b -> 'b) -> 'b -> 'a map -> 'b
84 :     (* Apply a folding function to the entries of the map
85 :     * in increasing map order.
86 :     *)
87 :    
88 :     val foldr : ('a * 'b -> 'b) -> 'b -> 'a map -> 'b
89 :     val foldri : (Key.ord_key * 'a * 'b -> 'b) -> 'b -> 'a map -> 'b
90 :     (* Apply a folding function to the entries of the map
91 :     * in decreasing map order.
92 :     *)
93 :    
94 :     val filter : ('a -> bool) -> 'a map -> 'a map
95 :     val filteri : (Key.ord_key * 'a -> bool) -> 'a map -> 'a map
96 :     (* Filter out those elements of the map that do not satisfy the
97 :     * predicate. The filtering is done in increasing map order.
98 :     *)
99 :    
100 :     val mapPartial : ('a -> 'b option) -> 'a map -> 'b map
101 :     val mapPartiali : (Key.ord_key * 'a -> 'b option) -> 'a map -> 'b map
102 :     (* map a partial function over the elements of a map in increasing
103 :     * map order.
104 :     *)
105 :    
106 :     end (* ORD_MAP *)

root@smlnj-gforge.cs.uchicago.edu
ViewVC Help
Powered by ViewVC 1.0.0