69 lines
1.7 KiB
Markdown
69 lines
1.7 KiB
Markdown
# StringAdd
|
||
|
||
The function adds a substring to the end of a string.
|
||
|
||
```
|
||
bool StringAdd(
|
||
string& string_var, // string, to which we add
|
||
string add_substring // string, which is added
|
||
);
|
||
|
||
```
|
||
|
||
Parameters
|
||
|
||
string_var
|
||
|
||
[in][out] String, to which another one is added.
|
||
|
||
add_substring
|
||
|
||
[in] String that is added to the end of a source string.
|
||
|
||
Return Value
|
||
|
||
In case of success returns true, otherwise false. In order to get an [error code](/en/docs/constants/errorswarnings/errorcodes), the [GetLastError()](/en/docs/check/getlasterror) function should be called.
|
||
|
||
Example:
|
||
|
||
```
|
||
void OnStart()
|
||
{
|
||
long length=1000000;
|
||
string a="a",b="b",c;
|
||
//--- first method
|
||
uint start=GetTickCount(),stop;
|
||
long i;
|
||
for(i=0;i<length;i++)
|
||
{
|
||
c=a+b;
|
||
}
|
||
stop=GetTickCount();
|
||
Print("time for 'c = a + b' = ",(stop-start)," milliseconds, i = ",i);
|
||
|
||
//--- second method
|
||
start=GetTickCount();
|
||
for(i=0;i<length;i++)
|
||
{
|
||
StringAdd(a,b);
|
||
}
|
||
stop=GetTickCount();
|
||
Print("time for 'StringAdd(a,b)' = ",(stop-start)," milliseconds, i = ",i);
|
||
|
||
//--- third method
|
||
start=GetTickCount();
|
||
a="a"; // re-initialize variable a
|
||
for(i=0;i<length;i++)
|
||
{
|
||
StringConcatenate(c,a,b);
|
||
}
|
||
stop=GetTickCount();
|
||
Print("time for 'StringConcatenate(c,a,b)' = ",(stop-start)," milliseconds, i = ",i);
|
||
}
|
||
|
||
```
|
||
|
||
See also
|
||
|
||
[StringConcatenate](/en/docs/strings/stringconcatenate), [StringSplit](/en/docs/strings/stringsplit), [StringSubstr](/en/docs/strings/stringsubstr)
|