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 ALSO
     wctype(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.