type t = Format.formattertype 'a printer = t -> 'a -> unitval silent : 'a printerPrints nothing
val unit : unit printerval int : int printerval string : string printerval bool : bool printerval float3 : float printerval float : float printerval char : char printerval int32 : int32 printerval int64 : int64 printerval nativeint : nativeint printerval string_quoted : string printerSimilar to CCString.print.
opt pp prints options as follows: Some x will become "some foo" if pp x ---> "foo" None will become "none"
In the tuple printers, the sep argument is only available
within a b p wraps p inside the strings a and b. Convenient, for instances, for brackets, parenthesis, quotes, etc.
Use ANSI escape codes https://en.wikipedia.org/wiki/ANSI_escape_code to put some colors on the terminal.
This uses tags in format strings to specify the style. Current styles are the following:
Example:
set_color_default true;;
Format.printf
"what is your @{<White>favorite color@}? @{<blue>blue@}! No, @{<red>red@}! Ahhhhhhh@.";;status: experimental
val set_color_tag_handling : t -> unitadds functions to support color tags to the given formatter.
set_color_default b enables color handling on the standard formatters (stdout, stderr) if b = true as well as on sprintf formatters; it disables the color handling if b = false.
with_color "Blue" pp behaves like the printer pp, but with the given style. status: experimental
val with_colorf : string -> t -> ('a, t, unit, unit) Pervasives.format4 -> 'awith_colorf "Blue" out "%s %d" "yolo" 42 will behave like Format.fprintf, but wrapping the content with the given style status: experimental
val with_color_sf : string -> ('a, t, unit, string) Pervasives.format4 -> 'awith_color_sf "Blue" out "%s %d" "yolo" 42 will behave like sprintf, but wrapping the content with the given style Example:
CCFormat.with_color_sf "red" "%a" CCFormat.Dump.(list int) [1;2;3] |> print_endline;;status: experimental
val to_string : 'a printer -> 'a -> stringval stdout : tval stderr : tval sprintf : ('a, t, unit, string) Pervasives.format4 -> 'aPrint into a string any format string that would usually be compatible with fprintf. Similar to Format.asprintf.
val sprintf_no_color : ('a, t, unit, string) Pervasives.format4 -> 'aSimilar to sprintf but never prints colors
val sprintf_dyn_color :
colors:bool ->
('a, t, unit, string) Pervasives.format4 ->
'aSimilar to sprintf but enable/disable colors depending on colors. Example:
(* with colors *)
CCFormat.sprintf_dyn_color ~colors:true "@{<Red>%a@}"
CCFormat.Dump.(list int) [1;2;3] |> print_endline;;
(* without colors *)
CCFormat.sprintf_dyn_color ~colors:false "@{<Red>%a@}"
CCFormat.Dump.(list int) [1;2;3] |> print_endline;;val fprintf : t -> ('a, t, unit) Pervasives.format -> 'aAlias to Format.fprintf
val fprintf_dyn_color :
colors:bool ->
t ->
('a, t, unit) Pervasives.format ->
'aSimilar to fprintf but enable/disable colors depending on colors
val ksprintf :
f:(string -> 'b) ->
('a, Format.formatter, unit, 'b) Pervasives.format4 ->
'aksprintf fmt ~f formats using fmt, in a way similar to sprintf, and then calls f on the resulting string.
val to_file : string -> ('a, t, unit, unit) Pervasives.format4 -> 'aPrint to the given file
Print structures as OCaml values, so that they can be parsed back by OCaml (typically, in the toplevel, for debugging).
Example:
Format.printf "%a@." CCFormat.Dump.(list int) CCList.(1 -- 200);;
Format.printf "%a@." CCFormat.Dump.(array (list (pair int bool)))
[| [1, true; 2, false]; []; [42, false] |];;module Dump : sig ... end