String Concatenate (CONCAT)

String Concatenate (CONCAT)

This information applies to the
CompactLogix
 5370,
ControlLogix
 5570,
Compact GuardLogix
 5370,
GuardLogix
 5570,
Compact GuardLogix
 5380,
CompactLogix
 5380,
CompactLogix
 5480,
ControlLogix
 5580, and
GuardLogix
 5580 controllers.
The CONCAT instruction adds ASCII characters to the end of a string.
Available Languages
Ladder Diagram
Function Block
This instruction is not available in function block.
Structured Text
CONCAT(SourceA,SourceB,Dest);
Operands
There are data conversion rules for mixed data types within an instruction. See Data conversions for more information on Data Conversion.
Ladder Diagram and Structured Text
Operand
Type
Format
Description
Notes
Source A
ANY_STRING
tag
Tag that contains the initial characters
String types are:
  • Default STRING data type with maximum 82 length of characters for the string.
  • Any new string type you created with configurable length of characters for the string.
Source B
ANY_STRING
tag
Tag that contains the end characters
Destination
ANY_STRING
tag
Tag to store the result
See Structured Text Syntax for more information on the syntax of expressions within structured text.
Description
The CONCAT instruction combines the characters in Source A with the characters in Source B and places the result in the Destination.
The characters from Source A are first, followed by the characters from Source B.
Unless Source A and the Destination are the same tag, Source A remains unchanged.
Affects Math Status Flags
No
Major/Minor Faults
A minor fault will occur if:
Fault Type
Fault Code
The LEN value of the string tag is greater than the DATA size of the string tag.
4
51
The sum length of Source A and Source B is greater than the DATA size of the string tag.
4
51
See Index through arrays for array-indexing faults.
Execution
Ladder Diagram
Condition
Action Taken
Prescan
N/A
Rung-condition-in is false
N/A
Rung-condition-in is true
The instruction executes.
Postscan
N/A
Structured Text
Condition
Action Taken
Prescan
See Prescan in the Ladder Diagram table.
Normal execution
See rung-condition-in is true in the Ladder Diagram table.
Postscan
See Postscan in the Ladder Diagram table.
Concat String flow chart
Example
Ladder Diagram
Structured Text
CONCAT(string_1,string_2,msg);
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.