/usr/share/doc/libnewlib-doc/libc.html/wcstod.html is in libnewlib-doc 2.4.0.20160527-3.
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 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>wcstod (The Red Hat newlib C Library)</title>
<meta name="description" content="wcstod (The Red Hat newlib C Library)">
<meta name="keywords" content="wcstod (The Red Hat newlib C Library)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html#Top" rel="start" title="Top">
<link href="Document-Index.html#Document-Index" rel="index" title="Document Index">
<link href="Document-Index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Stdlib.html#Stdlib" rel="up" title="Stdlib">
<link href="wcstol.html#wcstol" rel="next" title="wcstol">
<link href="wcsrtombs.html#wcsrtombs" rel="prev" title="wcsrtombs">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<a name="wcstod"></a>
<div class="header">
<p>
Next: <a href="wcstol.html#wcstol" accesskey="n" rel="next">wcstol</a>, Previous: <a href="wcsrtombs.html#wcsrtombs" accesskey="p" rel="prev">wcsrtombs</a>, Up: <a href="Stdlib.html#Stdlib" accesskey="u" rel="up">Stdlib</a> [<a href="Document-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Document-Index.html#Document-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="wcstod_002c-wcstof_002d_002d_002dwide-char-string-to-double-or-float"></a>
<h3 class="section">2.43 <code>wcstod</code>, <code>wcstof</code>—wide char string to double or float</h3>
<a name="index-wcstod"></a>
<a name="index-_005fwcstod_005fr"></a>
<a name="index-wcstof"></a>
<a name="index-_005fwcstof_005fr"></a>
<p><strong>Synopsis</strong>
</p><div class="example">
<pre class="example">#include <stdlib.h>
double wcstod(const wchar_t *__restrict <var>str</var>,
wchar_t **__restrict <var>tail</var>);
float wcstof(const wchar_t *__restrict <var>str</var>,
wchar_t **__restrict <var>tail</var>);
double _wcstod_r(void *<var>reent</var>,
const wchar_t *<var>str</var>, wchar_t **<var>tail</var>);
float _wcstof_r(void *<var>reent</var>,
const wchar_t *<var>str</var>, wchar_t **<var>tail</var>);
</pre></div>
<p><strong>Description</strong><br>
The function <code>wcstod</code> parses the wide character string <var>str</var>,
producing a substring which can be converted to a double
value. The substring converted is the longest initial
subsequence of <var>str</var>, beginning with the first
non-whitespace character, that has one of these formats:
</p><div class="smallexample">
<pre class="smallexample">[+|-]<var>digits</var>[.[<var>digits</var>]][(e|E)[+|-]<var>digits</var>]
[+|-].<var>digits</var>[(e|E)[+|-]<var>digits</var>]
[+|-](i|I)(n|N)(f|F)[(i|I)(n|N)(i|I)(t|T)(y|Y)]
[+|-](n|N)(a|A)(n|N)[<(>[<var>hexdigits</var>]<)>]
[+|-]0(x|X)<var>hexdigits</var>[.[<var>hexdigits</var>]][(p|P)[+|-]<var>digits</var>]
[+|-]0(x|X).<var>hexdigits</var>[(p|P)[+|-]<var>digits</var>]
</pre></div>
<p>The substring contains no characters if <var>str</var> is empty, consists
entirely of whitespace, or if the first non-whitespace
character is something other than <code>+</code>, <code>-</code>, <code>.</code>, or a
digit, and cannot be parsed as infinity or NaN. If the platform
does not support NaN, then NaN is treated as an empty substring.
If the substring is empty, no conversion is done, and
the value of <var>str</var> is stored in <code>*<var>tail</var></code>. Otherwise,
the substring is converted, and a pointer to the final string
(which will contain at least the terminating null character of
<var>str</var>) is stored in <code>*<var>tail</var></code>. If you want no
assignment to <code>*<var>tail</var></code>, pass a null pointer as <var>tail</var>.
<code>wcstof</code> is identical to <code>wcstod</code> except for its return type.
</p>
<p>This implementation returns the nearest machine number to the
input decimal string. Ties are broken by using the IEEE
round-even rule. However, <code>wcstof</code> is currently subject to
double rounding errors.
</p>
<p>The alternate functions <code>_wcstod_r</code> and <code>_wcstof_r</code> are
reentrant versions of <code>wcstod</code> and <code>wcstof</code>, respectively.
The extra argument <var>reent</var> is a pointer to a reentrancy structure.
</p>
<br>
<p><strong>Returns</strong><br>
Return the converted substring value, if any. If
no conversion could be performed, 0 is returned. If the
correct value is out of the range of representable values,
plus or minus <code>HUGE_VAL</code> is returned, and <code>ERANGE</code> is
stored in errno. If the correct value would cause underflow, 0
is returned and <code>ERANGE</code> is stored in errno.
</p>
<p>Supporting OS subroutines required: <code>close</code>, <code>fstat</code>, <code>isatty</code>,
<code>lseek</code>, <code>read</code>, <code>sbrk</code>, <code>write</code>.
</p>
<br>
<hr>
<div class="header">
<p>
Next: <a href="wcstol.html#wcstol" accesskey="n" rel="next">wcstol</a>, Previous: <a href="wcsrtombs.html#wcsrtombs" accesskey="p" rel="prev">wcsrtombs</a>, Up: <a href="Stdlib.html#Stdlib" accesskey="u" rel="up">Stdlib</a> [<a href="Document-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Document-Index.html#Document-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|