RPG Open

TCAT, BCAT, SCAT Concatenate Multiple Strings

Syntax Diagram

result = tcat( s1 : s2 [: s3 : s4 : ... ] );

result = bcat( s1 : s2 [: s3 : s4 : ... ] );

result = scat( c : s1 : s2 [: s3 : s4 : ... ] );

The concatenation procedures perform multiple concatenation operations simultaneously. There are 3 variations of the subprocedures:

1. TCAT - Performs concatenation and removes all blanks between each value--similar to *TCAT in the CL language.
2. BCAT - Performs concatenation and removes all blanks between each value and then inserts a single blank between each value--similar to *BCAT in the CL language.
3. SCAT - Performs concatenation and removes all blanks between each value and then inserts a user-specified character(s) between each value.

      /free
            userName = bcat(firstname : lastname);
            xmldata = tcat('<cust>':%char(custno):'</cust>');
            csvData = scat(',' : compname : address : city : state : zipcode);
      /end-free

Up to 8 values may be concatenated at a time.

NOTE: The SCAT subprocedure allows multiple characters (not just single characters) for its first parameter (character-to-insert).

Return to RPGOpen.com