необязательный числовой параметр, задающий номер
задающий обрабатываемую символьную строку.
<cReplace> - символьный параметр, задающий строку, заменяющую
найденную подстроку в исходной строке.
<nCounter> - необязательный числовой параметр, задающий номер или
количество вхождений <cSearchFor> в <cString>. По умолчанию последнее
вхождение.
<lMode> - необязательный логический параметр, задающий при значении
.T. замену только искомого вхождения подстроки, а при значении .F. и
по умолчанию замену всех подстрок до искомого вхождения включительно.
Возвращаемое значение
cReplString - символьная строка с замененными одним или несколькими
вхождениями подстрок <cSearchFor> на <cReplace>.
Описание
Функция позволяет заменить одну или несколько подстрок в <cString>.
Заменяющая подстрока <cReplace> может быть короче или длиннее, чем
<cSearchFor>.
Если длина <cReplace> меньше или равна <cSearchFor>, то поиск
осуществляется с учетом режима, устанавливаемого функцией
CSETATMUPA(), в зависимости от которого замена даст различные
результаты.
Поиск всех вхождений подстроки <cSearchFor> осуществляется с начала
строки <cString>, причем ищутся все случаи вхождения подстроки. Если
режим прохода по символам выключен (.F.), то поиск продолжается со
следующего за последним символа замененной подстроки, а иначе поиск
продолжается со второго символа замененной подстроки.
Примечания
. Применение функции SETATLIKE() позволяет организовать поиск по
образцу.
. Если <cSearchFor> и <cReplace> имеют одинаковую длину, то
<cString> может передаваться по ссылке.
. Если <cSearchFor> и <cReplace> идентичны, то функция возвращает
управление, не выполняя действий, т.к. при этом, если вызовом
CSETATMUPA(.T.) установлен режим прохода по символам, поиск и вставка
