Н.А.Богомолов, И.В.Зюряева

ТЕКСТОВЫЙ РЕДАКТОР TeConv v1.20

(специальные средства для организации контекстного редактирования)

СОДЕРЖАНИЕ

ВВЕДЕНИЕ

ОБЩИЙ АРХИВ

БЛОК РЕДАКТИРОВАНИЯ

Понятие блока редактирования

Условный блоковый контекст

Условное выражение

ГРУППОВОЙ ОПЕРАТОР В КОНТЕКСТЕ ЗАМЕНЫ

Понятие группового оператора

Простое групповое выражение

Циклическое групповое выражение

Операции простого и циклического условного выбора

Блоковые функции

1. Функция BlockOper

2. Функция BlockConv

3. Функция BlockEdit

4. Функция BlockFile

5. Функция BlockRepl

6. Функция BlockLexm

7. Функция BlockFind

8. Функция BlockEval

9. Функция BlockInfo

10. Функция BlockList

11. Функция BlockForm

12. Функция BlockNumb

13. Функция BlockOrfg

Аппарат подстановок в контекстах и сценариях

Источники и виды подстановок

Конструкции подстановок

СПЕЦИАЛЬНЫЕ АНАЛИТИЧЕСКИЕ СРЕДСТВА

Граничные контексты в таблице контекстов

Использование авторских идентификаторов

ПРИЕМЫ СОЗДАНИЯ СЛОЖНЫХ СЦЕНАРИЕВ

ПРИМЕР ИСПОЛЬЗОВАНИЯ СПЕЦИАЛЬНЫХ СРЕДСТВ

ЛИТЕРАТУРА

ВВЕДЕНИЕ

Текстовый редактор "TeConv - комплексное редактирование каталогов и файлов" является многопрофильным редактором текстовой информации, включающим в себя аппарат контекстного поиска и замены. Мощным средством контекстного редактирования является определение и использование контекстных групп. Дальнейшим расширением возможностей контекстного редактирования явилось создание специальных средств, включающих в себя блок редактирования, общий архив, условный поиск и создание блоков, разработка специальных конструкций групповых операторов и блоковых функций. Введение этих средств характеризуется появлением следующих возможностей:

- определять в файле отдельные области поиска,

- делать строковые и арифметические операции над найденными контекстными группами, архивными ячейками, системными переменными и системными списками,

- возможность замены/вставки блоков редактирования на блоки из других файлов, предварительно занесенные в архив,

- объединять блоки из разных файлов в единый файл,

- использовать набор блоковых операций для нестандартных контекстных преобразований,

- производить анализ данных до и после контекстного редактирования,

- использовать авторские идентификаторы в контекстном запросе.

TeConv, по сути, является инструментальным комплексом, обладающим спецсредствами для выполнения сложных текстовых преобразований на базе разработанного внутреннего языка "табличного" программирования, что позволяет использовать редактор TeConv в качестве программера .

ОБЩИЙ АРХИВ

Общий архив - это список, содержащий контексты как в виде одной строки, так и в виде группы строк. В последнем случае строки представляются в ячейке архива разделенными символом EOLN (в его текстовом представлении). Область действия общего архива распространяется на весь сеанс редактирования, поэтому ячейки архива могут создаваться либо заранее (загружаться из файла), либо в процессе редактирования одного или нескольких файлов, а использоваться при редактировании любого файла. Такой механизм позволяет делать межфайловые контекстные замены.

Для создания, просмотра и редактирования архива служит окно "Просмотр и редактирование общего архива", в котором при загрузке отображается таблица архивных ячеек с указанием их номеров. Для редактирования определенной ячейки таблицы необходимо указать ее номер в редакторском окошке (явно или кликнуть ячейку мышкой) и вызвать через контекстное меню поле редактирования. Редактирование ячейки, а также определенные действия над ячейками архива, осуществляющиеся через обычное меню окна, могут быть внесены в сценарий. Весь архив или отдельную его ячейку можно сохранить в файле или загрузить из файла, что может быть использовано также в сценариях.

Головное меню позволяет выбрать файл загрузки/выгрузки общего архива либо непосредственно из каталога, либо из обменного буфера, либо из левого или правого списка редактора TeConv. В последнем случае выбор файла списка производится в вызываемом окне "Выбор элемента списка". В этом окне выбирается вид списка и номер элемента по списку, который отсчитывается от 1. Номер может быть равен -1, что бывает полезно в сценариях при многоэтапной контекстной замене в режиме "по содержимому" списка для неявного определения номера ячейки списка с редактируемым в текущий момент файлом.

Архив не обязан заполняться последовательно, т.е. в любой момент может быть создана его ячейка с произвольным номером. Признаком работы с архивным контекстом при редактировании входного файла является использование конструкции {{n}}, где n>=1 - номер ячейки в архиве. Ячейка архива может участвовать в качестве операнда группового выражения и интерпретироваться не только как строковое значение, а и как числовое. Это обстоятельство позволяет использовать ячейку архива, например, как счетчик при программировании сложных преобразований :

""//{{1}} или "0"//{{1}} - обнуление счетчика

{{1}}+1//{{1}} - увеличение значения счетчика на 1

БЛОК РЕДАКТИРОВАНИЯ

Понятие блока редактирования и блокового контекста

Блок редактирования - это внутренний список, который может включать одну или несколько файловых строк, как из текущего редактируемого файла, так и из группы редактируемых файлов (при включенной опции на странице контекстной замены "Сводный файл строк редакции"). В общем случае, блок редактирования создается при нахождении в редактируемом файле блокового контекста поиска, в котором специальные конструкции ('%%' и '$$') определяют поиск начальной и конечной строки блока:

%%<контекст поиска начальной строки блока>

<контекст поиска внутренних строк блока>

$$<контекст поиска конечной строки блока>

В качестве ограничителей начала и конца блока могут использоваться спецконструкции без контекстов:

%%% (в этом случае начальная строка блока совпадает с началом файла)

$$ (в этом случае конечная и начальная строки блока совпадают)

$$$ (в этом случае конечная строка блока совпадает с концом файла)

Примеры блоковых контекстов:

Контекст поиска:	Контекст замены:	Комментарий:
%%<pre> {integer} $$</pre>	{real}	блок между обрамляющими граничными тегами <pre> и </pre>, в котором контекст integer заменяется на real ;
%%{фаза}|{фазов} {@[} $${~@[}	""	блок карточек, заголовок которых содержит производные от слова фаза, а тело состоит из конструкций, содержащих квадратную скобку;
%%{%Пример:} $$		блок, состоящий из строки, в начале которой находится контекст Пример: ;
%%{%Пример:} $$$		блок, начинающийся со строки с контекстом Пример: и заканчивающийся последней строкой редактируемого файла;

Таблица контекстов может содержать произвольное число блоковых контекстов (идентифицируются условием), которые определяют области таблицы и строки файла, в которых только и будет производиться контекстный поиск и замена, заданные для этого блока редактирования. Контекстным преобразованиям может быть подвергнута любая строка, удовлетворяющая условию вхождения в блоковый контекст, перед непосредственной записью ее в блок редактирования, в том числе начальная и конечная. При этом поиск контекста внутренних строк блока распространяется также на начальную строку. Если конечная строка блока содержит в контексте поиска более одного условия, то реальный конец блока соответствует выполнению только первого условия, а при необходимости определить конец блока по другому условию, следует написать ещё один контекст '$$' с другим условием. Начальных контекстов '%% 'для нахождения различных контекстов поиска, которые будут обрабатываться в одном блоке редактирования, может быть также несколько, но они определяют "вход" в блок при выполнении любого заданного условия в контексте поиска.

В качестве начальной и конечной строк блока могут быть как отдельные фиксированные конструкции (например, %%<pre> и $$</pre>), так и произвольные строки, содержащие контекст поиска начальной строки блока (например, %%{фаза}|{фазов} ). В последнем случае, конец искомого блока определяется отсутствием в строке заданного контекста начальной строки блока и контекста внутренней строки блока, но тогда он не должен быть включен в блок, что достигается заданием пустого контекста замены "".

Найденные блоковые контексты могут быть подвержены контекстной замене, а также над ними возможность производить определенные действия с помощью групповых операторов, причем это можно делать и в процессе построения блока и после его создания. Для указания действий над найденным блоком служит специальная конструкция '%$', которая располагается после контекста поиска конца блока и определяет набор действий, записанных в таблице контекстов в позиции контекста замены. Таких строк, относящихся к текущему блоку, может быть несколько, и они определяют определенную последовательность действий через блоковые функции. Таким образом, в таблице контекстов может присутствовать структура вида:

Контекст поиска:	Контекст замены:
%%<контекст начала блока> <контекст внутренних строк блока> . . . <контекст внутренних строк блока> $$<контекст конца блока> %$ . . . %$	<контекст замены> . . . <контекст замены> #[<блоковая функция>] . . . #[<блоковая функция>]

Контекстным преобразованиям может быть подвергнута любая строка, удовлетворяющая условию вхождения в блок, перед непосредственной записью ее в блок редактирования, в том числе начальная и конечная. При этом поиск контекста внутренних строк блока распространяется также на начальную строку.

Замечание. Блоковый контекст таблицы контекстов фактически определяет блок редактирования и поэтому в общем случае под блоком редактирования можно понимать совокупность конструкций таблицы контекстов и формируемого в процессе контекстной замены фрагмента редактирования.

Условный блоковый контекст

В одном файле может быть задан контекстный поиск нескольких блоковых контекстов, для чего вводится критерий условие, который идентифицирует все строки, относящиеся к данному блоку:

|<условие>|%%<контекст начала блока>

|<условие>|<контекст внутренних строк блока>

. . .

|<условие>|$$<контекст конца блока>

Здесь:

<условие> - конструкция вида :

<номер блока> или

<номер блока>[<групповое условное выражение>] или

<номер блока>[<групповое условное выражение> ::

<групповое условное выражение> :: …<групповое условное выражение>]

Символ-разделитель '::' (соответствует логической операции или) означает наличие набора групповых условных выражений. При выполнении очередного условия запоминается его номер в наборе и выполняется соответствующий этому номеру групповой оператор в контексте замены.

<номер блока> - целое число от 1 или пусто

<групповое условное выражение> - конструкция вида:

<условное выражение> [ || <условное выражение> … || <условное выражение>]

Символ-разделитель '||' (соответствует логической операции и) означает наличие нескольких условных выражений, каждое из которых должно выполняться для выполнения всего условного выражения. Эти условные выражения могут использоваться в подстановках в других условных выражениях набора:

>n|d0..d1

-

выборка диапазона условного выражения из набора условий с номером n , при этом до и после операторов выборки могут находиться другие условные выражения, например, <условие 1.1> // <условие 1.2> // <условие 1.3> :: >1/1..2 // <условие 2.1> (при подстановке для второго условия получим последовательность <условие 1.1> // <условие 1.2> // <условие 2.1>);

Примеры условных блоковых контекстов (в таблице контекстов каждый контекст поиска или замены записывается в одну строку):

1).Поиск в файле отдельных разделов для "точечного" редактирования

Контекст поиска:	Контекст замены:	Комментарий:
|1|%%<h3> *Использование |1|{_c(} |1|$$<h3> *Параметры |2|%%{<h3> *Версии} |2|{external} |2|$$<h3> *Примеры	"_c (" extern	Редактирование в разделе 'Использование' ; редактирование в разделе 'Версии' ;

Условное выражение

<условное выражение> - конструкция вида:

[<модификатор>]<групповое выражение><операция>

[<модификатор>]<групповое выражение>

или

[<модификатор>]<идентификатор>[<операция>

<величина для сравнения>]

<модификатор> - операции, применяемые к вычисленному операнду:

~~ исключение всех пробелов в значении операнда

_> перевод значения операнда в регистр больших букв

_< перевод значения операнда в регистр малых букв

<групповое выражение> - <простое групповое выражение>

или

<циклическое групповое выражение>

<операция> - допустимы следующие операции сравнения:

= , <> , > , < , (для простого группового выражения)

<=, >=

для цикла в правой части условия -

= , <> , > , < , (для циклического группового

<=, >= выражения: true- хотя бы для

одной итерации цикла)

=* , <>* , >* , <*, (для циклического группового

<=* ,>=* выражения: true - для всех

итераций цикла)

для цикла в левой части условия -

= , <> , > , < , (для циклического группового

<=, >= выражения: true- для всех

итераций цикла)

!= , !<> , !> , !<, (для циклического группового

!<= , !>= выражения: true - хотя бы для

одной итераций цикла)

Замечание. Не допускаются пробелы между символом '!'

и конечным символом условия. Например,

loop(sysvar|~1..-1~)/s!=0^^9 - условие выполнено,

если sysvar будет содержать хотя бы одну цифру;

loop(sysvar2|*.*)/s/sysvar3!=A^^Z - номер первой

найденной в sysvar2 буквы будет записан в sysvar3 .

<идентификатор> - смысловое имя (допустимые операции):

else - условие выполняется при невыполнении всех

предыдущих условий условного выражения,

block (>|<|=) - номер очередного вхождения блока в файл

для сравнения с числовым диапазоном n

или n1..n2,

file (=) - контроль существования файла, имя которого

задается в качестве выражения для сравнения,

fline (>|<|=) - номер текущей строки файла для сравнения

с числовым диапазоном n или n1..n2, при n<0

отсчёт производится от конечной строки файла,

retBlockOper (=) - контроль кода возврата при выполнении

предшествующей блоковой операции BlockOper

retBlockConv (=) - контроль кода возврата при выполнении

предшествующей блоковой операции BlockConv

retBlockEdit (=) - контроль кода возврата при выполнении

предшествующей блоковой операции BlockEdit

retBlockFile (=) - контроль кода возврата при выполнении

предшествующей блоковой операции BlockFile

(текстовые константы сравнения true или false)

retBlockRepl (=) - контроль кода возврата при выполнении

предшествующей блоковой операции BlockRepl

(текстовые константы сравнения true или false)

retBlockLexm (=) - контроль кода возврата при выполнении

предшествующей блоковой операции BlockLexm

(текстовые константы сравнения true или false)

retBlockFind (=) - контроль кода возврата при выполнении

предшествующей блоковой операции BlockFind

(текстовые константы сравнения true или false)

retBlockEval (=) - контроль кода возврата при выполнении

предшествующей блоковой операции BlockEval

(текстовые константы сравнения true или false)

retBlockList (=) - контроль кода возврата при выполнении

предшествующей блоковой операции BlockList

(текстовые константы сравнения true или false)

retBlockForm (=) - контроль кода возврата при выполнении

предшествующей блоковой операции BlockForm

(текстовые константы сравнения true или false)

retBlockNumb (=) - контроль кода возврата при выполнении

предшествующей блоковой операции BlockNumb

(текстовые константы сравнения true или false)

retBlockOrfg (=) - контроль кода возврата при выполнении

предшествующей блоковой операции BlockOrfg

(текстовые константы сравнения true или false)

В процессе анализа условия формируются системные переменные, которые могут в дальнейшем использоваться в групповых операторах контекста замены:

SysLloop	-	содержит найденное значение по циклу для текущего проверяемого простого условия, при котором это простое условие выполняется (это значение может быть использовано в следующем условии, стоящим за разделителями || или ::, если оно имеет такую же левую часть), например, последовательность лексем сравнения, задаваемая в цикле loop({{1}}|*''*)/l ;
SysRloop	-	содержит найденное значение по циклу для текущего проверяемого простого условия, при котором это простое условие выполняется (это значение может быть использовано в следующем условии, стоящим за разделителями || или ::, если оно имеет такую же правую часть) , например, три конечных байта из sysvar, получаемых в цикле loop(sysvar|-3..-1)/s ;
SysNcond	-	номер условия, которое удовлетворяется;
SysLiter	-	номер итерации, найденной по циклу в левой части простого условного выражения; в записи диапазона используется условное обозначение l* или L* , например, {1}|L*..L*;
SysRiter	-	номер итерации, найденной по циклу в правой части простого условного выражения; в записи диапазона используется условное обозначение r* или R* , например, {1}|r*''r* ;
SysLval	-	содержит вычисленную левую часть для текущего проверяемого условия текущего простого условного выражения (это значение может быть использовано в следующем условии, стоящем после разделителей || или :: , если оно имеет такую же левую часть);
SysRval	-	содержит вычисленную правую часть для текущего проверяемого условия текущего простого условного выражения (это значение может быть использовано в следующем условии, стоящем после разделителей || или :: , если оно имеет такую же правую часть);

Замечание. Если условное выражение состоит из нескольких простых условных выражений, объединяемых операцией '||', то значения соответствующих системных переменных считаются неопределёнными.

Примеры условных блоковых контекстов (в таблице контекстов каждый контекст поиска или замены записывается в одну строку):

1). Выборка блока, если он найден в файле первый раз

Контекст поиска:	Контекст замены:	Комментарий:
|3[block=1]|%%<table |3|{<tr>} |3|$$</table> |3|%$	#[BlockEdit(selsp,sysfile1)] #[BlockOper(del,{10},0, &1|sysfile1 ..&2|sysfile1 - 1)]	Контроль появления блока в первый раз и применение блоковых функций для удаления первой группы строк, описанной тегом <tr>;

В контексте замены использованы блоковые функции и аппарат подстановки лексем 1 и 2 из системного файла sysfile1, созданного при нахождении контекста <tr> внутри блока редактирования.

2). Поиск контекста во внешнем файле для замены в блоке

Контекст поиска:	Контекст замены:	Комментарий:
|4|%%{subroutine}{[a-z]+ [_a-z0-9]* ]}{?*)} |4|$${)} |4[file=d:\file\{{1}}.ci :: file=d:\file\{{1}}.cr]|%$	#[{2}|1..-2//{{1}}] #[BlockFile(extr,sysRcond,{10},"int {{1}}",")", "subroutine",")") :: BlockFile(extr,sysRval,{10},"real {{1}}",")", "subroutine",")")]	Запись имени п/п в первую ячейку архива; контроль наличия файла с расширением .ci или .cr, и выбор блоковой функции для контекстной замены обращения к п/п;

3). Поиск и замена левой части оператора присваивания для локальных и глобальных значений переменных (фрагмент п/п замены идентификаторов)

Контекст поиска:	Контекст замены:	Комментарий:
|[{1}|~1..-2~ = sysvar :: sysLval=loop({{3}}|*''*)/a :: else]|{ *[_A-Za-z][_A-Za-z0-9]* *=}	#[{{1}}|r*''r*//{1}|~1..-2~ :: :: {{5}} + 1//{{5}}; {1}|~1..-2~ & " "//{{2}}/b; loop({{2}}|*''*)/a//sysvar; "_" & {{5}} & " "//{{1}}/b; {{1}}|1''1//{1}|~1..-2~]	Для найденного контекста поочередно осуществляется ряд сравнений: со списком локальных переменных (находится в sysvar), со списком глобальных перем. (находится в ячейке общего архива {{3}}) не входит в списки;

В первом условии для ускорения общего процесса контекстного поиска/замены используется системная переменная sysvar, которая строится на основе списка локальных переменных из ячейки архива {{2}}, и содержит внутреннее представление списка. В силу этого первое условие фактически означает проверку элемента (лексемы) по списку локальных параметров и в случае нахождения элемента в списке на его номер указывает r* .По этому номеру из списка замены из ячейки архива {{1}} выбирается элемент замены и заменяет найденный контекст. Второе условие проверяет наличие контекста в списке глобальных переменных {{3}}, при этом исходный контекст не меняется. Здесь следует обратить внимание, что в качестве левой части условия используется вычисленное значение предыдущего условия, что существенно сокращает время выполнения всего процесса. Третье условие выполняется, если первые два не дали положительного результата. В этом случае дополняется список локальных переменных {{2}} и формируется новое значение переменной sysvar, в начало списка замены {{1}} добавляется элемент замены в виде _n (n - значение счетчика {{5}}, которое предварительно увеличивается на 1) и на это значение заменяется найденный контекст.

ГРУППОВОЙ ОПЕРАТОР В КОНТЕКСТЕ ЗАМЕНЫ

Понятие группового оператора

Вместо номера группы в контексте замены может быть задан групповой оператор или набор групповых операторов с разделителем ';' :

#[<групповой оператор>]

#[<групповой оператор>; <групповой оператор>; …<групповой оператор>]

Здесь:

<групповой оператор> - конструкция вида:

<простое групповое выражение>

или

<циклическое групповое выражение>

или

<блоковая функция>

Наборы операторов могут быть условными, в этом случае они разделяются символом '::' и выполняются при определенных условиях, заданных в контексте поиска условного блока редактирования:

<набор операторов> :: <набор операторов> :: … <набор операторов>

(последний оператор условия не обязан заканчиваться ограничителем ' ; ' )

В качестве набора операторов могут фигурировать подстановки:

>n[;]	-	номер набора операторов текущего условия; например, если наборы операторов первого и второго условий совпадают, то для записи набора операторов второго условия можно использовать подстановку: <набор операторов для условия 1> :: >1 ;
>n|d0..d1[;]	-	выборка диапазона групповых операторов из набора операторов для условия с номером n , при этом до и после операторов выборки могут находиться другие групповые операторы, например, <групповой оператор 1.1>; <групповой оператор 1.2>; <групповой оператор 1.3> :: >1/1..2; <групповой оператор 2.1> (при подстановке для второго условия получим последовательность <групповой оператор 1.1>; <групповой оператор 1.2>;<групповой оператор 2.1>);

Простое групповое выражение

Определим понятие простого группового выражения, которое для краткости будет называться групповым выражением. Групповое выражение позволяет выполнить некоторые строковые или арифметические действия над содержимым найденных групп (полным или взятом в заданном диапазоне), а затем поместить результат по стандартным правилам работы с группами или в место, указанное в самом контексте. Таким образом, групповое выражение определяет вычисляемый контекст замены и может быть задано в одном из следующих вариантов:

<выражение>

<выражение>//<место замены>/<режим замены>

<выражение>//<место замены>

Здесь:

<выражение> - комбинация действий на основе конструкции

<операнд> или <операнд> <операция> <операнд>,

где допускается использование круглых скобок

для задания порядка выполнения операций;

<операнд> - одна из конструкций:

<число>или<строковый операнд> или

<групповой операнд> или <системный операнд>;

<число> - целое или вещественное для арифметических операций;

<строковый операнд> - строка, заключенная в двойные кавычки

( "…" );

Замечание. Если строковый операнд содержит

символ "&", то его необходимо представить в виде

"&&", т.к. иначе он будет рассматриваться как

признак подчеркивания следующего за ним символа;

<групповой операнд> - конструкция вида:

- контекст группы: {n} , где

n - номер группы (1<=n<=9), содержимое которой надо взять,

допускается выборка диапазона символов и лексем;

- блок редактирования: {10} , где 10 - признак блока,

допускается выборка диапазона строк, символов и лексем;

- входная строка: {0} , где 0 - признак строки редактирования,

допускается выборка диапазона символов и лексем;

<системный операнд> - конструкция вида:

- контекст архива: {{n}} , где

n - номер ячейки общего архива (n=1,2,…);

допускается выборка диапазона символов и лексем;

- системная переменная: элемент списка TStringList типа String

(объект ObjectPascal) с именем sysvar[n] (n=0,1,2,…)

(например, sysvar (=sysvar0), sysvar1,sysvar99);

допускается выборка диапазона символов и лексем;

- системный список: список типа TStringList (объект ObjectPascal)

с именем syslist[n] (n=0,1,2,…)

(например, syslist (=syslist0), syslist1,syslist99);

допускается выборка диапазона строк, символов и лексем;

- системный файл: файл, располагающийся в том же каталоге,

что и TeConv.exe, c именем sysfile, sysfile1 или sysfile2 ;

эти файлы создаются с использованием блоковой функции

BlockEdit и используются в блоковой функции BlockConv;

допускается выборка диапазона лексем;

<операция> - допустимы следующие операции (по убыванию приоритета):

Max , Min , Abs , Int , Fruc , Sqr , Sqrt (встроенные функции)

div , mod , * , /

+ , -

& (объединение операндов в одну строку);

<место замены> - <групповой операнд>|<системный операнд>;

<режим замены> - r (заменить диапазон, режим работает по умолчанию)

b (вставить перед начальным символом диапазона замены)

e (вставить после конечного символа диапазона замены);

В записи группового выражения общие правила использования спецсимвола @ для "погашения" спецсимволов не действует, т.е. спецсимволы можно свободно использовать в строковых операндах наряду с обычными символами. Исключение составляет использование в строковом операнде спецсимвола $ (конец строки), что позволяет разбивать строку или вставлять в текст новые строки.

Вычисление выражения производится в соответствии с правилами арифметики над операндами, выделенными из найденных контекстных групп с учетом заданного диапазона, причем для арифметических операций эти операнды должны быть числовыми значениями. Если надо взять для контекстной замены символьный контекст или часть контекста группы, тогда выражение состоит только из операнда соответствующего вида. При задании места замены и режима замены возможности контекстного редактирования с использованием групп существенно возрастают. Если номер группы замены равен 0, то в режиме r вся исходная строка заменяется выражением, в режиме b выражение вставляется в начало строки, в режиме e выражение добавляется в конец строки.

Пример использования в контексте замены группового выражения:

исходная строка: Х1:200 Х2:20 Х3:2

контекст поиска: {Х1:[~ ]+}{Х2:[~ ]+}{Х3:[~ ]+}

контекст замены: #[">>>$Итог: " & ({1}|4..-1 + {2}|4..-1 + {3}|4..-1)//{0}/r]

выходные строки: >>>

Итог: 222

Область действия группового контекста ограничивается текущей строкой редактирования, однако есть возможность сохранять нужные контексты в ячейке архива и использовать их в течение одного сеанса редактирования. Признаком работы с архивным контекстом в групповом операнде является конструкция {{n}}, где n>=1 - номер ячейки в архиве. Если в выражении используется архивный контекст, который к этому времени не был определен, то считается, что он пустой для строковой операции и равен нулю для арифметической операции (исключение составляют оба операнда операции умножения и второй операнд операции деления, которые в случае неопределенности полагаются равными 1).

Пример использования архивных контекстов и контекстов групп:

исходные строки: S1:1 S2:2

S1:10 S2:20

R1:00 R2:00

a) контекст поиска: {S:[~ ]+}{S:[~ ]+}

контекст замены: #[{{1}}+{1}|4..-1//{{1}}; {{2}}+{2}|4..-1//{{2}}]

б) контекст поиска: {R1:[~ ]+}{R2:[~ ]+}

контекст замены: #[{{1}}//{1}|4..-1; {{2}}//{2}|4..-1]

выходные строки: S1:1 S2:2

S1:10 S2:20

R1:11 R2:22

Циклическое групповое выражение

Циклическое групповое выражение позволяет организовать циклический поиск по контекстам общего архива (ключ a), по группам (ключ g), по лексемам входной строки (ключ l), сканировать символы строки (ключ s), работать с элементами системного списка (ключ r), формировать итерационные символьные строки (ключ i) :

loop(<групповое выражение>)/a [// <место записи итерации цикла>]

loop(<групповое выражение>)/g [// <место записи итерации цикла>]

loop(<групповое выражение>)/l [// <место записи итерации цикла>]

loop(<строковый операнд>)/s [// < место записи итерации цикла>]

loop(<системный список>)/r [// < место записи итерации цикла>]

loop(<шаблон>#<число повторов>)/i // <место записи>

При этом цикл для параметров a и g производится либо по параметру группового выражения, который содержит в качестве архивного контекста или группы конструкции {{*}} или {*}, либо по значениям диапазона или лексем контекстов, заданных конструкциями типа {n}|*..* , {n}|*''* , {{n}}|*..* , {{n}}|*''* (см. простое групповое выражение и конструкции подстановок) , а для параметра l – по строке с лексемами ( например, цикл loop({{1}}|*..*)/l определяет выборку всех лексем из ячейки архива {{1}} ). При этом <место записи итерации цикла> указывает системную переменную или ячейку архива для сохранения итерации цикла, удовлетворяющей заданному условию. Параметр i определяет цикл создания итерационной строки по заданному шаблону и числу повторов ( например, цикл формирования в системной переменной sysvar строки из 6 пробелов: loop(" "#6)/i//sysvar ). Параметр s определяет цикл выборки байтов из заданного строкового операнда ( например, цикл loop(sysvar1|1..3)/s определяет выборку первых трёх байтов из системной переменной sysvar1 ). Параметр r определяет цикл выборки строк из системного списка ( например, цикл loop(syslist2|*..*)/r определяет выборку всех строк из системного списка syslist2 ).

Разновидностью циклического выражения является неявный цикл по заданному диапазону значений символов:

<начальная граница диапазона>^^<конечная граница диапазона>

( например, 0^^9 - цикл по цифрам, A^^Z - цикл по латинским буквам).

Операции простого и циклического условного выбора

Операции простого и циклического условного выбора предназначены для выполнения тех или иных действий в зависимости от истинности или ложности задаваемого условия. Эти операции содержат наборы операторов для истинного и ложного значения условия, а их отличие заключается в том, что в циклической операции при ложном значении условия, после выполнения заданного набора операторов и изменения параметров условия, заново начинается работа циклической операции пока не будет достигнуто истинное значение её условия. Операции условного выбора имеют вид:

cond( <условие> )/ <набор операторов> /,/ <набор операторов> /;

или

condl( <условие> )/ <набор операторов> /,/ <набор операторов> /;

Здесь:

<условие> - условное выражение (простое или сложное);

сложное условное выражение может содержать символы-

разделители:

‘||’ (соответствует логической операции ‘И’) означает наличие

нескольких одноуровневых условных выражений, каждое из

которых должно выполняться для истинности всего условия,

‘::’ (соответствует логической операции ‘ИЛИ’) означает

наличие нескольких одноуровневых условных выражений, из

которых должно выполняться хотя бы одно для истинности

всего условия.

<набор операторов> - один или несколько групповых операторов,

отделяемых символом ';' (в каждом наборе операторов

допускается рекурсия операций условного выбора).

Например, condl(sysvar>0 || sysvar mod 3 = 2 {условие op1}

)/ cond(sysvar mod 2 = 0 {True op1: условие op2}

)/ {{1}} & " " & sysvar1//{{1}} {True op2}

/,/ {{2}} & " " & sysvar1//{{2}} /; {False op2}

/,/ sysvar+1//sysvar /; {False op1)

Замечание. В синтаксисе операции условного выбора обязательны разделительные конструкции:

( - начало условия;

)/ - конец условия и начало набора операторов для истинности

условия;

/,/ - разделитель набора операторов для истинности и ложности

условия;

/; - конец операции условного выбора;

Для простого условного выбора может отсутствовать один из наборов операторов, тогда он заменяется одним или несколькими пробелами.

Например, cond( sysvar<0 )/ abs(sysvar)//sysvar /,/ /;

Блоковые функции

Блоковая функция является частью группового оператора и позволяет выполнить некоторые нестандартные действия для управления процессом контекстного редактирования, а также осуществляет взаимосвязь между внутренними объектами редактора TeConv и доступ к внешним файлам. Определен следующий набор блоковых функций:

BlockOper	-	основные блоковые операции: сохранение, замена, вставка, удаление строк блока редактирования; взаимосвязь его с другими объектами редактора TeConv;
BlockConv	-	преобразование символов блока редактирования: кодировка, регистр;
BlockEdit	-	создание файлов с характеристиками состояния найденных контекстов в блоке редактирования;
BlockFile	-	работа с внешним файлом: выделение, запись контекстов; взаимосвязь его с объектами редактора TeConv;
BlockRepl	-	выполнение контекста замены в групповом операторе;
BlockLexm	-	работа с лексемами строки: чтение, добавление, замена, удаление;
BlockFind	-	работа с текстовой строкой: вхождение шаблона, длина строки и др.;
BlockEval	-	вычисление числовых подвыражений в строке;
BlockInfo	-	выдача информационной строки в StatusBa окна редактора TeConv;
BlockList	-	работа со строками системного списка: загрузка, чтение, запись, добавление, замена, удаление, очистка и др.;
BlockForm	-	форматирование строки в рамках заданного поля шаблона;
BlockNumb	-	перевод целых числе между системами счисления ( от 2 до 36);
BlockOrfg	-	проверка орфографии и создание протокола ошибок.

Каждая функция имеет определенный набор входных параметров. При обращении, отсутствующие или заданные по умолчанию параметры в конце списка могут опускаться, а внутри списка (после параметров чтения/записи) несущественные для заданной операции параметры могут совсем отсутствовать или задаваться как число 0. Например, блоковые функции BlockOper(setcn,,,+6) и BlockOper(setcn,0,0,+6) идентичны.

При работе с блоковыми функциями следует четко понимать, где будет находиться указатель по входной строке после выполнения функции, чтобы обеспечить в дальнейшем правильный поиск по оставшейся части редактируемой строки. Функции, не изменяющие входную строку, устанавливают указатель на символ, следующий за конечным значением найденного диапазона контекста поиска, а функции, изменяющие входную строку, устанавливают указатель на символ, следующий за контекстом произведенной замены. После выполнения контекста замены поиск контекста по оставшейся части входной строки начинается с начала таблицы контекстов. Если после выполнения замены указатель перешел за границу строки, то начинается поиск с первой позиции следующей строки редактируемого файла. Для изменения значений выходного указателя по строке, порядка выбора контекстов поиска из таблицы контекстов или чтения строки редактирования из входного файла, следует воспользоваться соответствующими операциями возврата функции BlockOper (brk, setln, setst, setcn).

1. Функция BlockOper

Функция обеспечивает два вида работ:

1. Доступ к строкам блока редактирования и их преобразование;

2. Управление порядком чтения строк из входного файла, установка новой позиции доступа по входной строке и по Таблице контекстов;

1. В функции определены семь параметров:

BlockOper (<операция>,<блок чтения>,<блок записи>,
<диапазон строк чтения>,<диапазон строк записи>,
<признак записи блока в файл>,
<признак игнорирования пустых строк блока>)

2. В функции определены два основных параметра:

BlockOper (<операция>,,,<позиция установки>)

<операция>:

1.
save	-	сохранение строк блока редактирования (блок чтения) в ячейке общего архива (блок записи);
repl	-	замена строк в блоке записи на блок чтения;
insb	-	вставка строк блока чтения перед строками блока записи;
inse	-	вставка строк блока чтения после строк блока записи;
del	-	удаление строк блока редактирования (по умолчанию удаляется весь блок);
add	-	добавление строк в блок редактирования (строки добавления определяются параметром блока чтения);
coll	-	слияние строк блока редактирования (по умолчанию сливается весь блок);
2.
brk	-	прерывание поиска контекстов по файлу редактирования после того, как найден блок редактирования, в котором находится контекст замены (строка после выполнения редакции заносится в выходной файл); например, BlockOper(brk) ;
brkbl	-	прерывание рекурсии текущего блока и установка курсора на ячейку таблицы, стоящую за строкой входа в итерационный цикл по операции retb, а если такой ячейки таблицы нет, то на начало таблицы контекстов (принудительно изменить установку курсора можно операцией setcn); например, BlockOper(brkbl,,,11);
reted	-	переход по таблице контекстов из текущего блокового контекста на блоковый контекст, номер которого указан в четвертом параметре блоковой функции; на вход вызываемому блоковому контексту подаётся входная строка, к началу которой добавлены все строки, содержащиеся в блоке редактирования, возврат из нового блокового контекста производится на следующую ячейку таблицы основного блокового контекста; например, BlockOper(reted,,,3);
retbl	-	рекурсия по текущему блоковому контексту таблицы контекстов, номер которого указывается в параметре, причём на вход подаётся строка, отредактированная на прошлом шаге итерации (эта строка берётся из блока редактирования); например, BlockOper(retbl,,,5);
setln	-	позиция указателя по входному файлу: -сдвиг от текущего значения при чтении очередной строки исходного файла редактирования на n (n>=1) строк вверх (по умолчанию на одну строку вверх); -сдвиг строки чтения на число строк в блоке редактирования (при n= #), т.е. к началу текущей входной строки добавляются все строки из блока редактирования; например, BlockOper(setln,,,2), BlockOper(setln,,,#);
setst	-	позиция указателя для найденного контекста: -установка указателя на n-ю позицию строки (для n без знака); -сдвиг указателя по строке файла редактирования на n символов от конца найденного контекста поиска (при -n к началу строки, при +n к концу строки, при n=-0 сдвиг на начало строки, при n=+0 за пределы строки); -игнорирование найденного контекста при n=0 (по умолчанию), в этом случае контекст считается ненайденным и курсор не изменяет своего значения;
setcn	-	позиция указателя по таблице контекстов: -установка указателя на n-ю (n>=1) ячейку таблицы контекстов; -сдвиг указателя по таблице контекстов n ячеек от текущего значения (при -n к началу таблицы, при +n к концу таблицы); -сохранение указателя по таблице для следующего шага редактирования при n=0 (по умолчанию); -установка указателя на ячейку таблицы контекстов для "нестандартного" возврата из блока редактирования nblk, если он был вызван из другого блока редактирования оператором BlockOper(reted,,,nblk); стандартно возврат из блока производится на ячейку, следующую за оператором вызова, а для изменения этого порядка следующим параметром после setcn необходимо указать параметр return и этот оператор должен находиться в конечной конструкции '%$' блока редактирования nblk; например, BlockOper(setcn), BlockOper(setcn,,,+5), BlockOper(setcn,return,,-4);

<блок чтения> или <блок записи>:

{10}	-	блок редактирования (10 - стандартный номер);
{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n]	-	системная переменная (n=1,2,3…);
" … "	-	явно заданный контекст чтения (если содержит пробел, запятую, закрывающие круглую или квадратную скобку, то заключается в двойные кавычки);

<диапазон строк чтения> или <диапазон строк записи>:

n	-	номер строки блока чтения или записи (при отрицательном значении номера отсчет строк идет от конечной строки блока: -1 – последняя, -2 – предпоследняя и т.д.);
n1..n2	-	диапазон строк блока чтения или записи (значение по умолчанию 1..-1 );.
fname	-	системное или полное имя файла с лексемами, которые являются диапазонами строк блока чтения или записи (системные файловые имена: sysfile, sysfile1, sysfile2);

<признак записи блока в файл> - если задано true, то результат выполнения блоковой функции заносится в выходной файл редактирования, начиная со следующей позиции после конечного строкового указателя и без коррекции этого указателя; если задано true1, то производится аналогичная запись с коррекцией конечного указателя; если задано false (значение по умолчанию), то запись блока в файл не производится;

Замечание: Если блок редактирования записывается в файл и его последняя строка совпадает с входной строкой {0}, отредактированной на момент записи блока, то запись этой входной строки в файл в дальнейшем не происходит;

<признак игнорирования пустых строк блока> - если задано true, то пустые строки блока редактирования при записи в выходной файл редактирования игнорируются, если задано false (значение по умолчанию), то пустые строки сохраняются при записи в файл;

<позиция установки>:

n, -n, +n	-	целое число без знака или со знаком;
#	-	спецзначение;
sysvar[n], {{n}}, {n}	-	системный объект (n=1,2,3…), содержащий допустимое значение.

Примеры обращения к функции:

BlockOper(save,{10},{{1}})	-	сохранение блока редактирования в первой ячейке общего архива;
BlockOper(del,{10},0,1..-2)	-	удаление из общего блока диапазона строк от первой до предпоследней;
BlockOper(setln)	-	возврат на одну строку чтения вверх по входному файлу редактирования;
BlockOper(setcn,0,0,11)	-	дальнейший поиск контекста по входной строке начнется с 11-й ячейки таблицы контекстов;
BlockOper(repl,{10},{10},,,True)	-	запись блока редактирования (после его изменения) в выходной файл;
BlockOper(insb,{{1}},{10},0,&1|sysfile )	-	вставка перед строкой блока редактирования, определяемой первой лексемой системного файла sysfile, содержимого первой ячейки общего архива;
BlockOper(retbl,,,20)	-	рекурсия по текущему блоку редактирования с номером 20.

2. Функция BlockConv

Функция BlockConv осуществляет различные преобразования символов входной строки, заданной в блоке чтения. В функции определены шесть параметров:

BlockConv (<блок чтения>,<диапазон строк>,<диапазон символов в строке>,

<режим языка перевода>,<режим регистра перевода>,

<признак записи блока в файл>)

<блок чтения>:

{10}	-	блок редактирования (10 - стандартный номер);
{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n]	-	системная переменная (n=1,2,3…);

<диапазон строк>:

n	-	номер строки блока чтения (при отрицательном значении номера отсчет строк идет от конечной строки блока: -1 – последняя, -2 – предпоследняя и т.д.);
n1..n2	-	диапазон строк блока чтения (значение по умолчанию 1..-1 );

<диапазон символов в строке>:

n	-	номер символа в строке блока чтения (при отрицательном значении номера отсчет символов идет от длины строки блока: -1 – последний, -2 – предпоследний и т.д.);
n1..n2	-	диапазон символов в строке блока чтения;
fname	-	системное или полное имя файла со строками, состоящими из лексем: номер строки блока чтения, номер символа начала диапазона, номер символа конца диапазона (системные файловые имена: sysfile, sysfile1, sysfile2);

<режим языка перевода>:

en	-	перекодирование символов строки на латинский регистр;
ru	-	перекодирование символов строки на русский регистр;
eneq	-	перекодирование символов строки с одинаковым написанием букв с русского на латинский регистр;
rueq	-	перекодирование символов строки с одинаковым написанием букв с латинского на русский регистр;
doswin	-	перекодирование символов строки из dos в win1251;
windos	-	перекодирование символов строки из win1251 в dos;
koiwin	-	перекодирование символов строки из koi8-r в win1251;
winkoi	-	перекодирование символов строки из win1251 в koi8-r;

<режим регистра перевода>:

up	-	перекодирование символов строки на верхний регистр;
dn	-	перекодирование символов строки на нижний регистр;

<признак записи блока в файл> - если задано true, то после выполнения блоковой функции блок редактирования записывается в выходной файл редактирования, если задано false (значение по умолчанию), то запись блока в файл не происходит.

Примеры обращения к функции:

BlockConv({10},0,sysfile,rueq,dn,true)	-	перевод символов строк блока (указываются в системном файле sysfile), совпадающих по написанию (ABEKMHOPCTXY), с латинского на русский, а также на нижний регистр; ключ true указывает на то, что после перекодировки блок записывается в выходной файл;
BlockConv({10},0,sysfile1,eneq,dn)	-	перевод символов строк блока (указываются в системном файле sysfile1), совпадающих по написанию (АВЕКМНОРСТХУ), с русского на латинский, а также на нижний регистр;
BlockConv(sysvar2,0,0,doswin)	-	перевод из dos в win1251 символов строки, находящейся в системной переменной sysvar2.

3. Функция BlockEdit

Функция BlockEdit предназначена для создания рабочих файлов, в которых записываются определенные характеристики найденных контекстов в блоке редактирования. Эти файлы в дальнейшем могут использоваться как параметры в других блоковых функциях. В функции может быть два, три и более параметров:

BlockEdit (<операция>,<имя выходного файла>,

<диапазон контекста>, … <диапазон контекста>)

<операция>:

selcn	-	выборка заданных в качестве параметров функции диапазонов контекста и запись их в создаваемый файл в виде строк: <номер строки блока> <начало диапазона контекста> <конец диапазона контекста>;
selsp	-	создание файла с диапазоном min и max номеров строк блока, содержащих найденный в блоке контекст, т.е. файл будет содержать строку вида: <min номер строки> <max номер строки>;
selln	-	создание файла с перечнем номеров строк блока, содержащих контекст, т.е. файл будет содержать строку вида: <номер строки блока> <номер строки блока> … <номер строки блока>;
	-	создание нового выходного файла с заданным именем.

<имя выходного файла> - системное или полное имя выходного файла (системные файловые имена: sysfile, sysfile1, sysfile2).

Примеры обращения к функции:

Контекст поиска:	Контекст замены:	Комментарий:
|4|{Пример:}	#[BlockEdit(selln,sysfile2)]	номера строк блока с найденным контекстом Пример: будут записаны в рабочий файл sysfile2 ;
|3|{[A-Z0-9]*}	#[BlockEdit(selcn,sysfile1, _{1}..{1}_)]	при нахождении в строке блока данного контекста, третий параметр функции будет заменен значениями начала и конца диапазона найденного контекста, а при выполнении блоковой функции эти значения будут записаны в рабочий файл sysfile1 ;
|2|{%@*}	#[BlockEdit(selsp,d:\rf.txt)]	при работе блоковой функции сформируется рабочий файл d:\rf.txt, в котором будет находиться строка с диапазоном номеров строк блока, где встречаются строки, начинающиеся с символа *;
	#[BlockEdit(crtfl,sysfile)]	создание нового выходного файла с системным именем sysfile .

4. Функция BlockFile

Функция BlockFile дает возможность работать во время редактирования входного файла с другим внешним файлом, при этом поиск информации по файлу происходит путем задания начального и конечного контекстов поиска. В функции определены двенадцать параметров:

BlockFile (<операция>,<блок чтения>,<блок записи>,

<начальный контекст чтения>,<конечный контекст чтения>,

<начальный контекст записи>,<конечный контекст записи>,

<признак записи блока в файл>,

<признак позиционного/блокового контекста чтения>,

<признак позиционного/блокового контекста записи>,

<признак учета регистра при поиске контекста>,

<диапазон строк блока чтения>)

<операция>:

extr	-	чтение контекста из внешнего файла и занесение его в блок записи;
repl	-	замена контекста во внешнем файле из блока чтения в зависимости от позиционного или блокового признака;
insb	-	вставка контекста перед контекстом или строкой в зависимости от позиционного или блокового признака из блока чтения во внешний файл;
inse	-	вставка контекста после контекста или строки в зависимости от позиционного или блокового признака из блока чтения во внешний файл;
svarh	-	сохранение общего архива в файле записи;
ldarh	-	загрузка общего архива из файла чтения;
svllist	-	сохранение левого списка в файле записи;
ldllist	-	загрузка левого списка из файла чтения;
svrlist	-	сохранение правого списка в файле записи;
ldrlist	-	загрузка правого списка из файла чтения;

<блок чтения> или < блок записи>:

{10}	-	блок редактирования (10 - стандартный номер);
{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n]	-	системная переменная (n=1,2,3…) без подстановки её значений;
"sysvar[n]"	-	системная переменная (n=1,2,3…) с подстановкой её значений;
fname	-	полное имя внешнего файла (с путём доступа <имя диска>:\… ); может образоваться также путем подстановки системной переменной в конструкцию "sysvar[n]" при обязательном присутствии двойных кавычек;
LeftList:n RightList:n	-	файл берётся из ячейки n левого/правого списка; если n=-1, то текущий номер ячейки списка соответствует номеру редактируемого файла (например, при редактировании по правому списку – номер ячейки левого списка соответствует номеру ячейки правого списка с именем редактируемого файла);
FileRes	-	символическое имя файла, указывающее на то, что имя внешнего файла определяется заданным в данный момент именем выходного файла.

Замечание. Наличие внешнего файла в одном из блоков чтения или записи обязательно для данной блоковой функции.

<начальный контекст…> или <конечный контекст…> - параметр, являющийся контекстом поиска в файле или блоке редактирования (для системной переменной игнорируется), который обязан заключаться в двойные кавычки, если содержит следующие служебные символы: пробел, , , " , ) , ] , > , :: , || , ; . Контекст может также содержать спецсимволы, используемые в таблице контекстов. Если контекст не задан, то по умолчанию его значение устанавливается равным @, это означает, что начальный контекст совпадает с началом файла, а конечный контекст - с концом файла. Если конечный контекст представляет собой пустые двойные кавычки "" , то он совпадает с начальным контекстом. Допускается задание в параметре альтернативного контекста. В этом случае контексты, заключенные в двойные кавычки, отделяются друг от друга спецсимволом :: , а при поиске перебираются все допустимые сочетания заданных начального и конечного контекстов (например задание параметров "int func(" :: "real func(" , ")" означают, что будет искаться вхождение одной из конструкций: int func( … ) или real func( … ) .

<признак записи блока в файл> - если задано true, то после выполнения блоковой функции блок редактирования записывается в выходной файл редактирования, если задано false (значение по умолчанию), то записи блока в файл не происходит.

<признак позиционного/блокового контекста> - если задано true (значение умолчанию), то контекст является позиционным и точно соответствует своими границами началу и концу контекстов, заданным в параметрах, если задано false,то контекст является блоковым и соответствует своими границами номерам строк, в которых были найдены начало и конец контекста.

<признак учета регистра при поиске контекста> - если задано true (значение по умолчанию), то регистр учитывается, если задано false, то регистр не учитывается.

<диапазон строк блока чтения>:

n	-	номер строки блока чтения (при отрицательном значении номера отсчет строк идет от конечной строки блока: -1 – последняя, -2 – предпоследняя и т.д.);
n1..n2	-	диапазон строк блока чтения (значение по умолчанию 1..-1 );

Замечание. Для системной переменной диапазон игнорируется.

Примеры обращения к функции:

BlockFile(extr,sysRcond,{10},"int {{2}}"::"real {{2}}",")", "subroutine",")")	-	выделение контекста из внешнего файла, имя которого содержится в sysRcond (вычисленная правая часть условного выражения из блока редактирования), причем контекст поиска является альтернативным (‘от int до )’ или от ‘real до )’), и замена на него в блоке контекста от subroutine до );
BlockFile(extr,d:\zorg\pass.txt, {10},"?*","", "Cum","",,,,,3)	-	третью строку из внешнего файла pass.txt (строка выбирается по контексту поиска "?*") вставить вместо контекста "Cum" в блоке редактирования;
BlockFile(extr,"sysvar",sysvar1, %procedure,%\0d\0a,,,,false)	-	поиск контекста - фрагмента, начинающейся со строки procedure… и заканчивающегося пустой строкой в файле, полное имя которого определяется через переменную sysvar, и записью найденного фрагмента в переменную sysvar1;
BlockFile(repl,{{2}},d:\fn.txt, 0,0,""{{1}}"","")	-	содержимое второй ячейки общего архива замещает контекст во внешнем файле с именем d:\fn.txt, заменяемый контекст определяется содержимым первой ячейки общего архива с добавлением конечного пробела;
BlockFile(svarh,,RightList:-1)	-	сохранение общего архива в файле, указанном в текущей ячейке правого списка;
BlockFile(ldarh,RightList:-1)	-	загрузка общего архива из файла, указанного в текущей ячейке правого списка.

5. Функция BlockRepl

Функция BlockRepl дает возможность выполнить контекст замены в групповом операторе. Это бывает необходимо, если надо выполнить для найденного контекста несколько действий подряд. В функции определен один параметр:

BlockRepl (<контекст замены>)

<контекст замены> - параметр, являющийся контекстом замены найденного контекста поиска, который обязан заключаться в двойные кавычки, если содержит пробел, двойные кавычки в качестве граничного символа контекста, запятую, закрывающие круглую или квадратную скобку; контекст может также содержать спецсимволы, используемые в таблице контекстов.

Примеры обращения к функции:

Контекст поиска:	Контекст замены:	Комментарий:
|1|{%/@*}	#["true"//{{3}}; BlockRepl(%)]	признак разбора блока комментария по символам /* в начале строки: в ячейку архива с номером 3 заносится признак true , после чего входная строка уничтожается;
|1|{%@*/}	#[""//{{3}}; BlockRepl(%)]	снятие признака разбора блока комментария по признаку */ в конце строки: ячейка архива с номером 3 очищается (снятие признака), после чего входная строка уничтожается.
{%//?*}	#[BlockRepl(""""); BlockOper(setcn,0,0,11)]	игнорирование записи строки в выходной файл и задание начального номера выборки запросов по таблице контекстов.

6. Функция BlockLexm

Функция BlockLexm предназначена для работы с лексемами строки, причем понимая под лексемой не только последовательности символов, разделенные пробелом (классическое представление), но также допуская в качестве разделителя произвольные наборы символов. Если лексема содержит внутри себя разделитель, то она должна быть заключена в двойные кавычки. Фактически эта функция может быть использована для реализации аппарата работы со списками, располагающимися, например, в отдельной ячейке общего архива или системной переменной, и позволяет рассматривать эти списки как аналог стеков. В функции определены семь параметров:

BlockLexm (<операция>,<строка чтения>,<строка записи>,

<контекст вставки/замены/удаления>,<номер начальной лексемы>,

<номер конечной лексемы>,<разделитель лексем>)

<операция>:

addlex	-	добавление лексемы в конец строки чтения (пробел-разделитель в конце строки-списка сохраняется, если он был в исходной строке);
addchklex	-	добавление лексемы в конец строки чтения, если её в строке нет (пробел-разделитель в конце строки-списка сохраняется, если он был в исходной строке);
artlex	-	подсчет числа лексем в строке чтения (0, если лексем нет), результат в строке записи;
dellex	-	удаление заданных лексем из строки чтения;
delpatlex	-	удаление лексем из строки чтения по шаблону;
inslex	-	вставка лексем в строку чтения перед заданной;
rpllex	-	замена лексем в строке чтения в заданном диапазоне;
getlex	-	получение лексем заданного диапазона из строки чтения;
dlmlex	-	замена разделителя лексем в строке чтения;

<строка чтения> или < контекст вставки/замены>:

{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n]	-	системная переменная (n=1,2,3…);
" … "	-	явно заданный контекст чтения (если содержит пробел, запятую, закрывающие круглую или квадратную скобку, то заключается в двойные кавычки);

<строка записи>:

{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n]	-	системная переменная (n=1,2,3…);

<номер начальной лексемы> или <номер конечной лексемы>:

целое число, заданное явно или получаемое в результате подстановки и вычисления группового выражения; по умолчанию – первая и последняя (-1) лексемы строки чтения (отрицательное число задаёт отсчет лексем от конца строки);

<разделитель лексем>:

произвольный контекст, по умолчанию – пробел; разделитель в виде двойного пробела " ", указывает на то, что контекст вставки/замены, содержащий пробелы, рассматривается как строка, состоящая из нескольких лексем, разделённых пробелом, в противном случае контекст вставки/замены всегда представляется как одна лексема.

Примеры обращения к функции:

BlockLexm(addlex,{{11}},,"a b c" , , ," " )	-	добавление в 11-ю ячейку общего архива трёх лексем "a", "b" и "c", поскольку в качестве разделителя задан двойной пробел;
BlockLexm(artlex,{{3}},sysvar3, , , , ",")	-	подсчёт числа лексем с разделителем "," в третьей ячейке архива и занесение результата в sysvar3;
BlockLexm(getlex,sysvar,sysvar1, , sysvar2|-1''-1, sysvar2|-1''-1)	-	выборка лексемы из переменной sysvar по номеру, хранящемуся в последней лексеме переменной sysvar2, и помещение результата в переменную sysvar1;
BlockLexm(rpllex,{{sysvar}},{{sysvar}},sysvar1 & sysvar2,r*,r*)	-	замена лексемы с номером r* (значение циклического поиска в условном блоковом контексте) в ячейке архива с номером sysvar на конструкцию, получаемую в результате подстановки значений переменных в выражение: sysvar1 & sysvar2.

7. Функция BlockFind

Функция BlockFind предназначена для получения определённой информации, касающейся входной строки. В функции определены шесть параметров:

BlockFind (<операция>,<строка чтения>,<строка записи>,

<контекст шаблона>,<признак учета регистра>),

<позиция найденного контекста);

<операция>:

postxt	-		нахождение начальной позиции вхождения простого контекста шаблона в строку чтения (0, если вхождения нет);
posetxt	-		нахождение позиции последнего вхождения символа-шаблона в строку чтения (0, если вхождения нет);
lngtxt	-		длина строки чтения в байтах;
contxt	-		поиск контекста (простого или с использованием спецсимволов) в строке чтения; найденный контекст помещается в строку записи, а номер позиции начала контекста в переменную для позиции найденного контекста (-1, если контекст не найден);
countxt		-		число вхождений контекста в строку чтения, результат в строке записи;
latstx		-		контроль текста из строки чтения на латинице, результат помещается в строку записи (если буквы только латинские - True, иначе - False);

<строка чтения> или < контекст шаблона>:

{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n]	-	системная переменная (n=1,2,3…);
" … "	-	явно заданный контекст чтения (если содержит пробел, запятую, закрывающие круглую или квадратную скобку, то заключается в двойные кавычки);
{n}	-	контекст группы ( 1<=n<=9 );

<строка записи>:

{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n]	-	системная переменная (n=1,2,3…);

<контекст шаблона> - может задаваться через переменную или непосредственно в виде текстовой строки в двойных кавычках;

<признак учета регистра> - если задано true (значение по умолчанию), то регистр учитывается, если задано false, то регистр не учитывается;

<позиция найденного контекста> - номер позиции найденного контекста во входной строке для операции contxt.

Примеры обращения к функции:

BlockFind(postxt,{{11}},sysvar ,". " )	-	нахождение позиции вхождения в 11-ю ячейку общего архива шаблона "." и занесение номера позиции в переменную sysvar ;
BlockFind(lngtxt,sysvar3,sysvar)	-	подсчёт длины переменной sysvar3 и занесение результата в sysvar.
BlockFind(contxt,sysvar,sysvar1,{[A-Z][A-Z0-9]*},false,sysvar2)	-	нахождение в переменной sysvar идентификатора (по заданному контексту поиска, без учета регистра) и занесение найденного контекста в sysvar1, а номер позиции начала контекста в sysvar2 ;

8. Функция BlockEval

Функция BlockEval предназначена для вычисления арифметического выражения, если оно найдено в поданной на вход строке и замене этого выражения на его значение. В функции определены два параметра:

BlockEval (<строка чтения>,<строка записи>)

<строка чтения> :

{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n]	-	системная переменная (n=1,2,3…);
" … "	-	явно заданный контекст чтения (если содержит пробел, запятую, закрывающие круглую или квадратную скобку, то заключается в двойные кавычки);

<строка записи>:

{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n]	-	системная переменная (n=1,2,3…);

Примеры обращения к функции:

	-	нахождение позиции вхождения в 11-ю ячейку общего архива шаблона "." и занесение номера позиции в переменную sysvar ;
BlockFind(lngtxt,sysvar3,sysvar)	-	подсчёт длины переменной sysvar3 и занесение результата в sysvar.

9. Функция BlockInfo

Функция BlockInfo предназначена для выдачи информационной строки в диалоговое окно редактора TeConv. В функции определены три параметра:

BlockInfo (<информационная строка>,<параметр выдачи>,<признак выдачи>)

<информационная строка> - строка текстовых символов;

<параметр выдачи>:

0

-

выдача сообщения в StatusBar страничного блока и открытого диалогового окна "Управление редактированием" редактора TeConv (по умолчанию);

<признак выдачи> - если задано true, то информационная строка добавляется в строку сообщения в виде комментария, заключенного в фигурные скобки, если задано false (значение по умолчанию), то выдаётся новая строка сообщения.

Пример обращения к функции:

BlockInfo(“комплексная арифметика”,,True )	-	добавление комментария {комплексная арифметика} в StatusBar;
BlockInfo("",,True )	-	снятие комментария.

10. Функция BlockList

Функция BlockList предназначена для работы с системными списками, доступ к элементам которых осуществляется по индексу. Использование системных списков вместо системных переменных в качестве стеков или для хранения информационных списков в табличных контекстах сложных контекстных преобразований намного сокращает время их обработки. В функции определены пять параметров:

BlockList (<операция>,<блок чтения>,<блок записи>,
<индекс списка>,<разделитель лексем>)

<операция>:

ladd	-	добавление в системный список блока записи строки из блока чтения;
lins	-	вставка перед заданным индексом в системный список блока записи строки из блока чтения;
ldel	-	удаление строки из системного списка блока чтения по заданному индексу;
lclear	-	очистка строк системного блока чтения;
lcount	-	размер (число строк) системного блока чтения;
lgetstr	-	получение строки с заданным индексом из системного списка блока чтения в блоке записи (переменной или архиве);
lsetstr	-	занесение строки из блока чтения (переменной или архива) в строку системного списка с заданным индексом блока записи;
rdtext	-	получение строк системного списка блока чтения в виде текстовой строки с разделителями EOLN в блоке записи (переменной или архиве);
adtext	-	занесение строки из блока чтения без замены содержащихся в тексте конструкций подстановки (из переменной или архива) в строку системного списка блока записи с заданным индексом блока записи;
ldtext	-	загрузка системного списка блока записи лексемами с разделителем EOLN из блока чтения без замены содержащихся в тексте конструкций подстановки (из переменной или архива);
ldlexm	-	загрузка системного списка блока записи лексемами с заданным разделителем (пустой разделитель - """" ) из блока чтения (переменная или архив);
svlexm	-	выгрузка системного списка блока чтения в виде лексем с заданным разделителем в блок записи (переменную или архив);
ldfile	-	загрузка системного списка блока записи строками файла, полное имя которого задано в блоке чтения;
svfile	-	выгрузка системного списка блока чтения в файл, полное имя которого задано в блоке записи;
lcopy	-	копирование системных списков;

<блок чтения> или <блок записи>:

{10}	-	блок редактирования (10 - стандартный номер);
{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n]	-	системная переменная (n=1,2,3…);
syslist[n]	-	системный список (n=1,2,3…);
" … "	-	явно заданный контекст чтения (обязательно заключается в двойные кавычки, если содержит пробел, запятую, двойные кавычки, закрывающие круглую или квадратную скобку);
fname	-	полное имя файла;

<индекс списка>:

целое число (n>=1), которое не должно превышать размер списка;

<разделитель лексем>:

произвольный контекст (по умолчанию - пробел); разделитель в виде двойного пробела " ", указывает на то, что контекст, содержит лексемы, заключенные в двойные кавычки и содержащие внутри себя пробелы-разделители (например, контекст, состоящий из трех лексем: "a b c" "a1 b1" c1), либо определяет контекст вида ( a b c ) как одну лексему.

Примеры обращения к функции:

BlockList(ldlexm,syslist2,sysvar2)	-	загрузка системного списка syslist2 из системной переменной sysvar2;
BlockList(ldel,syslist2,,sysvar10)	-	удаление из системного списка syslist2, строки с индексом, содержащимся в sysvar10;
BlockList(ladd, ""a b c" "a1 b1" c1",syslist,, " ")		добавление в список syslist строки из трех лексем.

11. Функция BlockForm

Функция BlockForm предназначена для форматирования строки в рамках заданного поля шаблона. Поле шаблона - это строка заданной длины, образованная повторением символа поля шаблона, являющаяся основой для позиционирования строки чтения в соответствии с заданной операцией выравнивания и определения строки записи. В функции определены пять параметров:

BlockForm (<операция>,<строка чтения>,<строка записи>,

<длина поля шаблона>,<символ поля шаблона>)

<операция>:

ljust	-	выравнивание строки чтения по левому краю поля шаблона;
rjust	-	выравнивание строки чтения по правому краю поля шаблона;
cjust	-	центрирование строки чтения по полю шаблона;

<строка чтения>:

{10}	-	блок редактирования (10 - стандартный номер);
{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n] sysvar[n]|<диапазон>	-	системная переменная (n=1,2,3…);
" … "	-	явно заданный контекст чтения (если содержит пробел, запятую, закрывающие круглую или квадратную скобку, то заключается в двойные кавычки);

<диапазон>:

n1..n2	-	диапазон символов строки чтения, где n - номер символа в строке (при отрицательном значении номера идет отсчет от конца строки: -1 – последняя, -2 – предпоследняя и т.д.);
n1''n2	-	диапазон лексем строки чтения, где n - номер лексемы в строке (при отрицательном значении номера идет отсчет от конца строки: -1 – последняя, -2 – предпоследняя и т.д.);

<строка записи>:

{10}	-	блок редактирования (10 - стандартный номер);
{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n]	-	системная переменная (n=1,2,3…);

<длина поля шаблона> - целое число (n>=1), определяющее размер строки записи;

<символ поля шаблона> - символ, из которого образовано поле шаблона (по умолчанию - пробел);

Примеры обращения к функции:

BlockForm(сjust,"Комментарий",sysvar1,25)	-	центрирование строки 'Комментарий' по полю шаблона, представляющего строку из 25-ти пробелов (шаблон по умолчанию); результат записывается в системную переменную sysvar1 ;
BlockForm(rjust,{{2}}|1''1,sysvar,6,"0")	-	выравнивание по правому краю строки, являющейся 1-ой лексемой ячейки общего архива {{2}}, по полю шаблона '000000', и запись результата в системную переменную sysvar (например, если выбранная лексема – '125', то выходная строка - '000125' ;

12. Функция BlockNumb

Функция BlockNumb предназначена для перевода целых чисел в различные системы счисления (диапазон основания счисления от 2 до 36). В функции определены четыре параметра:

BlockNumb (<основание входной константы>,<основание выходной

константы>, <константа чтения>,<константа записи>)

<основание входной константы>|<основание выходной константы>|

<константа чтения>:

{n} {n}|<диапазон>	-	групповой контекст с номером группы n=1,2,3,…9;
{{n}} {{n}}|<диапазон>	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n] sysvar[n]|<диапазон>	-	системная переменная (n=1,2,3…);
" … "	-	явно заданная константа;

<диапазон>:

n1..n2	-	диапазон символов строки чтения, где n - номер символа в строке (при отрицательном значении номера идет отсчет от конца строки: -1 – последняя, -2 – предпоследняя и т.д.);
n1''n2	-	диапазон лексем строки чтения, где n - номер лексемы в строке (при отрицательном значении номера идет отсчет от конца строки: -1 – последняя, -2 – предпоследняя и т.д.);

<константа записи>:

{10}	-	блок редактирования (10 - стандартный номер);
{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n]	-	системная переменная (n=1,2,3…);

Пример обращения к функции:

BlockNumb("10",{1},"2011",{{sysvar}})

-

перевод константы '2011' из десятичной системы счисления в систему счисления, определяемую содержимым найденной контекстной группы {1} и запись результата в ячейку общего архива с номером sysvar ;

13. Функция BlockOrfg

Функция BlockOrfg дает возможность создать протокол ошибок, обнаруженных при проверке орфографии текстового файла, отражающий строку файла с ошибочным словом, слово и варианты его замены, ведется также подсчет количества ошибочных слов в файле. В функции определены четыре параметра:

BlockOrfg (<блок чтения>,<блок записи>,<режим записи>,<язык проверки>)

<блок чтения> или <блок записи>:

{{n}}	-	ячейка с номером n=1,2,… из общего архива;
sysvar[n]	-	системная переменная (n=1,2,3…);
fname	-	полное имя внешнего файла с путём доступа <имя диска>:\…; имя файла может образоваться также путем подстановки системной переменной в конструкцию "sysvar[n]" при обязательном присутствии двойных кавычек;
LeftList:n или RightList:n	-	файл берётся из ячейки n левого или правого списка; если n=-1, то текущий номер ячейки списка соответствует номеру редактируемого файла (например, при редактировании по правому списку – номер ячейки левого списка соответствует номеру ячейки правого списка с именем редактируемого файла);
замечание:		блоки чтения и записи при подстановке должны содержать полное имя файла с контрольным текстом и с протоколом соответственно; блок чтения может отсутствовать, тогда имя файла проверки совпадает с текущим файлом редактирования, а блок записи должен быть задан всегда;

<режим записи> - режим записи в протокол:

new - для создания нового файла протокола,

add - для добавления в файл протокола;

<язык проверки> - язык проверки орфографии:

ru - для проверки русского текста,

en - для проверки английского текста.

Пример обращения к функции:

BlockOrfg(,D:\RA\protorf.txt,add,ru)

-

проверка орфографии русского текста (ru) с добавлением (add) найденных ошибок в файл протокола D:\RA\protorf.txt;

Аппарат подстановок в контекстах и сценариях

Источники и виды подстановок

Перед выполнением группового оператора сначала производится подстановка значений в групповой или системный операнды, а также значений в переменные выполнения условия. Кроме этого в подстановках могут быть использованы списки и файлы. Таким образом, различного вида информация может быть получена и использована в процессе редактирования, что позволяет задавать в контекстах поиска/замены сложные виды контрольных проверок и преобразований. Аналогичные подстановки производятся и при анализе параметров блоковой функции перед её реализацией.

Источники подстановок:

- группа: {n} (n=1,…,9) ;

- блок редактирования: {10} ;

- входная строка: {0} ;

- системная переменная:sysvar[n] (n>=1) ;

- системный список: syslist[n] (n>=1);

- ячейка общего архива: {{n}} (n>=1);

- переменные выполнения условия: SysLloop, SysRloop, SysNcond, SysLiter,

SysRiter, SysLval, SysRval, r*, R*, l*, L*;

- правый и левый список: RightList[:n], LefttList[:n] (n>=-1);

- системный файл: sysfile[n] (n=1,2);

- внешний файл с полным путем доступа;

Выборка информации из исходных конструкций подстановки может определяться заданием соответствующих диапазонов строк, символов или лексем:

s0..s1 - диапазон строк , где s0 - номер начальной строки выборки,

s1 - номер конечной строки выборки;

d0..d1 - диапазон символов, где d0 - номер начального символа выборки,

d1 - номер конечного символа выборки;

d0''d1 - диапазон лексем, где d0 - номер начальной лексемы выборки,

d1 - номер конечной лексемы выборки;

Замечание: последний элемент выборки может быть задан как -1, предпоследний как -2 и т.д.

При выборе диапазона могут использоваться служебные символы-модификаторы:

<модификатор диапазона> -

.. байтовый диапазон строки | строковый диапазон блока

'' диапазон лексем строки

~ удаление пробелов левой или правой границы диапазона

non признак непустой строки диапазона блока

_{…} номер начального байта контекста группы по строке

{…}_ номер конечного байта контекста группы по строке

При занесении однотипной информации сразу во все созданные на данный момент ячейки общего архива в групповом выражении может использоваться конструкция {{*}} в качестве места замены. Например, чтобы очистить все ячейки архива следует написать оператор: ""//{{*}}

Особый вид подстановок может использоваться в сценарии. Эти подстановки связаны с реализацией цикла в сценарии и основываются на последовательных строках файла, содержащих информацию, считываемую для использования в текущей итерации цикла (см. раздел "Приемы создания сложных сценариев"). Признаком конструкции подстановки в сценарии является символ ‘&’ .

Конструкции подстановок

{n} {n}|d0..d1 {n}|d0''d1	-	по номеру группы (n=1,…,9), найденной в процессе контекстного поиска по входной строке файла, берется текстовое значение контекста и при необходимости из него выделяется диапазон символов от d0 до d1 (разделитель - две точки) или лексемы от d0 до d1 (разделитель – два апострофа);
{{n}} {{n}}|d0..d1 {n}|d0''d1	-	по номеру ячейки общего архива (n>=1) берется текстовое значение контекста и при необходимости из него выделяется диапазон символов от d0 до d1 (разделитель - две точки) или лексемы от d0 до d1 (разделитель - два апострофа);
{n}|~d0..d1 {n}|d0..d1~ {n}|~d0..d1~	-	из контекста, соответствующего номеру группы (n=1,…,9), выделяется диапазон символов от d0 до d1, при этом из него удаляются начальные, конечные или обрамляющие пробелы;
{{n}}|~d0..d1 {{n}}|d0..d1~ {{n}}|~d0..d1~	-	из контекста, соответствующего номеру ячейки общего архива (n>=1), выделяется диапазон символов от d0 до d1, потом из него удаляются начальные, конечные или обрамляющие пробелы; например, “__bbcc”|~1..-1 (здесь __ заменяет для наглядности два пробела) соответствует выборке подстроки “bbcc”, а при “__bbcc”|1..-1 выбирается вся строка с начальными пробелами;
{{n}}|nond0..d1 {{n}}|d0..d1non {{n}}|nond0..d1non	-	из строки сначала удаляются начальные, конечные или обрамляющие пробелы, и из полученной строки выделяется диапазон символов от d0 до d1; например, “__bbcc”|non1..1 (здесь __ заменяет для наглядности два пробела) соответствует выборке символа b, а при “__bbcc”|1..1 выбирается первый пробел;
_{n} {n}_	-	по номеру группы (n=1,…,9), найденной в процессе контекстного поиска по входной строке файла, определяется номер начального или конечного символа контекста группы в строке; такая конструкция может быть использована в задании границ диапазона (например, _{2}+1..{2}_);
_{n}|non {n}_|non	-	номер начального или конечного непустого байта для найденного контекста группы в строке; например, контекст поиска первой группы { *b+} в строке “aa__bbcc” (здесь __ заменяет для наглядности два пробела) имеет диапазон символов в строке 3..6 , т.е. _{1} равно 3, а при использовании модификатора _{1}|non равно 5;
{10}|s0..s1 {10}|nons0..s1non	-	из блока редактирования выбирается диапазон строк от s0 до s1; признак non указывает на то, что пустые граничные строки диапазона игнорируются, т.е. происходит сужение диапазона выборки строк;
{10}|s0..s0|d0..d1 {10}|nons0..s0|d0..d1 {10}|s0..s0non|d0..d1 {10}|~s0..s0~|d0..d1	-	из блока редактирования выбирается строка с номером s0, из которой далее выделяется диапазон символов от d0 до d1; признак non указывает на непустую строку выборки при движении вниз или вверх по блоку от заданной строки, если она пустая, а признак ~ обеспечивает удаление граничных пробелов в выбранной строке (например, последний символ предыдущей непустой строки редактирования, исключая пробел: {10}|non-1..-1~|-1..-1);
{10}_ syslist[n]_ sysvar[n]_	-	длина (число строк) блока редактирования; длина (число строк) системного списка; длина строки системной переменной;
&n|m|d:\rab\fn.txt &n|d:\rab\fn.txt &n|m|sysfile &n|sysfile	-	из строки файла с номером m (если номер не задан, то из первой строки) с указанным полным или системным (sysfile, sysfile1, sysfile2) именем выбирается лексема с номером n, при этом строка файла должна состоять из лексем, разделенных одним или несколькими пробелами; например, такая конструкция может быть использована в задании границ диапазона &1|sysfile ..&2|sysfile -1 ;
&n &n|m	-	из строки файла, образующего цикл сценария с номером m (m>=1), выбирается лексема с номером n, при этом строка файла должна содержать не менее n лексем, разделенных одним или несколькими пробелами; при n=0 берётся номер итерации текущего цикла сценария; если номер m файла не задан, то для подстановки берется файл текущего внутреннего цикла сценария;
&n|LeftList:m &n|RightList:m	-	из файла, имя которого берётся из m-ой ячейки левого или правого списка выбирается лексема с номером n; если m=-1, то текущий номер ячейки списка соответствует номеру редактируемого по списку файла (например, &2|RightList:-1); при n=0 берётся номер итерации текущего цикла по списку;
sysvar[n]|d0..d1 sysvar[n]|d0''d1	-	выделение диапазона из системной переменной с номером n (n>=1); можно применять все модификаторы диапазона;
sysvar&sysvar[n]	-	подстановка целого значения из системной переменной sysvar[n] как номер другой системной переменной;
syslist&sysvar[n]	-	подстановка целого значения из системной переменной sysvar[n] как номер системного списка;

Конструкции подстановок с использованием диапазонов, имен файлов, начинающиеся с символа '&', обязательно должны завершаться символом пробел. Значениями диапазонов d0 и d1 могут быть целые числа больше или меньше 0, а также групповые выражения, вычисленными значениями которых являются числа, при этом запись диапазона любого вида внутри себя не должна содержать пробелов (например для выделения символа, следующего за найденным контекстом группы, {1}|-1+1..-1+1 ).

Отрицательное значение (номер последнего байта или лексемы) определяет границу диапазона от конца аргумента, к которому относится этот диапазон. Граница диапазона может также являться результатом подстановки целого значения из некоторых исходных конструкций подстановки. Подстановка итерационных значений в диапазон может быть сделана в шаблоне оператора цикла для генерации итерационной строки (ключ i), в этом случае для указания границ диапазона используется конструкция &*..&* или &*''&* .

Например, есть два списка идентификаторов, разделенных пробелами, в ячейках архива {{1}} и {{2}} и необходимо, в случае нахождения в файле идентификатора из списка {{2}}, заменить его на соответствующий по порядку идентификатор из списка {{1}} плюс смещение, находящееся в архивной ячейке {{3}} :

контекст поиска

|[{1}=loop({{2}}|*''*)/a]|{[_A-Za-z][_A-Za-z0-9]*}

содержит условие проверки найденного контекста группы {1} со списком лексем (идентификаторов), находящимся в архивной ячейке {{2}};

контекст замены

#[{{1}}|r*+{{3}}''r*+{{3}}//{1}]

найденный контекст группы {1} заменяется на соответствующую лексему (идентификатор) с учетом смещения {{3}} из списка лексем (идентификаторов), находящегося в архивной ячейке {{1}}.

В цикле создания итерационной строки по заданному шаблону и числу повторов может быть использовано для подстановки текущее значение итерации цикла в виде конструкции '&*'. Например, в переменной sysvar1 находится список "2 11 3" и надо сумму этих чисел записать в переменную sysvar2. Это может быть осуществлено следующими операторами:

loop(sysvar1|&*''&* & "+"#sysvar2)/i; //создание строки в sysvar2: 2+11+3+

sysvar2|1..-2//sysvar2; // коррекция sysvar2: 2+11+3

BlockEval(sysvar2,sysvar2); //результат вычисления в sysvar2: 16

В групповых операторах могут определяться и в дальнейшем использоваться системные переменные: sysvar, sysvar1, sysvar2. Эти переменные могут хранить не только единичные значения, но также списковые в своем внутреннем представлении, что обеспечивает их широкое применение для сокращения времени выполнения неоднократно выполняемых операций в контекстах поиска/замены. Тогда при записи списка из архивной ячейки {{2}} в системную переменную:

#[loop({{2}}|*''*)/a//sysvar]

контекст поиска будет иметь вид:

|[{1}=sysvar]|{[_A-Za-z][_A-Za-z0-9]*}

При занесении определенной информации сразу во все ячейки архива в групповом операторе может использоваться конструкция {{*}}. Например, чтобы очистить все ячейки архива следует написать оператор: ""//{{*}}

Использование конструкций подстановок намного расширяет возможности применения групповых операторов и обеспечивает организацию циклов в сценариях.

СПЕЦИАЛЬНЫЕ АНАЛИТИЧЕСКИЕ СРЕДСТВА

Граничные контексты в таблице контекстов

В многоуровневом сеансе редактирования может возникнуть необходимость в выполнении некоторых действий перед началом или перед завершением определенного этапа редактирования, обусловленного заданным запросом на редактирование (например, занести информацию в некоторые архивные ячейки или системные переменные перед началом или после редактирования). Для выполнения этой цели служат граничные контексты, которые содержат в качестве контекста поиска <!> или <!!>, а необходимые для выполнения действия могут быть заданы через групповые операторы в контексте замены. Эти контексты отличаются своим функциональным назначением:

<!!>	-	граничный контекст, выполняющийся один раз для текущего запроса редактирования, который может включать группу файлов редактирования;
<!>	-	граничный контекст, выполняющийся в текущем запросе редактирования для каждого файла редактирования.

Один или несколько идущих подряд граничных контекстов могут находиться в начале или в конце таблицы контекстов и выполняться, соответственно, перед началом или после завершения редактирования входной информации (при основном поиске/замене по файлу граничные контексты игнорируются). При наличии в таблице контекстов граничных контекстов обоих видов, сначала располагаются строки с контекстом поиска <!!> , а потом с контекстом поиска <!> .

Граничные контексты могут быть использованы для анализа и коррекции состояния ячеек общего архива до начала или после конца редактирования текущего файла. В этом случае к началу строки с контекстом поиска может быть добавлено условие (в виде конструкции |[…]| ), в котором задаются условные выражения для проверки текущего состояния ячеек общего архива, а в контексте замены - реакция на выполнение соответствующего условного выражения. Особенностью граничных контекстов является то, что они могут организовывать циклы по таблице контекстов, причём вложенность циклов не ограничена. Область действия цикла определяется позиционным расположением в таблице операторов начала цикла (repeat) и конца цикла (until), но прямое вхождение в середину цикла (явный переход на ячейку таблицы, принадлежащей циклу) может привести к неадекватным действиям. В циклах определены контексты поиска:

<!>repeat	-	начало цикла граничного контекста, в контексте замены могут инициироваться начальные значения системных переменных;
<!>until|[…]|	-	конец цикла граничного контекста, достигается при выполнении первого условия контекста поиска;
<!>continue|[…]|	-	уход на конец текущего цикла после выполнения соответствующего контекста замены (только для первого условия контекста поиска, иначе переход на следующую ячейку таблицы);
<!>break|[…]|	-	выход за конец цикла после выполнения соответствующего контекста замены (только для первого условия контекста поиска, иначе переход на следующую ячейку таблицы).

Замечание. Если условное выражение состоит из нескольких условных выражений, разделяемых операцией '::', то оператор цикла выполняется только в том случае, если удовлетворяется первое из них, а иначе продолжается поиск контекстов по телу цикла.

Примеры граничных контекстов:

Контекст поиска:	Контекст замены:	Комментарий:
<!!>	#[""//{{*}}]	очистка всех ячеек архива;
<!>	#[loop({{2}}|*''*)/a//sysvar]		цикл формирования в системной переменной sysvar строки из списка лексем, находящихся в архивной ячейке {{2}};
<!> <!>repeat <!> <!>until|[sysvar<=250 :: else]| <!>|[sysvar2<>{{2}}]|	#[{{2}}//sysvar1; ""//sysvar2] #[BlockFind(lngtxt,"sysvar1",sysvar)] #[sysvar2 & sysvar1//sysvar2 :: sysvar2 & sysvar1|1..250 & "$"//sysvar2; sysvar1|251..-1//sysvar1] #[BlockLexm(rpllex,{{2}},{{2}}, sysvar2)]	цикл разбиения длинной строки архива {{2}} : sysvar1 - копия строки, sysvar2 - строка замены; длина строки sysvar1 в sysvar; если длина строки <=250, то цикл заканчивается, иначе в sysvar2 ставится признак переноса строки; если архивная строка не совпадает с sysvar2, то происходит её замена.

Использование авторских идентификаторов

При создании таблицы контекстов чаще удобно употреблять идентификаторы, отражающие мнемонику задаваемого процесса контекстного поиска. Однако все внутренние преобразования и подстановки в таблице контекстов настроены на работу с системными переменными (sysvar, sysvarN, N>=0,1,2,…) и списками /массивами/ (syslist, syslistN, N>=0,1,2,…), поэтому необходим аппарат, обеспечивающий их соответствие. Для создания внутренних таблиц соответствий между авторскими и системными идентификаторами (вне зависимости от регистра набора), необходимо декларировать все используемые авторские идентификаторы для переменных и списков, при этом идентификаторы должны относиться к определенным областям таблицы контекстов:

- глобальные для всех областей таблицы контекстов;

- локальные вне блоков редактирования;

- локальные для отдельного блока редактирования.

Декларация переменных и списков в таблице контекстов:

Контекст поиска:	Контекст замены:	Комментарий:
<var>|*| <var>|*| <lst>|*| <lst>|*|	# [идент1; идент2;…идентN] # [идент1=знач1;идент2=знач2…] # [идент1; идент2;…идентN] # [идент1=знач1;идент2=знач2…]	декларация глобальных переменных и списков; допускается наделение их начальными значениями;
<var> <lst>	# [идент1; идент2;…идентN] # [идент1; идент2;…идентN]		декларация локальных переменных и списков вне блоков редактирования;
<var>|| <lst>||	# [идент1; идент2;…идентN] # [идент1; идент2;…идентN]		декларация локальных переменных и списков для блока редактирования без номера;
<var>|n| <lst>|n|	# [идент1; идент2; идентN] # [идент1; идент2; идентN]		декларация локальных переменных и списков для блока редактирования с номером n (n>=1,2…);

Конструкции декларации могут располагаться в начале таблицы контекстов или непосредственно перед блоком редактирования. Каждому идентификатору ставится в соответствие системное имя, причем L всех глобальных объектов имеют системные имена с номерами от 0 до L-1, а локальные объекты имеют системные имена с номерами, от L и выше, которые для разных блоков редактирования могут повторяться. Таблица соответствия авторских и системных идентификаторов может быть просмотрена в окне задания параметров отладочного протокола, когда становится доступной кнопка "Идентификация", и использована для определения показа соответствующих системных переменных и списков в режиме отладки.

ПРИЕМЫ СОЗДАНИЯ СЛОЖНЫХ СЦЕНАРИЕВ

Создавать и дополнять сценарии следует путем выполнения операции "Создать сценарий" в окне "Сценарий редактирования каталогов и файлов", которое появляется после нажатия клавиши {Сценарий}. Здесь следует указать имя файла и режим создаваемого сценария. Тогда при реальном выполнении в редакторе TeConv любого шага редактирования появляется запрос на возможность включения этого шага в файл сценария. Доступ к сценарию открывается при вызове операции "Выполнить сценарий", загрузке сценария из файла и просмотра его через контекстное меню. После ручного редактирования сценарий следует сохранить в файле сценария.

При создании сценария группа макросов, идентифицированных своим номером в сценарии, может быть оформлена как цикл. Для этого следует войти в специальное окно "Проектировщик циклов в сценарии" по кнопке {Организовать цикл …} и вставить в нужные места операции начала и конца цикла:

#ЦИКЛ:<метка цикла>?<имя файла цикла>

#КОНЕЦ: <метка цикла>

Файл цикла должен быть предварительно создан и должен содержать в каждой строке набор заменяемых в цикле параметров, в виде лексем, разделяемых одним или несколькими пробелами. Если параметр содержит пробел, то он должен быть заключен в двойные кавычки, а пустые строки и строки-комментарии, начинающиеся с символа ! , исключаются из цикла. Параметры, подлежащие изменению при очередном проходе цикла (в сценарии и в файле запроса с таблицей контекстов), должны быть вручную заменены конструкцией подстановки '&n ' или '&n|m ' (n,m >=1), где n – номер параметра (лексемы) замены из строки файла цикла, а m – метка цикла, по которой ищется соответствующий файл цикла. Метки вложенных циклов не должны совпадать. Если метка не задана, то по умолчанию берется файл текущего цикла. Имя файла цикла может быть как с полным путем доступа, так и без пути, но тогда считается, что файл цикла находится в том же каталоге, что и файл текущего сценария.

Создать сложные сценарии, содержащие циклы, чисто механически не удастся в силу того, что в цикл основывается на строках и лексемах этих строк из конкретного файла цикла. Файл цикла может быть написан вручную или создан в процессе работы самого сценария. Рассмотрим для примера создание сценария распаковки zip-файлов из подкаталога d:\wrk .

Сначала создадим сценарий, включающий в себя распаковку в подкаталоге d:\wrk\ файла с именем file1.zip. Этот сценарий создается в режиме "Создать сценарий" при запуске внешнего процесса на странице "Файловые операции", причем путь доступа к имени файла распаковщика pkunzip.exe выбирается с диска C:, а в качестве командной строки задается режим и имя распаковываемого файла (режим -o означает распаковку без запросов). Внешний процесс распаковки выполняется в виде консольного приложения, которое само закроется по истечении заданного времени (2,5 сек):

#[ФАЙЛОВЫЕ ОПЕРАЦИИ] {1}

/1/тип операции (индекс): 4

/2/входной (базовый) каталог:

/3/шаблоны входных файлов: *.*

/4/базировать путь к файлу (признак): 0

/5/выходной каталог: d:\wrk\

/6/шаблоны файлов очистки: *

/7/режим очистки подкаталогов (индекс): 0

/8/создать структуру базы (признак): 0

/9/левый список (признак): 1

/10/правый список (признак): 0

/11/содержимое списка (индекс): 0

[ЗАПУСК ВНЕШНЕГО ПРОЦЕССА]

/1/имя внешнего процесса: c:\exe\pkunzip.exe

/2/источник выбора процесса (индекс): -1

/3/параметры командной строки: -o file1.zip

/4/путь доступа: d:\wrk\

/5/добавить параметр (признак): 0

/6/режим открытия внешнего процесса (индекс): 0

/7/время внешнего процесса: 2500

>ВНЕШНИЙ ПРОЦЕСС

Для организации цикла для распаковки списка файлов необходимо иметь файл цикла d:\wrk\listzip.txt , который содержит список zip-файлов, подлежащих распаковке. Тогда первая лексема каждой строки файла образует параметр подстановки, значение которого будет меняться с каждой итерацией цикла:

#ЦИКЛ:1?d:\wrk\listzip.txt

#[ФАЙЛОВЫЕ ОПЕРАЦИИ] {1}

/1/тип операции (индекс): 4

/2/входной (базовый) каталог:

/3/шаблоны входных файлов: *.*

/4/базировать путь к файлу (признак): 0

/5/выходной каталог: d:\wrk\

/6/шаблоны файлов очистки: *

/7/режим очистки подкаталогов (индекс): 0

/8/создать структуру базы (признак): 0

/9/левый список (признак): 1

/10/правый список (признак): 0

/11/содержимое списка (индекс): 0

[ЗАПУСК ВНЕШНЕГО ПРОЦЕССА]

/1/имя внешнего процесса: c:\exe\pkunzip.exe

/2/источник выбора процесса (индекс): -1

/3/параметры командной строки: -o &1

/4/путь доступа: d:\wrk\

/5/добавить параметр (признак): 0

/6/режим открытия внешнего процесса (индекс): 0

/7/время внешнего процесса: 2500

>ВНЕШНИЙ ПРОЦЕСС

#КОНЕЦ:1

Для создания файла цикла d:\wrk\listzip.txt вставим перед макросом цикла элемент сценария, обеспечивающий создание правого списка zip-файлов из каталога d:\wrk\ и запись этого списка в файл цикла. Можно сначала дозаписать этот макрос в сценарий при выполнении указанных действий в режиме "Создать сценарий", а потом переставить макросы местами, скорректировав их номера в фигурных скобках.

#[СОЗДАНИЕ СПИСКОВ] {2}

/1/источник списка (индекс): 0

/2/входной (базовый) каталог: d:\wrk\

/3/шаблоны входных файлов: *.zip

/4/искать в подкаталогах (признак): 1

/5/неполный путь к файлу (признак): 0

/6/левый список (признак): 0

/7/правый список (признак): 1

/8/новый список (признак): 1

/9/добавить в список (признак): 0

/10/содержимое списка (индекс): 0

/11/уровень от базы (режим): >=

/12/уровень от базы (значение): 0

>ПО ВХОДНОМУ КАТАЛОГУ

>ЗАПИСАТЬ СПИСОК: d:\wrk\listzip.txt,fNew,fRight,rAll

Таким образом, полный сценарий включает в себя два макроса:

#[СОЗДАНИЕ СПИСКОВ] {1}

. . . . . . . . . . . . . . .

>ЗАПИСАТЬ СПИСОК: d:\wrk\listzip.txt,fNew,fRight,rAll

#ЦИКЛ:1?d:\wrk\listzip.txt

#[ФАЙЛОВЫЕ ОПЕРАЦИИ] {2}

. . . . . . . . . . . . . . .

>ВНЕШНИЙ ПРОЦЕСС

#КОНЕЦ:1

ПРИМЕР ИСПОЛЬЗОВАНИЯ СПЕЦИАЛЬНЫХ СРЕДСТВ

Демонстрацию возможностей программных функций редактора TeConv рассмотрим на реальном примере. В Библиотеке Численного Анализа НИВЦ МГУ (www.srcc.msu.su/num_anal/) помещены описания библиотечных программ на языке ФОРТРАН. В связи с переводом программ на язык Си, возникла необходимость сделать подобные описания для языка Си, причем исходя из существующего описания на языке ФОРТРАН. Документ, описывающий программу, состоит из нескольких разделов: 'Программа: <имя п/п>', 'Назначение', 'Математическое описание', 'Использование', 'Параметры'. 'Версии', 'Вызываемые программы', 'Замечания по использованию', 'Пример использования', структуру и особенности которых при переводе документации надо учитывать. Кроме этого следует учесть, что документация предназначена для просмотра в Интернете и написана с использованием тегов языка HTML. В результате этих особенностей задача перевода документации включила в себя следующие основные пункты:

- перевод всех идентификаторов (кроме раздела 'Математическое описание') и имен всех встречаемых программ на нижний регистр, причем задача усложняется тем, что часть букв верхнего регистра, совпадающая по написанию с русскими, имеет русскую кодировку;

- добавление к именам программ окончаний для имен версии Си _c ; например, имя AM01R заменяется на имя am01r_c ;

- поиск и замена в разделе 'Использование' первого оператора обращения к программе на языке ФОРТРАН оператором, который ищется контекстным поиском и выделяется из текста программы на языке Си;

- поиск и замена в разделе 'Пример использования' теста к программе на языке ФОРТРАН на соответствующий тест на языке Си; при этом операторы теста в разделе могут быть обрамлены произвольными пояснительными строками, которые при поиске должны быть разграничены с тестом;

- в тексте может быть приведен вид первого оператора обращения к версии программы или к подпрограмме, приложенной к тесту, на языке ФОРТРАН, который заменяется соответствующим оператором языка Си, найденный в каталоге программ на Си;

- операторы и тесты программ на языке Си представлены в каталогах в виде заархивированных zip-файлов, поэтому перед началом работы с файлом документации все файлы надо разархивировать;

- в силу особенностей определенных разделов должен существовать механизм, обеспечивающий контекстные преобразования только в указанном разделе или группе разделов.

Для выполнения этой задачи создан сценарий, основные пункты которого описываются ниже с приведением подробных комментариев:

1. Запись в первую ячейку общего архива {{1}} тега <pre>

2. Запись во вторую ячейку общего архива {{2}} тега </pre>

Цикл по основным каталогам поиска (цикл охватывает пункты 3 – 22):

#ЦИКЛ:1?d:\docci\listcat.txt

Файлы исходной документации разбиты на несколько подкаталогов с именами am, pa, sf и др., определяющих отдельные разделы документации. Имена подкаталогов соответствуют начальным символам имен программ, находящимся в этом подкаталоге. Файл d:\docci\listcat.txt состоит из строк с именами этих подкаталогов и участвует в организации цикла 1. Соответствующие этим подкаталогам программы на языке Си находятся в подкаталогах с именами am_c, pa_c, sf_c и др., а тесты - в подкаталогах с именами tam_c, tpa_c, tsf_c и др.

3. Создание левого списка по файлам каталога цикла (например, из am) c расширением .htm

4. Добавление в левый список файлов из подкаталога Библиотеки d:\num_anal\lib_na\cat\&1 _c\ (например, из подкаталога am_c ). В этом подкаталоге находятся zip-файлы программ на Си раздела, имя которого формируется после подстановки первой лексемы &1 из текущей строки файла d:\docci\listcat.txt, организующем цикл 1.

5. Добавление в левый список файлов из подкаталога Библиотеки d:\num_anal\lib_na\cat\t&1 _c\ ( например, из подкаталога tam_c ). В этом подкаталоге находятся zip-файлы тестов на Си раздела, имя которого формируется после подстановки первой лексемы &1 из текущей строки файла d:\docci\listcat.txt, организующем цикл 1.

6. Создание рабочего каталога files_&1 . В этот каталог в дальнейшем соберем все распакованные файлы, которые будут использоваться для перекодировки соответствующего раздела документации.

7. Перепись файлов левого списка в каталог files_&1 .

8. Создание правого списка zip-файлов из каталога files_&1 (например, files_am) и запись этого списка в файл d:\docci\tmp\listzip.txt. Этот файл будет использован для организации внутреннего цикла распаковки zip-файлов.

9. Цикл распаковки zip-файлов через запуск внешнего процесса:

#ЦИКЛ:2?d:\docci\tmp\listzip.txt

Создание и структура цикла распаковки рассмотрены в разделе "Приемы создания сложных сценариев".

Завершение цикла 2:

#КОНЕЦ:2

10. Удаление zip-файлов правого списка из каталога files_&1 после распаковки.

11. Создание правого списка htm-файлов из каталога files_&1 и запись списка в файл d:\docci\tmp\listhtm_&1 .txt (например, создали файл listhtm_am.txt, содержащий файлы Am00r.htm, Am01r.htm и др.).

12. Редактирование файла listhtm_&1 .txt, используя таблицу контекстов:

Контекст поиска:	Контекст замены:	Комментарий:
{?*~[.]}{.htm}	#[{1} & {2} & " " & {1} & "_c.c t" & {1} & "_c.c"//{0}]	Формирование строк вида (f - имя файла): f.htm f_c.c tf_c.c

Цикл 3 по созданному на предыдущем этапе файлу (цикл охватывает пункты 13 – 18):

#ЦИКЛ:3?d:\docci\tmp\listhtm_&1|1 .txt

13. Запись в третью ячейку общего архива {{3}} обращения к п/п с параметрами на Си из файла d:\docci\files_&1|1 \&2 . Здесь каталог определяется первой лексемой файла цикла 1, а имя файла - второй лексемой текущего цикла 3. Это действие выполняет контекстное преобразование:

Контекст поиска:	Контекст замены:	Комментарий:
%%{&1|1 ???_c(}|{&1|1 ????_c(}		Начало блока: имя п/п, начинающееся с имени каталога, плюс 3 или 4 произвольных символа (дополнение до 5 символов исходного имени) плюс стандартное окончание имени _c.
$${%@{}		Конец блока: { в начале строки.
%$	#[BlockOper(save,{10}, {{3}},1..-2)]	Запись блока без последней строки ({) в третью ячейку архива.

14. Запись в четвертую ячейку архива {{4}} теста на языке Си из файла d:\docci\files_&1|1 \&3 . Здесь каталог определяется первой лексемой файла цикла 1, а имя теста - третьей лексемой текущего цикла 3. Это действие выполняет контекстное преобразование:

Контекст поиска:	Контекст замены:	Комментарий:
%%{main(void)}		Начало блока: заданный контекст.
$$$		Конец блока: конец файла.
%$	#[BlockOper(save,{10}, {{4}},1..-1)]	Запись блока в четвертую ячейку архива.

15. Изменение прописных букв на строчные в именах программ и идентификаторах, включая замену русских букв, одинакового с латинским написания, на латинские. Контекстные преобразования разделены на блоки, относящиеся к определенным разделам документации (приводится фрагмент):

Контекст поиска:	Контекст замены:	Комментарий:
|1|%%<hr>		Начало блока 1
|1|{[АВЕКМНОРСТХУ A-Z]+[АВЕКМНОРС ТХУA-Z0-9]*[ |,|.|;|:|&| (|)|=|@+|@-|*|<|!|@}|^]}	#[BlockEdit(selcn,sysfile1, _{1}..{1}_)]	Формирование системного файла sysfile1 с диапазонами имен п/п и идентификаторов, подлежащих переводу (поиск проводится по списку возможных прописных русских букв и диапазону латинских букв), последний перечень символов определяет допустимые символы, ограничивающие имена и идентификаторы.
|1|$${<h3> * Математическое описание}		Конец блока 1
|1|%$	#[BlockConv({10},,sysfile1, eneq,dn)]	Функция перевода символов с использованием созданного в блоке системного файла sysfile1 .
|1|%$	#[BlockOper(setn)]	Сдвиг по входному файлу на одну строку вверх (чтобы повторить чтение конечной строки этого блока).
|2|%%{<h3> * Математическое описание}		Начало блока 2
|2|{[АВЕКМНОРСТХ A-Z][АВЕКМНОРСТХ A-Z][АВЕКМНОРСТХ A-Z0-9][АВЕКМНОРС ТХA-Z0-9][СCRD]}	#[BlockEdit(selcn,sysfile1, _{1}..{1}_)]	Формирование системного файла sysfile1 с диапазонами имен п/п.
|2|$${<h3> * Использование}		Конец блока 2.
|2|%$	#[BlockConv({10},,sysfile1, eneq,dn)]	Функция перевода символов с использованием созданного в блоке системного файла sysfile1 .

16. Добавление к именам п/п окончания _c . Контекстные преобразования разделены на блоки, относящиеся к определенным разделам документации (приводится фрагмент):

Контекст поиска:	Контекст замены:	Комментарий:
|1|%%<hr>		Начало блока 1
|1|{[a-z][a-z][a-z0-9] [a-z0-9][rdci][ |.|)|,|(]}	#[{1}|1..-2 & "_c" & {1}|-1..-1 //{1}]	Выделение из найденной группы символов имени п/п (последний символ группы не включается) и присоединение к нему . _c и конечного символа группы (например, из имени am01r формируется имя am01r_c).
|1|$${<h3> * Использование}		Конец блока 1
|1|%$	#[BlockOper(repl,{10}, {10})]	Запись отредактированного блока в выходной файл.
|2|%%{<h3> *Параметры}		Начало блока 2
|2|{[a-z][a-z0-9]* }{ *@-$}		Идентификаторы параметров не изменяются.
|2|{[a-z][a-z][a-z0-9] [a-z0-9][rdci][ |.|)|,|(]}	#[{1}|1..-2 & "_c" & {1}|-1..-1 //{1}]	Добавление к имени п/п окончания _c .
|2|$${<h3> *Версии}		Конец блока 2.
|2|%$	#[BlockOper(repl,{10}, {10})]	Запись отредактированного блока в выходной файл.

17. Замена содержимого раздела 'Использование' на обращение к п/п на Си и содержимого раздела 'Пример использования' на тест к п/п на Си. Эти действие выполняются контекстными преобразованиями:

Контекст поиска:	Контекст замены:	Комментарий:
|1|%%<h3> * Использование		Начало блока 1
|1|$${%\0d\0a}		Конец блока 1 (пустая строка - в начале строки стоят коды #13#10).
|1|%$	#[BlockOper(repl,{{3}}, {10},,2..-2,False)]	Замещение строки блока редактирования от второй до предпоследней содержимым третьей ячейки общего архива, без записи блока в выходной файл (ключ False).
|1|%$	#[BlockOper(insb,{{2}}, {10},,-1,False)]	Перед последней строкой блока вставляется содержимое второй ячейки общего архива ( </pre> ) без записи блока в выходной файл (ключ False).
|1|%$	#[BlockOper(insb,{{1}}, {10},,2)]	Перед второй строкой блока вставляется содержимое первой ячейки общего архива ( <pre> ) и блок записывается в файл.
|2|%%{<h3> *Пример использования}		Начало блока 2
|2|{% +[АВЕКМНОРСТ ХУA-Z][АВЕКМНОРСТ ХУA-Z0-9]* }	#[BlockEdit(selsp,sysfile)]	Формирование системного файла sysfile, содержащего номера min и max строки блока с оператором языка ФОРТРАН (для строк теста, начинающихся с идентификатора).
|2|{% +[0-9]+ +[АВЕКМН ОРСТХУA-Z]}	#[BlockEdit(selsp,sysfile)]	Формирование системного файла sysfile, содержащего номера min и max строки блока с оператором языка ФОРТРАН (для строк теста, начинающихся с цифровой метки).
2|$${% *Результат}		Конец блока 2.
|2|%$	#[BlockOper(repl,{{4}}, {10},,&1|sysfile .. &2|sysfile )]	Замена в блоке диапазона строк, взятого из первой и второй лексем системного файла sysfile, на содержимое четвертой ячейки общего архива .

18. Замена в обращений к первым операторам п/п на языке ФОРТРАН subroutine fname( … ) на их аналог на языке Си (п/п может быть версией исходной п/п и ее следует искать непосредственно в каталоге files_&1|1 под именем fname_c.c, или содержаться в тесте исходной п/п и ее следует искать в том же каталоге под именем &3|3 , которое находится в третьей лексеме файла цикла 3). Эти действия выполняются контекстными преобразованиями:

Контекст поиска:	Контекст замены:	Комментарий:
|1|%%{subroutine}{[a-z]+ [_a-z0-9]*[ |&|(]}{?*)}	#[{2}|1..-2//{{5}}]	Начало блока 1: имя п/п выделяется из второй группы (без последнего граничного с именем символа) и записывается в ячейку пять общего архива.
|1|$$		Конец блока 1: строка совпадает с началом блока, т.к. закрывающая скобка списка параметров находится в этой же строке.
|1[file=d:\docci\files_&1|1 \{{5}}.c :: file=d:\docci\files_&1|1 \&3|3 ] |%$	#[BlockFile(extr,sysRcond, {10},"int {{5}}"::"real {{5}}",")","subroutine",")") :: BlockFile(extr,sysRcond, {10},"%int {{5}}_c"::"%real {{5}}_c",")","subroutine",")")]	Системная переменная sysRcond формируется в процессе проверки блокового условия и содержит имя файла, по которому будет производиться поиск контекстов; по номеру выполненного условия выбирается блоковая функция для работы с эти файлом, производится поиск контекста по заданным граничным условиям и запись его в блок.
|2|%%{subroutine} {[a-z]+[_a-z0-9]*[ |&|(]}	#[{2}|1..-2//{{5}}]	Начало блока 2: имя п/п выделяется из второй группы (без последнего граничного с именем символа) и записывается в ячейку пять общего архива.
|2|$${)}		Конец блока 2: строка не совпадает с началом блока, т.к. закрывающая скобка находится в другой строке.
|2[file=d:\docci\files_&1|1 \{{5}}.c :: file=d:\docci\files_&1|1 \&3|3 ]|%$	#[BlockFile(extr,sysRcond, {10},"int {{5}}"::"real {{5}}",")","subroutine",")") :: BlockFile(extr,sysRcond, {10},"%int {{5}}_c"::"%real {{5}}_c",")","subroutine",")")]	Контекстные преобразования аналогичные преобразования блока 1.

Завершение цикла 3:

#КОНЕЦ:3

19. Создание левого списка файлов htm-файлов каталога d:\docci\cat\&1|1 \ (например, для подкаталога am).

20. Создание правого абстрактного списка htm-файлов каталога d:\docci\cat\&1|1 \ с добавлением к именам файлов окончания _c .

21. Переименование файлов из левого списка в правый (например, Am00r.htm в Am00r_c.htm).

22. Перевод имен файлов на нижний регистр в каталоге d:\docci\cat\&1|1 \ .

Завершение цикла 1:

#КОНЕЦ:1

Полный текст сценария: www.srcc.msu.su/viz/teconv-h/resurs/docscrpt.html

Для иллюстрации приведем отображение в Интернете исходной и выходной документации (для программ SF60R и sf60r_c), полученной с применением данного сценария:

Подпрограмма: SF60R (версия SF61R)

Назначение

Вычисление функции распределения вероятностей Пуассона.

Математическое описание

SF60R вычисляет вероятности того, что целочисленная случайная величина, распределенная по закону Пуассона с параметром RLАМ, примет значение I

P {x = I} = T(I + 1) = (RLAM) ^I exp (- RLAM) / I ! , I = 0, 1, ..., K

а также вероятность P = P {x £ K} , т.е.

_K

P = å T(I + 1)

^I=0

M.Abramowitz, I.A.Stegun, Handbook of Mathematical Functions, New York, Dover Publications, Inc., 1965.

Использование

SUBROUTINE SF60R (K, RLAM, T, P)

Параметры

K -	максимальное значение I, для которого вычисляется вероятность P {x = I} (тип: целый);
RLAM -	заданный параметр распределения вероятностей Пуассона (тип: вещественный);
T -	вещественный вектор длины K + 1, содержащий вычисленные значения вероятностей P {x = I} , 0 £ I £ K;
P -	вещественная переменная, содержащая вычисленное значение вероятности P {x £ K}.

Версии

SF61R -

вычисление функции распределения вероятностей Пуассона P {x £ K} (см. замечания по использованию).

Вызываемые подпрограммы: нет

Замечания по использованию

Если P{x = I} меньше наименьшего представимого на данной ЭВМ вещественного числа, то программа полагает T(I)=0.

Если RLAM £ 0, то P{x £ K}=1. , T(1)=1., I(J)=0, 2 £ Ј £ K.

Подпрограмма SF61R имеет следующий список формальных параметров
SUBROUTINE SF61R (K, RLAM, P),
так как производится вычисление только вероятности P {x £ K}. Смысл остальных параметров остается прежним.

Пример использования

REAL T(2)

K = 1

RLAM = 0.6

CALL SF60R (K, RLAM, T, P)

Результаты:

T(1) = 0.54881163609

T(2) = 0.32928698166

Подпрограмма: sf60r_c (версия sf61r_c)

Назначение

Вычисление функции распределения вероятностей Пуассона.

Математическое описание

sf60r_c вычисляет вероятности того, что целочисленная случайная величина, распределенная по закону Пуассона с параметром RLАМ, примет значение I

P {x = I} = T(I + 1) = (RLAM) ^I exp (- RLAM) / I ! , I = 0, 1, ..., K

а также вероятность P = P {x £ K} , т.е.

_K

P = å T(I + 1)

^I=0

M.Abramowitz, I.A.Stegun, Handbook of Mathematical Functions, New York, Dover Publications, Inc., 1965.

Использование

int sf60r_c (integer *k, real *rlam, real *t, real *p)

Параметры

k -	максимальное значение i, для которого вычисляется вероятность p {x = i} (тип: целый);
rlam -	заданный параметр распределения вероятностей Пуассона (тип: вещественный);
t -	вещественный вектоp длины k + 1, содержащий вычисленные значения вероятностей p {x = i} , 0 £ i £ k;
p -	Вещественная переменная, содержащая вычисленное значение вероятности p {x £ k}.

Версии

sf61r_c -

вычисление функции распределения вероятностей Пуассона p {x £ k} (см. замечания по использованию).

Вызываемые подпрограммы: нет

Замечания по использованию

Если p {x = i} меньше наименьшего представимого на данной ЭВМ вещественного числа, то программа полагает t(i) = 0.

Если rlam £ 0, то p {x £ k} = 1. , t(1) = 1., i(j) = 0, 2 £ j £ k.

Подпрограмма sf61r_c имеет следующий список формальных параметров
int sf61r_c (integer *k, real *rlam, real *p),
так как производится вычисление только вероятности p {x £ k}. Смысл остальных параметров остается прежним.

Пример использования

int main(void)

{

/* Local variables */

static float rlam;

extern int sf60r_c(int *, float *, float *, float *);

static int k;

static float p, t[2];

k = 1;

rlam = .6f;

sf60r_c(&k, &rlam, t, &p);

printf("\n %16.7e %16.7e \n",t[0],t[1]);

printf("\n %5i %16.7e %16.7e \n",k,rlam,p);

return 0;

} /* main */

Результаты:

t(1) = 0.54881163609

t(2) = 0.32928698166

ЛИТЕРАТУРА

1. В.В.Фаронов. Delphi4. Учебный курс. М.: Изд-во “Нолидж”, 1999.

2. Том Сван. Delphi 4. Библия разработчика. К.;М.;СПб. : Изд-во “Диалектика”, 1998.

3. Марко Кэнту. Delphi 4 для профессионалов. М.: СПб: Изд-во “Питер”, 1999.

4. А.Я.Архангельский. Программирование в Delphi 5. М.: ЗАО “Издательство БИНОМ”, 2000.

4. А.Я.Архангельский. Приемы программирования в Delphi. М.: ООО “Бином-Пресс”, 2004.

5. В.Э.Фигурнов. IBM PC для пользователя. 6-е изд. М.:Изд-во”ИНФРА-М”, 1995.

6. Дж.Фридл. Регулярные выражения. Библиотека программиста. СПб.: Изд-во “Питер”, 2001.