strtoul
- Updated2023-02-21
- 2 minute(s) read
strtoul
unsigned long strtoul (const char stringInput[], char **endPointer, int base);
Purpose
Converts the initial portion of a string to an unsigned long int representation with a specified base. The function skips whitespace characters at the beginning of the string. The conversion stops when the function reaches a character that cannot be part of the number. The function obtains a pointer to the unconverted part of the string.
Parameters
| Input | ||||
| Name | Type | Description | ||
| stringInput | const char [] | Contains a pointer to the character sequence from which a conversion is made. | ||
| base | int |
Contains the value of the radix that is used to make the appropriate conversion. If the base is zero, the expected form of the
subject sequence is that of an integer constant. If the value of the base is between 2 and 36, the expected form of the subject
sequence is a sequence of letters and digits representing an integer.
|
||
| 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 | unsigned long | 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, strtoul returns ULONG_MAX and sets errno to ERANGE. |
Additional Information
Library: ANSI C Library
Include file: ansi_c.h
LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later
Example
Refer to functionpanels\Customization\SelectColor.cws for an example of using the strtoul function.