4D v16.3

Change string

Home

 
4D v16.3
Change string

Change string 


 

Change string ( source ; newChars ; where ) -> Function result 
Parameter Type   Description
source  String in Original string
newChars  String in New characters
where  Longint in Where to start the changes
Function result  String in Resulting string

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"



See also 

Delete string
Insert string
Replace string

 
PROPERTIES 

Product: 4D
Theme: String
Number: 234

This command can be run in preemptive processes

 
HISTORY 

Created: < 4D v6

 
ARTICLE USAGE

4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)