package lwt

  1. Overview
  2. Docs
Promises and event-driven I/O

Install 

dune-project
 Dependency

github.com Readme MIT License Edit opam file Versions (27)

Authors

  1. J
    Jérôme Vouillon
  2. J
    Jérémie Dimino

Maintainers

  1. R
    Raphaël Proust <code@bnwr.net>
  2. Anton Bachin

Sources

5.4.2.tar.gz
md5=ba3659a8918d8e7cb0f4ef9a83945f90
sha512=9f46fb2e56dc7bd57a12d5ab4dc68719947a1462f336087a95e991d087bb9b5b8dee2592d0f7d35abc507d9a641dd221c44c949c81d00e26c673a067d94ba3f4

doc/lwt.unix/Lwt_fmt/index.html

Module Lwt_fmtSource

Format API for Lwt-powered IOs

  • since 4.1.0

This module bridges the gap between Format and Lwt. Although it is not required, it is recommended to use this module with the Fmt library.

Compared to regular formatting function, the main difference is that printing statements will now return promises instead of blocking.

Sourceval printf : ('a, Format.formatter, unit, unit Lwt.t) format4 -> 'a

Returns a promise that prints on the standard output. Similar to Format.printf.

Sourceval eprintf : ('a, Format.formatter, unit, unit Lwt.t) format4 -> 'a

Returns a promise that prints on the standard error. Similar to Format.eprintf.

Formatters

Sourcetype formatter

Lwt enabled formatters

Sourcetype order =
  1. | String of string * int * int
    (*

    String (s, off, len) indicate the output of s at offset off and length len.

    *)
  2. | Flush
    (*

    Flush operation

    *)
Sourceval make_stream : unit -> order Lwt_stream.t * formatter

make_stream () returns a formatter and a stream of all the writing order given on that stream.

of_channel oc creates a formatter that writes to the channel oc.

Sourceval stdout : formatter

Formatter printing on Lwt_io.stdout.

Sourceval stderr : formatter

Formatter printing on Lwt_io.stdout.

Sourceval make_formatter : commit:(unit -> unit Lwt.t) -> fmt:Format.formatter -> unit -> formatter

make_formatter ~commit ~fmt creates a new lwt formatter based on the Format.formatter fmt. The commit function will be called by the printing functions to update the underlying channel.

Sourceval get_formatter : formatter -> Format.formatter

get_formatter fmt returns the underlying Format.formatter. To access the underlying formatter during printing, it isvrecommended to use %t and %a.

Printing

Sourceval fprintf : formatter -> ('a, Format.formatter, unit, unit Lwt.t) format4 -> 'a
Sourceval kfprintf : (formatter -> unit Lwt.t -> 'a) -> formatter -> ('b, Format.formatter, unit, 'a) format4 -> 'b
Sourceval ifprintf : formatter -> ('a, Format.formatter, unit, unit Lwt.t) format4 -> 'a
Sourceval ikfprintf : (formatter -> unit Lwt.t -> 'a) -> formatter -> ('b, Format.formatter, unit, 'a) format4 -> 'b
Sourceval flush : formatter -> unit Lwt.t

flush fmt flushes the formatter (as with Format.pp_print_flush) and executes all the printing action on the underlying channel.

Low level functions

Sourceval write_order : Lwt_io.output_channel -> order -> unit Lwt.t

write_order oc o applies the order o on the channel oc.

Sourceval write_pending : formatter -> unit Lwt.t

Write all the pending orders of a formatter. Warning: This function flush neither the internal format queues nor the underlying channel and is intended for low level use only. You should probably use flush instead.