www.icetips.com  Icetips Utilities Documentation 5/9/2015    

Core Class: FindReplace

Previous  Top  Next  


Prototype: (String pFind, String pReplace, String pSearchS, <*LONG pNewLen>),String

 

pFindThe string to search for.
pReplaceThe string to replace with.
pSearchSThe string to search and replace in.  This can be a string literal or a string variable.
pNewLenOmittable parameter that receives the new length of the string

 

ReturnsThe resulting string with the pFind string replaced with the pReplace string

 

This method is identical to the SearchReplace method except FindReplace can take a literal string or variable as the string to search in and instead of returning the number of replacements performed, it returns the new string.  This makes it a little bit more flexible to use since you don't need to declare a variable to execute the search and replace. 

 

Note that this method will be slightly slower than SearchReplace because it has to count the number of times the pFind is found in pSearchS in order to allocate enough memory for it to start the search and replace process.  A simple test with the example code from SearchReplace took 0.71 seconds to run 100,000 (one hundred thousand) iterations of SearchReplace but 1.45 seconds to run the same number of iterations using FindReplace on the same machine.  However, for most practical application the difference is not noticable.

 

Example:

S    String(255)

ITC  ITCoreClass

Code

S = ITC.FindReplace('now','NOW','Check this out now') ! S is now:  'Check this out NOW'

 

 

 

See also:

SearchReplace

AllocateSearchString

CountFinds

ReplaceString

 



Direct link to this page: http://www.icetips.com/manuals/utilities/findreplace_core.htm