pSOSystem System Calls - Read

strtod pREPC+ System Calls
strtod Converts a string to a double.
#include
double strtod(
const char *nptr, /* input string */
char **endptr /* string conversion terminator */
)
Description
Arguments
Return Value
Notes
This function converts the initial portion of a string (nptr) to a double
representation. Leading white spaces are ignored. The string can be in scientific
exponential form (for example, +123.45e+67, -123.45E+67). The strtod() function
stops parsing the string when it detects a character that is inconsistent with a
double data type.
This function sets errno if the converted value is out of the supported range for
doubles.
nptr Points to the string to be converted.
endptr An output parameter. If nptr is null, strtod() functions the same
as atof(). If nptr is not null, it points to a pointer to the character
in str that terminated the scan.
This function returns either the converted value or 0 if no conversion occurs. No
conversion occurs if the first nonwhite space in str is neither a digit nor a decimal
point. If the correct value is outside the range of representable values, a plus or
minus HUGE_VAL is returned. If the correct value would cause underflow, 0 is
returned. If either of these two errors occurs, errno is set.
The pREPC+ library returns double values (including floating point) in the CPU
register pair designated by the compiler to receive a return value of type double
from a function call when a hardware floating point is not selected. Additionally, if
3-164 pSOSystem System Calls