ConcatStringsSpecifiedLength

Concatenate Up to Five Strings a Specified Length

Minor Business Rule

Object Name: B0001211

Parent DLL: CALLBSFN

Location: Client/Server

Language: C

Functional Description

Purpose
This function supports European International Payment Instruction (IPI) processing.  Specifically, it 
formats up to five strings into a single string.  If separators are needed between strings, the 
function will format up to three strings into a single string--unless you manipulate your strings prior to 
passing them to this function.  Given the function's design, you need not use this function only with 
the IPI.  It contains no IPI-specific functionality.

Technical Specification

Parameters
Data Item / Data Structure Desc           / I/O / Req'd.
Notes
---------------------------------------------------------------------
GPTX        szStringOne_GPTX                I     N

GPTX        szStringTwo_GPTX                I     N
Typically, you will want to use this parameter as a separator.

GPTX        szStringThree_GPTX              I     N

GPTX        szStringFour_GPTX               I     N
Typically, you will want to use this parameter as a separator.

GPTX        szStringFive_GPTX               I     N

EV01        cRightPadOutputWithBlanks_EV01  I     N
'1' if you want the output string to be exactly what you designate as the its length.

MATH01      mnStrlenOfOutputString_MATH01   I     Y
Specify how long your output string should be (or its maximum length)

GPTX        szConcatenatedOutput_GPTX       O     N
Output string.

Processing
Validate that there is a specified length of output (required parameter).
Prep the output string.
Validate that the output string is large enough for the specified length of output.
Concatenate each of the five input strings ... up to the specified length of output.
Null terminate the output string.