/usr/share/doc/libghc-floatinghex-doc/html/Data-Numbers-FloatingHex.html is in libghc-floatinghex-doc 0.4-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Data.Numbers.FloatingHex</title><link href="ocean.css" rel="stylesheet" type="text/css" title="Ocean" /><script src="haddock-util.js" type="text/javascript"></script><script src="file:///usr/share/javascript/mathjax/MathJax.js" type="text/javascript"></script><script type="text/javascript">//<![CDATA[
window.onload = function () {pageLoad();setSynopsis("mini_Data-Numbers-FloatingHex.html");};
//]]>
</script></head><body><div id="package-header"><ul class="links" id="page-menu"><li><a href="src/Data-Numbers-FloatingHex.html">Source</a></li><li><a href="index.html">Contents</a></li><li><a href="doc-index.html">Index</a></li></ul><p class="caption">FloatingHex-0.4: Read and write hexadecimal floating point numbers</p></div><div id="content"><div id="module-header"><table class="info"><tr><th valign="top">Copyright</th><td>(c) Levent Erkok</td></tr><tr><th>License</th><td>BSD3</td></tr><tr><th>Maintainer</th><td>erkokl@gmail.com</td></tr><tr><th>Stability</th><td>experimental</td></tr><tr><th>Safe Haskell</th><td>None</td></tr><tr><th>Language</th><td>Haskell2010</td></tr></table><p class="caption">Data.Numbers.FloatingHex</p></div><div id="table-of-contents"><p class="caption">Contents</p><ul><li><a href="#g:1">QuasiQuoting</a></li><li><a href="#g:2">Reading hex-floats</a></li><li><a href="#g:3">Showing hex-floats</a></li></ul></div><div id="description"><p class="caption">Description</p><div class="doc"><p>Reading/Writing hexadecimal floating-point numbers.</p><p>See: <a href="http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1256.pdf">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.</p></div></div><div id="synopsis"><p id="control.syn" class="caption expander" onclick="toggleSection('syn')">Synopsis</p><ul id="section.syn" class="hide" onclick="toggleSection('syn')"><li class="src short"><a href="#v:hf">hf</a> :: <a href="file:///usr/share/doc/ghc-doc/html/libraries/template-haskell-2.11.1.0/Language-Haskell-TH-Quote.html#t:QuasiQuoter">QuasiQuoter</a></li><li class="src short"><span class="keyword">class</span> <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Prelude.html#t:RealFloat">RealFloat</a> a => <a href="#t:FloatingHexReader">FloatingHexReader</a> a <span class="keyword">where</span><ul class="subs"></ul></li><li class="src short"><a href="#v:showHFloat">showHFloat</a> :: <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Prelude.html#t:RealFloat">RealFloat</a> a => a -> <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Text-Show.html#t:ShowS">ShowS</a></li></ul></div><div id="interface"><h2 id="g:1">QuasiQuoting</h2><div class="top"><p class="src"><a id="v:hf" class="def">hf</a> :: <a href="file:///usr/share/doc/ghc-doc/html/libraries/template-haskell-2.11.1.0/Language-Haskell-TH-Quote.html#t:QuasiQuoter">QuasiQuoter</a> <a href="src/Data-Numbers-FloatingHex.html#hf" class="link">Source</a> <a href="#v:hf" class="selflink">#</a></p><div class="doc"><p>A quasiquoter for hexadecimal floating-point literals.
See: <a href="http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1256.pdf">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.</p><p>Example:</p><pre>{-# LANGUAGE QuasiQuotes #-}
import Data.Numbers.FloatingHex
f :: Double
f = [hf|0x1.f44abd5aa7ca4p+25|]</pre><p>With these definitions, <code>f</code> will be equal to the number <code>6.5574266708245546e7</code></p></div></div><h2 id="g:2">Reading hex-floats</h2><div class="top"><p class="src"><span class="keyword">class</span> <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Prelude.html#t:RealFloat">RealFloat</a> a => <a id="t:FloatingHexReader" class="def">FloatingHexReader</a> a <span class="keyword">where</span> <a href="src/Data-Numbers-FloatingHex.html#FloatingHexReader" class="link">Source</a> <a href="#t:FloatingHexReader" class="selflink">#</a></p><div class="doc"><p>Due to intricacies of conversion between
<code>Float</code> and <code>Double</code> types (see <a href="http://ghc.haskell.org/trac/ghc/ticket/3676">http://ghc.haskell.org/trac/ghc/ticket/3676</a>), we explicitly introduce
a class to do the reading properly.</p></div><div class="subs minimal"><p class="caption">Minimal complete definition</p><p class="src"><a href="Data-Numbers-FloatingHex.html#v:readHFloat">readHFloat</a></p></div><div class="subs methods"><p class="caption">Methods</p><p class="src"><a id="v:readHFloat" class="def">readHFloat</a> :: <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Data-String.html#t:String">String</a> -> <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Data-Maybe.html#t:Maybe">Maybe</a> a <a href="src/Data-Numbers-FloatingHex.html#readHFloat" class="link">Source</a> <a href="#v:readHFloat" class="selflink">#</a></p><div class="doc"><p>Convert a hex-float from a string, if possible.</p></div></div><div class="subs instances"><p id="control.i:FloatingHexReader" class="caption collapser" onclick="toggleSection('i:FloatingHexReader')">Instances</p><div id="section.i:FloatingHexReader" class="show"><table><tr><td class="src clearfix"><span class="inst-left"><span id="control.i:ic:FloatingHexReader:FloatingHexReader:1" class="instance expander" onclick="toggleSection('i:ic:FloatingHexReader:FloatingHexReader:1')"></span> <a href="Data-Numbers-FloatingHex.html#t:FloatingHexReader">FloatingHexReader</a> <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Prelude.html#t:Double">Double</a></span> <a href="src/Data-Numbers-FloatingHex.html#line-44" class="link">Source</a> <a href="#t:FloatingHexReader" class="selflink">#</a></td><td class="doc"><p>The Double instance</p></td></tr><tr><td colspan="2"><div id="section.i:ic:FloatingHexReader:FloatingHexReader:1" class="inst-details hide"><div class="subs methods"><p class="caption">Methods</p><p class="src"><a href="#v:readHFloat">readHFloat</a> :: <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Data-String.html#t:String">String</a> -> <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Prelude.html#t:Double">Double</a> <a href="src/Data-Numbers-FloatingHex.html#readHFloat" class="link">Source</a> <a href="#v:readHFloat" class="selflink">#</a></p></div></div></td></tr><tr><td class="src clearfix"><span class="inst-left"><span id="control.i:ic:FloatingHexReader:FloatingHexReader:2" class="instance expander" onclick="toggleSection('i:ic:FloatingHexReader:FloatingHexReader:2')"></span> <a href="Data-Numbers-FloatingHex.html#t:FloatingHexReader">FloatingHexReader</a> <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Prelude.html#t:Float">Float</a></span> <a href="src/Data-Numbers-FloatingHex.html#line-40" class="link">Source</a> <a href="#t:FloatingHexReader" class="selflink">#</a></td><td class="doc"><p>The Float instance</p></td></tr><tr><td colspan="2"><div id="section.i:ic:FloatingHexReader:FloatingHexReader:2" class="inst-details hide"><div class="subs methods"><p class="caption">Methods</p><p class="src"><a href="#v:readHFloat">readHFloat</a> :: <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Data-String.html#t:String">String</a> -> <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Prelude.html#t:Float">Float</a> <a href="src/Data-Numbers-FloatingHex.html#readHFloat" class="link">Source</a> <a href="#v:readHFloat" class="selflink">#</a></p></div></div></td></tr></table></div></div></div><h2 id="g:3">Showing hex-floats</h2><div class="top"><p class="src"><a id="v:showHFloat" class="def">showHFloat</a> :: <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Prelude.html#t:RealFloat">RealFloat</a> a => a -> <a href="file:///usr/share/doc/ghc-doc/html/libraries/base-4.9.1.0/Text-Show.html#t:ShowS">ShowS</a> <a href="src/Data-Numbers-FloatingHex.html#showHFloat" class="link">Source</a> <a href="#v:showHFloat" class="selflink">#</a></p><div class="doc"><p>Show a floating-point value in the hexadecimal format, similar to the <code>%a</code> specifier in C's printf.</p><pre class="screen"><code class="prompt">>>> </code><strong class="userinput"><code>showHFloat (212.21 :: Double) ""
</code></strong>"0x1.a86b851eb851fp7"
<code class="prompt">>>> </code><strong class="userinput"><code>showHFloat (-12.76 :: Float) ""
</code></strong>"-0x1.9851ecp3"
<code class="prompt">>>> </code><strong class="userinput"><code>showHFloat (-0 :: Double) ""
</code></strong>"-0x0p+0"
</pre></div></div></div></div><div id="footer"><p>Produced by <a href="http://www.haskell.org/haddock/">Haddock</a> version 2.17.3</p></div></body></html>
|