You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
163 lines
7.7 KiB
HTML
163 lines
7.7 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<!-- Created by GNU Texinfo 6.4, http://www.gnu.org/software/texinfo/ -->
|
|
<head>
|
|
<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">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<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_002c-wcstold_002c-wcstod_005fl_002c-wcstof_005fl_002c-wcstold_005fl_002d_002d_002dwide-char-string-to-double-or-float"></a>
|
|
<h3 class="section">2.43 <code>wcstod</code>, <code>wcstof</code>, <code>wcstold</code>, <code>wcstod_l</code>, <code>wcstof_l</code>, <code>wcstold_l</code>—wide char string to double or float</h3>
|
|
<a name="index-wcstod"></a>
|
|
<a name="index-wcstof"></a>
|
|
<a name="index-wcstold"></a>
|
|
<a name="index-wcstod_005fl"></a>
|
|
<a name="index-wcstof_005fl"></a>
|
|
<a name="index-wcstold_005fl"></a>
|
|
<a name="index-_005fwcstod_005fr"></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>);
|
|
long double wcstold(const wchar_t *__restrict <var>str</var>,
|
|
wchar_t **__restrict <var>tail</var>);
|
|
|
|
#include <stdlib.h>
|
|
double wcstod_l(const wchar_t *__restrict <var>str</var>,
|
|
wchar_t **__restrict <var>tail</var>, locale_t <var>locale</var>);
|
|
float wcstof_l(const wchar_t *__restrict <var>str</var>,
|
|
wchar_t **__restrict <var>tail</var>, locale_t <var>locale</var>);
|
|
long double wcstold_l(const wchar_t *__restrict <var>str</var>,
|
|
wchar_t **__restrict <var>tail</var>,
|
|
locale_t <var>locale</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>
|
|
<code>wcstod</code>, <code>wcstof</code>, <code>wcstold</code> parse the wide-character string
|
|
<var>str</var>, producing a substring which can be converted to a double,
|
|
float, or long 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>.
|
|
</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><code>wcstod_l</code>, <code>wcstof_l</code>, <code>wcstold_l</code> are like <code>wcstod</code>,
|
|
<code>wcstof</code>, <code>wcstold</code> but perform the conversion based on the
|
|
locale specified by the locale object locale. If <var>locale</var> is
|
|
LC_GLOBAL_LOCALE or not a valid locale object, the behaviour is
|
|
undefined.
|
|
</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>
|
|
<br>
|
|
<p><strong>Portability</strong><br>
|
|
<code>wcstod</code> is ANSI.
|
|
<code>wcstof</code>, <code>wcstold</code> are C99.
|
|
<code>wcstod_l</code>, <code>wcstof_l</code>, <code>wcstold_l</code> are GNU extensions.
|
|
</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>
|