Strtod – Zilog Z8F0130 User Manual
Page 494

Appendix B. C Standard Library
UM013037-1212
470
Zilog Developer Studio II – Z8 Encore!
User Manual
Returns
A pointer to the located string or a null pointer if the string is not found.
Example
char *ptr;
char s1[]="Production Languages";
char s2[]="Lang";
ptr=strstr(s1,s2);
strtod
Converts the string pointed to by nptr to
double
representation. The function recognizes
an optional leading sequence of white-space characters (as specified by the
isspace
function), then an optional plus or minus sign, then a sequence of digits optionally con-
taining a decimal point, then an optional letter e or E followed by an optionally signed
integer, then an optional floating suffix. If an inappropriate character occurs before the
first digit following the e or E, the exponent is taken to be zero.
The first inappropriate character ends the conversion. If endptr is not a null pointer, a
pointer to that character is stored in the object endptr points to; if an inappropriate charac-
ter occurs before any digit, the value of nptr is stored.
The sequence of characters from the first digit or the decimal point (whichever occurs
first) to the character before the first inappropriate character is interpreted as a floating
constant according to the rules of this section, except that if neither an exponent part or a
decimal point appears, a decimal point is assumed to follow the last digit in the string. If a
minus sign appears immediately before the first digit, the value resulting from the conver-
sion is negated.
Synopsis
#include
double strtod(char *nptr, char **endptr);
Returns
The converted value, or zero if an inappropriate character occurs before any digit. If the
correct value would cause overflow, plus or minus HUGE_VAL is returned (according to
the sign of the value), and the macro
errno
acquires the value ERANGE. If the correct
value causes underflow, zero is returned and the macro
errno
acquires the value
ERANGE.
Example
char *ptr;
char s[]="0.1456";
- Z8F0131 Z8F0230 Z8F0231 Z8F0430 Z8F0431 Z8F043A Z8F0830 Z8F0831 Z8F083A Z8F1232 Z8F1233 Z8F0113 Z8F011A Z8F0123 Z8F012A Z8F0213 Z8F021A Z8F0223 Z8F022A Z8F0411 Z8F0412 Z8F0413 Z8F041A Z8F0421 Z8F0422 Z8F0423 Z8F042A Z8F0811 Z8F0812 Z8F0813 Z8F081A Z8F0821 Z8F0822 Z8F0823 Z8F082A Z8F0880 Z8F1621 Z8F1622 Z8F1680 Z8F1681 Z8F1682 Z8F2421 Z8F2422 Z8F2480 Z8F3221 Z8F3222 Z8F3281 Z8F3282 Z8F4821 Z8F4822 Z8F4823 Z8F6081 Z8F6082 Z8F6421 Z8F6422 Z8F6423 Z8F6481 Z8F6482 Z8FS021A ZMOT1AHH Z8FS040B ZMOT0BHH ZMOT0BSB Z8FMC04 Z8FMC08 Z8FMC16