Open topic with navigation CAPL Functions » General » Function Overview » strtol

strtol

Valid for: CANoe DE • CANoe:lite DE • CANoe4SW DE • CANoe4SW:lite DE

Function Syntax

int strtol(char s[], long& result); // form 1
int strtol(char s[], dword startIndex, long& result); // from 2

Description

Converts the string s to a 32bit integer. The number base is:

hexadecimal if the string starts with ‘0x’
octal if it starts with ‘0’
decimal otherwise

Whitespace (spaces or tabs) at the start of the string is ignored.

Parameters

s: String to be converted.
result: Contains the converted value after the call. The value is 0 if the string can’t be converted to a number. It is the largest possible positive/negative number in case of overflow.
startIndex: Position in s where the conversion shall begin.

Return Values

-2: If s is empty or startIndex is larger than strlen(s).
-1: An overflow occurs.

Otherwise, returns the index of the first character after the number.

Example

char s[20] = "123 0xFF";
long number1, number2;
int res;
res = strtol(s, number1);
write("number1: %d, res: %d", number1, res); // output: number1: 123, res: 3
res = strtol(s, res, number2);
write("number2: %d, res: %d", number2, res); // output: number2: 255, res: 8