CHANGE(), SWAP()

Top  Previous  Next

 

The CHANGE() function replaces occurrences of a substring within a string by another substring. The synonym SWAP() can be used.

 

 

Format

 

CHANGE(string, old, new{, occurrence{, start}})

 

where

 

stringis the string in which the replacement is to occur.

 

oldevaluates to the substring to be replaced.

 

newevaluates to the substring with which old is to be replaced.

 

occurrenceevaluates to the number of occurrences of old to be replaced. If omitted or specified as a value of less than one, all occurrences are  replaced.

 

startspecifies the first occurrence to be replaced. If omitted or specified as a value of less than one it defaults to one.

 

 

The CHANGE() function replaces the specified occurrences of old within string by new.

 

If old is a null string, the function returns string unchanged. If new is a null string, all occurrences of old are removed.

 

 

If the $NOCASE.STRINGS compiler directive is used, matching of old against string is case insensitive.

 

 

Examples

 

PRINT CHANGE("ABRACADABRA", "A", "a", 3, 2)

 

This statement results in printing the string "ABRaCaDaBRA".

 

 

See also:

CONVERT()