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


-- | GHC preprocessor and library to enable variable interpolation in strings
--   
--   This preprocessor enables variable interpolation in strings.
--   Alternatively, the library may be used.
--   
--   See the README.md file for details.
@package interpol
@version 0.2.2


-- | Support module for the <tt>interpol</tt> preprocessor.
module Text.Interpol

-- | Append a showable value to a <a>String</a> in a smart way. In
--   particular, do <i>not</i> <a>show</a> a <a>String</a>, as this
--   encloses it in "quotes". So, depending on the type of the second
--   parameter, <a>^-^</a> is equivalent to one of the following
--   
--   <pre>
--   x ^-^ y = x ++ y
--   x ^-^ y = x ++ show y
--   </pre>
--   
--   For all intents and purposes, the <a>ToString</a> type-class is a
--   wrapper around <a>Show</a>, so any type that has an instance for
--   <a>Show</a> will also have an instance for <tt>Interpol</tt>.
(^-^, interpol) :: (ToString a, ToString b) => a -> b -> String
class ToString a
instance [overlap ok] Show a => ToString a
instance [overlap ok] ToString Char
instance [overlap ok] ToString [Char]