X-Git-Url: http://matita.cs.unibo.it/gitweb/?a=blobdiff_plain;f=helm%2Focaml%2Fextlib%2FhExtlib.mli;h=c0538bfabc8c88eb332c945fdc5372035b5000c8;hb=99b249b23524cda2d91602ee088fef1a7be253ee;hp=ad055315e077faf337f0d937fb2b516eada03eab;hpb=4cf620c8fa51986897a60cbef60431103aa98d5a;p=helm.git diff --git a/helm/ocaml/extlib/hExtlib.mli b/helm/ocaml/extlib/hExtlib.mli index ad055315e..c0538bfab 100644 --- a/helm/ocaml/extlib/hExtlib.mli +++ b/helm/ocaml/extlib/hExtlib.mli @@ -26,6 +26,7 @@ (** {2 Optional values} *) val map_option: ('a -> 'b) -> 'a option -> 'b option +val iter_option: ('a -> unit) -> 'a option -> unit val unopt: 'a option -> 'a (** @raise Failure *) (** {2 Filesystem} *) @@ -33,6 +34,15 @@ val unopt: 'a option -> 'a (** @raise Failure *) val is_dir: string -> bool (** @return true if file is a directory *) val is_regular: string -> bool (** @return true if file is a regular file *) val mkdir: string -> unit (** create dir and parents. @raise Failure *) +val tilde_expand: string -> string (** bash-like (head) tilde expansion *) +val safe_remove: string -> unit (** removes a file if it exists *) +val safe_rmdir: string -> unit (** removes a dir if it exists and is empty *) +val is_dir_empty: string -> bool (** checks if the dir is empty *) +val rmdir_descend: string -> unit (** rmdir -p *) + + + (** find all _files_ matching test under a filesystem root *) +val find: ?test:(string -> bool) -> string -> string list (** {2 File I/O} *) @@ -44,16 +54,39 @@ val output_file: filename:string -> text:string -> unit (** other way round *) val finally: (unit -> unit) -> ('a -> 'b) -> 'a -> 'b +(** {2 Char processing} *) + +val is_alpha: char -> bool +val is_blank: char -> bool +val is_digit: char -> bool +val is_alphanum: char -> bool (** is_alpha || is_digit *) + (** {2 String processing} *) val split: ?sep:char -> string -> string list (** @param sep defaults to ' ' *) val trim_blanks: string -> string (** strip heading and trailing blanks *) +(** {2 List processing} *) + +val list_uniq: + ?eq:('a->'a->bool) -> 'a list -> 'a list (** uniq unix filter on lists *) +val filter_map: ('a -> 'b option) -> 'a list -> 'b list (** filter + map *) +val list_concat: ?sep:'a list -> 'a list list -> 'a list (**String.concat-like*) +val list_findopt: ('a -> 'b option) -> 'a list -> 'b option + (** {2 Debugging & Profiling} *) type profiler = { profile : 'a 'b. ('a -> 'b) -> 'a -> 'b } (** @return a profiling function; [s] is used for labelling the total time at * the end of the execution *) -val profile : string -> profiler +val profile : ?enable:bool -> string -> profiler +val set_profiling_printings : (unit -> bool) -> unit + +(** {2 Localized exceptions } *) + +exception Localized of Token.flocation * exn + +val loc_of_floc: Token.flocation -> int * int +val raise_localized_exception: offset:int -> Token.flocation -> exn -> 'a