Skip to main content
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