Print this page
11620 strtod man page typo equence
@@ -41,16 +41,15 @@
.\"
.\"
.\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved.
.\" Portions Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
.\"
-.TH WCSTOD 3C "Mar 31, 2003"
+.TH WCSTOD 3C "Aug 25, 2019"
.SH NAME
wcstod, wcstof, wcstold, wstod, watof \- convert wide character string to
floating-point number
.SH SYNOPSIS
-.LP
.nf
#include <wchar.h>
\fBdouble\fR \fBwcstod\fR(\fBconst wchar_t *restrict\fR \fInptr\fR,
\fBwchar_t **restrict\fR \fIendptr\fR);
@@ -77,12 +76,10 @@
.nf
\fBdouble\fR \fBwatof\fR(\fBwchar_t *\fR\fInptr\fR);
.fi
.SH DESCRIPTION
-.sp
-.LP
The \fBwcstod()\fR, \fBwcstof()\fR, and \fBwcstold()\fR functions convert the
initial portion of the wide-character string pointed to by \fInptr\fR to
\fBdouble\fR, \fBfloat\fR, and \fBlong double\fR representation, respectively.
They first decompose the input wide-character string into three parts:
.RS +4
@@ -151,17 +148,17 @@
.RE
.sp
.LP
In default mode for \fBwcstod()\fR, only decimal, INF/INFINITY, and
-NAN/NAN(\fIn-char-sequence\fR) forms are recognized. In C99/SUSv3 mode,
+NAN/NAN(\fIn-wchar-sequence\fR) forms are recognized. In C99/SUSv3 mode,
hexadecimal strings are also recognized.
.sp
.LP
-In default mode for \fBwcstod()\fR, the \fIn-char-sequence\fR in the
-NAN(\fIn-char-equence\fR) form can contain any character except ')' (right
-parenthesis) or '\e0' (null). In C99/SUSv3 mode, the \fIn-char-sequence\fR can
+In default mode for \fBwcstod()\fR, the \fIn-wchar-sequence\fR in the
+NAN(\fIn-wchar-sequence\fR) form can contain any character except ')' (right
+parenthesis) or '\e0' (null). In C99/SUSv3 mode, the \fIn-wchar-sequence\fR can
contain only upper and lower case letters, digits, and '_' (underscore).
.sp
.LP
The \fBwcstof()\fR and \fBwcstold()\fR functions always function in
C99/SUSv3-conformant mode.
@@ -213,12 +210,10 @@
.sp
.LP
The \fBwatof\fR(\fIstr\fR) function is equivalent to \fBwstod(\fR\fInptr\fR\fB,
(wchar_t **)NULL)\fR.
.SH RETURN VALUES
-.sp
-.LP
Upon successful completion, these functions return the converted value. If no
conversion could be performed, \fB0\fR is returned.
.sp
.LP
If the correct value is outside the range of representable values,
@@ -229,17 +224,15 @@
.LP
If the correct value would cause an underflow, the correctly rounded result
(which may be normal, subnormal, or zero) is returned, a floating point
underflow exception is raised, and \fBerrno\fR is set to \fBERANGE\fR.
.SH ERRORS
-.sp
-.LP
The \fBwcstod()\fR and \fBwstod()\fR functions will fail if:
.sp
.ne 2
.na
-\fB\fBERANGE\fR\fR
+\fBERANGE\fR
.ad
.RS 10n
The value to be returned would cause overflow or underflow.
.RE
@@ -247,26 +240,22 @@
.LP
The \fBwcstod()\fR and \fBwcstod()\fR functions may fail if:
.sp
.ne 2
.na
-\fB\fBEINVAL\fR\fR
+\fBEINVAL\fR
.ad
.RS 10n
No conversion could be performed.
.RE
.SH USAGE
-.sp
-.LP
Because 0 is returned on error and is also a valid return on success, an
application wishing to check for error situations should set \fBerrno\fR to 0
call \fBwcstod()\fR, \fBwcstof()\fR, \fBwcstold()\fR, or \fBwstod()\fR, then
check \fBerrno\fR and if it is non-zero, assume an error has occurred.
.SH ATTRIBUTES
-.sp
-.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
.TS
@@ -281,9 +270,7 @@
_
MT-Level MT-Safe
.TE
.SH SEE ALSO
-.sp
-.LP
\fBiswspace\fR(3C), \fBlocaleconv\fR(3C), \fBscanf\fR(3C), \fBsetlocale\fR(3C),
\fBwcstol\fR(3C), \fBattributes\fR(5), \fBstandards\fR(5)