1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
(************************************************************************)
(* * The Coq Proof Assistant / The Coq Development Team *)
(* v * Copyright INRIA, CNRS and contributors *)
(* <O___,, * (see version control and CREDITS file for authors & dates) *)
(* \VV/ **************************************************************)
(* // * This file is distributed under the terms of the *)
(* * GNU Lesser General Public License Version 2.1 *)
(* * (see LICENSE file for the text of the license) *)
(************************************************************************)
(** Extending streams with a (non-canonical) location function *)
type ('e,'a) t
val from : ?loc:Loc.t -> ('e -> ('a * Loc.t) option) -> ('e,'a) t
(** Returning the loc of the last consumed element or the initial loc
if no element is consumed *)
val current_loc : ('e,'a) t -> Loc.t
(** Returning the loc of the max visited element or the initial loc
if no element is consumed *)
val max_peek_loc : ('e,'a) t -> Loc.t
(** [interval_loc bp ep strm] returns the loc starting after element
[bp] (counting from 0) and spanning up to already peeked element
at position [ep], under the assumption that [bp] <= [ep]; returns
an empty interval if [bp] = [ep]; returns the empty initial
interval if additionally [bp] = 0; fails if the elements have not
been peeked yet *)
val interval_loc : int -> int -> ('e,'a) t -> Loc.t
(** Return location of an already peeked element at some position counting from 0;
fails if the element has not been peeked yet *)
val get_loc : int -> ('e,'a) t -> Loc.t
(** Lifted usual function on streams *)
val count : ('e,'a) t -> int
val peek : 'e -> ('e,'a) t -> 'a option
val npeek : 'e -> int -> ('e,'a) t -> 'a list
val junk : 'e -> ('e,'a) t -> unit
(** consumes the next element if there is one *)
val njunk : 'e -> int -> ('e,'a) t -> unit
(** [njunk e n strm] consumes [n] elements from [strm] *)
val next : 'e -> ('e,'a) t -> 'a
(** [next e strm] returns and consumes the next element;
raise [Stream.Failure] if the stream is empty *)
(** Other functions *)
val peek_nth : 'e -> int -> ('e,'a) t -> 'a
(** [peek_nth e n strm] returns the nth element counting from 0 without
consuming the stream; raises [Stream.Failure] if not enough
elements *)
|
