author  wenzelm 
Sun, 07 Sep 2008 22:19:46 +0200  
changeset 28157  0435d23deccc 
parent 28122  3d099ce624e7 
child 28347  3cb64932ac77 
permissions  rwrr 
41
97aae241094b
added cons, rcons, last_elem, sort_strings, take_suffix;
wenzelm
parents:
24
diff
changeset

1 
(* Title: Pure/library.ML 
0  2 
ID: $Id$ 
233  3 
Author: Lawrence C Paulson, Cambridge University Computer Laboratory 
16188  4 
Author: Markus Wenzel, TU Muenchen 
0  5 

233  6 
Basic library: functions, options, pairs, booleans, lists, integers, 
23424
d0580634f128
moved balanced tree operations to General/balanced_tree.ML;
wenzelm
parents:
23251
diff
changeset

7 
strings, lists as sets, orders, current directory, misc. 
21395
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

8 

f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

9 
See also General/basics.ML for the most fundamental concepts. 
0  10 
*) 
11 

21395
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

12 
infix 1 >>> 
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

13 
infix 2 ? 
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

14 
infix 3 o oo ooo oooo 
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

15 
infix 4 ~~ upto downto 
20854  16 
infix orf andf \ \\ mem mem_int mem_string union union_int 
21395
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

17 
union_string inter inter_int inter_string subset subset_int subset_string 
5893  18 

15745  19 
signature BASIC_LIBRARY = 
4621  20 
sig 
21 
(*functions*) 

23860  22 
val undefined: 'a > 'b 
16842  23 
val I: 'a > 'a 
24 
val K: 'a > 'b > 'a 

4621  25 
val curry: ('a * 'b > 'c) > 'a > 'b > 'c 
26 
val uncurry: ('a > 'b > 'c) > 'a * 'b > 'c 

21335
6b9d4a19a3a8
added higherorder combinators for structured results
haftmann
parents:
21182
diff
changeset

27 
val >>> : ('a * 'c) * ('a > 'b * 'd) > 'b * ('c * 'd) 
21565  28 
val ? : bool * ('a > 'a) > 'a > 'a 
16721  29 
val oo: ('a > 'b) * ('c > 'd > 'a) > 'c > 'd > 'b 
30 
val ooo: ('a > 'b) * ('c > 'd > 'e > 'a) > 'c > 'd > 'e > 'b 

31 
val oooo: ('a > 'b) * ('c > 'd > 'e > 'f > 'a) > 'c > 'd > 'e > 'f > 'b 

16842  32 
val funpow: int > ('a > 'a) > 'a > 'a 
1364
8ea1a962ad72
files now define a structure to allow SML/NJ to optimize the code
clasohm
parents:
1290
diff
changeset

33 

18681
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

34 
(*errors*) 
19542  35 
exception SYS_ERROR of string 
36 
val sys_error: string > 'a 

18681
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

37 
exception ERROR of string 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

38 
val error: string > 'a 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

39 
val cat_error: string > string > 'a 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

40 
val assert_all: ('a > bool) > 'a list > ('a > string) > unit 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

41 

4621  42 
(*pairs*) 
43 
val pair: 'a > 'b > 'a * 'b 

44 
val rpair: 'a > 'b > 'b * 'a 

45 
val fst: 'a * 'b > 'a 

46 
val snd: 'a * 'b > 'b 

17498
d83af87bbdc5
improved eq_fst and eq_snd, removed some deprecated stuff
haftmann
parents:
17486
diff
changeset

47 
val eq_fst: ('a * 'c > bool) > ('a * 'b) * ('c * 'd) > bool 
d83af87bbdc5
improved eq_fst and eq_snd, removed some deprecated stuff
haftmann
parents:
17486
diff
changeset

48 
val eq_snd: ('b * 'd > bool) > ('a * 'b) * ('c * 'd) > bool 
19454
46a7e133f802
moved coalesce to AList, added equality predicates to library
haftmann
parents:
19424
diff
changeset

49 
val eq_pair: ('a * 'c > bool) > ('b * 'd > bool) > ('a * 'b) * ('c * 'd) > bool 
4621  50 
val swap: 'a * 'b > 'b * 'a 
51 
val apfst: ('a > 'b) > 'a * 'c > 'b * 'c 

52 
val apsnd: ('a > 'b) > 'c * 'a > 'c * 'b 

53 
val pairself: ('a > 'b) > 'a * 'a > 'b * 'b 

54 

55 
(*booleans*) 

56 
val equal: ''a > ''a > bool 

57 
val not_equal: ''a > ''a > bool 

58 
val orf: ('a > bool) * ('a > bool) > 'a > bool 

59 
val andf: ('a > bool) * ('a > bool) > 'a > bool 

60 
val exists: ('a > bool) > 'a list > bool 

61 
val forall: ('a > bool) > 'a list > bool 

62 
val set: bool ref > bool 

63 
val reset: bool ref > bool 

64 
val toggle: bool ref > bool 

9118  65 
val change: 'a ref > ('a > 'a) > unit 
28157  66 
val change_result: 'a ref > ('a > 'b * 'a) > 'b 
23932  67 
val setmp_noncritical: 'a ref > 'a > ('b > 'c) > 'b > 'c 
4621  68 
val setmp: 'a ref > 'a > ('b > 'c) > 'b > 'c 
25797  69 
val setmp_thread_data: 'a Universal.tag > 'a > 'a > ('b > 'c) > 'b > 'c 
4621  70 

71 
(*lists*) 

15570  72 
exception UnequalLengths 
5285  73 
val single: 'a > 'a list 
20882  74 
val the_single: 'a list > 'a 
19273  75 
val singleton: ('a list > 'b list) > 'a > 'b 
25061  76 
val yield_singleton: ('a list > 'c > 'b list * 'c) > 'a > 'c > 'b * 'c 
5904  77 
val apply: ('a > 'a) list > 'a > 'a 
25058  78 
val perhaps_apply: ('a > 'a option) list > 'a > 'a option 
79 
val perhaps_loop: ('a > 'a option) > 'a > 'a option 

25681  80 
val foldl1: ('a * 'a > 'a) > 'a list > 'a 
15760  81 
val foldr1: ('a * 'a > 'a) > 'a list > 'a 
18278  82 
val foldl_map: ('a * 'b > 'a * 'c) > 'a * 'b list > 'a * 'c list 
19461  83 
val flat: 'a list list > 'a list 
19424  84 
val unflat: 'a list list > 'b list > 'b list list 
18441  85 
val burrow: ('a list > 'b list) > 'a list list > 'b list list 
24864  86 
val burrow_options: ('a list > 'b list) > 'a option list > 'b option list 
18549
5308a6ea3b96
rearranged burrow_split to fold_burrow to allow composition with fold_map
haftmann
parents:
18514
diff
changeset

87 
val fold_burrow: ('a list > 'c > 'b list * 'd) > 'a list list > 'c > 'b list list * 'd 
21395
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

88 
val maps: ('a > 'b list) > 'a list > 'b list 
25549  89 
val filter: ('a > bool) > 'a list > 'a list 
90 
val filter_out: ('a > bool) > 'a list > 'a list 

91 
val map_filter: ('a > 'b option) > 'a list > 'b list 

19011  92 
val chop: int > 'a list > 'a list * 'a list 
4713  93 
val dropwhile: ('a > bool) > 'a list > 'a list 
18278  94 
val nth: 'a list > int > 'a 
18011
685d95c793ff
cleaned up nth, nth_update, nth_map and nth_string functions
haftmann
parents:
17952
diff
changeset

95 
val nth_map: int > ('a > 'a) > 'a list > 'a list 
24846  96 
val nth_drop: int > 'a list > 'a list 
18286  97 
val nth_list: 'a list list > int > 'a list 
18514  98 
val map_index: (int * 'a > 'b) > 'a list > 'b list 
99 
val fold_index: (int * 'a > 'b > 'b) > 'a list > 'b > 'b 

4621  100 
val split_last: 'a list > 'a list * 'a 
101 
val find_index: ('a > bool) > 'a list > int 

102 
val find_index_eq: ''a > ''a list > int 

103 
val find_first: ('a > bool) > 'a list > 'a option 

19233
77ca20b0ed77
renamed HOL +  * etc. to HOL.plus HOL.minus HOL.times etc.
haftmann
parents:
19119
diff
changeset

104 
val get_index: ('a > 'b option) > 'a list > (int * 'b) option 
4916
fe8b0c82691b
get_first: ('a > 'b option) > 'a list > 'b option;
wenzelm
parents:
4893
diff
changeset

105 
val get_first: ('a > 'b option) > 'a list > 'b option 
19454
46a7e133f802
moved coalesce to AList, added equality predicates to library
haftmann
parents:
19424
diff
changeset

106 
val eq_list: ('a * 'b > bool) > 'a list * 'b list > bool 
18330  107 
val map2: ('a > 'b > 'c) > 'a list > 'b list > 'c list 
108 
val fold2: ('a > 'b > 'c > 'c) > 'a list > 'b list > 'c > 'c 

19799  109 
val zip_options: 'a list > 'b option list > ('a * 'b) list 
18330  110 
val ~~ : 'a list * 'b list > ('a * 'b) list 
25943  111 
val map_split: ('a > 'b * 'c) > 'a list > 'b list * 'c list 
18330  112 
val split_list: ('a * 'b) list > 'a list * 'b list 
26449  113 
val map_product: ('a > 'b > 'c) > 'a list > 'b list > 'c list 
114 
val fold_product: ('a > 'b > 'c > 'c) > 'a list > 'b list > 'c > 'c 

4621  115 
val separate: 'a > 'a list > 'a list 
25980  116 
val surround: 'a > 'a list > 'a list 
4621  117 
val replicate: int > 'a > 'a list 
18441  118 
val is_prefix: ('a * 'a > bool) > 'a list > 'a list > bool 
4621  119 
val take_prefix: ('a > bool) > 'a list > 'a list * 'a list 
20108  120 
val chop_prefix: ('a * 'b > bool) > 'a list * 'b list > 'a list * ('a list * 'b list) 
4621  121 
val take_suffix: ('a > bool) > 'a list > 'a list * 'a list 
12249  122 
val prefixes1: 'a list > 'a list list 
19011  123 
val prefixes: 'a list > 'a list list 
12249  124 
val suffixes1: 'a list > 'a list list 
19011  125 
val suffixes: 'a list > 'a list list 
4621  126 

127 
(*integers*) 

128 
val inc: int ref > int 

129 
val dec: int ref > int 

130 
val upto: int * int > int list 

131 
val downto: int * int > int list 

132 
val radixpand: int * int > int list 

133 
val radixstring: int * string * int > string 

134 
val string_of_int: int > string 

21942
d6218d0f9ec3
added signed_string_of_int (pruduces proper  instead of SML's ~);
wenzelm
parents:
21920
diff
changeset

135 
val signed_string_of_int: int > string 
4621  136 
val string_of_indexname: string * int > string 
24630
351a308ab58d
simplified type int (eliminated IntInf.int, integer);
wenzelm
parents:
24593
diff
changeset

137 
val read_radix_int: int > string list > int * string list 
14826
48cfe0fe53e2
output channels and diagnostics moved to General/output.ML; added read_int etc. from term.ML; removed obsolete mtree; type rat uses exception RAT;
wenzelm
parents:
14797
diff
changeset

138 
val read_int: string list > int * string list 
48cfe0fe53e2
output channels and diagnostics moved to General/output.ML; added read_int etc. from term.ML; removed obsolete mtree; type rat uses exception RAT;
wenzelm
parents:
14797
diff
changeset

139 
val oct_char: string > string 
4621  140 

141 
(*strings*) 

18011
685d95c793ff
cleaned up nth, nth_update, nth_map and nth_string functions
haftmann
parents:
17952
diff
changeset

142 
val nth_string: string > int > string 
16188  143 
val fold_string: (string > 'a > 'a) > string > 'a > 'a 
6312  144 
val exists_string: (string > bool) > string > bool 
16188  145 
val forall_string: (string > bool) > string > bool 
28025  146 
val first_field: string > string > (string * string) option 
4621  147 
val enclose: string > string > string > string 
6642  148 
val unenclose: string > string 
4621  149 
val quote: string > string 
150 
val space_implode: string > string list > string 

151 
val commas: string list > string 

152 
val commas_quote: string list > string 

153 
val cat_lines: string list > string 

154 
val space_explode: string > string > string list 

14826
48cfe0fe53e2
output channels and diagnostics moved to General/output.ML; added read_int etc. from term.ML; removed obsolete mtree; type rat uses exception RAT;
wenzelm
parents:
14797
diff
changeset

155 
val split_lines: string > string list 
5942  156 
val prefix_lines: string > string > string 
18681
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

157 
val prefix: string > string > string 
5285  158 
val suffix: string > string > string 
18681
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

159 
val unprefix: string > string > string 
5285  160 
val unsuffix: string > string > string 
10951  161 
val replicate_string: int > string > string 
14926  162 
val translate_string: (string > string) > string > string 
25549  163 
val multiply: 'a list > 'a list list > 'a list list 
4621  164 

16492  165 
(*lists as sets  see also Pure/General/ord_list.ML*) 
18923  166 
val member: ('b * 'a > bool) > 'a list > 'b > bool 
167 
val insert: ('a * 'a > bool) > 'a > 'a list > 'a list 

168 
val remove: ('b * 'a > bool) > 'b > 'a list > 'a list 

24049  169 
val update: ('a * 'a > bool) > 'a > 'a list > 'a list 
19301  170 
val subtract: ('b * 'a > bool) > 'b list > 'a list > 'a list 
18923  171 
val merge: ('a * 'a > bool) > 'a list * 'a list > 'a list 
4621  172 
val mem: ''a * ''a list > bool 
173 
val mem_int: int * int list > bool 

174 
val mem_string: string * string list > bool 

175 
val union: ''a list * ''a list > ''a list 

176 
val union_int: int list * int list > int list 

177 
val union_string: string list * string list > string list 

178 
val gen_union: ('a * 'a > bool) > 'a list * 'a list > 'a list 

7090  179 
val gen_inter: ('a * 'b > bool) > 'a list * 'b list > 'a list 
4621  180 
val inter: ''a list * ''a list > ''a list 
181 
val inter_int: int list * int list > int list 

182 
val inter_string: string list * string list > string list 

183 
val subset: ''a list * ''a list > bool 

184 
val subset_int: int list * int list > bool 

185 
val subset_string: string list * string list > bool 

186 
val eq_set: ''a list * ''a list > bool 

187 
val eq_set_string: string list * string list > bool 

188 
val gen_subset: ('a * 'b > bool) > 'a list * 'b list > bool 

19301  189 
val gen_eq_set: ('a * 'b > bool) > 'a list * 'b list > bool 
4621  190 
val \ : ''a list * ''a > ''a list 
191 
val \\ : ''a list * ''a list > ''a list 

19046
bc5c6c9b114e
removed distinct, renamed gen_distinct to distinct;
wenzelm
parents:
19011
diff
changeset

192 
val distinct: ('a * 'a > bool) > 'a list > 'a list 
18966  193 
val duplicates: ('a * 'a > bool) > 'a list > 'a list 
16878  194 
val has_duplicates: ('a * 'a > bool) > 'a list > bool 
4621  195 

23220  196 
(*lists as multisets*) 
22142  197 
val remove1: ('b * 'a > bool) > 'b > 'a list > 'a list 
23220  198 
val submultiset: ('a * 'b > bool) > 'a list * 'b list > bool 
4621  199 

200 
(*orders*) 

18966  201 
val is_equal: order > bool 
4621  202 
val rev_order: order > order 
203 
val make_ord: ('a * 'a > bool) > 'a * 'a > order 

25224  204 
val bool_ord: bool * bool > order 
4621  205 
val int_ord: int * int > order 
206 
val string_ord: string * string > order 

16676  207 
val fast_string_ord: string * string > order 
16492  208 
val option_ord: ('a * 'b > order) > 'a option * 'b option > order 
4621  209 
val prod_ord: ('a * 'b > order) > ('c * 'd > order) > ('a * 'c) * ('b * 'd) > order 
210 
val dict_ord: ('a * 'b > order) > 'a list * 'b list > order 

211 
val list_ord: ('a * 'b > order) > 'a list * 'b list > order 

212 
val sort: ('a * 'a > order) > 'a list > 'a list 

18427  213 
val sort_distinct: ('a * 'a > order) > 'a list > 'a list 
4621  214 
val sort_strings: string list > string list 
215 
val sort_wrt: ('a > string) > 'a list > 'a list 

216 

14106
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

217 
(*random numbers*) 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

218 
exception RANDOM 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

219 
val random: unit > real 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

220 
val random_range: int > int > int 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

221 
val one_of: 'a list > 'a 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

222 
val frequency: (int * 'a) list > 'a 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

223 

4621  224 
(*misc*) 
19644
0b01436e1843
added divide_and_conquer combinator (by Amine Chaieb);
wenzelm
parents:
19596
diff
changeset

225 
val divide_and_conquer: ('a > 'a list * ('b list > 'b)) > 'a > 'b 
4621  226 
val partition_eq: ('a * 'a > bool) > 'a list > 'a list list 
227 
val partition_list: (int > 'a > bool) > int > int > 'a list > 'a list list 

228 
val gensym: string > string 

16439  229 
type stamp 
230 
val stamp: unit > stamp 

231 
type serial 

232 
val serial: unit > serial 

19512  233 
val serial_string: unit > string 
16535
86c9eada525b
added structure Object (from Pure/General/object.ML);
wenzelm
parents:
16492
diff
changeset

234 
structure Object: sig type T end 
4621  235 
end; 
236 

15745  237 
signature LIBRARY = 
15570  238 
sig 
15745  239 
include BASIC_LIBRARY 
15570  240 
val foldl: ('a * 'b > 'a) > 'a * 'b list > 'a 
241 
val foldr: ('a * 'b > 'b) > 'a list * 'b > 'b 

242 
val take: int * 'a list > 'a list 

243 
val drop: int * 'a list > 'a list 

244 
val last_elem: 'a list > 'a 

245 
end; 

246 

15745  247 
structure Library: LIBRARY = 
1364
8ea1a962ad72
files now define a structure to allow SML/NJ to optimize the code
clasohm
parents:
1290
diff
changeset

248 
struct 
0  249 

21395
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

250 
(* functions *) 
0  251 

23860  252 
fun undefined _ = raise Match; 
253 

16842  254 
fun I x = x; 
255 
fun K x = fn _ => x; 

233  256 
fun curry f x y = f (x, y); 
257 
fun uncurry f (x, y) = f x y; 

0  258 

21395
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

259 
(*application and structured results  old version*) 
16705  260 
fun (x, y) >>> f = let val (x', z) = f x in (x', (y, z)) end; 
16842  261 

17141
4b0dc89de43b
added ? combinator for conditional transformations
haftmann
parents:
17101
diff
changeset

262 
(*conditional application*) 
21565  263 
fun b ? f = fn x => if b then f x else x; 
17141
4b0dc89de43b
added ? combinator for conditional transformations
haftmann
parents:
17101
diff
changeset

264 

16721  265 
(*composition with multiple args*) 
266 
fun (f oo g) x y = f (g x y); 

267 
fun (f ooo g) x y z = f (g x y z); 

268 
fun (f oooo g) x y z w = f (g x y z w); 

269 

233  270 
(*function exponentiation: f(...(f x)...) with n applications of f*) 
24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

271 
fun funpow (0: int) _ x = x 
23718  272 
 funpow n f x = funpow (n  1) f (f x); 
160  273 

274 

18681
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

275 
(* errors *) 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

276 

19542  277 
exception SYS_ERROR of string; 
278 
fun sys_error msg = raise SYS_ERROR msg; 

279 

18681
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

280 
exception ERROR of string; 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

281 
fun error msg = raise ERROR msg; 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

282 

3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

283 
fun cat_error "" msg = error msg 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

284 
 cat_error msg1 msg2 = error (msg1 ^ "\n" ^ msg2); 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

285 

3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

286 
fun assert_all pred list msg = 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

287 
let 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

288 
fun ass [] = () 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

289 
 ass (x :: xs) = if pred x then ass xs else error (msg x); 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

290 
in ass list end; 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

291 

3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

292 

21395
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

293 
(* pairs *) 
233  294 

295 
fun pair x y = (x, y); 

296 
fun rpair x y = (y, x); 

297 

298 
fun fst (x, y) = x; 

299 
fun snd (x, y) = y; 

300 

17498
d83af87bbdc5
improved eq_fst and eq_snd, removed some deprecated stuff
haftmann
parents:
17486
diff
changeset

301 
fun eq_fst eq ((x1, _), (x2, _)) = eq (x1, x2); 
d83af87bbdc5
improved eq_fst and eq_snd, removed some deprecated stuff
haftmann
parents:
17486
diff
changeset

302 
fun eq_snd eq ((_, y1), (_, y2)) = eq (y1, y2); 
19454
46a7e133f802
moved coalesce to AList, added equality predicates to library
haftmann
parents:
19424
diff
changeset

303 
fun eq_pair eqx eqy ((x1, y1), (x2, y2)) = eqx (x1, x2) andalso eqy (y1, y2); 
233  304 

305 
fun swap (x, y) = (y, x); 

306 

307 
fun apfst f (x, y) = (f x, y); 

308 
fun apsnd f (x, y) = (x, f y); 

4212  309 
fun pairself f (x, y) = (f x, f y); 
233  310 

311 

21395
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

312 
(* booleans *) 
233  313 

21395
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

314 
(*polymorphic equality*) 
233  315 
fun equal x y = x = y; 
316 
fun not_equal x y = x <> y; 

317 

21395
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

318 
(*combining predicates*) 
16721  319 
fun p orf q = fn x => p x orelse q x; 
320 
fun p andf q = fn x => p x andalso q x; 

233  321 

25752  322 
val exists = List.exists; 
323 
val forall = List.all; 

0  324 

19644
0b01436e1843
added divide_and_conquer combinator (by Amine Chaieb);
wenzelm
parents:
19596
diff
changeset

325 

380  326 
(* flags *) 
327 

328 
fun set flag = (flag := true; true); 

329 
fun reset flag = (flag := false; false); 

330 
fun toggle flag = (flag := not (! flag); ! flag); 

331 

9118  332 
fun change r f = r := f (! r); 
28157  333 
fun change_result r f = let val (x, y) = f (! r) in r := y; x end; 
9118  334 

18712  335 
(*temporarily set flag during execution*) 
23932  336 
fun setmp_noncritical flag value f x = 
26079  337 
uninterruptible (fn restore_attributes => fn () => 
338 
let 

339 
val orig_value = ! flag; 

340 
val _ = flag := value; 

341 
val result = Exn.capture (restore_attributes f) x; 

342 
val _ = flag := orig_value; 

343 
in Exn.release result end) (); 

2958  344 

26079  345 
fun setmp flag value f x = 
346 
NAMED_CRITICAL "setmp" (fn () => setmp_noncritical flag value f x); 

23932  347 

25797  348 
fun setmp_thread_data tag orig_data data f x = 
26079  349 
uninterruptible (fn restore_attributes => fn () => 
350 
let 

28122  351 
val _ = Thread.setLocal (tag, data); 
26079  352 
val result = Exn.capture (restore_attributes f) x; 
28122  353 
val _ = Thread.setLocal (tag, orig_data); 
26079  354 
in Exn.release result end) (); 
25797  355 

19644
0b01436e1843
added divide_and_conquer combinator (by Amine Chaieb);
wenzelm
parents:
19596
diff
changeset

356 

21395
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

357 

233  358 
(** lists **) 
359 

15570  360 
exception UnequalLengths; 
233  361 

5285  362 
fun single x = [x]; 
233  363 

20882  364 
fun the_single [x] = x 
365 
 the_single _ = raise Empty; 

366 

367 
fun singleton f x = the_single (f [x]); 

19273  368 

25061  369 
fun yield_singleton f x = f [x] #>> the_single; 
370 

5904  371 
fun apply [] x = x 
372 
 apply (f :: fs) x = apply fs (f x); 

373 

25058  374 
fun perhaps_apply funs arg = 
375 
let 

376 
fun app [] res = res 

377 
 app (f :: fs) (changed, x) = 

378 
(case f x of 

379 
NONE => app fs (changed, x) 

380 
 SOME x' => app fs (true, x')); 

381 
in (case app funs (false, arg) of (false, _) => NONE  (true, arg') => SOME arg') end; 

382 

383 
fun perhaps_loop f arg = 

384 
let 

385 
fun loop (changed, x) = 

386 
(case f x of 

387 
NONE => (changed, x) 

388 
 SOME x' => loop (true, x')); 

389 
in (case loop (false, arg) of (false, _) => NONE  (true, arg') => SOME arg') end; 

390 

233  391 

21395
f34ac19659ae
moved some fundamental concepts to General/basics.ML;
wenzelm
parents:
21335
diff
changeset

392 
(* fold  old versions *) 
16691
539b9cc282fa
added combinatros '>' and '>>' and fold_map fitting nicely to ST combinator '>'
haftmann
parents:
16688
diff
changeset

393 

233  394 
(*the following versions of fold are designed to fit nicely with infixes*) 
0  395 

233  396 
(* (op @) (e, [x1, ..., xn]) ===> ((e @ x1) @ x2) ... @ xn 
397 
for operators that associate to the left (TAIL RECURSIVE)*) 

398 
fun foldl (f: 'a * 'b > 'a) : 'a * 'b list > 'a = 

399 
let fun itl (e, []) = e 

400 
 itl (e, a::l) = itl (f(e, a), l) 

401 
in itl end; 

402 

403 
(* (op @) ([x1, ..., xn], e) ===> x1 @ (x2 ... @ (xn @ e)) 

404 
for operators that associate to the right (not tail recursive)*) 

405 
fun foldr f (l, e) = 

406 
let fun itr [] = e 

407 
 itr (a::l) = f(a, itr l) 

408 
in itr l end; 

409 

25681  410 
(* (op @) [x1, ..., xn] ===> ((x1 @ x2) @ x3) ... @ xn 
411 
for operators that associate to the left (TAIL RECURSIVE)*) 

412 
fun foldl1 f [] = raise Empty 

413 
 foldl1 f (x :: xs) = foldl f (x, xs); 

414 

233  415 
(* (op @) [x1, ..., xn] ===> x1 @ (x2 ... @ (x[n1] @ xn)) 
416 
for n > 0, operators that associate to the right (not tail recursive)*) 

20443  417 
fun foldr1 f [] = raise Empty 
20510  418 
 foldr1 f l = 
20443  419 
let fun itr [x] = x 
20510  420 
 itr (x::l) = f(x, itr l) 
20443  421 
in itr l end; 
233  422 

16705  423 
fun foldl_map f = 
424 
let 

425 
fun fold_aux (x, []) = (x, []) 

426 
 fold_aux (x, y :: ys) = 

427 
let 

428 
val (x', y') = f (x, y); 

429 
val (x'', ys') = fold_aux (x', ys); 

430 
in (x'', y' :: ys') end; 

431 
in fold_aux end; 

432 

233  433 

434 
(* basic list functions *) 

435 

20510  436 
fun eq_list eq (list1, list2) = 
20348  437 
let 
20510  438 
fun eq_lst (x :: xs, y :: ys) = eq (x, y) andalso eq_lst (xs, ys) 
439 
 eq_lst _ = true; 

440 
in length list1 = length list2 andalso eq_lst (list1, list2) end; 

20348  441 

19483
55ee839198bd
renamed mapfilter to map_filter, made pervasive (again);
wenzelm
parents:
19474
diff
changeset

442 
fun maps f [] = [] 
55ee839198bd
renamed mapfilter to map_filter, made pervasive (again);
wenzelm
parents:
19474
diff
changeset

443 
 maps f (x :: xs) = f x @ maps f xs; 
55ee839198bd
renamed mapfilter to map_filter, made pervasive (again);
wenzelm
parents:
19474
diff
changeset

444 

25538  445 
val filter = List.filter; 
446 
fun filter_out f = filter (not o f); 

447 
val map_filter = List.mapPartial; 

448 

24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

449 
fun chop (0: int) xs = ([], xs) 
23220  450 
 chop _ [] = ([], []) 
451 
 chop n (x :: xs) = chop (n  1) xs >> cons x; 

19011  452 

233  453 
(*take the first n elements from a list*) 
24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

454 
fun take (n: int, []) = [] 
233  455 
 take (n, x :: xs) = 
456 
if n > 0 then x :: take (n  1, xs) else []; 

457 

458 
(*drop the first n elements from a list*) 

24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

459 
fun drop (n: int, []) = [] 
233  460 
 drop (n, x :: xs) = 
461 
if n > 0 then drop (n  1, xs) else x :: xs; 

0  462 

4713  463 
fun dropwhile P [] = [] 
464 
 dropwhile P (ys as x::xs) = if P x then dropwhile P xs else ys; 

465 

233  466 
(*return nth element of a list, where 0 designates the first element; 
18461  467 
raise Subscript if list too short*) 
18011
685d95c793ff
cleaned up nth, nth_update, nth_map and nth_string functions
haftmann
parents:
17952
diff
changeset

468 
fun nth xs i = List.nth (xs, i); 
233  469 

18461  470 
fun nth_list xss i = nth xss i handle Subscript => []; 
471 

18011
685d95c793ff
cleaned up nth, nth_update, nth_map and nth_string functions
haftmann
parents:
17952
diff
changeset

472 
fun nth_map 0 f (x :: xs) = f x :: xs 
685d95c793ff
cleaned up nth, nth_update, nth_map and nth_string functions
haftmann
parents:
17952
diff
changeset

473 
 nth_map n f (x :: xs) = x :: nth_map (n  1) f xs 
24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

474 
 nth_map (_: int) _ [] = raise Subscript; 
11773  475 

24846  476 
fun nth_drop n xs = 
477 
List.take (xs, n) @ List.drop (xs, n + 1); 

478 

18514  479 
fun map_index f = 
480 
let 

24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

481 
fun mapp (_: int) [] = [] 
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

482 
 mapp i (x :: xs) = f (i, x) :: mapp (i + 1) xs 
18514  483 
in mapp 0 end; 
484 

21118  485 
fun fold_index f = 
486 
let 

24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

487 
fun fold_aux (_: int) [] y = y 
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

488 
 fold_aux i (x :: xs) y = fold_aux (i + 1) xs (f (i, x) y); 
21118  489 
in fold_aux 0 end; 
490 

15570  491 
val last_elem = List.last; 
233  492 

3762  493 
(*rear decomposition*) 
15570  494 
fun split_last [] = raise Empty 
3762  495 
 split_last [x] = ([], x) 
496 
 split_last (x :: xs) = apfst (cons x) (split_last xs); 

497 

4212  498 
(*find the position of an element in a list*) 
499 
fun find_index pred = 

24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

500 
let fun find (_: int) [] = ~1 
4212  501 
 find n (x :: xs) = if pred x then n else find (n + 1) xs; 
502 
in find 0 end; 

3762  503 

4224  504 
fun find_index_eq x = find_index (equal x); 
4212  505 

506 
(*find first element satisfying predicate*) 

22593  507 
val find_first = List.find; 
233  508 

4916
fe8b0c82691b
get_first: ('a > 'b option) > 'a list > 'b option;
wenzelm
parents:
4893
diff
changeset

509 
(*get first element by lookup function*) 
15531  510 
fun get_first _ [] = NONE 
4916
fe8b0c82691b
get_first: ('a > 'b option) > 'a list > 'b option;
wenzelm
parents:
4893
diff
changeset

511 
 get_first f (x :: xs) = 
fe8b0c82691b
get_first: ('a > 'b option) > 'a list > 'b option;
wenzelm
parents:
4893
diff
changeset

512 
(case f x of 
15531  513 
NONE => get_first f xs 
4916
fe8b0c82691b
get_first: ('a > 'b option) > 'a list > 'b option;
wenzelm
parents:
4893
diff
changeset

514 
 some => some); 
fe8b0c82691b
get_first: ('a > 'b option) > 'a list > 'b option;
wenzelm
parents:
4893
diff
changeset

515 

19233
77ca20b0ed77
renamed HOL +  * etc. to HOL.plus HOL.minus HOL.times etc.
haftmann
parents:
19119
diff
changeset

516 
fun get_index f = 
77ca20b0ed77
renamed HOL +  * etc. to HOL.plus HOL.minus HOL.times etc.
haftmann
parents:
19119
diff
changeset

517 
let 
24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

518 
fun get (_: int) [] = NONE 
19461  519 
 get i (x :: xs) = 
19233
77ca20b0ed77
renamed HOL +  * etc. to HOL.plus HOL.minus HOL.times etc.
haftmann
parents:
19119
diff
changeset

520 
case f x 
19461  521 
of NONE => get (i + 1) xs 
19233
77ca20b0ed77
renamed HOL +  * etc. to HOL.plus HOL.minus HOL.times etc.
haftmann
parents:
19119
diff
changeset

522 
 SOME y => SOME (i, y) 
77ca20b0ed77
renamed HOL +  * etc. to HOL.plus HOL.minus HOL.times etc.
haftmann
parents:
19119
diff
changeset

523 
in get 0 end; 
77ca20b0ed77
renamed HOL +  * etc. to HOL.plus HOL.minus HOL.times etc.
haftmann
parents:
19119
diff
changeset

524 

15531  525 
val flat = List.concat; 
233  526 

12136  527 
fun unflat (xs :: xss) ys = 
19424  528 
let val (ps, qs) = chop (length xs) ys 
13629  529 
in ps :: unflat xss qs end 
12136  530 
 unflat [] [] = [] 
15570  531 
 unflat _ _ = raise UnequalLengths; 
12136  532 

21479
63e7eb863ae6
moved string_of_pair/list/option to structure ML_Syntax;
wenzelm
parents:
21395
diff
changeset

533 
fun burrow f xss = unflat xss (f (flat xss)); 
18359  534 

24864  535 
fun burrow_options f os = map (try hd) (burrow f (map the_list os)); 
536 

18549
5308a6ea3b96
rearranged burrow_split to fold_burrow to allow composition with fold_map
haftmann
parents:
18514
diff
changeset

537 
fun fold_burrow f xss s = 
5308a6ea3b96
rearranged burrow_split to fold_burrow to allow composition with fold_map
haftmann
parents:
18514
diff
changeset

538 
apfst (unflat xss) (f (flat xss) s); 
18359  539 

233  540 
(*separate s [x1, x2, ..., xn] ===> [x1, s, x2, s, ..., s, xn]*) 
541 
fun separate s (x :: (xs as _ :: _)) = x :: s :: separate s xs 

542 
 separate _ xs = xs; 

543 

25980  544 
fun surround s (x :: xs) = s :: x :: surround s xs 
545 
 surround s [] = [s]; 

546 

233  547 
(*make the list [x, x, ..., x] of length n*) 
24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

548 
fun replicate (n: int) x = 
233  549 
let fun rep (0, xs) = xs 
550 
 rep (n, xs) = rep (n  1, x :: xs) 

551 
in 

15570  552 
if n < 0 then raise Subscript 
233  553 
else rep (n, []) 
554 
end; 

555 

14926  556 
fun translate_string f = String.translate (f o String.str); 
557 

4248
5e8a31c41d44
added get_error: 'a error > string option, get_ok: 'a error > 'a option;
wenzelm
parents:
4224
diff
changeset

558 
(*multiply [a, b, c, ...] * [xs, ys, zs, ...]*) 
18148  559 
fun multiply [] _ = [] 
560 
 multiply (x :: xs) yss = map (cons x) yss @ multiply xs yss; 

4248
5e8a31c41d44
added get_error: 'a error > string option, get_ok: 'a error > 'a option;
wenzelm
parents:
4224
diff
changeset

561 

25549  562 

563 
(* direct product *) 

564 

25538  565 
fun map_product f _ [] = [] 
566 
 map_product f [] _ = [] 

567 
 map_product f (x :: xs) ys = map (f x) ys @ map_product f xs ys; 

233  568 

25538  569 
fun fold_product f _ [] z = z 
570 
 fold_product f [] _ z = z 

571 
 fold_product f (x :: xs) ys z = z > fold (f x) ys > fold_product f xs ys; 

233  572 

25549  573 

574 
(* lists of pairs *) 

233  575 

15570  576 
exception UnequalLengths; 
577 

18330  578 
fun map2 _ [] [] = [] 
579 
 map2 f (x :: xs) (y :: ys) = f x y :: map2 f xs ys 

580 
 map2 _ _ _ = raise UnequalLengths; 

380  581 

23220  582 
fun fold2 f [] [] z = z 
583 
 fold2 f (x :: xs) (y :: ys) z = fold2 f xs ys (f x y z) 

584 
 fold2 f _ _ _ = raise UnequalLengths; 

380  585 

25943  586 
fun map_split f [] = ([], []) 
587 
 map_split f (x :: xs) = 

588 
let 

589 
val (y, w) = f x; 

590 
val (ys, ws) = map_split f xs; 

591 
in (y :: ys, w :: ws) end; 

592 

19799  593 
fun zip_options (x :: xs) (SOME y :: ys) = (x, y) :: zip_options xs ys 
594 
 zip_options (_ :: xs) (NONE :: ys) = zip_options xs ys 

595 
 zip_options _ [] = [] 

596 
 zip_options [] _ = raise UnequalLengths; 

4956
a7538e43896e
added foldl_map: ('a * 'b > 'a * 'c) > 'a * 'b list > 'a * 'c list;
wenzelm
parents:
4945
diff
changeset

597 

233  598 
(*combine two lists forming a list of pairs: 
599 
[x1, ..., xn] ~~ [y1, ..., yn] ===> [(x1, y1), ..., (xn, yn)]*) 

600 
fun [] ~~ [] = [] 

601 
 (x :: xs) ~~ (y :: ys) = (x, y) :: (xs ~~ ys) 

15570  602 
 _ ~~ _ = raise UnequalLengths; 
233  603 

604 
(*inverse of ~~; the old 'split': 

605 
[(x1, y1), ..., (xn, yn)] ===> ([x1, ..., xn], [y1, ..., yn])*) 

15570  606 
val split_list = ListPair.unzip; 
233  607 

608 

609 
(* prefixes, suffixes *) 

610 

18441  611 
fun is_prefix _ [] _ = true 
612 
 is_prefix eq (x :: xs) (y :: ys) = eq (x, y) andalso is_prefix eq xs ys 

613 
 is_prefix eq _ _ = false; 

233  614 

615 
(* [x1, ..., xi, ..., xn] > ([x1, ..., x(i1)], [xi, ..., xn]) 

616 
where xi is the first element that does not satisfy the predicate*) 

617 
fun take_prefix (pred : 'a > bool) (xs: 'a list) : 'a list * 'a list = 

618 
let fun take (rxs, []) = (rev rxs, []) 

255
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

619 
 take (rxs, x :: xs) = 
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

620 
if pred x then take(x :: rxs, xs) else (rev rxs, x :: xs) 
233  621 
in take([], xs) end; 
622 

20108  623 
fun chop_prefix eq ([], ys) = ([], ([], ys)) 
624 
 chop_prefix eq (xs, []) = ([], (xs, [])) 

23220  625 
 chop_prefix eq (xs as x :: xs', ys as y :: ys') = 
20108  626 
if eq (x, y) then 
627 
let val (ps', xys'') = chop_prefix eq (xs', ys') 

23220  628 
in (x :: ps', xys'') end 
20108  629 
else ([], (xs, ys)); 
630 

233  631 
(* [x1, ..., xi, ..., xn] > ([x1, ..., xi], [x(i+1), ..., xn]) 
632 
where xi is the last element that does not satisfy the predicate*) 

633 
fun take_suffix _ [] = ([], []) 

634 
 take_suffix pred (x :: xs) = 

635 
(case take_suffix pred xs of 

636 
([], sffx) => if pred x then ([], x :: sffx) else ([x], sffx) 

637 
 (prfx, sffx) => (x :: prfx, sffx)); 

638 

12249  639 
fun prefixes1 [] = [] 
640 
 prefixes1 (x :: xs) = map (cons x) ([] :: prefixes1 xs); 

641 

19011  642 
fun prefixes xs = [] :: prefixes1 xs; 
643 

12249  644 
fun suffixes1 xs = map rev (prefixes1 (rev xs)); 
19011  645 
fun suffixes xs = [] :: suffixes1 xs; 
233  646 

23220  647 

648 

233  649 
(** integers **) 
650 

24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

651 
fun inc i = (i := ! i + (1: int); ! i); 
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

652 
fun dec i = (i := ! i  (1: int); ! i); 
233  653 

654 

655 
(* lists of integers *) 

656 

657 
(*make the list [from, from + 1, ..., to]*) 

24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

658 
fun ((i: int) upto j) = 
21859  659 
if i > j then [] else i :: (i + 1 upto j); 
233  660 

661 
(*make the list [from, from  1, ..., to]*) 

24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

662 
fun ((i: int) downto j) = 
21859  663 
if i < j then [] else i :: (i  1 downto j); 
233  664 

665 

666 
(* convert integers to strings *) 

667 

668 
(*expand the number in the given base; 

669 
example: radixpand (2, 8) gives [1, 0, 0, 0]*) 

670 
fun radixpand (base, num) : int list = 

671 
let 

672 
fun radix (n, tail) = 

673 
if n < base then n :: tail 

674 
else radix (n div base, (n mod base) :: tail) 

675 
in radix (num, []) end; 

676 

677 
(*expands a number into a string of characters starting from "zerochar"; 

678 
example: radixstring (2, "0", 8) gives "1000"*) 

679 
fun radixstring (base, zerochar, num) = 

680 
let val offset = ord zerochar; 

681 
fun chrof n = chr (offset + n) 

682 
in implode (map chrof (radixpand (base, num))) end; 

683 

684 

3407
afd288caf573
Removal of radixstring from string_of_int; addition of string_of_indexname
paulson
parents:
3393
diff
changeset

685 
val string_of_int = Int.toString; 
233  686 

21942
d6218d0f9ec3
added signed_string_of_int (pruduces proper  instead of SML's ~);
wenzelm
parents:
21920
diff
changeset

687 
fun signed_string_of_int i = 
d6218d0f9ec3
added signed_string_of_int (pruduces proper  instead of SML's ~);
wenzelm
parents:
21920
diff
changeset

688 
if i < 0 then "" ^ string_of_int (~ i) else string_of_int i; 
d6218d0f9ec3
added signed_string_of_int (pruduces proper  instead of SML's ~);
wenzelm
parents:
21920
diff
changeset

689 

23220  690 
fun string_of_indexname (a, 0) = a 
691 
 string_of_indexname (a, i) = a ^ "_" ^ string_of_int i; 

233  692 

693 

14826
48cfe0fe53e2
output channels and diagnostics moved to General/output.ML; added read_int etc. from term.ML; removed obsolete mtree; type rat uses exception RAT;
wenzelm
parents:
14797
diff
changeset

694 
(* read integers *) 
48cfe0fe53e2
output channels and diagnostics moved to General/output.ML; added read_int etc. from term.ML; removed obsolete mtree; type rat uses exception RAT;
wenzelm
parents:
14797
diff
changeset

695 

24630
351a308ab58d
simplified type int (eliminated IntInf.int, integer);
wenzelm
parents:
24593
diff
changeset

696 
fun read_radix_int radix cs = 
20095  697 
let 
698 
val zero = ord "0"; 

699 
val limit = zero + radix; 

700 
fun scan (num, []) = (num, []) 

701 
 scan (num, c :: cs) = 

702 
if zero <= ord c andalso ord c < limit then 

24630
351a308ab58d
simplified type int (eliminated IntInf.int, integer);
wenzelm
parents:
24593
diff
changeset

703 
scan (radix * num + (ord c  zero), cs) 
20095  704 
else (num, c :: cs); 
24630
351a308ab58d
simplified type int (eliminated IntInf.int, integer);
wenzelm
parents:
24593
diff
changeset

705 
in scan (0, cs) end; 
14826
48cfe0fe53e2
output channels and diagnostics moved to General/output.ML; added read_int etc. from term.ML; removed obsolete mtree; type rat uses exception RAT;
wenzelm
parents:
14797
diff
changeset

706 

24630
351a308ab58d
simplified type int (eliminated IntInf.int, integer);
wenzelm
parents:
24593
diff
changeset

707 
val read_int = read_radix_int 10; 
14826
48cfe0fe53e2
output channels and diagnostics moved to General/output.ML; added read_int etc. from term.ML; removed obsolete mtree; type rat uses exception RAT;
wenzelm
parents:
14797
diff
changeset

708 

24630
351a308ab58d
simplified type int (eliminated IntInf.int, integer);
wenzelm
parents:
24593
diff
changeset

709 
fun oct_char s = chr (#1 (read_radix_int 8 (explode s))); 
14826
48cfe0fe53e2
output channels and diagnostics moved to General/output.ML; added read_int etc. from term.ML; removed obsolete mtree; type rat uses exception RAT;
wenzelm
parents:
14797
diff
changeset

710 

48cfe0fe53e2
output channels and diagnostics moved to General/output.ML; added read_int etc. from term.ML; removed obsolete mtree; type rat uses exception RAT;
wenzelm
parents:
14797
diff
changeset

711 

48cfe0fe53e2
output channels and diagnostics moved to General/output.ML; added read_int etc. from term.ML; removed obsolete mtree; type rat uses exception RAT;
wenzelm
parents:
14797
diff
changeset

712 

233  713 
(** strings **) 
714 

16188  715 
(* functions tuned for strings, avoiding explode *) 
6312  716 

18011
685d95c793ff
cleaned up nth, nth_update, nth_map and nth_string functions
haftmann
parents:
17952
diff
changeset

717 
fun nth_string str i = 
6959  718 
(case try String.substring (str, i, 1) of 
15531  719 
SOME s => s 
15570  720 
 NONE => raise Subscript); 
6312  721 

16188  722 
fun fold_string f str x0 = 
6282  723 
let 
724 
val n = size str; 

16188  725 
fun iter (x, i) = 
726 
if i < n then iter (f (String.substring (str, i, 1)) x, i + 1) else x; 

727 
in iter (x0, 0) end; 

6282  728 

14968  729 
fun exists_string pred str = 
730 
let 

731 
val n = size str; 

732 
fun ex i = i < n andalso (pred (String.substring (str, i, 1)) orelse ex (i + 1)); 

733 
in ex 0 end; 

6312  734 

16188  735 
fun forall_string pred = not o exists_string (not o pred); 
736 

28025  737 
fun first_field sep str = 
28022  738 
let 
28025  739 
val n = size sep; 
28022  740 
val len = size str; 
741 
fun find i = 

742 
if i + n > len then NONE 

28025  743 
else if String.substring (str, i, n) = sep then SOME i 
28022  744 
else find (i + 1); 
28025  745 
in 
746 
(case find 0 of 

747 
NONE => NONE 

748 
 SOME i => SOME (String.substring (str, 0, i), String.extract (str, i + n, NONE))) 

749 
end; 

28022  750 

512
55755ed9fab9
Pure/library/enclose, Pure/Syntax/pretty/enclose: renamed from parents
lcp
parents:
410
diff
changeset

751 
(*enclose in brackets*) 
55755ed9fab9
Pure/library/enclose, Pure/Syntax/pretty/enclose: renamed from parents
lcp
parents:
410
diff
changeset

752 
fun enclose lpar rpar str = lpar ^ str ^ rpar; 
6642  753 
fun unenclose str = String.substring (str, 1, size str  2); 
255
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

754 

233  755 
(*simple quoting (does not escape special chars)*) 
512
55755ed9fab9
Pure/library/enclose, Pure/Syntax/pretty/enclose: renamed from parents
lcp
parents:
410
diff
changeset

756 
val quote = enclose "\"" "\""; 
233  757 

4212  758 
(*space_implode "..." (explode "hello") = "h...e...l...l...o"*) 
233  759 
fun space_implode a bs = implode (separate a bs); 
760 

255
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

761 
val commas = space_implode ", "; 
380  762 
val commas_quote = commas o map quote; 
255
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

763 

233  764 
(*concatenate messages, one per line, into a string*) 
255
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

765 
val cat_lines = space_implode "\n"; 
233  766 

4212  767 
(*space_explode "." "h.e..l.lo" = ["h", "e", "", "l", "lo"]*) 
3832
17a20a2af8f5
fixed space_explode, old one retained as BAD_space_explode;
wenzelm
parents:
3762
diff
changeset

768 
fun space_explode _ "" = [] 
21899  769 
 space_explode sep s = String.fields (fn c => str c = sep) s; 
3832
17a20a2af8f5
fixed space_explode, old one retained as BAD_space_explode;
wenzelm
parents:
3762
diff
changeset

770 

17a20a2af8f5
fixed space_explode, old one retained as BAD_space_explode;
wenzelm
parents:
3762
diff
changeset

771 
val split_lines = space_explode "\n"; 
17a20a2af8f5
fixed space_explode, old one retained as BAD_space_explode;
wenzelm
parents:
3762
diff
changeset

772 

14826
48cfe0fe53e2
output channels and diagnostics moved to General/output.ML; added read_int etc. from term.ML; removed obsolete mtree; type rat uses exception RAT;
wenzelm
parents:
14797
diff
changeset

773 
fun prefix_lines "" txt = txt 
48cfe0fe53e2
output channels and diagnostics moved to General/output.ML; added read_int etc. from term.ML; removed obsolete mtree; type rat uses exception RAT;
wenzelm
parents:
14797
diff
changeset

774 
 prefix_lines prfx txt = txt > split_lines > map (fn s => prfx ^ s) > cat_lines; 
48cfe0fe53e2
output channels and diagnostics moved to General/output.ML; added read_int etc. from term.ML; removed obsolete mtree; type rat uses exception RAT;
wenzelm
parents:
14797
diff
changeset

775 

18681
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

776 
fun prefix prfx s = prfx ^ s; 
16188  777 
fun suffix sffx s = s ^ sffx; 
5285  778 

18681
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

779 
fun unprefix prfx s = 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

780 
if String.isPrefix prfx s then String.substring (s, size prfx, size s  size prfx) 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

781 
else raise Fail "unprefix"; 
3020496cff28
added exception ERROR, error, cat_error, sys_error, assert, deny, assert_all;
wenzelm
parents:
18549
diff
changeset

782 

16188  783 
fun unsuffix sffx s = 
17061  784 
if String.isSuffix sffx s then String.substring (s, 0, size s  size sffx) 
785 
else raise Fail "unsuffix"; 

5285  786 

24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

787 
fun replicate_string (0: int) _ = "" 
10951  788 
 replicate_string 1 a = a 
789 
 replicate_string k a = 

790 
if k mod 2 = 0 then replicate_string (k div 2) (a ^ a) 

791 
else replicate_string (k div 2) (a ^ a) ^ a; 

792 

233  793 

23220  794 

16492  795 
(** lists as sets  see also Pure/General/ord_list.ML **) 
233  796 

26439  797 
(* canonical operations *) 
798 

18923  799 
fun member eq list x = 
800 
let 

801 
fun memb [] = false 

802 
 memb (y :: ys) = eq (x, y) orelse memb ys; 

803 
in memb list end; 

1576
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

804 

18923  805 
fun insert eq x xs = if member eq xs x then xs else x :: xs; 
806 
fun remove eq x xs = if member eq xs x then filter_out (fn y => eq (x, y)) xs else xs; 

24049  807 
fun update eq x xs = cons x (remove eq x xs); 
233  808 

19301  809 
fun subtract eq = fold (remove eq); 
810 

18923  811 
fun merge _ ([], ys) = ys 
812 
 merge eq (xs, ys) = fold_rev (insert eq) ys xs; 

0  813 

26439  814 

815 
(* oldstyle infixes *) 

816 

18923  817 
fun x mem xs = member (op =) xs x; 
818 
fun (x: int) mem_int xs = member (op =) xs x; 

819 
fun (x: string) mem_string xs = member (op =) xs x; 

1576
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

820 

233  821 
(*union of sets represented as lists: no repetitions*) 
822 
fun xs union [] = xs 

823 
 [] union ys = ys 

20854  824 
 (x :: xs) union ys = xs union (insert (op =) x ys); 
0  825 

2175
21fde76bc742
Updated syntax; shortened comments; put in monomorphic versions of ins
paulson
parents:
2157
diff
changeset

826 
(*union of sets, optimized version for ints*) 
1576
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

827 
fun (xs:int list) union_int [] = xs 
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

828 
 [] union_int ys = ys 
20854  829 
 (x :: xs) union_int ys = xs union_int (insert (op =) x ys); 
1576
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

830 

2175
21fde76bc742
Updated syntax; shortened comments; put in monomorphic versions of ins
paulson
parents:
2157
diff
changeset

831 
(*union of sets, optimized version for strings*) 
1576
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

832 
fun (xs:string list) union_string [] = xs 
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

833 
 [] union_string ys = ys 
20854  834 
 (x :: xs) union_string ys = xs union_string (insert (op =) x ys); 
1576
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

835 

0  836 
(*generalized union*) 
233  837 
fun gen_union eq (xs, []) = xs 
838 
 gen_union eq ([], ys) = ys 

18923  839 
 gen_union eq (x :: xs, ys) = gen_union eq (xs, insert eq x ys); 
233  840 

841 

842 
(*intersection*) 

843 
fun [] inter ys = [] 

844 
 (x :: xs) inter ys = 

845 
if x mem ys then x :: (xs inter ys) else xs inter ys; 

846 

2175
21fde76bc742
Updated syntax; shortened comments; put in monomorphic versions of ins
paulson
parents:
2157
diff
changeset

847 
(*intersection, optimized version for ints*) 
1576
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

848 
fun ([]:int list) inter_int ys = [] 
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

849 
 (x :: xs) inter_int ys = 
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

850 
if x mem_int ys then x :: (xs inter_int ys) else xs inter_int ys; 
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

851 

2175
21fde76bc742
Updated syntax; shortened comments; put in monomorphic versions of ins
paulson
parents:
2157
diff
changeset

852 
(*intersection, optimized version for strings *) 
1576
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

853 
fun ([]:string list) inter_string ys = [] 
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

854 
 (x :: xs) inter_string ys = 
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

855 
if x mem_string ys then x :: (xs inter_string ys) else xs inter_string ys; 
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

856 

7090  857 
(*generalized intersection*) 
858 
fun gen_inter eq ([], ys) = [] 

12284  859 
 gen_inter eq (x::xs, ys) = 
18923  860 
if member eq ys x then x :: gen_inter eq (xs, ys) 
861 
else gen_inter eq (xs, ys); 

7090  862 

233  863 

864 
(*subset*) 

865 
fun [] subset ys = true 

866 
 (x :: xs) subset ys = x mem ys andalso xs subset ys; 

867 

2175
21fde76bc742
Updated syntax; shortened comments; put in monomorphic versions of ins
paulson
parents:
2157
diff
changeset

868 
(*subset, optimized version for ints*) 
16439  869 
fun ([]: int list) subset_int ys = true 
1576
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

870 
 (x :: xs) subset_int ys = x mem_int ys andalso xs subset_int ys; 
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

871 

2175
21fde76bc742
Updated syntax; shortened comments; put in monomorphic versions of ins
paulson
parents:
2157
diff
changeset

872 
(*subset, optimized version for strings*) 
16439  873 
fun ([]: string list) subset_string ys = true 
1576
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

874 
 (x :: xs) subset_string ys = x mem_string ys andalso xs subset_string ys; 
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

875 

4363  876 
(*set equality*) 
877 
fun eq_set (xs, ys) = 

878 
xs = ys orelse (xs subset ys andalso ys subset xs); 

879 

2182
29e56f003599
Removal of polymorphic equality via mem, subset, eq_set, etc
paulson
parents:
2175
diff
changeset

880 
(*set equality for strings*) 
16439  881 
fun eq_set_string ((xs: string list), ys) = 
1576
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

882 
xs = ys orelse (xs subset_string ys andalso ys subset_string xs); 
af8f43f742a0
Added some optimized versions of functions dealing with sets
berghofe
parents:
1460
diff
changeset

883 

18923  884 
fun gen_subset eq (xs, ys) = forall (member eq ys) xs; 
2182
29e56f003599
Removal of polymorphic equality via mem, subset, eq_set, etc
paulson
parents:
2175
diff
changeset

885 

19301  886 
fun gen_eq_set eq (xs, ys) = 
20348  887 
eq_list eq (xs, ys) orelse 
19301  888 
(gen_subset eq (xs, ys) andalso gen_subset (eq o swap) (ys, xs)); 
889 

265  890 

233  891 
(*removing an element from a list WITHOUT duplicates*) 
892 
fun (y :: ys) \ x = if x = y then ys else y :: (ys \ x) 

893 
 [] \ x = []; 

2243
3ebeaaacfbd1
Etaexpanded some declarations that are illegal under value polymorphism
paulson
parents:
2196
diff
changeset

894 
fun ys \\ xs = foldl (op \) (ys,xs); 
0  895 

233  896 

897 
(*makes a list of the distinct members of the input; preserves order, takes 

898 
first of equal elements*) 

19046
bc5c6c9b114e
removed distinct, renamed gen_distinct to distinct;
wenzelm
parents:
19011
diff
changeset

899 
fun distinct eq lst = 
233  900 
let 
901 
fun dist (rev_seen, []) = rev rev_seen 

902 
 dist (rev_seen, x :: xs) = 

18923  903 
if member eq rev_seen x then dist (rev_seen, xs) 
233  904 
else dist (x :: rev_seen, xs); 
19046
bc5c6c9b114e
removed distinct, renamed gen_distinct to distinct;
wenzelm
parents:
19011
diff
changeset

905 
in dist ([], lst) end; 
233  906 

255
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

907 
(*returns a list containing all repeated elements exactly once; preserves 
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

908 
order, takes first of equal elements*) 
18966  909 
fun duplicates eq lst = 
255
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

910 
let 
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

911 
fun dups (rev_dups, []) = rev rev_dups 
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

912 
 dups (rev_dups, x :: xs) = 
18923  913 
if member eq rev_dups x orelse not (member eq xs x) then 
255
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

914 
dups (rev_dups, xs) 
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

915 
else dups (x :: rev_dups, xs); 
18966  916 
in dups ([], lst) end; 
255
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

917 

16878  918 
fun has_duplicates eq = 
919 
let 

920 
fun dups [] = false 

921 
 dups (x :: xs) = member eq xs x orelse dups xs; 

922 
in dups end; 

923 

255
ee132db91681
added if_none, parents, commas, gen_duplicates, duplicates, assoc2;
wenzelm
parents:
245
diff
changeset

924 

23220  925 

22142  926 
(** lists as multisets **) 
927 

928 
fun remove1 _ _ [] = raise Empty 

23220  929 
 remove1 eq y (x::xs) = if eq (y, x) then xs else x :: remove1 eq y xs; 
22142  930 

23220  931 
fun submultiset _ ([], _) = true 
932 
 submultiset eq (x :: xs, ys) = member eq ys x andalso submultiset eq (xs, remove1 eq x ys); 

233  933 

0  934 

935 

2506  936 
(** orders **) 
937 

18966  938 
fun is_equal EQUAL = true 
939 
 is_equal _ = false; 

940 

4445  941 
fun rev_order LESS = GREATER 
942 
 rev_order EQUAL = EQUAL 

943 
 rev_order GREATER = LESS; 

944 

4479  945 
(*assume rel is a linear strict order*) 
4445  946 
fun make_ord rel (x, y) = 
947 
if rel (x, y) then LESS 

948 
else if rel (y, x) then GREATER 

949 
else EQUAL; 

950 

25224  951 
fun bool_ord (false, true) = LESS 
952 
 bool_ord (true, false) = GREATER 

953 
 bool_ord _ = EQUAL; 

954 

15051
0dbbab9f77fe
int_ord = Int.compare, string_ord = String.compare;
wenzelm
parents:
15035
diff
changeset

955 
val int_ord = Int.compare; 
0dbbab9f77fe
int_ord = Int.compare, string_ord = String.compare;
wenzelm
parents:
15035
diff
changeset

956 
val string_ord = String.compare; 
2506  957 

16676  958 
fun fast_string_ord (s1, s2) = 
959 
(case int_ord (size s1, size s2) of EQUAL => string_ord (s1, s2)  ord => ord); 

960 

16492  961 
fun option_ord ord (SOME x, SOME y) = ord (x, y) 
962 
 option_ord _ (NONE, NONE) = EQUAL 

963 
 option_ord _ (NONE, SOME _) = LESS 

964 
 option_ord _ (SOME _, NONE) = GREATER; 

965 

4343  966 
(*lexicographic product*) 
967 
fun prod_ord a_ord b_ord ((x, y), (x', y')) = 

968 
(case a_ord (x, x') of EQUAL => b_ord (y, y')  ord => ord); 

969 

970 
(*dictionary order  in general NOT wellfounded!*) 

16984  971 
fun dict_ord elem_ord (x :: xs, y :: ys) = 
972 
(case elem_ord (x, y) of EQUAL => dict_ord elem_ord (xs, ys)  ord => ord) 

973 
 dict_ord _ ([], []) = EQUAL 

4343  974 
 dict_ord _ ([], _ :: _) = LESS 
16984  975 
 dict_ord _ (_ :: _, []) = GREATER; 
4343  976 

977 
(*lexicographic product of lists*) 

978 
fun list_ord elem_ord (xs, ys) = 

16676  979 
(case int_ord (length xs, length ys) of EQUAL => dict_ord elem_ord (xs, ys)  ord => ord); 
4343  980 

2506  981 

4621  982 
(* sorting *) 
983 

18427  984 
(*quicksort  stable, i.e. does not reorder equal elements*) 
985 
fun quicksort unique ord = 

4621  986 
let 
16878  987 
fun qsort [] = [] 
988 
 qsort (xs as [_]) = xs 

18427  989 
 qsort (xs as [x, y]) = 
990 
(case ord (x, y) of 

991 
LESS => xs 

992 
 EQUAL => if unique then [x] else xs 

993 
 GREATER => [y, x]) 

16878  994 
 qsort xs = 
18011
685d95c793ff
cleaned up nth, nth_update, nth_map and nth_string functions
haftmann
parents:
17952
diff
changeset

995 
let val (lts, eqs, gts) = part (nth xs (length xs div 2)) xs 
16878  996 
in qsort lts @ eqs @ qsort gts end 
4621  997 
and part _ [] = ([], [], []) 
998 
 part pivot (x :: xs) = add (ord (x, pivot)) x (part pivot xs) 

999 
and add LESS x (lts, eqs, gts) = (x :: lts, eqs, gts) 

18427  1000 
 add EQUAL x (lts, [], gts) = (lts, [x], gts) 
1001 
 add EQUAL x (res as (lts, eqs, gts)) = if unique then res else (lts, x :: eqs, gts) 

4621  1002 
 add GREATER x (lts, eqs, gts) = (lts, eqs, x :: gts); 
1003 
in qsort end; 

1004 

18427  1005 
fun sort ord = quicksort false ord; 
1006 
fun sort_distinct ord = quicksort true ord; 

1007 

4621  1008 
val sort_strings = sort string_ord; 
1009 
fun sort_wrt sel xs = sort (string_ord o pairself sel) xs; 

1010 

1011 

2506  1012 

14106
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1013 
(** random numbers **) 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1014 

bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1015 
exception RANDOM; 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1016 

14618
068bb99f3ebd
Fixed bug in rmod that caused an overflow exception in SML/NJ.
berghofe
parents:
14472
diff
changeset

1017 
fun rmod x y = x  y * Real.realFloor (x / y); 
14106
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1018 

bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1019 
local 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1020 
val a = 16807.0; 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1021 
val m = 2147483647.0; 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1022 
val random_seed = ref 1.0; 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1023 
in 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1024 

23922
707639e9497d
marked some CRITICAL sections (for multithreading);
wenzelm
parents:
23860
diff
changeset

1025 
fun random () = CRITICAL (fn () => 
707639e9497d
marked some CRITICAL sections (for multithreading);
wenzelm
parents:
23860
diff
changeset

1026 
let val r = rmod (a * ! random_seed) m 
707639e9497d
marked some CRITICAL sections (for multithreading);
wenzelm
parents:
23860
diff
changeset

1027 
in (random_seed := r; r) end); 
14106
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1028 

bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1029 
end; 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1030 

bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1031 
fun random_range l h = 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1032 
if h < l orelse l < 0 then raise RANDOM 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1033 
else l + Real.floor (rmod (random ()) (real (h  l + 1))); 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1034 

18011
685d95c793ff
cleaned up nth, nth_update, nth_map and nth_string functions
haftmann
parents:
17952
diff
changeset

1035 
fun one_of xs = nth xs (random_range 0 (length xs  1)); 
14106
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1036 

bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1037 
fun frequency xs = 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1038 
let 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1039 
val sum = foldl op + (0, map fst xs); 
17756  1040 
fun pick n ((k: int, x) :: xs) = 
14106
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1041 
if n <= k then x else pick (n  k) xs 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1042 
in pick (random_range 1 sum) xs end; 
bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1043 

bbf708a7e27f
Added several functions for producing random numbers.
berghofe
parents:
13794
diff
changeset

1044 

23220  1045 

4621  1046 
(** misc **) 
233  1047 

19644
0b01436e1843
added divide_and_conquer combinator (by Amine Chaieb);
wenzelm
parents:
19596
diff
changeset

1048 
fun divide_and_conquer decomp x = 
0b01436e1843
added divide_and_conquer combinator (by Amine Chaieb);
wenzelm
parents:
19596
diff
changeset

1049 
let val (ys, recomb) = decomp x 
0b01436e1843
added divide_and_conquer combinator (by Amine Chaieb);
wenzelm
parents:
19596
diff
changeset

1050 
in recomb (map (divide_and_conquer decomp) ys) end; 
0b01436e1843
added divide_and_conquer combinator (by Amine Chaieb);
wenzelm
parents:
19596
diff
changeset

1051 

0  1052 

233  1053 
(*Partition a list into buckets [ bi, b(i+1), ..., bj ] 
0  1054 
putting x in bk if p(k)(x) holds. Preserve order of elements if possible.*) 
1055 
fun partition_list p i j = 

233  1056 
let fun part k xs = 
1057 
if k>j then 

0  1058 
(case xs of [] => [] 
15570  1059 
 _ => raise Fail "partition_list") 
0  1060 
else 
19691  1061 
let val (ns, rest) = List.partition (p k) xs; 
233  1062 
in ns :: part(k+1)rest end 
24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

1063 
in part (i: int) end; 
0  1064 

19691  1065 
fun partition_eq (eq:'a * 'a > bool) = 
1066 
let 

1067 
fun part [] = [] 

1068 
 part (x :: ys) = 

1069 
let val (xs, xs') = List.partition (fn y => eq (x, y)) ys 

1070 
in (x::xs)::(part xs') end 

1071 
in part end; 

1072 

1073 

0  1074 

233  1075 
(* generating identifiers *) 
0  1076 

4063  1077 
(** Freshly generated identifiers; supplied prefix MUST start with a letter **) 
22369  1078 
local 
1079 
(*Maps 061 to AZ, az, 09; exclude _ or ' to avoid clash with internal/unusual indentifiers*) 

22582
f315da9400fb
removed obsolete scanwords (see obsolete tactic.ML:rename_tac for its only use);
wenzelm
parents:
22567
diff
changeset

1080 
fun gensym_char i = 
22368
0e0fe77d4768
gensym no longer includes ' or _ in names (trailing _ is bad)
paulson
parents:
22256
diff
changeset

1081 
if i<26 then chr (ord "A" + i) 
0e0fe77d4768
gensym no longer includes ' or _ in names (trailing _ is bad)
paulson
parents:
22256
diff
changeset

1082 
else if i<52 then chr (ord "a" + i  26) 
22369  1083 
else chr (ord "0" + i  52); 
4063  1084 

22369  1085 
val char_vec = Vector.tabulate (62, gensym_char); 
1086 
fun newid n = implode (map (fn i => Vector.sub (char_vec, i)) (radixpand (62, n))); 

4284  1087 

24593
1547ea587f5a
added some int constraints (ML_Parse.fix_ints not active here);
wenzelm
parents:
24148
diff
changeset

1088 
val gensym_seed = ref (0: int); 
2003  1089 

22369  1090 
in 
24148  1091 
fun gensym pre = pre ^ newid (NAMED_CRITICAL "gensym" (fn () => inc gensym_seed)); 
22369  1092 
end; 
4063  1093 

1094 

16439  1095 
(* stamps and serial numbers *) 
1096 

1097 
type stamp = unit ref; 

1098 
val stamp: unit > stamp = ref; 

1099 

1100 
type serial = int; 

25702
a61554b1e7a9
serial: now based on specific version in structure Multithreading;
wenzelm
parents:
25681
diff
changeset

1101 
val serial = Multithreading.serial; 
19512  1102 
val serial_string = string_of_int o serial; 
1103 

16535
86c9eada525b
added structure Object (from Pure/General/object.ML);
wenzelm
parents:
16492
diff
changeset

1104 

86c9eada525b
added structure Object (from Pure/General/object.ML);
wenzelm
parents:
16492
diff
changeset

1105 
(* generic objects *) 
86c9eada525b
added structure Object (from Pure/General/object.ML);
wenzelm
parents:
16492
diff
changeset

1106 

86c9eada525b
added structure Object (from Pure/General/object.ML);
wenzelm
parents:
16492
diff
changeset

1107 
(*note that the builtin exception datatype may be extended by new 
86c9eada525b
added structure Object (from Pure/General/object.ML);
wenzelm
parents:
16492
diff
changeset

1108 
constructors at any time*) 
86c9eada525b
added structure Object (from Pure/General/object.ML);
wenzelm
parents:
16492
diff
changeset

1109 
structure Object = struct type T = exn end; 
86c9eada525b
added structure Object (from Pure/General/object.ML);
wenzelm
parents:
16492
diff
changeset

1110 

1364
8ea1a962ad72
files now define a structure to allow SML/NJ to optimize the code
clasohm
parents:
1290
diff
changeset

1111 
end; 
8ea1a962ad72
files now define a structure to allow SML/NJ to optimize the code
clasohm
parents:
1290
diff
changeset

1112 

15745  1113 
structure BasicLibrary: BASIC_LIBRARY = Library; 
1114 
open BasicLibrary; 