Siemens SIMATIC S7-1200 - 9.2.4.3 CONCAT (Combine character strings)

Extended instructions
9.2 String and character
S7-1200 Programmable controller
System Manual, V4.2, 09/2016, A5E02486680-AK
363
9.2.4.3
CONCAT (Combine character strings)
Table 9- 52 Concatenate strings instruction
LAD / FBD
SCL
Description
out := CONCAT(in1, in2);
CONCAT (concatenate strings) joins string parameters IN1 and
IN2 to form one string provided at OUT. After concatenation,
String IN1 is the left part and String IN2 is the right part of the
combined string.
Table 9- 53 Data types for the parameters
Parameter and type
Data type
Description
IN1
IN
String, WString
Input string 1
IN2
IN
String, WString
Input string 2
OUT
OUT
String, WString
Combined string (string 1 + string 2)
Table 9- 54 ENO status
ENO
Condition
OUT
1
No errors detected
Valid characters
0 Resulting string after concatenation is larger than maximum length of OUT
string
Resulting string characters are
copied until the maximum length
of the OUT is reached
Current length of IN1 exceeds maximum length of IN1, current length of
IN2 exceeds maximum length of IN2, or current length of OUT exceeds
maximum length of OUT (invalid string)
Current length is set to 0
Maximum length of IN1, IN2 or OUT does not fit within allocated memory
range
Maximum length of IN1 or IN2 is 255, or the maximum length of OUT is 0
or 255 (String data type)
Maximum length of IN1 or IN2 is 65534, or the maximum length of OUT is
0 or 65534 (WString data type)