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

Материал из Wikipedia
Перейти к: навигация, поиск
Строка 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

Содержание

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

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

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

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

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

0

Примеры:

&unifor('0')

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

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

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

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

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

  • 3 - выдать текущую дату в виде ГГГГММДД.
  • 30 - выдать текущий год в виде ГГГГ.
  • 31 - выдать текущий месяц в виде ММ (с лидирующим нулем).
  • 32 - выдать текущий день в виде ДД (с лидирующим нулем).
  • 33 - выдать текущий год в виде ГГ.
  • 34 - выдать текущий месяц в виде М (без лидирующего нуля).
  • 35 - выдать текущий день в виде Д (без лидирующего нуля).
  • 36MM - выдать по заданному номеру месяца его название на русском языке в именительном падеже.
  • 37MM - выдать по заданному номеру месяца его название на русском языке в родительном падеже.
  • 38MM - выдать по заданному номеру месяца его название на английском языке.
  • 39 - выдать текущее время.
  • - выдать номер текущего дня от начала года.
  • 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…