to_string_hum forces the lazy message, which might be an expensive operation.
to_string_hum usually produces a sexp; however, it is guaranteed that
(of_string s) = s.
If this string is going to go into a log file, you may find it useful to ensure that
the string is only one line long. To do this, use
to_string_mach t outputs
t as a sexp on a single-line.
old version (pre 109.61) of
to_string_hum that some applications rely on.
Calls should be replaced with
to_string_mach t, which outputs more parenthesis and
Be careful that the body of the lazy or thunk does not access mutable data, since it will only be called at an undetermined later point.
create message a sexp_of_a,
sexp_of_a a is lazily computed, when the info is
converted to a sexp. So, if
a is mutated in the time between the call to
and the sexp conversion, those mutations will be reflected in the sexp. Use
~strict:() to force
sexp_of_a a to be computed immediately.
t containing only a string from a format. This eagerly constructs
to_exn are primarily used with
Error, but their definitions have to
be here because they refer to the underlying representation.