REPLACE - замена подстроки

Назначение.

Функциональный блок REPLACE применяется для замены части строки новым набором символов.

Состав структурной переменной.

Переменная со структурным типом REPLACE будет добавлена в локальный словарь автоматически при добавлении блока в редактор.

Описание алгоритма.

Преобразование строки осуществляется в два этапа, рассмотрим их на примере исходной строки INP = 'I love the world!', вставляемой подстроки STR = 'programming', LEN = 9, POS = 8:

Из исходной строки INP удаляется подстрока длиной LEN, начиная с позиции POS, в результате остается промежуточное значение 'I love !'.
В промежуточную строку, начиная с позиции POS, вставляется подстрока STR. Результат выводится на выход OUT = 'I love programming!'.

Удаляемая часть символов должна полностью находиться в границах исходной строки, а параметр LEN > 0. Иначе на выход OUT передается пустая строка.

При передаче пустой подстроки STR, в блоке выполняется только первый этап преобразования в виде удаления подстроки.

Пример синтаксиса на языке ST.

//вызов функционального блока

Block.REPLACE('I love the world!', 'programming', 9, 8);

//возвращается преобразованная строка OUT = 'I love programming!'

OUT := Block.OUT;