Module `Base__Sexp`

type t = Sexplib0.Sexp.t = | Atom of string | List of t list: Type of S-expressions

val compare : t -> t -> int
val hash_fold_t : Base.Hash.state -> t -> Base.Hash.state
val hash : t -> Base.Hash.hash_value

include module type of Sexplib0.Sexp with type t := Sexplib0.Sexp.t

module Private : sig ... end

val of_int_style : [ `Underscores | `No_underscores ] Stdlib.ref
val of_float_style : [ `Underscores | `No_underscores ] Stdlib.ref

Styles

val to_string : Sexplib0.Sexp.t -> string: Same as to_string_mach.

val to_string_mach : Sexplib0.Sexp.t -> string: to_string_mach sexp converts S-expression sexp to a string in machine readable (i.e. most compact) form.

val to_string_hum : ?⁠indent:int -> Sexplib0.Sexp.t -> string

to_string_hum ?indent sexp converts S-expression sexp to a string in human readable form with indentation level indent.

parameter indent: default = !default_indent

Conversion to strings

val pp : Stdlib.Format.formatter -> Sexplib0.Sexp.t -> unit: Same as pp_mach.

val pp_mach : Stdlib.Format.formatter -> Sexplib0.Sexp.t -> unit: pp_mach ppf sexp outputs S-expression sexp to formatter ppf in machine readable (i.e. most compact) form.

val pp_hum_indent : int -> Stdlib.Format.formatter -> Sexplib0.Sexp.t -> unit: pp_hum_indent n ppf sexp outputs S-expression sexp to formatter ppf in human readable form and indentation level n.

val pp_hum : Stdlib.Format.formatter -> Sexplib0.Sexp.t -> unit: pp_hum ppf sexp outputs S-expression sexp to formatter ppf in human readable form.

Pretty printing of S-expressions

val default_indent : int Stdlib.ref

default_indent reference to default indentation level for human-readable conversions.

Initialisation value: 2.

Defaults

val message : string -> (string * Sexplib0.Sexp.t) list -> Sexplib0.Sexp.t

Helper to build nice s-expressions for error messages. It imitates the behavior of [%message ...] from the ppx_sexp_message rewriter.

message name key_values produces a s-expression list starting with atom name and followed by list of size 2 of the form (key value). When the key is the empty string, value is used directly instead as for [%message].

For instance the following code:

Sexp.message "error"
  [ "x", sexp_of_int 42
  ; "" , sexp_of_exn Exit
  ]

produces the s-expression:

(error (x 42) Exit)

Helpers

exception Of_sexp_error of exn * Sexplib0.Sexp.t: Of_sexp_error (exn, sexp) the exception raised when an S-expression could not be successfully converted to an OCaml-value.

exception Not_found_s of Sexplib0.Sexp.t: Not_found_s is used by functions that historically raised Not_found, to allow them to raise an exception that contains an informative error message (as a sexp), while still having an exception that can be distinguished from other exceptions.

val compare : Sexplib0.Sexp.t -> Sexplib0.Sexp.t -> int
val equal : Sexplib0.Sexp.t -> Sexplib0.Sexp.t -> bool
val sexp_of_t : Sexplib0.Sexp.t -> Sexplib0.Sexp.t
val t_of_sexp : Sexplib0.Sexp.t -> Sexplib0.Sexp.t

val of_string : unit: Base has never had an of_string function. We expose a deprecated of_string here so that people can find it (e.g. with merlin), and learn what we recommend. This of_string has type unit because we don't want it to be accidentally used.