United States-English |
|
|
HP-UX Reference > Wwcstod(3C)HP-UX 11i Version 3: February 2007 |
|
NAMEwcstod(), wcstof(), wcstold() — convert a wide character string to a double-precision number SYNOPSIS#include <wchar.h> double wcstod(const wchar_t *__restrict nptr, wchar_t **__restrict endptr); long double wcstold(const wchar_t *__restrict nptr, wchar_t **__restrict endptr); RemarksThese functions are compliant with the UNIX standard Worldwide Portability Interface wide-character formatting functions. They parallel the 8-bit character formatting functions defined in strtod(3C), strtold(3C) and strtof(3C) respectively. DESCRIPTIONThe wcstod(), wcstof(), and wcstold() functions return the value represented by the wide-character string pointed to by nptr as a double-precision floating-point number, single-precision floating-point number, and long double-precision number, respectively. The wide character string is scanned (leading white-space characters as defined by iswspace() in wctype(3C) are ignored) up to the first unrecognized character. If no conversion can take place, zero is returned. The wcstod(), wcstof(), and wcstold() functions recognize wide characters in the following sequence:
The radix character is determined by the current NLS environment (see setlocale(3C)). If setlocale() has not been called successfully, the default NLS environment, "C", is used (see lang(5)). The default environment specifies a period (.) as the radix character. If the value of endptr is not (wchar_t **)NULL, the variable to which it points is set to point at the wide character after the last number, if any, that was recognized. If no number can be formed, *endptr is set to nptr, and zero is returned. EXTERNAL INFLUENCESRETURN VALUEIf the correct value would cause overflow, +HUGE_VAL or -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. If wcstod() encounters an input wide character string equal to inf or infinity (both case insensitive) it will return HUGE_VAL. If wcstod() encounters an input wide character string equal to nan or NAN(n-wchar-sequence) (both case insensitive) it will return _DNANQ. |
Printable version | ||
|