62 lines
2.5 KiB
Markdown
62 lines
2.5 KiB
Markdown
# StringConcatenate
|
||
|
||
The function forms a string of passed parameters and returns the size of the formed string. Parameters can be of any type. Number of parameters can't be less than 2 or more than 64.
|
||
|
||
```
|
||
int StringConcatenate(
|
||
string& string_var, // string to form
|
||
void argument1 // first parameter of any simple type
|
||
void argument2 // second parameter of any simple type
|
||
... // next parameter of any simple type
|
||
);
|
||
|
||
```
|
||
|
||
Parameters
|
||
|
||
string_var
|
||
|
||
[out] String that will be formed as a result of concatenation.
|
||
|
||
argumentN
|
||
|
||
[in] Any comma separated values. From 2 to 63 parameters of any simple type.
|
||
|
||
Return Value
|
||
|
||
Returns the string length, formed by concatenation of parameters transformed into string type. Parameters are transformed into strings according to the same rules as in [Print()](/en/docs/common/print) and [Comment()](/en/docs/common/comment).
|
||
|
||
Example:
|
||
|
||
```
|
||
void OnStart()
|
||
{
|
||
//--- declare and define variables participating in concatenation
|
||
string text="";
|
||
string text1="This script shows how the StringConcatenate() function works.\n";
|
||
string text2="This is the second line, at the end of which there is a line break control code.\n";
|
||
string text3="This is line number ";
|
||
int num3=3;
|
||
string text31=", the number of which is entered into the function as a separate parameter.";
|
||
string textN="\n";
|
||
string text4="This is line number 4, preceded by a separate parameter with a line break code.";
|
||
int length=StringConcatenate(text, text1, text2, text3, num3, text31, textN, text4, "\nLine 5 includes a real number: ", 0.12345);
|
||
Print(text, "\nLength of the resulting string = ", length);
|
||
|
||
/*
|
||
Result
|
||
This script shows how the StringConcatenate() function works.
|
||
This is the second line, at the end of which there is a line break control code.
|
||
This is line number 3, the number of which is entered into the function as a separate parameter.
|
||
This is line number 4, preceded by a separate parameter with a line break code.
|
||
Line 5 includes a real number: 0.12345
|
||
Length of the resulting string = 358
|
||
*/
|
||
}
|
||
|
||
```
|
||
|
||
See also
|
||
|
||
[StringAdd](/en/docs/strings/stringadd), [StringSplit](/en/docs/strings/stringsplit), [StringSubstr](/en/docs/strings/stringsubstr)
|