STRTRAN()

Translate substring valuw with a main string

Syntax

STRTRAN( <cString>, <cLocString>, <cRepString>, <nPos>, <nOccurences> ) --> cReturn

Arguments

<cString> The main string to search

<cLocString> The string to locate in the main string

<cRepString> The string to replace the <cLocString>

<nPos> The first occurence to be replaced

<nOccurences> Number of occurence to replace

Returns

<cReturn> Formated string

Description

This function searches for any occurence of <cLocString> in <cString> and replacesit with <cRepString>.If <cRepString> is not specified, a NULL byte will replace <cLocString>.

If <nPos> is used,its value defines the first occurence to be replaced.The default value is 1.Additionally,if used,the value of <nOccurences> tell the function how many occurrences of <cLocString> in <cString> are to the replaced.The default of <nOccurences> is all occurrences.
Examples
      ? StrTran("Harbour  Power","  "," ") // Harbour Power
      ? StrTran("Harbour  Power  The Future  of  xBase","  "," ",,2) // Harbour Power The future  of  xBase
Tests
      See regression test
Status

Ready

Compliance

Will not work with a search string of > 64 KB on some platforms

Platforms

All

Files

Libraty is rtl

See Also