UNIFOR — различия между версиями
Sokv (обсуждение | вклад) |
Sokv (обсуждение | вклад) |
||
Строка 253: | Строка 253: | ||
* С - принимает значения: R - разделители справа от каждого подэлемента, кроме последнего; L - разделители слева от каждого подэлемента; D - каждый подэлемент заключен слева разделителем Х и справа - Y. | * С - принимает значения: R - разделители справа от каждого подэлемента, кроме последнего; L - разделители слева от каждого подэлемента; D - каждый подэлемент заключен слева разделителем Х и справа - Y. | ||
* ? - символ-разделитель. | * ? - символ-разделитель. | ||
− | * Остальные параметры аналогичны параметрам для функции | + | * Остальные параметры аналогичны параметрам для функции {{Описание функции UNIFOR (ссылка)|name=A|title=Выдать заданное повторение поля}}. |
'''Примеры:''' | '''Примеры:''' | ||
Строка 438: | Строка 438: | ||
+1MNNN,nnn#MMM,mmm | +1MNNN,nnn#MMM,mmm | ||
+ | где параметры аналогичны описанным для функции {{Описание функции UNIFOR (ссылка)|name=+1K|title=Групповая мультираскодировка переменных}} | ||
+ | |||
+ | {{Описание функции UNIFOR | ||
+ | |name=+1S | ||
+ | |title=Вычитание списков (групп переменных) | ||
+ | }} | ||
− | + | +1SNNN,nnn#MMM,mmm | |
− | + | где параметры аналогичны описанным для функции {{Описание функции UNIFOR (ссылка)|name=+1K|title=Групповая мультираскодировка переменных}} | |
+ | |||
+ | {{Описание функции UNIFOR | ||
+ | |name=+1A | ||
+ | |title=Сложение списков (групп переменных) | ||
+ | }} | ||
+ | |||
+ | +1ANNN,nnn#MMM,mmm | ||
+ | где параметры аналогичны описанным для функции {{Описание функции UNIFOR (ссылка)|name=+1K|title=Групповая мультираскодировка переменных}} | ||
+ | |||
+ | {{Описание функции UNIFOR | ||
+ | |name=+1G | ||
+ | |title=Исключение неоригинальных значений из группы переменных | ||
+ | }} | ||
+ | |||
+ | +1GNNN,nnn | ||
+ | где параметры аналогичны описанным для функции {{Описание функции UNIFOR (ссылка)|name=+1K|title=Групповая мультираскодировка переменных}} | ||
+ | |||
+ | {{Описание функции UNIFOR | ||
+ | |name=+1T | ||
+ | |title=Сортировка группы переменных | ||
+ | }} | ||
+ | |||
+ | +1TNNN,nnn | ||
+ | где параметры аналогичны описанным для функции {{Описание функции UNIFOR (ссылка)|name=+1K|title=Групповая мультираскодировка переменных}} | ||
+ | |||
+ | {{Описание функции UNIFOR | ||
+ | |name=+1I | ||
+ | |title=Исключение неоригинальных значений из списка | ||
+ | }} | ||
+ | |||
+ | +1ISSSS | ||
+ | где параметры аналогичны описанным для функции {{Описание функции UNIFOR (ссылка)|name=+1O|title=Групповая мультираскодировка списка}} | ||
+ | |||
+ | {{Описание функции UNIFOR | ||
+ | |name=+1V | ||
+ | |title=Сортировка списка | ||
+ | }} | ||
+ | |||
+ | +1VSSSS | ||
+ | где параметры аналогичны описанным для функции {{Описание функции UNIFOR (ссылка)|name=+1O|title=Групповая мультираскодировка списка}} | ||
[[Категория:Язык форматирования системы ИРБИС]] | [[Категория:Язык форматирования системы ИРБИС]] |
Версия 19:00, 7 апреля 2010
Содержание
- 1 Перечень функций формат-программы UNIFOR с примерами их применения
- 1.1 Выдать содержимое документа полностью – &uf('0…
- 1.2 Выдача данных, связанных с датой и временем – &uf('3…
- 1.3 Удалить двойные кавычки из заданной строки – &uf('9…
- 1.4 Выдать заданное повторение поля – &uf('A…
- 1.5 Выдать заданное оригинальное повторение поля – &uf('P…
- 1.6 Выдать библиографическую свертку документа – &uf('B…
- 1.7 Контроль ISSN/ISBN – &uf('C…
- 1.8 Вернуть заданное количество слов с начала строки – &uf('E…
- 1.9 Вернуть часть строки, начиная со следующего слова после указанного и до конца строки – &uf('F…
- 1.10 Вернуть часть строки до или начиная с заданного символа – &uf('G…
- 1.11 Универсальный счетчик – &uf('S…
- 1.12 Вернуть окончание термина – &uf('L…
- 1.13 Кумуляция номеров журналов – &uf('U…
- 1.14 Декумуляция номеров журналов – &uf('V…
- 1.15 Контроль кумуляции – &uf('W…
- 1.16 Размножение экземпляров – &uf('Z…
- 1.17 Генерация случайного числа – &uf('R…
- 1.18 Раскодировка через справочник (меню) – &uf('K…
- 1.19 Вернуть параметр из INI-файла – &uf('I…
- 1.20 Вернуть заданный подэлемент – &uf('1…
- 1.21 Транслитерация кириллических символов с помощью латиницы – &uf('T…
- 1.22 Вернуть кол-во ссылок для заданного термина – &uf('J…
- 1.23 Форматирование документа из другой БД – &uf('D…
- 1.24 Удаление из заданной строки фрагментов, выделенных угловыми скобками <> – &uf('X…
- 1.25 Вернуть заданную строку в нижнем регистре – &uf('Q…
- 1.26 Отсортировать повторения заданного поля – &uf('M…
- 1.27 Расформатирование группы связанных документов из другой БД – &uf('7…
- 1.28 Команда постредактуры: очистить результат расформатирования от двойных разделителей – &uf('!…
- 1.29 Команда постредактуры: очистить результат расформатирования от RTF-конструкций – &uf('+F…
- 1.30 Очистить (опустошить) все глобальные переменные – &uf('+1…
- 1.31 Чтение глобальных переменных – &uf('+1R…
- 1.32 Запись в глобальные переменные – &uf('+1W…
- 1.33 Групповая мультираскодировка списка – &uf('+1O…
- 1.34 Групповая мультираскодировка переменных – &uf('+1K…
- 1.35 Перемножение двух списков (групп переменных) – &uf('+1M…
- 1.36 Вычитание списков (групп переменных) – &uf('+1S…
- 1.37 Сложение списков (групп переменных) – &uf('+1A…
- 1.38 Исключение неоригинальных значений из группы переменных – &uf('+1G…
- 1.39 Сортировка группы переменных – &uf('+1T…
- 1.40 Исключение неоригинальных значений из списка – &uf('+1I…
- 1.41 Сортировка списка – &uf('+1V…
Перечень функций формат-программы UNIFOR с примерами их применения
Выдать содержимое документа полностью – &uf('0…
Вид функции: 0.
Назначение: Выдать содержимое документа полностью (формат ALLl).
Формат (передаваемая строка):
0
Примеры:
&unifor('0')
Выдача данных, связанных с датой и временем – &uf('3…
Вид функции: 3.
Назначение: Выдача данных, связанных с датой и временем.
Формат (передаваемая строка):
Имеются следующие подфункции:
- 3 - выдать текущую дату в виде ГГГГММДД.
- 30 - выдать текущий год в виде ГГГГ.
- 31 - выдать текущий месяц в виде ММ (с лидирующим нулем).
- 32 - выдать текущий день в виде ДД (с лидирующим нулем).
- 33 - выдать текущий год в виде ГГ.
- 34 - выдать текущий месяц в виде М (без лидирующего нуля).
- 35 - выдать текущий день в виде Д (без лидирующего нуля).
- 36MM - выдать по заданному номеру месяца его название на русском языке в именительном падеже.
- 37MM - выдать по заданному номеру месяца его название на русском языке в родительном падеже.
- 38MM - выдать по заданному номеру месяца его название на английском языке.
- 39 - выдать текущее время.
- 3А - выдать номер текущего дня от начала года.
- 3BГГГГММДД/ддд - прибавить/вычесть из заданной даты в виде ГГГГММДД заданное количество дней (ддд – м.б. с минусом) и вернуть полученную дату в виде ГГГГММДД.
- 3СГГГГММДД/ГГГГММДД - вычесть из одной даты в виде ГГГГММДД другую дату в виде ГГГГММДД и вернуть разницу в виде количества дней.
Примеры:
&unifor('36',&unifor('34'))
Удалить двойные кавычки из заданной строки – &uf('9…
Вид функции: 9.
Назначение: Удалить двойные кавычки из заданной строки.
Формат (передаваемая строка):
9<исх.строка>
Примеры:
&unifor("9"v200^a)
Выдать заданное повторение поля – &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('B…
Вид функции: B.
Назначение: Выдать библиографическую свертку документа.
Формат (передаваемая строка):
B
Примеры:
&unifor('B')
Контроль ISSN/ISBN – &uf('C…
Вид функции: C.
Назначение: Контроль ISSN/ISBN. Возвращаемое значение: 0 - при положительном результате, 1 - при отрицательном.
Формат (передаваемая строка):
С<ISSN/ISBN>
Примеры:
&unifor("C"v10^a)
Вернуть заданное количество слов с начала строки – &uf('E…
Вид функции: E.
Назначение: Вернуть заданное количество слов с начала строки.
Формат (передаваемая строка):
EN<строка>
где N - количество слов (одна цифра).
Примеры:
&unifor("E3"v200^a)
Вернуть часть строки, начиная со следующего слова после указанного и до конца строки – &uf('F…
Вид функции: F.
Назначение: Вернуть часть строки, начиная со следующего слова после указанного и до конца строки.
Формат (передаваемая строка):
FN<строка>
где N - количество слов (одна цифра).
Примеры:
&unifor("F3"v200^a)
Вернуть часть строки до или начиная с заданного символа – &uf('G…
Вид функции: G.
Назначение: Вернуть часть строки до или начиная с заданного символа.
Формат (передаваемая строка):
GNA<строка>
где:
- N=0 если ДО заданного символа (не включая его); N=1 если начиная С заданного символа (включая его).
- А - заданный символ (# - обозначает цифру; $ - обозначает букву).
Примеры:
&unifor("G0#"v700) &unifor("G1-"v700^a)
Универсальный счетчик – &uf('S…
Вид функции: S.
Назначение: Универсальный счетчик.
Формат (передаваемая строка):
SN
где:
- N=0 - обнулить счетчик.
- N=1..9 - увеличить значение счетчика на со-отв. значение.
- N=A - вернуть значение счетчика - арабскими цифрами.
- N=X - вернуть значение счетчика - римскими цифрами.
Примеры:
&unifor('S0') &unifor('S1') &unifor('SA')
Вернуть окончание термина – &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('R…
Вид функции: R.
Назначение: Генерация случайного числа.
Формат (передаваемая строка):
RNN
где NN - кол-во знаков в случайном числе (по умолчанию - 6).
Примеры:
&unifor('R10')
Раскодировка через справочник (меню) – &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('T…
Вид функции: T.
Назначение: Транслитерация кириллических символов с помощью латиницы.
Формат (передаваемая строка):
TN<строка>
где N - вид таблицы транслитерации (0 или 1).
Примеры:
&unifor("T0"V200)
Вернуть кол-во ссылок для заданного термина – &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('X…
Вид функции: X.
Назначение: Удаление из заданной строки фрагментов, выделенных угловыми скобками <>.
Формат (передаваемая строка):
X<строка>
Примеры:
&unifor("X"v200)
Вернуть заданную строку в нижнем регистре – &uf('Q…
Вид функции: Q.
Назначение: Вернуть заданную строку в нижнем регистре.
Формат (передаваемая строка):
Q<строка>
Примеры:
&unifor("Q"v200)
Отсортировать повторения заданного поля – &uf('M…
Вид функции: M.
Назначение: Отсортировать повторения заданного поля (имеется в виду строковая сортировка) - функция ничего не возвращает. Можно применять только в глобальной корректировке.
Формат (передаваемая строка):
MX<tag>^<delims>
где:
- X - вид сортировки: I - по возрастанию; D - по убыванию.
- <tag> - метка поля.
- <delims> - разделители подполей, определяющих ключ сортировки.
Примеры:
&unifor('MI910^BD')
Расформатирование группы связанных документов из другой БД – &uf('7…
Вид функции: 7.
Назначение: Расформатирование группы связанных документов из другой БД (отношение «от одного к многим»).
Формат (передаваемая строка):
7<имя_БД>,</termin/>,<@имя_формата|формат|*>
где:
- имя_БД - имя базы данных, из которой будут браться связанные документы; по умолчанию используется текущая БД.
- /termin/ - ключевой термин, на основе которого отбираются связанные документы; термин заключается в уникальные ограничители (например. /), в качестве которых используется символ, не входящий (гарантированно) в термин.
- @имя_формата|формат|* - имя формата или формат в явном виде, в соответствии с которым будут расформатироваться связанные документы. Если задается имя формата, то он берется из директории БД, заданной параметром <имя_БД>. Если задается *, данные выводятся по прямой ссылке (метка поля, номер повторения).
Примеры:
&unifor('7TEST,',"/T="v200^a"/",',v903"\par "')
Команда постредактуры: очистить результат расформатирования от двойных разделителей – &uf('!…
Вид функции: !.
Назначение: Команда постредактуры: очистить результат расформатирования от двойных разделителей (двойных точек или двойных конструкций <. - >). Имеет смысл использовать один раз в любом месте формата.
Формат (передаваемая строка):
!
Примеры:
&unifor('!')
Команда постредактуры: очистить результат расформатирования от RTF-конструкций – &uf('+F…
Вид функции: +F.
Назначение: Команда постредактуры: очистить результат расформатирования от RTF-конструкций. Имеет смысл использовать один раз в любом месте формата.
Формат (передаваемая строка):
+F
Примеры:
&unifor('+F')
Очистить (опустошить) все глобальные переменные – &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('+1O…
Вид функции: +1O.
Назначение: Групповая мультираскодировка списка.
Формат (передаваемая строка):
+1O<MNU>|SSSS
где:
- <MNU> имя справочника (с расширением).
- SSSS – список строк (результат расформатирования.
Примеры:
&unifor(‘+1Omhr.mnu|’,(v910^m/))
Групповая мультираскодировка переменных – &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('+1I…
Вид функции: +1I.
Назначение: Исключение неоригинальных значений из списка.
Формат (передаваемая строка):
+1ISSSS
где параметры аналогичны описанным для функции Групповая мультираскодировка списка – &uf('+1O…
Сортировка списка – &uf('+1V…
Вид функции: +1V.
Назначение: Сортировка списка.
Формат (передаваемая строка):
+1VSSSS
где параметры аналогичны описанным для функции Групповая мультираскодировка списка – &uf('+1O…