NXC  Version 1.2.1 r5
 All Data Structures Files Functions Variables Groups Pages
long atol ( const string &  str)
inline

Convert string to long integer.

Parses the string str interpreting its content as an integral number, which is returned as a long int value.

The function first discards as many whitespace characters as necessary until the first non-whitespace character is found. Then, starting from this character, takes an optional initial plus or minus sign followed by as many numerical digits as possible, and interprets them as a numerical value.

The string can contain additional characters after those that form the integral number, which are ignored and have no effect on the behavior of this function.

If the first sequence of non-whitespace characters in str does not form a valid integral number, or if no such sequence exists because either str is empty or contains only whitespace characters, no conversion is performed.

Parameters
strString beginning with the representation of an integral number.
Returns
On success, the function returns the converted integral number as a long int value. If no valid conversion could be performed a zero value is returned.
Examples:
ex_atol.nxc.