Difference between revisions of "STR REPLACE()"
From Recital Documentation Wiki
Yvonnemilne (Talk | contribs) |
Yvonnemilne (Talk | contribs) |
||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
==Purpose== | ==Purpose== | ||
| − | + | Function to search for and replace text within a character string or memo field | |
==Syntax== | ==Syntax== | ||
| − | + | STR_REPLACE(<expC1>, <expC2>, <expC3> | <memofield> [, <expN>]) | |
==See Also== | ==See Also== | ||
| − | + | [[AT()]], [[ATNEXT()]], [[CHRTRAN()]], [[INLIST()]], [[LEFT()]], [[OCCURS()]], [[RAT()]], [[RIGHT()]], [[SET STRESCAPE]], [[STR()]], [[STREXTRACT()]], [[STRTRAN()]], [[STUFF()]], [[SUBSTR()]] | |
==Description== | ==Description== | ||
| + | The STR_REPLACE() function will search <expC3> or <memofield> and replace text within <expC3> or <memofield> with <expC2> wherever the occurrence of <expC1> is found. The STR_REPLACE() function returns a character expression that contains the result of the string replacement. | ||
| + | The optional count argument, <expN>, can be used to return the number of matched and replaced <expC1> strings. | ||
==Example== | ==Example== | ||
<code lang="recital"> | <code lang="recital"> | ||
| − | + | ? str_replace("ello", "i","Hello World",nCount) | |
| + | Hi World | ||
| + | ? nCount | ||
| + | 1 | ||
</code> | </code> | ||
| − | |||
| + | ==Products== | ||
| + | Recital Server, Recital | ||
[[Category:Documentation]] | [[Category:Documentation]] | ||
[[Category:Functions]] | [[Category:Functions]] | ||
| + | [[Category:String Data]] | ||
| + | [[Category:String Data Functions]] | ||
Latest revision as of 14:25, 21 July 2010
Purpose
Function to search for and replace text within a character string or memo field
Syntax
STR_REPLACE(<expC1>, <expC2>, <expC3> | <memofield> [, <expN>])
See Also
AT(), ATNEXT(), CHRTRAN(), INLIST(), LEFT(), OCCURS(), RAT(), RIGHT(), SET STRESCAPE, STR(), STREXTRACT(), STRTRAN(), STUFF(), SUBSTR()
Description
The STR_REPLACE() function will search <expC3> or <memofield> and replace text within <expC3> or <memofield> with <expC2> wherever the occurrence of <expC1> is found. The STR_REPLACE() function returns a character expression that contains the result of the string replacement.
The optional count argument, <expN>, can be used to return the number of matched and replaced <expC1> strings.
Example
? str_replace("ello", "i","Hello World",nCount) Hi World ? nCount 1
Products
Recital Server, Recital
