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


-- | Read and write hexadecimal floating point numbers
--   
--   Read and write hexadecimal floating point numbers. Provides a
--   quasiquoter for entering hex-float literals, and a function for
--   printing them in hexadecimal.
--   
--   See: <a>http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1256.pdf</a>,
--   pages 57-58. We slightly diverge from the standard and do not allow
--   for the "floating-suffix," as the type inference of Haskell makes this
--   unnecessary.
--   
--   For details, please see:
--   <a>http://github.com/LeventErkok/FloatingHex/</a>
@package FloatingHex
@version 0.1


-- | Reading/Writing hexadecimal floating-point numbers.
--   
--   See: <a>http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1256.pdf</a>,
--   pages 57-58. We slightly diverge from the standard and do not allow
--   for the "floating-suffix," as the type inference of Haskell makes this
--   unnecessary.
module Data.Numbers.FloatingHex

-- | A quasiquoter for hexadecimal floating-point literals. See:
--   <a>http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1256.pdf</a>,
--   pages 57-58. We slightly diverge from the standard and do not allow
--   for the "floating-suffix," as the type inference of Haskell makes this
--   unnecessary.
--   
--   Example:
--   
--   <pre>
--   {-# LANGUAGE QuasiQuotes #-}
--   import Data.Numbers.FloatingHex
--   
--   f :: Double
--   f = [hf|0x1.f44abd5aa7ca4p+25|]
--   </pre>
--   
--   With these definitions, <tt>f</tt> will be equal to the number
--   <tt>6.5574266708245546e7</tt>
hf :: QuasiQuoter

-- | Show a floating-point value in the hexadecimal format.
--   
--   NB. While this function will print a faithful (i.e., correct) value,
--   it is not 100% compatible with the <tt>%a</tt> modifier as found in
--   the C's printf implementation.
--   
--   <pre>
--   &gt;&gt;&gt; showHFloat (212.21 :: Double) ""
--   "0x1.a86b851eb851fp7"
--   
--   &gt;&gt;&gt; showHFloat (-12.76 :: Float) ""
--   "-0xc.c28f6p0"
--   </pre>
showHFloat :: RealFloat a => a -> ShowS