pSOSystem System Calls - Read

strtol pREPC+ System Calls
strtol Converts a string to a long integer.
#include
long strtol(
const char *nptr, /* string */
char **endptr, /* string conversion terminator */
int base /* conversion base */
)
Description
Arguments
Return Value
Error Codes
The strtol() function converts the initial portion of a string (nptr) to long int
representation, according to the radix specified by base. This function ignores
leading white spaces, and the string can contain either a + or a -.
nptr Points to the string to be converted.
endptr An output parameter. If endptr is null, this function is equivalent to
the atol() function. If endptr is not null, it points to a pointer to the
character in str that terminated the scan.
base Specifies the base of the number system assumed by the function.
base must be either 0 or within the range 2 through 36. If it is 0, the
string itself is used to determine its base. If nptr begins with the
character 0, base eight is assumed; if nptr begins with 0x or 0X, base
sixteen is assumed; otherwise base ten is assumed.
This function returns the converted value. If the conversion fails, this function
returns a 0 and sets errno.
Refer to Appendix B.
3-168 pSOSystem System Calls