ADDTEXT Function (BigText)
Adds a text string to a BigText variable.
BigText.ADDTEXT(Variable[, Position])
Parameters
- Variable
-
Type: Text or BigText
The string that will be added to the BigText variable. If this parameter is empty, then the BigText variable is not modified.
- Position
-
Type: Integer
This is an optional parameter that defines the position in the BigText variable where the string is inserted. If this parameter is omitted, then the string is added at the end of the BigText variable. If this parameter is less than one, then a run-time error occurs. If this parameter is greater than the length of the BigText variable, then the string is added at the end of the BigText variable.
Variable can be inserted anywhere in BigText or added at the end of the BigText.
The first character in a BigText variable is position 1.
To delete the content in a BigText variable use the CLEAR Function.
CLEAR(BigText)
The following table shows examples of the ADDTEXT function.
| Initial BigText variable | Function call | Result |
|---|---|---|
|
ABCDEFG |
BigText.ADDTEXT('ZZZ', 0) |
Error |
|
ABCDEFG |
BigText.ADDTEXT('ZZZ', 3) |
ABZZZCDEFG |
|
ABCDEFG |
BigText.ADDTEXT('ZZZ', 15) |
ABCDEFGZZZ |
|
ABCDEFG |
BigText.ADDTEXT('', 1) |
ABCDEFG |