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

​
strncpy_off

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

​
Function Syntax

void strncpy_off(char dest[], long destOffset, char src[], long max);

​
Description

This function copies 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-destOffset bytes are copied. Bytes are overwritten in dest starting at destOffset. 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 mbstrncpy_off instead.

​
Parameters

  • dest: Destination buffer
  • destOffset: Offset in destination buffer
  • src: Source string
  • max: Is used to determine the maximum number of copied bytes. Must not be larger than the size of dest. A maximum of max-1-destOffset bytes are copied. If src is shorter than that, bytes are only copied until a terminating ‘\0’ is encountered.

​
Return Values

—

​
Example

char s[6] = "Hello";
strncpy_off(s, 1, "e", elcount(s)); // s: He
Related Functions: strlen • strncat • strncmp • strncpy