Клиппер 5. Справочник

символьный параметр, задающий список символов,


    <cSearchFor2> - символьный параметр, задающий список символов, поиск
    которых осуществляется в строке <cString2>.
 
    [@]<cString2> - символьный параметр, допускающий передачу по ссылке
    и задающий строку, в которой осуществляется поиск символов из списка
    <cSearchFor2>.
 
    <cReplaceExpression> - символьный параметр, задающий список символов,
    используемых для замены в <cString2>.
 
  Возвращаемое значение
 
    cString - модифицированная строка <cString2>.


 
  Описание
 
    Функция ищет одинаковые позиции вхождений символов из списков в
    соответствующие строки и производит замену в найденных позициях
    строки <cString2>.
 
    Одиночные замены
 
    В случае, когда оба искомых и заменяющий списки содержат лишь по
    одному символу, определяются все одинаковые позиции вхождений символа
    из списка <cSearchFor1> в строку <cString1> и из списка <cSearchFor2>
    в строку <cString2>. После этого символы в найденных позициях строки
    <cString2> заменяются символом из <cReplaceExpression>.
 
    Это можно, например, использовать при обработке символьных строк,
    содержащих образы экрана. Например, если строка cPict1 содержит символ
    "|" в позиции 34, а в строке cPict2 в той же позиции находится символ
    "-", то этот символ в cPict2 может быть заменен на "+",
    воспроизводящий их комбинацию.
 
    Множественные замены
 
    Искомые и заменяющий списки могут содержать несколько символов.
    Вышеописанная процедура в этом случае применяется итеративно сначала
    для первых символов трех подстрок (<cSearchFor1>, <cSearchFor2> и
    <cReplaceExpression>), затем для вторых и т.д. Число итераций
    определяется длиной <cSearchFor1>. Если <cSearchFor2> или
    <cReplaceExpression> короче <cSearchFor1>, то повторно используется их

Содержание раздела