Moduleprettyprinter-1.7.1Haskell2010

Prettyprinter.Render.Text

Render an unannotated SimpleDocStream as plain Text.

5 values

Packageprettyprinter-1.7.1
Exports5
LanguageHaskell2010
LicenceBSD-2-Clause
SourceText.hs

Conversion to plain Text

2 declarations

valuerenderLazy :: SimpleDocStream ann -> Text

(renderLazy sdoc) takes the output sdoc from a rendering function and transforms it to lazy text.

Example3 expressions

>>> let render = TL.putStrLn . renderLazy . layoutPretty defaultLayoutOptions>>> let doc = "lorem" <+> align (vsep ["ipsum dolor", parens "foo bar", "sit amet"])>>> render doclorem ipsum dolor      (foo bar)      sit amet

valuerenderStrict :: SimpleDocStream ann -> Text

(renderStrict sdoc) takes the output sdoc from a rendering function and transforms it to strict text.

Render to a Handle

1 declaration

valuerenderIO :: Handle -> SimpleDocStream ann -> IO ()

(renderIO h sdoc) writes sdoc to the file h.

Example1 expression

>>> renderIO System.IO.stdout (layoutPretty defaultLayoutOptions "hello\nworld")helloworld

This function is more efficient than hPutStr h (renderStrict sdoc), since it writes to the handle directly, skipping the intermediate Text representation.

Convenience functions

valueputDoc :: Doc ann -> IO ()

(putDoc doc) prettyprints document doc to standard output. Uses the defaultLayoutOptions.

Example1 expression

>>> putDoc ("hello" <+> "world")hello world

putDoc = hPutDoc stdout

valuehPutDoc :: Handle -> Doc ann -> IO ()

Like putDoc, but instead of using stdout, print to a user-provided handle, e.g. a file or a socket. Uses the defaultLayoutOptions.

main = withFile filename (h -> hPutDoc h doc)
  where
    doc = vcat ["vertical", "text"]
    filename = "someFile.txt"

hPutDoc h doc = renderIO h (layoutPretty defaultLayoutOptions doc)