wcstod(3S)wcstod(3S)NAME
wcstod: wcstod, wcstof, wcstold - convert wide-character string to
floating-point number
SYNOPSIS
#include <wchar.h>
double wcstod (const wchar_t *nptr, wchar_t **endptr);
float wcstof (const wchar_t *nptr, wchar_t **endptr);
long double wcstold (const wchar_t *nptr, wchar_t **endptr);
DESCRIPTION
The wcstod, wcstof, and wcstold functions return as a double-precision,
single-precision, or long double-precision floating-point number
respectively the value represented by the wide-character string pointed
to by nptr. This function scans the string up to the first unrecognized
character.
wcstod recognizes an optional string of ``white-space'' characters [as
defined by iswspace in wctype(3S)], then an optional sign, then a string
of digits optionally containing a decimal-point character [as specified
by the current locale; see setlocale(3C)], then an optional exponent part
including an e or E followed by an optional sign, followed by an integer.
If the value of endptr is not (wchar_t **)NULL, a pointer to the
character terminating the scan is returned in the location pointed to by
endptr. If no number can be formed, *endptr is set to nptr, and zero is
returned.
SEE ALSOwctype(3S),
NOTE
Precision may be silently lost if the number of digits comprising the
floating-point number (i.e., not including the exponent) exceeds the
value of the constant DBL_DIG (LDBL_DIG) in <float.h>.
The wcstof() and wcstold() functions are supported in n32 and 64 bit C
Libraries for IRIX 6.5.18 and later versions as one of C99 features.
DIAGNOSTICS
If the correct value would cause overflow, +/-HUGE_VAL is returned
(according to the sign of the value), and errno is set to ERANGE.
If the correct value would cause underflow, zero is returned and errno is
set to ERANGE.
Page 1
