UNIFOR — различия между версиями

Материал из Wikipedia
Перейти к: навигация, поиск
(Обычные функции для обработки строк)
(Функции для работы с глобальными переменными)
Строка 401: Строка 401:
 
|name=+99
 
|name=+99
 
|title=Групповая установка глобальных переменных
 
|title=Групповая установка глобальных переменных
|description=Групповая установка глобальных переменных. Применяется для ИРБИС-Навигатора. Исходная строка закодирована через URLEncode (&unifor('+3E....). После раскодировки рассматривается как список строк(TStringList.Text). Каждая строка этого списка имеет структуру: NNN#<значение_глобальной_переменной_NNN>
+
|description=Групповая установка глобальных переменных. Применяется для ИРБИС-Навигатора. Исходная строка закодирована с помощью URL-кодировки. После раскодировки рассматривается как список строк (аналогично <tt>TStringList.Text</tt> в Delphi). Каждая строка этого списка имеет структуру: <tt>NNN#<значение_глобальной_переменной_NNN><tt>
 
}}
 
}}
  

Версия 17:34, 11 мая 2010

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

Содержание

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

Обращение к программной функции UNIFOR в формате производится в полной или сокращённой форме:

&unifor(формат)
&uf(формат)

где:

  • & – идентификатор вызова формат-программы;
  • unifor – имя формат-программы (соответственно uf – сокращённое имя формат-программы);
  • формат – аргумент.

Рекомендуется использовать сокращённую форму вызова программной функции UNIFOR. Сокращённая форма по действию ничем не отличается от полной формы, зато позволяет сократить размер формата и повысить его читаемость.

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

Перечень функций формат-программы UNIFOR с примерами их применения

Функции для обработки строк

Обычные функции для обработки строк

Вернуть длину исходной строки – &uf('+95…

Вид функции: +95.

Назначение: Вернуть длину исходной строки.

Формат (передаваемая строка):

+95<строка>
Вернуть часть строки – &uf('+96…

Вид функции: +96.

Назначение: Вернуть часть строки.

Формат (передаваемая строка):

+96A*SSS.NNN#<строка>

где:

  • A – направление: 0 – с начала строки; 1 – с конца;
  • SSS – смещение;
  • NNN – кол-во символов.

Примеры:

&unifor("G0#"v700)
&unifor("G1-"v700^a)
Вернуть часть строки до или начиная с заданного символа – &uf('G…

Вид функции: G.

Назначение: Вернуть часть строки до или начиная с заданного символа.

Формат (передаваемая строка):

GNA<строка>

где:

  • N=0 если ДО заданного символа (не включая его); N=1 если начиная С заданного символа (включая его).
  • А – заданный символ (# – обозначает цифру; $ – обозначает букву).

Примеры:

&unifor("G0#"v700)
&unifor("G1-"v700^a)
Вернуть заданную строку в нижнем регистре – &uf('Q…

Вид функции: Q.

Назначение: Вернуть заданную строку в нижнем регистре.

Формат (передаваемая строка):

Q<строка>

Примеры:

&unifor("Q"v200)
Вернуть заданную строку в верхнем регистре – &uf('+97…

Вид функции: +97.

Назначение: Вернуть заданную строку в верхнем регистре.

Формат (передаваемая строка):

+97<строка>
Заменить в заданной строке один символ на другой – &uf('+98…

Вид функции: +98.

Назначение: Заменить в заданной строке один символ на другой (регистр учитывается).

Формат (передаваемая строка):

+98ab<строка>

где:

  • a – заменяемый символ;
  • b – заменяющий символ.
Вернуть ANSI-символ с заданным кодом – &uf('+9F…

Вид функции: +9F.

Назначение: Вернуть ANSI-символ с заданным кодом.

Формат (передаваемая строка):

+9F<код>

Функции для работы со словами

Вернуть заданное количество слов с начала строки – &uf('E…

Вид функции: E.

Назначение: Вернуть заданное количество слов с начала строки.

Формат (передаваемая строка):

EN<строка>

где N – количество слов (одна цифра).


Примеры:

&unifor("E3"v200^a)
Вернуть часть строки, начиная со следующего слова после указанного и до конца строки – &uf('F…

Вид функции: F.

Назначение: Вернуть часть строки, начиная со следующего слова после указанного и до конца строки.

Формат (передаваемая строка):

FN<строка>

где N – количество слов (одна цифра).

Примеры:

&unifor("F3"v200^a)
Преобразовать заданную строку в список слов – &uf('+9G…

Вид функции: +9G.

Назначение: Преобразовать заданную строку в список слов.

Формат (передаваемая строка):

+9G<строка>

Дополнительные функции для обработки строк

Кодирование данных для представления в URL – &uf('+3E…

Вид функции: +3E.

Назначение: Кодирование данных для представления в URL.

Формат (передаваемая строка):

+3E<данные>

Примеры:

&unifor('+3E',v1007)
Декодирование данных из URL – &uf('+3D…

Вид функции: +3D.

Назначение: Декодирование данных из URL.

Формат (передаваемая строка):

+3D<данные>
Транслитерация кириллических символов с помощью латиницы – &uf('T…

Вид функции: T.

Назначение: Транслитерация кириллических символов с помощью латиницы.

Формат (передаваемая строка):

TN<строка>

где N – вид таблицы транслитерации (0 или 1).

Примеры:

&unifor("T0"V200)
Удалить двойные кавычки из заданной строки – &uf('9…

Вид функции: 9.

Назначение: Удалить двойные кавычки из заданной строки.

Формат (передаваемая строка):

9<исх.строка>

Примеры:

&unifor("9"v200^a)
Удаление из заданной строки фрагментов, выделенных угловыми скобками <> – &uf('X…

Вид функции: X.

Назначение: Удаление из заданной строки фрагментов, выделенных угловыми скобками <>.

Формат (передаваемая строка):

X<строка>

Примеры:

&unifor("X"v200)

Функции для работы с датой и временем

Выдача данных, связанных с датой и временем – &uf('3…

Вид функции: 3.

Назначение: Выдача данных, связанных с датой и временем.

Формат (передаваемая строка):

Имеются следующие подфункции:

  • 3 – выдать текущую дату в виде ГГГГММДД.
  • 30 – выдать текущий год в виде ГГГГ.
  • 31 – выдать текущий месяц в виде ММ (с лидирующим нулем).
  • 32 – выдать текущий день в виде ДД (с лидирующим нулем).
  • 33 – выдать текущий год в виде ГГ.
  • 34 – выдать текущий месяц в виде М (без лидирующего нуля).
  • 35 – выдать текущий день в виде Д (без лидирующего нуля).
  • 36MM – выдать по заданному номеру месяца его название на русском языке в именительном падеже.
  • 37MM – выдать по заданному номеру месяца его название на русском языке в родительном падеже.
  • 38MM – выдать по заданному номеру месяца его название на английском языке.
  • 39 – выдать текущее время.
  • – выдать номер текущего дня от начала года.
  • 3BГГГГММДД/ддд – прибавить/вычесть из заданной даты в виде ГГГГММДД заданное количество дней (ддд – м.б. с минусом) и вернуть полученную дату в виде ГГГГММДД.
  • 3СГГГГММДД/ГГГГММДД – вычесть из одной даты в виде ГГГГММДД другую дату в виде ГГГГММДД и вернуть разницу в виде количества дней.

Примеры:

&unifor('36',&unifor('34'))

Функции для работы с глобальными переменными

Очистить (опустошить) все глобальные переменные – &uf('+7…

Вид функции: +7.

Назначение: Очистить (опустошить) все глобальные переменные.

Формат (передаваемая строка):

+7

Примеры:

&unifor('+7')

Чтение глобальной переменной – &uf('+7R…

Вид функции: +7R.

Назначение: Чтение глобальной переменной.

Формат (передаваемая строка):

+7RNNN,nnn

где:

  • NNN – номер переменной.
  • nnn – номер повторения. По умолчанию – номер текущего повторения в повторяющейся группе.

Эквивалентная конструкция языка форматирования GNNN.

Примеры:

&unifor('+7R100')

эквивалентная конструкция языка форматирования:

G100

Запись глобальной переменной – &uf('+7W…

Вид функции: +7W.

Назначение: Запись глобальной переменной.

Формат (передаваемая строка):

+7WNNN#SSSS

где:

  • NNN – номер переменной;
  • SSSS – список строк (результат расформатирования); каждая строка становится отдельным повторением.

Примеры:

&unifor('+7W100#',(v910/))

Добавление повторений глобальной переменной – &uf('+7U…

Вид функции: +7U.

Назначение: Добавление повторений глобальной переменной.

Формат (передаваемая строка):

+7UNNN#SSSS

где:

  • NNN – номер переменной;
  • SSSS – список строк (результат расформатирования); каждая строка становится отдельным повторением.

Логическое перемножение повторений двух переменных – &uf('+7M…

Вид функции: +7M.

Назначение: Логическое перемножение повторений двух переменных.

Формат (передаваемая строка):

+7MNNN#MMM

Результат перемножения записывается в первую переменную.

Логическое вычитание повторений двух переменных – &uf('+7S…

Вид функции: +7S.

Назначение: Логическое вычитание повторений двух переменных.

Формат (передаваемая строка):

+7SNNN#MMM

Результат вычитания записывается в первую переменную.

Логическое сложение повторений двух переменных – &uf('+7A…

Вид функции: +7A.

Назначение: Логическое сложение повторений двух переменных.

Формат (передаваемая строка):

+7ANNN#MMM

Результат сложения записывается в первую переменную.

Исключение неоригинальных повторений переменной – &uf('+7G…

Вид функции: +7G.

Назначение: Исключение неоригинальных повторений переменной.

Формат (передаваемая строка):

+7GNNN

Результат исключения записывается в ту же переменную.

Сортировка повторений переменной – &uf('+7T…

Вид функции: +7T.

Назначение: Сортировка повторений переменной.

Формат (передаваемая строка):

+7TNNN

Результат сортировки записывается в ту же переменную.

Очистить (опустошить) все глобальные переменные – &uf('+1…

Вид функции: +1.

Назначение: Очистить (опустошить) все глобальные переменные.

Формат (передаваемая строка):

+1

Примеры:

&unifor('+1')

Чтение глобальных переменных – &uf('+1R…

Вид функции: +1R.

Назначение: Чтение глобальных переменных.

Формат (передаваемая строка):

+1RNNN,nnn

где:

  • NNN – номер первой или единственной переменной, возможна конструкция *+-<число>. * – номер текущего повторения в повторяющейся группе.
  • nnn – кол-во переменных (по умолчанию 1).


Примеры:

&unifor('+1R100,2')

Запись в глобальные переменные – &uf('+1W…

Вид функции: +1W.

Назначение: Запись в глобальные переменные.

Формат (передаваемая строка):

+1WNNN,MMM#SSSS

где:

  • NNN – номер первой или единственной переменной, возможна конструкция *+-<число>. * – номер текущего повторения в повторяющейся группе.
  • MMM – номер переменной для сохранения кол-ва записанных переменных (по умолчанию не используется).
  • SSSS – список строк (результат расформатирования). Если задан MMM – каждая строка пишется в отдельную переменную, в противном случае все пишется в одну переменную.

Примеры:

&unifor('+1W100,0#',(v910/))

Групповая мультираскодировка переменных – &uf('+1K…

Вид функции: +1K.

Назначение: Групповая мультираскодировка переменных.

Формат (передаваемая строка):

+1K<MNU>|NNN,nnn

где:

  • NNN – номер первой или единственной переменной.
  • nnn – кол-во переменных (по умолчанию 1).

Примеры:

&unifor('+1Kmhr.mnu|100,10')

Перемножение двух списков (групп переменных) – &uf('+1M…

Вид функции: +1M.

Назначение: Перемножение двух списков (групп переменных).

Формат (передаваемая строка):

+1MNNN,nnn#MMM,mmm

где параметры аналогичны описанным для функции Групповая мультираскодировка переменных – &uf('+1K…

Вычитание списков (групп переменных) – &uf('+1S…

Вид функции: +1S.

Назначение: Вычитание списков (групп переменных).

Формат (передаваемая строка):

+1SNNN,nnn#MMM,mmm

где параметры аналогичны описанным для функции Групповая мультираскодировка переменных – &uf('+1K…

Сложение списков (групп переменных) – &uf('+1A…

Вид функции: +1A.

Назначение: Сложение списков (групп переменных).

Формат (передаваемая строка):

+1ANNN,nnn#MMM,mmm

где параметры аналогичны описанным для функции Групповая мультираскодировка переменных – &uf('+1K…

Исключение неоригинальных значений из группы переменных – &uf('+1G…

Вид функции: +1G.

Назначение: Исключение неоригинальных значений из группы переменных.

Формат (передаваемая строка):

+1GNNN,nnn

где параметры аналогичны описанным для функции Групповая мультираскодировка переменных – &uf('+1K…

Сортировка группы переменных – &uf('+1T…

Вид функции: +1T.

Назначение: Сортировка группы переменных.

Формат (передаваемая строка):

+1TNNN,nnn

где параметры аналогичны описанным для функции Групповая мультираскодировка переменных – &uf('+1K…

Групповая установка глобальных переменных – &uf('+99…

Вид функции: +99.

Назначение: Групповая установка глобальных переменных. Применяется для ИРБИС-Навигатора. Исходная строка закодирована с помощью URL-кодировки. После раскодировки рассматривается как список строк (аналогично TStringList.Text в Delphi). Каждая строка этого списка имеет структуру: NNN#<значение_глобальной_переменной_NNN><tt>.

Формат (передаваемая строка):

+99

Функции для работы с базой данных

Выдать содержимое документа полностью – <tt>&uf('0…

Вид функции: 0.

Назначение: Выдать содержимое документа полностью (формат ALLl).

Формат (передаваемая строка):

0

Примеры:

&unifor('0')

Выдать заданное повторение поля – &uf('A…

Вид функции: A.

Назначение: Выдать заданное повторение поля.

Формат (передаваемая строка):

AV<tag>^<delim>*<offset>.<length>#<occur>

где:

  • <tag> – метка поля;
  • <delim> – разделитель подполя;
  • <offset> – смещение;
  • <length> – длина;
  • <occur> – номер повторения.

Примеры:

&unifor('Av200#2')
&unifor('Av910^a#5')
&unifor('Av10^b*2.10#2')

Выдать заданное оригинальное повторение поля – &uf('P…

Вид функции: P.

Назначение: Выдать заданное оригинальное повторение поля.

Формат (передаваемая строка): см. формат для функции Выдать заданное повторение поля – &uf('A….

Примеры: см. примеры для функции Выдать заданное повторение поля – &uf('A….

Раскодировка через справочник (меню) – &uf('K…

Вид функции: K.

Назначение: Раскодировка через справочник (меню).

Формат (передаваемая строка):

K<имя_меню>\<исх_значение>

Примеры:

&unifor("Kjz.mnu\"v101)

Вернуть параметр из INI-файла – &uf('I…

Вид функции: I.

Назначение: Вернуть параметр из INI-файла.

Формат (передаваемая строка):

I<SECTION>,<PAR_NAME>,<DE-FAULT_VALUE>

Примеры:

&unifor('IPRIVATE,NAME,NONAME')

Вернуть заданный подэлемент – &uf('1…

Вид функции: 1.

Назначение: Вернуть заданный подэлемент.

Формат (передаваемая строка):

1NCXY?V<tag>^<delim>*<offset>.<length>#<occur>

где:

  • N – номер повторения подэлемента; если указана * – номер подэлемента совпадает со счетчиком повторяющейся группы.
  • ХY – разделители между подэлементами.
  • С – принимает значения: R – разделители справа от каждого подэлемента, кроме последнего; L – разделители слева от каждого подэлемента; D – каждый подэлемент заключен слева разделителем Х и справа – Y.
  •  ? – символ-разделитель.
  • Остальные параметры аналогичны параметрам для функции Выдать заданное повторение поля – &uf('A….

Примеры:

(/&unifor('1*R; ?v910^h#1'))

Вернуть кол-во ссылок для заданного термина – &uf('J…

Вид функции: J.

Назначение: Вернуть кол-во ссылок для заданного термина.

Формат (передаваемая строка):

J<dbn>,<термин>

<dbn> – имя БД; по умолчанию используется текущая.

Примеры:

&unifor('JBOOK,',"A="v200^a)

Форматирование документа из другой БД – &uf('D…

Вид функции: D.

Назначение: Форматирование документа из другой БД (REF на другую БД – отношение «от одного к одному»).

Формат (передаваемая строка):

D<dbn>,<@mfn|/termin/>,<@имя_формата|формат|*>

Передаются три параметра, разделенные запятой:

  • Первый – имя БД;
  • Второй – или непосредственно MFN с предшествующим символом @ или термин, ссылающийся на документ (термин – заключается в ограничительные символы);
  • Третий – или имя формата с предшествующим символом @ или непосредственно формат.

Если задается *, данные выводятся по прямой ссылке (метка поля, номер повторения).

Примеры:

&unifor('DBOOK,/K=AAA/,v200')

Расформатирование группы связанных документов из другой БД – &uf('7…

Вид функции: 7.

Назначение: Расформатирование группы связанных документов из другой БД (отношение «от одного к многим»).

Формат (передаваемая строка):

7<имя_БД>,</termin/>,<@имя_формата|формат|*>

где:

  • имя_БД – имя базы данных, из которой будут браться связанные документы; по умолчанию используется текущая БД.
  • /termin/ – ключевой термин, на основе которого отбираются связанные документы; термин заключается в уникальные ограничители (например. /), в качестве которых используется символ, не входящий (гарантированно) в термин.
  • @имя_формата|формат|* – имя формата или формат в явном виде, в соответствии с которым будут расформатироваться связанные документы. Если задается имя формата, то он берется из директории БД, заданной параметром <имя_БД>. Если задается *, данные выводятся по прямой ссылке (метка поля, номер повторения).

Примеры:

&unifor('7TEST,',"/T="v200^a"/",',v903"\par "')

Команда постредактуры: очистить результат расформатирования от двойных разделителей – &uf('!…

Вид функции: !.

Назначение: Команда постредактуры: очистить результат расформатирования от двойных разделителей (двойных точек или двойных конструкций <. – >). Имеет смысл использовать один раз в любом месте формата.

Формат (передаваемая строка):

!

Примеры:

&unifor('!')

Команда постредактуры: очистить результат расформатирования от RTF-конструкций – &uf('+F…

Вид функции: +F.

Назначение: Команда постредактуры: очистить результат расформатирования от RTF-конструкций. Имеет смысл использовать один раз в любом месте формата.

Формат (передаваемая строка):

+F

Примеры:

&unifor('+F')

Групповая мультираскодировка списка – &uf('+1O…

Вид функции: +1O.

Назначение: Групповая мультираскодировка списка.

Формат (передаваемая строка):

+1O<MNU>|SSSS

где:

  • <MNU> имя справочника (с расширением).
  • SSSS – список строк (результат расформатирования.

Примеры:

&unifor('+1Omhr.mnu|',(v910^m/))

Исключение неоригинальных значений из списка – &uf('+1I…

Вид функции: +1I.

Назначение: Исключение неоригинальных значений из списка.

Формат (передаваемая строка):

+1ISSSS

где параметры аналогичны описанным для функции Групповая мультираскодировка списка – &uf('+1O…

Сортировка списка – &uf('+1V…

Вид функции: +1V.

Назначение: Сортировка списка.

Формат (передаваемая строка):

+1VSSSS

где параметры аналогичны описанным для функции Групповая мультираскодировка списка – &uf('+1O…

Формирования ссылки (гиперссылки) – &uf('+I…

Вид функции: +I.

Назначение: Формирования ссылки (гиперссылки).

Формат (передаваемая строка):

+I/содержание_ссылки/название_ссылки

/содержание_ссылки/ – внутренние данные ссылки, ограниченные уникальным разделителем. Имеют структуру

NNN,HHH,<параметры>

где:

  • NNN – тип ссылки, возможные значения:
    • 0 – ссылки на внешние объекты;
    • 1 – ссылка на связанный документ (возможно в другой БД) – "от одного к одному";
    • 2 – ссылка на связанные документы (возможно в другой БД) – "от одного к многим";
  • HHH – экранная подсказка, может иметь вид: @iii – где iii – номер текста в файле IRBISMSG.TXT, \text\ – собственно текст подсказки в уникальных ограничителях.

<параметры>:

  • Для ссылок типа 0 представляет собой в общем виде URL внешнего объекта (в том числе – полный путь на файл).
  • Для ссылок типа 1 и 2 <параметры> имеют следующую структуру:
имя_БД,имя_формата,termin

где:

  • имя_БД – имя базы данных, из которой будут браться связанные документы; по умолчанию используется текущая БД.
  • имя_формата – имя формата, в соответствии с которым будут расформатироваться связанные документы. (по умолчанию – используется оптимизированный формат).
  • termin – ключевой термин, на основе которого отбираются (ищутся) связанные документы.


Примеры:

&unifor('+I?0,,'v951^i'?',v951^t,|INTERNET|n951^t)
&unifor(|+I?1,,,,I=|v421^w|?|,v421^a)

Выдача метки, порядкового номера и значения поля в соответствии с индексом (номером повторения) повторяющейся группы – &uf('+4…

Вид функции: +4.

Назначение: Выдача метки, порядкового номера и значения поля в соответствии с индексом (номером повторения) повторяющейся группы.

Формат (передаваемая строка):

+4XY 

где:

  • Х принимает три значения: T – выдать метку; F – выдать значение поле; N – выдать порядковый номер поля в записи (отличается от индекса повторения, если Y принимает значение 1);
  • Y принимает значения: 0 – поля выдаются в порядке расположения в записи; 1 – поля выдаются в порядке возрастания меток (по умолчанию 0).

Примеры:

(…&unifor('+4T1'),'_' &unifor('+4N1'),': ', &unifor('+4F1'),'
'…)

Выдача элемента списка/справочника в соответствии с индексом (номером повторения) повторяющейся группы – &uf('+5…

Вид функции: +5.

Назначение: Выдача элемента списка/справочника в соответствии с индексом (номером повторения) повторяющейся группы.

Формат (передаваемая строка):

+5Х<имя_справочника/списка> 

где Х принимает значения: Т – выдать значение; F – выдать пояснение (имеет смысл, если задается справочник, т.е. файл с расширением MNU).

Примеры:

…(…&unifor('+5Tfield.mnu'),' – ',&unifor('+5Ffield.mnu'),'
'…)

Вернуть номер текущего повторения в повторяющейся группе – &uf('+90…

Вид функции: +90.

Назначение: Вернуть номер текущего повторения в повторяющейся группе.

Формат (передаваемая строка):

+90

Выдать статус записи – &uf('+6…

Вид функции: +6.

Назначение: Выдать статус записи. Если запись логически удаленная, возвращается 0, в противном случае – 1.

Формат (передаваемая строка):

+6

Примеры:

… if &unifor('+6')='0' then 'запись логически удаленная' fi …

Функции для работы с базой данных электронного каталога

Выдать библиографическую свертку документа – &uf('B…

Вид функции: B.

Назначение: Выдать библиографическую свертку документа.

Формат (передаваемая строка):

B

Примеры:

&unifor('B')

Контроль ISSN/ISBN – &uf('C…

Вид функции: C.

Назначение: Контроль ISSN/ISBN. Возвращаемое значение: 0 – при положительном результате, 1 – при отрицательном.

Формат (передаваемая строка):

С<ISSN/ISBN>

Примеры:

&unifor("C"v10^a)

Вернуть окончание термина – &uf('L…

Вид функции: L.

Назначение: Вернуть окончание термина.

Формат (передаваемая строка):

L<начало_термина>

Примеры:

&unifor("L"v101)

Кумуляция номеров журналов – &uf('U…

Вид функции: U.

Назначение: Кумуляция номеров журналов.

Формат (передаваемая строка):

U<strbase>,<stradd>

где:

  • <strbase> – исходная кумулированная строка.
  • <stradd> – кумулируемые номера.

Примеры:

&unifor("U"v909^h",12")

Декумуляция номеров журналов – &uf('V…

Вид функции: V.

Назначение: Декумуляция номеров журналов.

Формат (передаваемая строка):

V<strbase>

где: <strbase> – исходная строка для декумуляции.

Примеры:

&unifor("V"v909^h")

Контроль кумуляции – &uf('W…

Вид функции: W.

Назначение: Контроль кумуляции.

Формат (передаваемая строка):

W<strbadd>,<strbase>

где:

  • <strbase> – исходная кумулированная строка.
  • <stradd> – кумулируемый номер.

Возвращаемые значения:

  • 0 – если <stradd> не присутствует в <strbase>.
  • 1 – если <stradd> присутствует в <strbase>.

Примеры:

&unifor("W12,"v909^h)

Функции, используемые только в глобальной корректировке

Размножение экземпляров – &uf('Z…

Вид функции: Z.

Назначение: Размножение экземпляров. Функция ничего не возвращает. Можно применять только в глобальной корректировке.

Формат (передаваемая строка):

Z

Примеры:

&unifor('Z')

Отсортировать повторения заданного поля – &uf('M…

Вид функции: M.

Назначение: Отсортировать повторения заданного поля (имеется в виду строковая сортировка) – функция ничего не возвращает. Можно применять только в глобальной корректировке.

Формат (передаваемая строка):

MX<tag>^<delims>

где:

  • X – вид сортировки: I – по возрастанию; D – по убыванию.
  • <tag> – метка поля.
  • <delims> – разделители подполей, определяющих ключ сортировки.

Примеры:

&unifor('MI910^BD')

Функции, не вошедшие в другие категории

Универсальный счетчик – &uf('S…

Вид функции: S.

Назначение: Универсальный счетчик.

Формат (передаваемая строка):

SN

где:

  • N=0 – обнулить счетчик.
  • N=1..9 – увеличить значение счетчика на со-отв. значение.
  • N=A – вернуть значение счетчика – арабскими цифрами.
  • N=X – вернуть значение счетчика – римскими цифрами.

Примеры:

&unifor('S0')
&unifor('S1')
&unifor('SA')

Генерация случайного числа – &uf('R…

Вид функции: R.

Назначение: Генерация случайного числа.

Формат (передаваемая строка):

RNN

где NN – кол-во знаков в случайном числе (по умолчанию – 6).

Примеры:

&unifor('R10')


Группа технических форматных выходов – &uf('+9…

Вид функции: +9.

Назначение: Группа технических форматных выходов.

Формат (передаваемая строка):

+9T<исходные_данные>

T – определяет тип и принимает следующие значения:

  • 0 – вернуть номер текущего повторения в повторяющейся группе (исходные данные не задаются);
  • 1 – вернуть имя файла из заданного полного пути/имени;
  • 2 – вернуть путь из заданного полного пути/имени;
  • 3 – вернуть расширение из заданного полного пути/имени;
  • 4 – вернуть имя диска из заданного полного пути;
  • 5 – вернуть длину исходной строки;
  • 6 – вернуть фрагмент строки:
+96A*SSS.NNN#<строка>

где:

    • A – направление: 0 – с начала строки; 1 – с конца;
    • SSS – смещение;
    • NNN – кол-во символов;
  • 7 – вернуть строку в верхнем регистре;
  • 8 – заменить в заданной строке один символ на другой (регистр учитывается):
+98ab<строка>

где:

    • a – заменяемый символ;
    • b – заменяющий символ;
  • 9 – групповая установка глобальных переменных (для ИРБИС-Навигатора). Исходная строка закодирована через URLEncode (&unifor('+3E....). После раскодировки рассматривается как список строк(TStringList.Text). Каждая строка этого списка имеет структуру: NNN#<значение_глобальной_переменной_NNN>;
  • C – вставить данные из заданного текстового файла:
+9С<path>,<dbname>,<filename>
    • <path> – определяет относительный путь к файлу в рамках ИР-БИС и принимает значения: 0 – основная директория системы (для ИРБИС32 – та, где находятся исполняемые модули; для ИРБИС64 – та, где находятся исполняемые модули сервера); 1 – общая директория баз данных (по умолчанию \DATAI); 10 – директо-рия конкретной БД;
    • <dbname> – имя БД (имеет смысл только при path=10). По умолчанию – предполагается текущая БД;
    • <filename> – имя файла;
  • D – сохранить заданный внутренний двоичный объект в заданном файле: +9DNN#<полный путь>, где NN – номер внутреннего двоичного объекта;
  • F – вернуть ANSI-символ с заданным кодом;
  • G – преобразовать заданную строку в список слов.