Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

strtod(3c) [hpux man page]

strtod(3C)																strtod(3C)

NAME
strtod(), strtof(), strtold(), strtow(), strtoq(), atof() - convert string to floating-point number SYNOPSIS
Itanium(R)-based Systems Only DESCRIPTION
returns, as a double-precision floating-point number, the value represented by the character string pointed to by str. The string is scanned (leading white-space characters as defined by in ctype(3C) are ignored) up to the first unrecognized character. If no conversion can take place, zero is returned. recognizes characters in the following sequence: 1. An optional string of white space characters which are ignored 2. An optional sign and one of the following: 3. A string of digits optionally containing a radix character, followed by an optional or followed by an optional sign or space, followed by an integer 4. One of or ignoring case 5. ignoring case 6. For Itanium-based system only: or then a nonempty sequence of hexadecimal digits optionally containing a radix character, then a or followed by an optional sign or space, followed by a decimal integer The radix character is determined by the loaded environment (see setlocale(3C)). If has not been called successfully, the default environ- ment, "C", is used (see lang(5)). The default environment specifies a period as the radix character. In the hexadecimal form, the optionally signed decimal integer following the or is interpreted as the power of 2 by which the significant part is to be scaled. If the value of ptr is not the variable to which it points is set to point at the character after the last number, if any, that was recog- nized. If no number can be formed, is set to str, and zero is returned. is equivalent to is a version of it returns a result. For PA-RISC and for Itanium-based systems, if the user has defined the result type is declared as a instead of as a The declaration with a is obsolescent. Itanium-based Systems Only is a version of it returns a result. is an version of it returns an result. is equivalent to EXTERNAL INFLUENCES
Environment Variables determines the value of the radix character within the currently loaded environment. APPLICATION USAGE
To use (for Itanium-based systems) or compile with the option. RETURN VALUE
If the correct value would cause overflow, returns (equal to according to the sign of the value, and sets to If the correct value would be nonzero but too small in magnitude to represent as a nonzero then returns zero and sets to For Itanium-based system, also sets to whenever the conversion of its input parameter character string to raises the underflow exception. When the input parameter character string for after the optional white space and sign, is either (case insensitive) or (case insensitive) will return according to the sign indicated by the character string. When the input parameter character string for after the optional white space and sign, is (case insensitive), will return a quiet NaN. On Itanium-based systems, these functions round correctly for hexadecimal input strings, and round correctly for up to 36 significant deci- mal digits, according to the specification in ISO/IEC C99. SEE ALSO
ctype(3C), setlocale(3C), scanf(3S), strtol(3C), lang(5), thread_safety(5). STANDARDS CONFORMANCE
strtod(3C)

Check Out this Related Man Page

wcstod(3C)																wcstod(3C)

NAME
wcstod(), wcstof(), wcstold() - convert a wide character string to a double-precision number SYNOPSIS
Itanium(R)-based Systems Only Remarks These 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. DESCRIPTION
The and 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 in wctype(3C) are ignored) up to the first unrecognized character. If no conversion can take place, zero is returned. The and functions recognize wide characters in the following sequence: 1. An optional string of white space wide characters, which are ignored 2. An optional sign followed by one of the following: o A string of digits optionally containing a radix character, then an optional or followed by an optional sign or space, followed by an integer o A 0x or 0X, then a non-empty sequence of hexadecimal digits optionally containing a radix character, then an optional binary exponent part o One of INF or INFINITY, or any other wide string equivalent except for case o One of NAN or NAN(n-wchar-sequence), or any other wide string ignoring case in the NAN part, where n-wchar-sequence is: o digit o nondigit o n-wchar-sequence digit o n-wchar-sequence nondigit The radix character is determined by the current environment (see setlocale(3C)). If has not been called successfully, the default envi- ronment, "C", is used (see lang(5)). The default environment specifies a period (.) as the radix character. If the value of endptr is not 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, is set to nptr, and zero is returned. EXTERNAL INFLUENCES
Environment Variables determines the value of the radix character within the currently loaded environment. determines how wide character codes are interpreted. International Code Set Support Single- and multibyte character code sets are supported. RETURN VALUE
If the correct value would cause overflow, or is returned (according to the sign of the value), and is set to If the correct value would cause underflow, zero is returned and is set to If encounters an input wide character string equal to or (both case insensitive) it will return If encounters an input wide character string equal to or (both case insensitive) it will return AUTHOR
was developed by AT&T and HP. and were developed by HP. SEE ALSO
scanf(3S), setlocale(3C), wcstol(3C), wctype(3C), lang(5), thread_safety(5), glossary(9). STANDARDS CONFORMANCE
wcstod(3C)
Man Page