author | wenzelm |
Sun, 06 Apr 2014 15:51:02 +0200 | |
changeset 56437 | b14bd153a753 |
parent 56333 | 38f1422ef473 |
child 56459 | 38d0b2099743 |
permissions | -rw-r--r-- |
6118 | 1 |
(* Title: Pure/General/position.ML |
5010 | 2 |
Author: Markus Wenzel, TU Muenchen |
3 |
||
29307 | 4 |
Source positions: counting Isabelle symbols, starting from 1. |
5010 | 5 |
*) |
6 |
||
7 |
signature POSITION = |
|
8 |
sig |
|
41484 | 9 |
eqtype T |
43710
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
10 |
val make: {line: int, offset: int, end_offset: int, props: Properties.T} -> T |
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
11 |
val dest: T -> {line: int, offset: int, end_offset: int, props: Properties.T} |
23673 | 12 |
val line_of: T -> int option |
27795 | 13 |
val offset_of: T -> int option |
41484 | 14 |
val end_offset_of: T -> int option |
23673 | 15 |
val file_of: T -> string option |
27796 | 16 |
val advance: Symbol.symbol -> T -> T |
17 |
val distance_of: T -> T -> int |
|
5010 | 18 |
val none: T |
27777 | 19 |
val start: T |
31435 | 20 |
val file_name: string -> Properties.T |
44200 | 21 |
val file_only: string -> T |
27777 | 22 |
val file: string -> T |
56437 | 23 |
val line_file_only: int -> string -> T |
24 |
val line_file: int -> string -> T |
|
5010 | 25 |
val line: int -> T |
29307 | 26 |
val id: string -> T |
32573 | 27 |
val id_only: string -> T |
27426 | 28 |
val get_id: T -> string option |
29 |
val put_id: string -> T -> T |
|
50911
ee7fe4230642
more explicit treatment of (optional) exception properties, notably for "serial" -- avoid conflict with startPosition = offset;
wenzelm
parents:
50254
diff
changeset
|
30 |
val parse_id: T -> int option |
28017 | 31 |
val of_properties: Properties.T -> T |
32 |
val properties_of: T -> Properties.T |
|
42327
7c7cc7590eb3
Name_Space.entry_markup: keep def position as separate properties;
wenzelm
parents:
42204
diff
changeset
|
33 |
val def_properties_of: T -> Properties.T |
45412 | 34 |
val entity_properties_of: bool -> serial -> T -> Properties.T |
28017 | 35 |
val default_properties: T -> Properties.T -> Properties.T |
39440
4c2547af5909
simplified/clarified (Context_)Position.markup/reported_text;
wenzelm
parents:
38887
diff
changeset
|
36 |
val markup: T -> Markup.T -> Markup.T |
41504 | 37 |
val is_reported: T -> bool |
39507
839873937ddd
tuned signature of (Context_)Position.report variants;
wenzelm
parents:
39440
diff
changeset
|
38 |
val reported_text: T -> Markup.T -> string -> string |
839873937ddd
tuned signature of (Context_)Position.report variants;
wenzelm
parents:
39440
diff
changeset
|
39 |
val report_text: T -> Markup.T -> string -> unit |
839873937ddd
tuned signature of (Context_)Position.report variants;
wenzelm
parents:
39440
diff
changeset
|
40 |
val report: T -> Markup.T -> unit |
44736 | 41 |
type report = T * Markup.T |
48767 | 42 |
type report_text = report * string |
43 |
val reports_text: report_text list -> unit |
|
44736 | 44 |
val reports: report list -> unit |
55922
710bc66f432c
more markup for inner syntax class/type names (notably for completion);
wenzelm
parents:
55624
diff
changeset
|
45 |
val store_reports: report_text list Unsynchronized.ref -> |
710bc66f432c
more markup for inner syntax class/type names (notably for completion);
wenzelm
parents:
55624
diff
changeset
|
46 |
T list -> ('a -> Markup.T list) -> 'a -> unit |
55959
c3b458435f4f
more decisive commitment to get_free vs. the_const;
wenzelm
parents:
55922
diff
changeset
|
47 |
val append_reports: report_text list Unsynchronized.ref -> report list -> unit |
48992 | 48 |
val here: T -> string |
49691 | 49 |
val here_list: T list -> string |
27764 | 50 |
type range = T * T |
27796 | 51 |
val no_range: range |
41484 | 52 |
val set_range: range -> T |
27777 | 53 |
val reset_range: T -> T |
27764 | 54 |
val range: T -> T -> range |
25817 | 55 |
val thread_data: unit -> T |
56 |
val setmp_thread_data: T -> ('a -> 'b) -> 'a -> 'b |
|
49528
789b73fcca72
report proper binding positions only -- avoid swamping document model with unspecific information;
wenzelm
parents:
48992
diff
changeset
|
57 |
val default: T -> bool * T |
5010 | 58 |
end; |
59 |
||
60 |
structure Position: POSITION = |
|
61 |
struct |
|
62 |
||
63 |
(* datatype position *) |
|
64 |
||
43710
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
65 |
datatype T = Pos of (int * int * int) * Properties.T; |
41484 | 66 |
|
67 |
fun norm_props (props: Properties.T) = |
|
45666 | 68 |
maps (fn a => the_list (find_first (fn (b, _) => a = b) props)) |
50201
c26369c9eda6
Isabelle-specific implementation of quasi-abstract markup elements -- back to module arrangement before d83797ef0d2d;
wenzelm
parents:
49691
diff
changeset
|
69 |
Markup.position_properties'; |
41484 | 70 |
|
43710
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
71 |
fun make {line = i, offset = j, end_offset = k, props} = Pos ((i, j, k), norm_props props); |
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
72 |
fun dest (Pos ((i, j, k), props)) = {line = i, offset = j, end_offset = k, props = props}; |
27777 | 73 |
|
27795 | 74 |
fun valid (i: int) = i > 0; |
75 |
fun if_valid i i' = if valid i then i' else i; |
|
76 |
||
27777 | 77 |
|
27796 | 78 |
(* fields *) |
79 |
||
43710
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
80 |
fun line_of (Pos ((i, _, _), _)) = if valid i then SOME i else NONE; |
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
81 |
fun offset_of (Pos ((_, j, _), _)) = if valid j then SOME j else NONE; |
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
82 |
fun end_offset_of (Pos ((_, _, k), _)) = if valid k then SOME k else NONE; |
27796 | 83 |
|
50201
c26369c9eda6
Isabelle-specific implementation of quasi-abstract markup elements -- back to module arrangement before d83797ef0d2d;
wenzelm
parents:
49691
diff
changeset
|
84 |
fun file_of (Pos (_, props)) = Properties.get props Markup.fileN; |
27796 | 85 |
|
86 |
||
27777 | 87 |
(* advance *) |
26003 | 88 |
|
43710
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
89 |
fun advance_count "\n" (i: int, j: int, k: int) = |
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
90 |
(if_valid i (i + 1), if_valid j (j + 1), k) |
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
91 |
| advance_count s (i, j, k) = |
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
92 |
if Symbol.is_regular s then (i, if_valid j (j + 1), k) |
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
93 |
else (i, j, k); |
5010 | 94 |
|
43710
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
95 |
fun invalid_count (i, j, _: int) = |
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
96 |
not (valid i orelse valid j); |
27795 | 97 |
|
98 |
fun advance sym (pos as (Pos (count, props))) = |
|
99 |
if invalid_count count then pos else Pos (advance_count sym count, props); |
|
27777 | 100 |
|
101 |
||
27796 | 102 |
(* distance of adjacent positions *) |
27777 | 103 |
|
43710
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
104 |
fun distance_of (Pos ((_, j, _), _)) (Pos ((_, j', _), _)) = |
27796 | 105 |
if valid j andalso valid j' then j' - j |
106 |
else 0; |
|
26882 | 107 |
|
5010 | 108 |
|
27777 | 109 |
(* make position *) |
110 |
||
43710
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
111 |
val none = Pos ((0, 0, 0), []); |
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
112 |
val start = Pos ((1, 1, 0), []); |
27744 | 113 |
|
29307 | 114 |
|
27796 | 115 |
fun file_name "" = [] |
50201
c26369c9eda6
Isabelle-specific implementation of quasi-abstract markup elements -- back to module arrangement before d83797ef0d2d;
wenzelm
parents:
49691
diff
changeset
|
116 |
| file_name name = [(Markup.fileN, name)]; |
27796 | 117 |
|
44200 | 118 |
fun file_only name = Pos ((0, 0, 0), file_name name); |
43710
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
119 |
fun file name = Pos ((1, 1, 0), file_name name); |
27744 | 120 |
|
56437 | 121 |
fun line_file_only i name = Pos ((i, 0, 0), file_name name); |
43710
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
122 |
fun line_file i name = Pos ((i, 1, 0), file_name name); |
27795 | 123 |
fun line i = line_file i ""; |
5010 | 124 |
|
50201
c26369c9eda6
Isabelle-specific implementation of quasi-abstract markup elements -- back to module arrangement before d83797ef0d2d;
wenzelm
parents:
49691
diff
changeset
|
125 |
fun id id = Pos ((0, 1, 0), [(Markup.idN, id)]); |
c26369c9eda6
Isabelle-specific implementation of quasi-abstract markup elements -- back to module arrangement before d83797ef0d2d;
wenzelm
parents:
49691
diff
changeset
|
126 |
fun id_only id = Pos ((0, 0, 0), [(Markup.idN, id)]); |
22158 | 127 |
|
50201
c26369c9eda6
Isabelle-specific implementation of quasi-abstract markup elements -- back to module arrangement before d83797ef0d2d;
wenzelm
parents:
49691
diff
changeset
|
128 |
fun get_id (Pos (_, props)) = Properties.get props Markup.idN; |
c26369c9eda6
Isabelle-specific implementation of quasi-abstract markup elements -- back to module arrangement before d83797ef0d2d;
wenzelm
parents:
49691
diff
changeset
|
129 |
fun put_id id (Pos (count, props)) = Pos (count, Properties.put (Markup.idN, id) props); |
27426 | 130 |
|
50911
ee7fe4230642
more explicit treatment of (optional) exception properties, notably for "serial" -- avoid conflict with startPosition = offset;
wenzelm
parents:
50254
diff
changeset
|
131 |
fun parse_id pos = Option.map Markup.parse_int (get_id pos); |
ee7fe4230642
more explicit treatment of (optional) exception properties, notably for "serial" -- avoid conflict with startPosition = offset;
wenzelm
parents:
50254
diff
changeset
|
132 |
|
29307 | 133 |
|
134 |
(* markup properties *) |
|
135 |
||
25817 | 136 |
fun of_properties props = |
23627 | 137 |
let |
27795 | 138 |
fun get name = |
28017 | 139 |
(case Properties.get props name of |
27795 | 140 |
NONE => 0 |
50254
935ac0ad7e83
prefer tight Markup.print_int/parse_int for property values;
wenzelm
parents:
50201
diff
changeset
|
141 |
| SOME s => Markup.parse_int s); |
41484 | 142 |
in |
50201
c26369c9eda6
Isabelle-specific implementation of quasi-abstract markup elements -- back to module arrangement before d83797ef0d2d;
wenzelm
parents:
49691
diff
changeset
|
143 |
make {line = get Markup.lineN, offset = get Markup.offsetN, |
c26369c9eda6
Isabelle-specific implementation of quasi-abstract markup elements -- back to module arrangement before d83797ef0d2d;
wenzelm
parents:
49691
diff
changeset
|
144 |
end_offset = get Markup.end_offsetN, props = props} |
41484 | 145 |
end; |
146 |
||
26003 | 147 |
|
50254
935ac0ad7e83
prefer tight Markup.print_int/parse_int for property values;
wenzelm
parents:
50201
diff
changeset
|
148 |
fun value k i = if valid i then [(k, Markup.print_int i)] else []; |
41484 | 149 |
|
43710
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
150 |
fun properties_of (Pos ((i, j, k), props)) = |
50201
c26369c9eda6
Isabelle-specific implementation of quasi-abstract markup elements -- back to module arrangement before d83797ef0d2d;
wenzelm
parents:
49691
diff
changeset
|
151 |
value Markup.lineN i @ value Markup.offsetN j @ value Markup.end_offsetN k @ props; |
26003 | 152 |
|
54038 | 153 |
val def_properties_of = properties_of #> map (fn (x, y) => ("def_" ^ x, y)); |
42327
7c7cc7590eb3
Name_Space.entry_markup: keep def position as separate properties;
wenzelm
parents:
42204
diff
changeset
|
154 |
|
45412 | 155 |
fun entity_properties_of def id pos = |
50254
935ac0ad7e83
prefer tight Markup.print_int/parse_int for property values;
wenzelm
parents:
50201
diff
changeset
|
156 |
if def then (Markup.defN, Markup.print_int id) :: properties_of pos |
935ac0ad7e83
prefer tight Markup.print_int/parse_int for property values;
wenzelm
parents:
50201
diff
changeset
|
157 |
else (Markup.refN, Markup.print_int id) :: def_properties_of pos; |
45412 | 158 |
|
26052 | 159 |
fun default_properties default props = |
50201
c26369c9eda6
Isabelle-specific implementation of quasi-abstract markup elements -- back to module arrangement before d83797ef0d2d;
wenzelm
parents:
49691
diff
changeset
|
160 |
if exists (member (op =) Markup.position_properties o #1) props then props |
26052 | 161 |
else properties_of default @ props; |
162 |
||
39440
4c2547af5909
simplified/clarified (Context_)Position.markup/reported_text;
wenzelm
parents:
38887
diff
changeset
|
163 |
val markup = Markup.properties o properties_of; |
4c2547af5909
simplified/clarified (Context_)Position.markup/reported_text;
wenzelm
parents:
38887
diff
changeset
|
164 |
|
4c2547af5909
simplified/clarified (Context_)Position.markup/reported_text;
wenzelm
parents:
38887
diff
changeset
|
165 |
|
4c2547af5909
simplified/clarified (Context_)Position.markup/reported_text;
wenzelm
parents:
38887
diff
changeset
|
166 |
(* reports *) |
38887
1261481ef5e5
Command.State: add reported positions to markup tree, according main message position or Markup.binding/entity/report occurrences in body;
wenzelm
parents:
38236
diff
changeset
|
167 |
|
41504 | 168 |
fun is_reported pos = is_some (offset_of pos) andalso is_some (get_id pos); |
30669
6de7ef888aa3
added report_text -- status messages with text body;
wenzelm
parents:
29307
diff
changeset
|
169 |
|
41504 | 170 |
fun reported_text pos m txt = if is_reported pos then Markup.markup (markup pos m) txt else ""; |
56333
38f1422ef473
support bulk messages consisting of small string segments, which are more healthy to the Poly/ML RTS and might prevent spurious GC crashes such as MTGCProcessMarkPointers::ScanAddressesInObject;
wenzelm
parents:
55959
diff
changeset
|
171 |
fun report_text pos markup txt = Output.report [reported_text pos markup txt]; |
39507
839873937ddd
tuned signature of (Context_)Position.report variants;
wenzelm
parents:
39440
diff
changeset
|
172 |
fun report pos markup = report_text pos markup ""; |
27764 | 173 |
|
44736 | 174 |
type report = T * Markup.T; |
48767 | 175 |
type report_text = report * string; |
44736 | 176 |
|
48767 | 177 |
val reports_text = |
178 |
map (fn ((pos, m), txt) => if is_reported pos then Markup.markup (markup pos m) txt else "") |
|
56333
38f1422ef473
support bulk messages consisting of small string segments, which are more healthy to the Poly/ML RTS and might prevent spurious GC crashes such as MTGCProcessMarkPointers::ScanAddressesInObject;
wenzelm
parents:
55959
diff
changeset
|
179 |
#> Output.report; |
42204 | 180 |
|
48767 | 181 |
val reports = map (rpair "") #> reports_text; |
182 |
||
44735 | 183 |
fun store_reports _ [] _ _ = () |
55922
710bc66f432c
more markup for inner syntax class/type names (notably for completion);
wenzelm
parents:
55624
diff
changeset
|
184 |
| store_reports (r: report_text list Unsynchronized.ref) ps markup x = |
42204 | 185 |
let val ms = markup x |
55922
710bc66f432c
more markup for inner syntax class/type names (notably for completion);
wenzelm
parents:
55624
diff
changeset
|
186 |
in Unsynchronized.change r (fold (fn p => fold (fn m => cons ((p, m), "")) ms) ps) end; |
42204 | 187 |
|
55959
c3b458435f4f
more decisive commitment to get_free vs. the_const;
wenzelm
parents:
55922
diff
changeset
|
188 |
fun append_reports (r: report_text list Unsynchronized.ref) reports = |
c3b458435f4f
more decisive commitment to get_free vs. the_const;
wenzelm
parents:
55922
diff
changeset
|
189 |
Unsynchronized.change r (append (map (rpair "") reports)); |
c3b458435f4f
more decisive commitment to get_free vs. the_const;
wenzelm
parents:
55922
diff
changeset
|
190 |
|
25817 | 191 |
|
48992 | 192 |
(* here: inlined formal markup *) |
26003 | 193 |
|
48992 | 194 |
fun here pos = |
26003 | 195 |
let |
196 |
val props = properties_of pos; |
|
55624 | 197 |
val (s1, s2) = |
26003 | 198 |
(case (line_of pos, file_of pos) of |
55624 | 199 |
(SOME i, NONE) => (" ", "(line " ^ Markup.print_int i ^ ")") |
200 |
| (SOME i, SOME name) => (" ", "(line " ^ Markup.print_int i ^ " of " ^ quote name ^ ")") |
|
201 |
| (NONE, SOME name) => (" ", "(file " ^ quote name ^ ")") |
|
202 |
| _ => if is_reported pos then ("", "\\<here>") else ("", "")); |
|
26003 | 203 |
in |
204 |
if null props then "" |
|
55624 | 205 |
else s1 ^ Markup.markup (Markup.properties props Markup.position) s2 |
26003 | 206 |
end; |
25817 | 207 |
|
49691 | 208 |
val here_list = space_implode " " o map here; |
209 |
||
23627 | 210 |
|
27736 | 211 |
(* range *) |
212 |
||
213 |
type range = T * T; |
|
214 |
||
27796 | 215 |
val no_range = (none, none); |
216 |
||
43710
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
217 |
fun set_range (Pos ((i, j, _), props), Pos ((_, j', _), _)) = Pos ((i, j, j'), props); |
7270ae921cf2
discontinued odd Position.column -- left-over from attempts at PGIP implementation;
wenzelm
parents:
42818
diff
changeset
|
218 |
fun reset_range (Pos ((i, j, _), props)) = Pos ((i, j, 0), props); |
27777 | 219 |
|
41484 | 220 |
fun range pos pos' = (set_range (pos, pos'), pos'); |
27741 | 221 |
|
27764 | 222 |
|
223 |
(* thread data *) |
|
224 |
||
225 |
local val tag = Universal.tag () : T Universal.tag in |
|
27741 | 226 |
|
28122 | 227 |
fun thread_data () = the_default none (Thread.getLocal tag); |
27764 | 228 |
|
37043
f8e24980af05
more robust Position.setmp_thread_data, independently of Output.debugging (essentially reverts f9ec18f7c0f6, which was motivated by clean exception_trace, but without transaction positions the Isabelle_Process protocol breaks down);
wenzelm
parents:
33097
diff
changeset
|
229 |
fun setmp_thread_data pos = Library.setmp_thread_data tag (thread_data ()) pos; |
27764 | 230 |
|
5010 | 231 |
end; |
27764 | 232 |
|
33097
9d501e11084a
maintain position of formal entities via name space;
wenzelm
parents:
32573
diff
changeset
|
233 |
fun default pos = |
49528
789b73fcca72
report proper binding positions only -- avoid swamping document model with unspecific information;
wenzelm
parents:
48992
diff
changeset
|
234 |
if pos = none then (false, thread_data ()) |
789b73fcca72
report proper binding positions only -- avoid swamping document model with unspecific information;
wenzelm
parents:
48992
diff
changeset
|
235 |
else (true, pos); |
33097
9d501e11084a
maintain position of formal entities via name space;
wenzelm
parents:
32573
diff
changeset
|
236 |
|
27764 | 237 |
end; |