-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | Quasiquoters for printf
--   
--   Quasiquoters for printf: string, bytestring, text.
@package th-printf
@version 0.6.0

module Language.Haskell.Printf.Lib

-- | Takes a format string as input and produces a tuple <tt>(args,
--   outputExpr)</tt>.
--   
--   This function processes character escapes as they would appear in
--   Haskell source code. It will emit warnings (or throw an error, as
--   appropriate) when given an invalid format string.
--   
--   Use if you wish to leverage <tt>th-printf</tt> in conjunction with,
--   for example, an existing logging library.
toSplices :: String -> Q ([Pat], Exp)

module Language.Haskell.Printf

-- | <pre>
--   [<a>s</a>|Hello, %s! (%d people greeted)|] :: ... -&gt; <a>String</a>
--   </pre>
--   
--   This formatter follows the guidelines listed <a>here</a>, except for
--   <tt>%n</tt> (store number of printed characters) for obvious reasons.
--   
--   <pre>
--   %c     :: <a>Char</a>
--   %s     :: <a>String</a>
--   
--   -- datatypes with Show instances
--   %?     :: <a>Show</a> a =&gt; a
--   
--   -- signed integer types
--   %d, %i :: <a>Integral</a> i =&gt; i
--   
--   -- unsigned integer types
--   %u     :: (<a>Bounded</a> i, <a>Integral</a> i) =&gt; i
--   %o     :: (<a>Bounded</a> i, <a>Integral</a> i) =&gt; i
--   %x, %X :: (<a>Bounded</a> i, <a>Integral</a> i) =&gt; i
--   
--   -- floats
--   %a, %A :: <a>RealFloat</a> f =&gt; f
--   %e, %E :: <a>RealFloat</a> f =&gt; f
--   %f, %F :: <a>RealFloat</a> f =&gt; f
--   %g, %G :: <a>RealFloat</a> f =&gt; f
--   
--   %p     :: <a>Ptr</a> a
--   </pre>
--   
--   N.B.: For consistency with other <tt>printf</tt> implementations,
--   arguments formatted as unsigned integer types will "underflow" if
--   negative.
s :: QuasiQuoter

-- | Like <a>s</a>, but prints the resulting string to <tt>stdout</tt>.
--   
--   <pre>
--   [p|Hello, %s! (%d people greeted)|] :: <a>MonadIO</a> m =&gt; ... -&gt; m ()
--   </pre>
p :: QuasiQuoter

-- | Like <a>p</a>, but takes as its first argument the <a>Handle</a> to
--   print to.
--   
--   <pre>
--   [hp|Hello, %s! (%d people greeted)|] :: <a>MonadIO</a> m =&gt; <a>Handle</a> -&gt; ... -&gt; m ()
--   </pre>
hp :: QuasiQuoter