Skip to main content
Open topic with navigation CAPL Functions » General » Function Overview » substr_cpy

​
substr_cpy

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

​
Function Syntax

void substr_cpy(char dest[], char src[], long srcStart, long len, long max);

​
Description

This function copies a substring of src to dest. max indicates the size of dest in bytes. The function ensures that there is a terminating ‘\0’. Thus, a maximum of max-1 bytes are copied. Note: A character may need several bytes depending on the string encoding, e.g. Japanese characters in Windows ANSI (932) encoding or any special characters in UTF-8 encoding. In that case, you should use mbsubstr_cpy instead.

​
Parameters

  • dest: Destination buffer
  • src: Source string
  • srcStart: Start index in bytes in src of substring
  • len: Length of the substring in bytes, or -1 to copy the string until the end
  • max: Size of dest in bytes

​
Return Values

—

​
Example

char s1[7];
char s2[18] = "Vector Informatik";
substr_cpy(s1, s2, 0, 6, elcount(s1)); // s1: Vector
strstr