heptagon/compiler/global/idents.mli

62 lines
1.9 KiB
OCaml
Raw Normal View History

open Names
(** This modules manages unique identifiers,
2011-01-20 23:05:18 +01:00
/!\ To be effective, [enter_node] has to be called when entering a node
[gen_var] generates a variable identifier
[name] returns a unique name (inside its node) from an identifier. *)
2010-06-15 10:49:03 +02:00
(** The (abstract) type of identifiers*)
type ident
(** Type to be used for local variables *)
type var_ident = ident
2010-06-15 10:49:03 +02:00
2011-01-20 23:05:18 +01:00
(** Comparison on idents with the same properties as [Pervasives.compare] *)
val ident_compare : ident -> ident -> int
(** Get the full name of an identifier (it is guaranteed to be unique) *)
2010-06-15 10:49:03 +02:00
val name : ident -> string
2011-05-09 19:32:12 +02:00
(** Get the source name of an identifier (useful when dealing with signatures *)
val source_name : ident -> string
(** [gen_fresh pass_name kind_to_string kind]
generate a fresh ident with a sweet [name].
It should be used to define a [fresh] function specific to a pass. *)
2011-05-23 20:42:04 +02:00
val gen_fresh : string -> ('a -> string) -> ?reset:bool -> 'a -> ident
2011-01-20 23:05:18 +01:00
(** [gen_var pass_name name]
generates a fresh ident with a sweet [name] *)
2011-05-23 20:42:04 +02:00
val gen_var : string -> ?reset:bool -> string -> ident
2011-05-09 19:32:12 +02:00
(** [ident_of_name n] returns an fresh identifier corresponding
to a _source_ variable (do not use it for generated variables). *)
2011-05-23 20:42:04 +02:00
val ident_of_name : ?reset:bool -> string -> ident
val is_reset : ident -> bool
(** /!\ [enter_node qualname] should be called every time we enter a node with name [qualname]. *)
val enter_node : Names.qualname -> unit
2010-06-15 10:49:03 +02:00
(** Maps taking an identifier as a key. *)
module Env :
sig
include (Map.S with type key = ident)
val append : 'a t -> 'a t -> 'a t
val union : 'a t -> 'a t -> 'a t
val diff : 'a t -> 'b t -> 'a t
val partition : (key -> bool) -> 'a t -> 'a t * 'a t
val print_t : (Format.formatter -> 'a -> unit) -> Format.formatter -> 'a t -> unit
end
2010-06-15 10:49:03 +02:00
(** A set of identifiers. *)
module IdentSet :
sig
include (Set.S with type elt = ident)
val print_t : Format.formatter -> t -> unit
end
val print_ident : Format.formatter -> ident -> unit