/usr/share/doc/libghc-text-doc/html/Data-Text-Read.html is in libghc-text-doc 0.11.1.13-1build1.
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 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 | <!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.Text.Read</title><link href="ocean.css" rel="stylesheet" type="text/css" title="Ocean" /><script src="haddock-util.js" type="text/javascript"></script><script type="text/javascript">//<![CDATA[
window.onload = function () {pageLoad();setSynopsis("mini_Data-Text-Read.html");};
//]]>
</script></head><body><div id="package-header"><ul class="links" id="page-menu"><li><a href="src/Data-Text-Read.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">text-0.11.1.13: An efficient packed Unicode text type.</p></div><div id="content"><div id="module-header"><table class="info"><tr><th>Portability</th><td>GHC</td></tr><tr><th>Stability</th><td>experimental</td></tr><tr><th>Maintainer</th><td>bos@serpentine.com</td></tr><tr><th>Safe Haskell</th><td>Safe-Infered</td></tr></table><p class="caption">Data.Text.Read</p></div><div id="description"><p class="caption">Description</p><div class="doc"><p>Functions used frequently when reading textual data.
</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"><span class="keyword">type</span> <a href="#t:Reader">Reader</a> a = <a href="Data-Text-Internal.html#t:Text">Text</a> -> <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Data-Either.html#t:Either">Either</a> <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a> (a, <a href="Data-Text-Internal.html#t:Text">Text</a>)</li><li class="src short"><a href="#v:decimal">decimal</a> :: <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Prelude.html#t:Integral">Integral</a> a => <a href="Data-Text-Read.html#t:Reader">Reader</a> a</li><li class="src short"><a href="#v:hexadecimal">hexadecimal</a> :: <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Prelude.html#t:Integral">Integral</a> a => <a href="Data-Text-Read.html#t:Reader">Reader</a> a</li><li class="src short"><a href="#v:signed">signed</a> :: <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Prelude.html#t:Num">Num</a> a => <a href="Data-Text-Read.html#t:Reader">Reader</a> a -> <a href="Data-Text-Read.html#t:Reader">Reader</a> a</li><li class="src short"><a href="#v:rational">rational</a> :: <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Prelude.html#t:Fractional">Fractional</a> a => <a href="Data-Text-Read.html#t:Reader">Reader</a> a</li><li class="src short"><a href="#v:double">double</a> :: <a href="Data-Text-Read.html#t:Reader">Reader</a> <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Prelude.html#t:Double">Double</a></li></ul></div><div id="interface"><h1>Documentation</h1><div class="top"><p class="src"><span class="keyword">type</span> <a name="t:Reader" class="def">Reader</a> a = <a href="Data-Text-Internal.html#t:Text">Text</a> -> <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Data-Either.html#t:Either">Either</a> <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a> (a, <a href="Data-Text-Internal.html#t:Text">Text</a>)<a href="src/Data-Text-Read.html#Reader" class="link">Source</a></p><div class="doc"><p>Read some text. If the read succeeds, return its value and the
remaining text, otherwise an error message.
</p></div></div><div class="top"><p class="src"><a name="v:decimal" class="def">decimal</a> :: <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Prelude.html#t:Integral">Integral</a> a => <a href="Data-Text-Read.html#t:Reader">Reader</a> a<a href="src/Data-Text-Read.html#decimal" class="link">Source</a></p><div class="doc"><p>Read a decimal integer. The input must begin with at least one
decimal digit, and is consumed until a non-digit or end of string
is reached.
</p><p>This function does not handle leading sign characters. If you need
to handle signed input, use <code><code><a href="Data-Text-Read.html#v:signed">signed</a></code> <code><a href="Data-Text-Read.html#v:decimal">decimal</a></code></code>.
</p><p><em>Note</em>: For fixed-width integer types, this function does not
attempt to detect overflow, so a sufficiently long input may give
incorrect results. If you are worried about overflow, use
<code><a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a></code> for your result type.
</p></div></div><div class="top"><p class="src"><a name="v:hexadecimal" class="def">hexadecimal</a> :: <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Prelude.html#t:Integral">Integral</a> a => <a href="Data-Text-Read.html#t:Reader">Reader</a> a<a href="src/Data-Text-Read.html#hexadecimal" class="link">Source</a></p><div class="doc"><p>Read a hexadecimal integer, consisting of an optional leading
<code>"0x"</code> followed by at least one decimal digit. Input is consumed
until a non-hex-digit or end of string is reached. This function
is case insensitive.
</p><p>This function does not handle leading sign characters. If you need
to handle signed input, use <code><code><a href="Data-Text-Read.html#v:signed">signed</a></code> <code><a href="Data-Text-Read.html#v:hexadecimal">hexadecimal</a></code></code>.
</p><p><em>Note</em>: For fixed-width integer types, this function does not
attempt to detect overflow, so a sufficiently long input may give
incorrect results. If you are worried about overflow, use
<code><a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a></code> for your result type.
</p></div></div><div class="top"><p class="src"><a name="v:signed" class="def">signed</a> :: <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Prelude.html#t:Num">Num</a> a => <a href="Data-Text-Read.html#t:Reader">Reader</a> a -> <a href="Data-Text-Read.html#t:Reader">Reader</a> a<a href="src/Data-Text-Read.html#signed" class="link">Source</a></p><div class="doc"><p>Read an optional leading sign character (<code>'-'</code> or <code>'+'</code>) and
apply it to the result of applying the given reader.
</p></div></div><div class="top"><p class="src"><a name="v:rational" class="def">rational</a> :: <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Prelude.html#t:Fractional">Fractional</a> a => <a href="Data-Text-Read.html#t:Reader">Reader</a> a<a href="src/Data-Text-Read.html#rational" class="link">Source</a></p><div class="doc"><p>Read a rational number.
</p><p>This function accepts an optional leading sign character, followed
by at least one decimal digit. The syntax similar to that accepted
by the <code><a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Text-Read.html#v:read">read</a></code> function, with the exception that a trailing <code>'.'</code>
or <code>'e'</code> <em>not</em> followed by a number is not consumed.
</p><p>Examples (with behaviour identical to <code><a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Text-Read.html#v:read">read</a></code>):
</p><pre>rational "3" == Right (3.0, "")
rational "3.1" == Right (3.1, "")
rational "3e4" == Right (30000.0, "")
rational "3.1e4" == Right (31000.0, "")
rational ".3" == Left "input does not start with a digit"
rational "e3" == Left "input does not start with a digit"
</pre><p>Examples of differences from <code><a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Text-Read.html#v:read">read</a></code>:
</p><pre>rational "3.foo" == Right (3.0, ".foo")
rational "3e" == Right (3.0, "e")
</pre></div></div><div class="top"><p class="src"><a name="v:double" class="def">double</a> :: <a href="Data-Text-Read.html#t:Reader">Reader</a> <a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Prelude.html#t:Double">Double</a><a href="src/Data-Text-Read.html#double" class="link">Source</a></p><div class="doc"><p>Read a rational number.
</p><p>The syntax accepted by this function is the same as for <code><a href="Data-Text-Read.html#v:rational">rational</a></code>.
</p><p><em>Note</em>: This function is almost ten times faster than <code><a href="Data-Text-Read.html#v:rational">rational</a></code>,
but is slightly less accurate.
</p><p>The <code><a href="/usr/share/doc/ghc-doc/html/libraries/base-4.5.0.0/Prelude.html#t:Double">Double</a></code> type supports about 16 decimal places of accuracy.
For 94.2% of numbers, this function and <code><a href="Data-Text-Read.html#v:rational">rational</a></code> give identical
results, but for the remaining 5.8%, this function loses precision
around the 15th decimal place. For 0.001% of numbers, this
function will lose precision at the 13th or 14th decimal place.
</p></div></div></div></div><div id="footer"><p>Produced by <a href="http://www.haskell.org/haddock/">Haddock</a> version 2.10.0</p></div></body></html>
|