author | wenzelm |
Tue, 31 Mar 2015 11:16:55 +0200 | |
changeset 59874 | 3ecb48ce92d7 |
parent 59859 | f9d1442c70f3 |
child 59885 | 3470a265d404 |
permissions | -rw-r--r-- |
28941 | 1 |
(* Title: Pure/General/binding.ML |
2 |
Author: Florian Haftmann, TU Muenchen |
|
30214
f84c9f10292a
moved name space externalization flags back to name_space.ML;
wenzelm
parents:
29617
diff
changeset
|
3 |
Author: Makarius |
28941 | 4 |
|
5 |
Structured name bindings. |
|
6 |
*) |
|
7 |
||
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
8 |
type bstring = string; (*primitive names to be bound*) |
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
9 |
|
30214
f84c9f10292a
moved name space externalization flags back to name_space.ML;
wenzelm
parents:
29617
diff
changeset
|
10 |
signature BINDING = |
28941 | 11 |
sig |
53380
08f3491c50bf
cases: formal binding of 'assumes', with position provided via invoke_case;
wenzelm
parents:
50239
diff
changeset
|
12 |
eqtype binding |
59858 | 13 |
val path_of: binding -> (string * bool) list |
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
14 |
val make: bstring * Position.T -> binding |
30276 | 15 |
val pos_of: binding -> Position.T |
53380
08f3491c50bf
cases: formal binding of 'assumes', with position provided via invoke_case;
wenzelm
parents:
50239
diff
changeset
|
16 |
val set_pos: Position.T -> binding -> binding |
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
17 |
val name: bstring -> binding |
30464 | 18 |
val name_of: binding -> bstring |
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
19 |
val map_name: (bstring -> bstring) -> binding -> binding |
30338 | 20 |
val prefix_name: string -> binding -> binding |
21 |
val suffix_name: string -> binding -> binding |
|
22 |
val eq_name: binding * binding -> bool |
|
29617 | 23 |
val empty: binding |
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
24 |
val is_empty: binding -> bool |
30410 | 25 |
val qualify: bool -> string -> binding -> binding |
35200
aaddb2b526d6
more systematic treatment of qualified names derived from binding;
wenzelm
parents:
33157
diff
changeset
|
26 |
val qualified: bool -> string -> binding -> binding |
30464 | 27 |
val qualified_name: string -> binding |
30276 | 28 |
val prefix_of: binding -> (string * bool) list |
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
29 |
val map_prefix: ((string * bool) list -> (string * bool) list) -> binding -> binding |
30335
b3ef64cadcad
Binding.str_of: removed verbose feature, include qualifier in output;
wenzelm
parents:
30276
diff
changeset
|
30 |
val prefix: bool -> string -> binding -> binding |
59858 | 31 |
val private: binding -> binding |
59859 | 32 |
val concealed: binding -> binding |
43547
f3a8476285c6
clarified Binding.pretty/print: no quotes, only markup -- Binding.str_of is rendered obsolete;
wenzelm
parents:
43546
diff
changeset
|
33 |
val pretty: binding -> Pretty.T |
42381
309ec68442c6
added Binding.print convenience, which includes quote already;
wenzelm
parents:
41254
diff
changeset
|
34 |
val print: binding -> string |
58032
e92cdae8b3b5
clarified ML toplevel pp: avoid ML output to be attached to inlined binding positions;
wenzelm
parents:
53380
diff
changeset
|
35 |
val pp: binding -> Pretty.T |
41254
78c3e472bb35
extra checking of name bindings for classes, types, consts;
wenzelm
parents:
39442
diff
changeset
|
36 |
val bad: binding -> string |
78c3e472bb35
extra checking of name bindings for classes, types, consts;
wenzelm
parents:
39442
diff
changeset
|
37 |
val check: binding -> unit |
59874 | 38 |
val name_spec: (string * bool) list -> binding -> |
39 |
{private: bool, concealed: bool, spec: (string * bool) list} |
|
29617 | 40 |
end; |
28941 | 41 |
|
32590
95f4f08f950f
replaced opaque signature matching by plain old abstype (again, cf. ac4498f95d1c) -- this recovers pretty printing in SML/NJ and Poly/ML 5.3;
wenzelm
parents:
30795
diff
changeset
|
42 |
structure Binding: BINDING = |
28941 | 43 |
struct |
44 |
||
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
45 |
(** representation **) |
29338 | 46 |
|
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
47 |
(* datatype *) |
29338 | 48 |
|
53380
08f3491c50bf
cases: formal binding of 'assumes', with position provided via invoke_case;
wenzelm
parents:
50239
diff
changeset
|
49 |
datatype binding = Binding of |
59874 | 50 |
{private: bool, (*entry is private -- no name space accesses, only full name*) |
59859 | 51 |
concealed: bool, (*entry is for foundational purposes -- please ignore*) |
33157
56f836b9414f
allow name space entries to be "concealed" -- via binding/naming/local_theory;
wenzelm
parents:
32590
diff
changeset
|
52 |
prefix: (string * bool) list, (*system prefix*) |
30276 | 53 |
qualifier: (string * bool) list, (*user qualifier*) |
54 |
name: bstring, (*base name*) |
|
53380
08f3491c50bf
cases: formal binding of 'assumes', with position provided via invoke_case;
wenzelm
parents:
50239
diff
changeset
|
55 |
pos: Position.T}; (*source position*) |
28941 | 56 |
|
59859 | 57 |
fun make_binding (private, concealed, prefix, qualifier, name, pos) = |
58 |
Binding {private = private, concealed = concealed, prefix = prefix, |
|
59858 | 59 |
qualifier = qualifier, name = name, pos = pos}; |
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
60 |
|
59859 | 61 |
fun map_binding f (Binding {private, concealed, prefix, qualifier, name, pos}) = |
62 |
make_binding (f (private, concealed, prefix, qualifier, name, pos)); |
|
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
63 |
|
59874 | 64 |
fun path_of (Binding {prefix, qualifier, ...}) = prefix @ qualifier; |
30217
894eb2034f02
renamed Binding.display to Binding.str_of, which is slightly more canonical;
wenzelm
parents:
30214
diff
changeset
|
65 |
|
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
66 |
|
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
67 |
|
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
68 |
(** basic operations **) |
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
69 |
|
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
70 |
(* name and position *) |
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
71 |
|
59858 | 72 |
fun make (name, pos) = make_binding (false, false, [], [], name, pos); |
28965 | 73 |
|
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
74 |
fun pos_of (Binding {pos, ...}) = pos; |
53380
08f3491c50bf
cases: formal binding of 'assumes', with position provided via invoke_case;
wenzelm
parents:
50239
diff
changeset
|
75 |
fun set_pos pos = |
59859 | 76 |
map_binding (fn (private, concealed, prefix, qualifier, name, _) => |
77 |
(private, concealed, prefix, qualifier, name, pos)); |
|
53380
08f3491c50bf
cases: formal binding of 'assumes', with position provided via invoke_case;
wenzelm
parents:
50239
diff
changeset
|
78 |
|
08f3491c50bf
cases: formal binding of 'assumes', with position provided via invoke_case;
wenzelm
parents:
50239
diff
changeset
|
79 |
fun name name = make (name, Position.none); |
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
80 |
fun name_of (Binding {name, ...}) = name; |
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
81 |
|
30338 | 82 |
fun eq_name (b, b') = name_of b = name_of b'; |
83 |
||
33157
56f836b9414f
allow name space entries to be "concealed" -- via binding/naming/local_theory;
wenzelm
parents:
32590
diff
changeset
|
84 |
fun map_name f = |
59859 | 85 |
map_binding (fn (private, concealed, prefix, qualifier, name, pos) => |
86 |
(private, concealed, prefix, qualifier, f name, pos)); |
|
33157
56f836b9414f
allow name space entries to be "concealed" -- via binding/naming/local_theory;
wenzelm
parents:
32590
diff
changeset
|
87 |
|
30338 | 88 |
val prefix_name = map_name o prefix; |
89 |
val suffix_name = map_name o suffix; |
|
28941 | 90 |
|
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
91 |
val empty = name ""; |
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
92 |
fun is_empty b = name_of b = ""; |
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
93 |
|
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
94 |
|
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
95 |
(* user qualifier *) |
28941 | 96 |
|
30410 | 97 |
fun qualify _ "" = I |
33157
56f836b9414f
allow name space entries to be "concealed" -- via binding/naming/local_theory;
wenzelm
parents:
32590
diff
changeset
|
98 |
| qualify mandatory qual = |
59859 | 99 |
map_binding (fn (private, concealed, prefix, qualifier, name, pos) => |
100 |
(private, concealed, prefix, (qual, mandatory) :: qualifier, name, pos)); |
|
30410 | 101 |
|
59858 | 102 |
fun qualified mandatory name' = |
59859 | 103 |
map_binding (fn (private, concealed, prefix, qualifier, name, pos) => |
59858 | 104 |
let val qualifier' = if name = "" then qualifier else qualifier @ [(name, mandatory)] |
59859 | 105 |
in (private, concealed, prefix, qualifier', name', pos) end); |
35200
aaddb2b526d6
more systematic treatment of qualified names derived from binding;
wenzelm
parents:
33157
diff
changeset
|
106 |
|
30361
8ea7a197e2e6
added qualified_name -- emulates old-style qualified bstring;
wenzelm
parents:
30338
diff
changeset
|
107 |
fun qualified_name "" = empty |
8ea7a197e2e6
added qualified_name -- emulates old-style qualified bstring;
wenzelm
parents:
30338
diff
changeset
|
108 |
| qualified_name s = |
8ea7a197e2e6
added qualified_name -- emulates old-style qualified bstring;
wenzelm
parents:
30338
diff
changeset
|
109 |
let val (qualifier, name) = split_last (Long_Name.explode s) |
59858 | 110 |
in make_binding (false, false, [], map (rpair false) qualifier, name, Position.none) end; |
30361
8ea7a197e2e6
added qualified_name -- emulates old-style qualified bstring;
wenzelm
parents:
30338
diff
changeset
|
111 |
|
28965 | 112 |
|
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
113 |
(* system prefix *) |
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
114 |
|
30276 | 115 |
fun prefix_of (Binding {prefix, ...}) = prefix; |
116 |
||
33157
56f836b9414f
allow name space entries to be "concealed" -- via binding/naming/local_theory;
wenzelm
parents:
32590
diff
changeset
|
117 |
fun map_prefix f = |
59859 | 118 |
map_binding (fn (private, concealed, prefix, qualifier, name, pos) => |
119 |
(private, concealed, f prefix, qualifier, name, pos)); |
|
30222
4102bbf2af21
moved type bstring from name_space.ML to binding.ML -- it is the primitive concept behind bindings;
wenzelm
parents:
30217
diff
changeset
|
120 |
|
30335
b3ef64cadcad
Binding.str_of: removed verbose feature, include qualifier in output;
wenzelm
parents:
30276
diff
changeset
|
121 |
fun prefix _ "" = I |
30410 | 122 |
| prefix mandatory prfx = map_prefix (cons (prfx, mandatory)); |
123 |
||
124 |
||
59858 | 125 |
(* visibility flags *) |
126 |
||
127 |
val private = |
|
59859 | 128 |
map_binding (fn (_, concealed, prefix, qualifier, name, pos) => |
129 |
(true, concealed, prefix, qualifier, name, pos)); |
|
33157
56f836b9414f
allow name space entries to be "concealed" -- via binding/naming/local_theory;
wenzelm
parents:
32590
diff
changeset
|
130 |
|
59859 | 131 |
val concealed = |
59858 | 132 |
map_binding (fn (private, _, prefix, qualifier, name, pos) => |
133 |
(private, true, prefix, qualifier, name, pos)); |
|
33157
56f836b9414f
allow name space entries to be "concealed" -- via binding/naming/local_theory;
wenzelm
parents:
32590
diff
changeset
|
134 |
|
56f836b9414f
allow name space entries to be "concealed" -- via binding/naming/local_theory;
wenzelm
parents:
32590
diff
changeset
|
135 |
|
42381
309ec68442c6
added Binding.print convenience, which includes quote already;
wenzelm
parents:
41254
diff
changeset
|
136 |
(* print *) |
30410 | 137 |
|
43547
f3a8476285c6
clarified Binding.pretty/print: no quotes, only markup -- Binding.str_of is rendered obsolete;
wenzelm
parents:
43546
diff
changeset
|
138 |
fun pretty (Binding {prefix, qualifier, name, pos, ...}) = |
46897
ec793befc232
proper printing of empty binding (again, cf. 93f6f24010c2);
wenzelm
parents:
45666
diff
changeset
|
139 |
if name = "" then Pretty.str "\"\"" |
ec793befc232
proper printing of empty binding (again, cf. 93f6f24010c2);
wenzelm
parents:
45666
diff
changeset
|
140 |
else |
50201
c26369c9eda6
Isabelle-specific implementation of quasi-abstract markup elements -- back to module arrangement before d83797ef0d2d;
wenzelm
parents:
48992
diff
changeset
|
141 |
Pretty.markup (Position.markup pos Markup.binding) |
46897
ec793befc232
proper printing of empty binding (again, cf. 93f6f24010c2);
wenzelm
parents:
45666
diff
changeset
|
142 |
[Pretty.str (Long_Name.implode (map #1 (prefix @ qualifier) @ [name]))] |
ec793befc232
proper printing of empty binding (again, cf. 93f6f24010c2);
wenzelm
parents:
45666
diff
changeset
|
143 |
|> Pretty.quote; |
28941 | 144 |
|
43547
f3a8476285c6
clarified Binding.pretty/print: no quotes, only markup -- Binding.str_of is rendered obsolete;
wenzelm
parents:
43546
diff
changeset
|
145 |
val print = Pretty.str_of o pretty; |
42381
309ec68442c6
added Binding.print convenience, which includes quote already;
wenzelm
parents:
41254
diff
changeset
|
146 |
|
58032
e92cdae8b3b5
clarified ML toplevel pp: avoid ML output to be attached to inlined binding positions;
wenzelm
parents:
53380
diff
changeset
|
147 |
val pp = pretty o set_pos Position.none; |
e92cdae8b3b5
clarified ML toplevel pp: avoid ML output to be attached to inlined binding positions;
wenzelm
parents:
53380
diff
changeset
|
148 |
|
41254
78c3e472bb35
extra checking of name bindings for classes, types, consts;
wenzelm
parents:
39442
diff
changeset
|
149 |
|
78c3e472bb35
extra checking of name bindings for classes, types, consts;
wenzelm
parents:
39442
diff
changeset
|
150 |
(* check *) |
78c3e472bb35
extra checking of name bindings for classes, types, consts;
wenzelm
parents:
39442
diff
changeset
|
151 |
|
48992 | 152 |
fun bad binding = "Bad name binding: " ^ print binding ^ Position.here (pos_of binding); |
41254
78c3e472bb35
extra checking of name bindings for classes, types, consts;
wenzelm
parents:
39442
diff
changeset
|
153 |
|
78c3e472bb35
extra checking of name bindings for classes, types, consts;
wenzelm
parents:
39442
diff
changeset
|
154 |
fun check binding = |
50239 | 155 |
if Symbol_Pos.is_identifier (name_of binding) then () |
41254
78c3e472bb35
extra checking of name bindings for classes, types, consts;
wenzelm
parents:
39442
diff
changeset
|
156 |
else legacy_feature (bad binding); |
78c3e472bb35
extra checking of name bindings for classes, types, consts;
wenzelm
parents:
39442
diff
changeset
|
157 |
|
59874 | 158 |
|
159 |
||
160 |
(** resulting name_spec **) |
|
161 |
||
162 |
val bad_specs = ["", "??", "__"]; |
|
163 |
||
164 |
fun name_spec path binding = |
|
165 |
let |
|
166 |
val Binding {private, concealed, prefix, qualifier, name, ...} = binding; |
|
167 |
val _ = Long_Name.is_qualified name andalso error (bad binding); |
|
168 |
||
169 |
val spec1 = |
|
170 |
maps (fn (a, b) => map (rpair b) (Long_Name.explode a)) (path @ prefix @ qualifier); |
|
171 |
val spec2 = if name = "" then [] else [(name, true)]; |
|
172 |
val spec = spec1 @ spec2; |
|
173 |
val _ = |
|
174 |
exists (fn (a, _) => member (op =) bad_specs a orelse exists_string (fn s => s = "\"") a) spec |
|
175 |
andalso error (bad binding); |
|
176 |
in {private = private, concealed = concealed, spec = if null spec2 then [] else spec} end; |
|
177 |
||
28941 | 178 |
end; |
179 |
||
30214
f84c9f10292a
moved name space externalization flags back to name_space.ML;
wenzelm
parents:
29617
diff
changeset
|
180 |
type binding = Binding.binding; |