/usr/lib/ocaml/obus/oBus_path.mli is in libobus-ocaml-dev 1.1.5-3build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | (*
* oBus_path.mli
* -------------
* Copyright : (c) 2008, Jeremie Dimino <jeremie@dimino.org>
* Licence : BSD3
*
* This file is a part of obus, an ocaml implementation of D-Bus.
*)
(** Manipulation of dbus object paths *)
type element = string
(** A path component *)
type t = element list
(** A complete path *)
val compare : t -> t -> int
(** Same as [Pervasives.compare]. It allows this module to be used
as argument to the functors [Set.Make] and [Map.Make]. *)
(** {6 Construction} *)
val empty : t
(** Empty path *)
val after : t -> t -> t option
(** [after prefix path] if [path = prefix @ p] return [Some p], and
[None] if not *)
val of_string : string -> t
(** Create an object path from a string.
@raise OBus_string.Invalid_string if the given string does not
represent a valid object path *)
val to_string : t -> string
(** Return a string representation of an object path *)
(** {6 Helpers} *)
val escape : string -> element
(** Escape an arbitrary string into a valid element *)
val unescape : element -> string
(** Interpret escape sequence to get back the original string *)
val generate : unit -> t
(** [generate ()] generate a new unique path *)
(** {6 Validation} *)
val validate : OBus_string.validator
val validate_element : OBus_string.validator
|