Debug.Trace.ByteString

ByteString variants of the tracing functions in Debug.Trace.

Documentation

traceEvent :: ByteString -> a -> a

ByteString variant of traceEvent.

\(O(n)\) This function copies the ByteString to convert it to a null-terminated CString.

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

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

traceEventIO :: ByteString -> IO ()

ByteString variant of traceEventIO.

\(O(n)\) This function copies the ByteString to convert it to a null-terminated CString.

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

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

traceMarker :: ByteString -> a -> a

ByteString variant of traceMarker.

\(O(n)\) This function copies the ByteString to convert it to a null-terminated CString.

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

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

traceMarkerIO :: ByteString -> IO ()

ByteString variant of traceMarkerIO.

\(O(n)\) This function copies the ByteString to convert it to a null-terminated CString.

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

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

unsafeTraceEvent :: ByteString -> a -> a

ByteString variant of traceEvent.

\(O(1)\) This function is unsafe in the way that it doesn't ensure the input string to be null-terminated. It is user's responsibility to null-terminate the input.

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

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

unsafeTraceEventIO :: ByteString -> IO ()

ByteString variant of traceEventIO.

\(O(1)\) This function is unsafe in the way that it doesn't ensure the input string to be null-terminated. It is user's responsibility to null-terminate the input.

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

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

unsafeTraceMarker :: ByteString -> a -> a

ByteString variant of traceMarker.

\(O(1)\) This function is unsafe in the way that it doesn't ensure the input string to be null-terminated. It is user's responsibility to null-terminate the input.

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

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

unsafeTraceMarkerIO :: ByteString -> IO ()

ByteString variant of traceMarkerIO.

\(O(1)\) This function is unsafe in the way that it doesn't ensure the input string to be null-terminated. It is user's responsibility to null-terminate the input.

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

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