A set of loggers. The number of loggers is the capabilities of GHC RTS. You can specify it with "+RTS -N<x>". A buffer is prepared for each capability.

Creating a new LoggerSet using a file.

Creating a new LoggerSet using stdout.

Creating a new LoggerSet using stderr.

Creating a new LoggerSet. If Nothing is specified to the second argument, stdout is used. Please note that the minimum BufSize is 1.

The type for buffer size of each core.

The default buffer size (4,096 bytes).

Renewing the internal file information in LoggerSet. This does nothing for stdout and stderr.

Flushing the buffers, closing the internal file information and freeing the buffers.

Log message builder. Use (<>) to append two LogStr in O(1).

Types that can be converted to a LogStr. Instances for types from the text library use a UTF-8 encoding. Instances for numerical types use a decimal encoding.

Converting LogStr to ByteString.

Obtaining the length of LogStr.

Writing a log message to the corresponding buffer. If the buffer becomes full, the log messages in the buffer are written to its corresponding file, stdout, or stderr.

Same as pushLogStr but also appends a newline.

Flushing log messages in buffers. This function must be called explicitly when the program is being terminated.

Note: Since version 2.1.6, this function does not need to be explicitly called, as every push includes an auto-debounced flush courtesy of the auto-update package. Since version 2.2.2, this function can be used to force flushing outside of the debounced flush calls.

FastLogger simply log logStr.

TimedFastLogger pass FormattedTime to callback and simply log its result. this can be used to customize how to log timestamp.

Usually, one would write a wrapper on top of TimedFastLogger, for example:

{--}

log :: TimedFastLogger -> LogStr -> IO ()
log logger msg = logger (time -> toLogStr (show time) <> " " <> msg <> "n")

Logger Type.

Initialize a FastLogger without attaching timestamp a tuple of logger and clean up action are returned.

bracket version of newFastLogger

Initialize a FastLogger with timestamp attached to each message. a tuple of logger and clean up action are returned.

bracket version of newTimeFastLogger