BIG FAT COMMIT REGARDING COERCIONS:

[helm.git] / components / extlib / hExtlib.mli

diff --git a/components/extlib/hExtlib.mli b/components/extlib/hExtlib.mli
index 37a3bc6df2686c17c38144b2882d1f9093842ffa..0c2206a08bd82339f85cb3ad8c60934b9fcb0aba 100644 (file)
--- a/components/extlib/hExtlib.mli
+++ b/components/extlib/hExtlib.mli
@@ -40,7 +40,6 @@ 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_ whose name matches test under a filesystem root.
    * Test is passed the filename path relative to the given filesystem root *)
 val find: ?test:(string -> bool) -> string -> string list 
@@ -53,6 +52,10 @@ val output_file: filename:string -> text:string -> unit (** other way round *)
 
 (** {2 Exception handling} *)
 
+  (** @param finalizer finalization function (execution both in case of success
+   * and in case of raised exception
+   * @param f function to be invoked
+   * @param arg argument to be passed to function *)
 val finally: (unit -> unit) -> ('a -> 'b) -> 'a -> 'b
 
 (** {2 Char processing} *)
@@ -74,6 +77,14 @@ val list_uniq:
 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
+val flatten_map: ('a -> 'b list) -> 'a list -> 'b list
+val list_last: 'a list -> 'a
+
+  (** split_nth n l
+   * @returns two list, the first contains at least n elements, the second the
+   * remaining one
+   * @raise Failure when List.length l < n *)
+val split_nth: int -> 'a list -> 'a list * 'a list
 
 (** {2 Debugging & Profiling} *)