Change string
Change string ( source ; newChars ; where ) : Text
| Parameter | Type | Description | |
|---|---|---|---|
| source | Text | → | Original string |
| newChars | Text | → | New characters |
| where | Integer | → | Where to start the changes |
| Function result | Text | ← | Resulting string |
Description
Change string changes a group of characters in source and returns the resulting string. The command overlays source, with the characters in newChars, at the character described by where.
If newChars is an empty string (""), Change string returns source unchanged. Change string always returns a string of the same length as source. If where is less than one or greater than the length of source, Change string returns source.
Change string is different from Insert string in that it overwrites characters instead of inserting them.
Example
The following example illustrates the use of Change string. The results are assigned to the variable vtResult.
vtResult:=Change string("Acme";"CME";2) // vtResult gets "ACME"
vtResult:=Change string("November";"Dec";1) // vtResult gets "December"