strtod
- Updated2023-02-21
- 1 minute(s) read
strtod
double strtod (const char stringInput[], char **endPointer);
Purpose
Converts the initial portion of a string to double representation. The function skips whitespace characters at the beginning of the string. The conversion stops when a character that cannot be part of a number is reached. strtod obtains a pointer to the unconverted part of the string. The expected form of the subject sequence is an optional plus or minus sign, then a nonempty sequence of digits optionally containing a decimal-point character, then an optional exponent part.
Parameters
| Input | ||
| Name | Type | Description |
| stringInput | const char [] | Contains a pointer to the character sequence from which a conversion is made. |
| Output | ||
| Name | Type | Description |
| endPointer | char * | Contains a pointer to the first character in stringInput that cannot be part of the number converted, provided that NULL is not entered into this parameter. If the subject sequence is empty or does not have the expected form, the value of stringInput is stored in the object pointed to by this parameter, provided that NULL is not entered into this parameter. |
Return Value
| Name | Type | Description |
| convertedValue | double | Contains the converted value, if any. If no conversion is possible, the function returns zero. If the correct value is outside the range of representable values, strtod returns ±HUGE_VAL, according to the sign of the value, and sets errno to ERANGE. If the correct value causes underflow, the function returns zero. |
Additional Information
Library: ANSI C Library
Include file: ansi_c.h
LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later