Debug.Trace.Text

Text variant of the tracing functions in Debug.Trace.

Documentation

traceEvent :: Text -> a -> a

Text variant of traceEvent.

\(O(n)\) This function marshals the Text into a ByteString and convert it into a null-terminated CString.

Note that this function doesn't evaluate the Text if user tracing in eventlog is disabled.

The input should be shorter than \(2^{16}\) bytes. Otherwise the RTS generates a broken eventlog.

traceEventIO :: Text -> IO ()

Text variant of traceEventIO.

\(O(n)\) This function marshals the Text into a ByteString and convert it into a null-terminated CString.

Note that this function doesn't evaluate the Text if user tracing in eventlog is disabled.

The input should be shorter than \(2^{16}\) bytes. Otherwise the RTS generates a broken eventlog.

traceMarker :: Text -> a -> a

Text variant of traceMarker.

\(O(n)\) This function marshals the Text into a ByteString and convert it into a null-terminated CString.

Note that this function doesn't evaluate the Text if user tracing in eventlog is disabled.

The input should be shorter than \(2^{16}\) bytes. Otherwise the RTS generates a broken eventlog.

traceMarkerIO :: Text -> IO ()

Text variant of traceMarkerIO.

\(O(n)\) This function marshals the Text into a ByteString and convert it into a null-terminated CString.

Note that this function doesn't evaluate the Text if user tracing in eventlog is disabled.

The input should be shorter than \(2^{16}\) bytes. Otherwise the RTS generates a broken eventlog.