Язык форматирования системы ИРБИС - История изменений

Sokv: /* Выполнение файла формата */

2017-06-30T13:56:42Z

‎Выполнение файла формата

Sokv в 17:42, 12 сентября 2016

2016-09-12T17:42:00Z

Sokv в 16:57, 20 мая 2016

2016-05-20T16:57:15Z

Внесённые изменения

Sokv: /* Вложенные форматы */

2016-05-20T15:38:37Z

‎Вложенные форматы

Sokv: /* Выполнение формата */

2016-03-18T16:39:28Z

‎Выполнение формата

Sokv: /* Команды фиктивного вывода поля */

2015-07-30T14:58:03Z

‎Команды фиктивного вывода поля

Sokv в 17:32, 29 мая 2015

2015-05-29T17:32:01Z

Sokv: /* Форматёр */

2014-06-18T19:09:40Z

‎Форматёр

Sokv в 18:47, 18 июня 2014

2014-06-18T18:47:23Z

Sokv в 16:08, 18 июня 2014

2014-06-18T16:08:22Z

@@ Строка 589: / Строка 589: @@
 Возможность выполнения файла формата реализована с помощью [[UNIFOR|форматного выхода <tt>&uf('6…</tt>]].
-Особенности выполнения файла формата:
+Выполнение файла формата происходит динамически, когда доходит очередь до данной инструкции.
-* возможно вложенное использование повторяющихся групп, если внутри повторяющейся группы выполнить файл формата, содержащий повторяющуюся группу;
-* допустима не более чем тройная вложенность выполнения файла формата;
+Только с помощью выполнения файла формата возможно вложенное использование повторяющихся групп. Для этого внутри повторяющейся группы выполнить файл формата, содержащий повторяющуюся группу.
-* выполнение файла формата происходит динамически, когда доходит очередь до данной инструкции.
 ===Вложенный формат===

@@ Строка 94: / Строка 94: @@
 ==Инструкции языка форматирования==
-===Команды вывода полей===
+===Базовые команды вывода===
 Команды вывода полей – это команды, используемые для извлечения из записи и вывода конкретного поля или подполя. Имеется [[#Команда вывода MFN|специальная команда для извлечения и вывода номера записи MFN]], хотя, строго говоря, MFN не является полем (MFN не имеет метки).
@@ Строка 185: / Строка 185: @@
 Заметим, что для подавления в MFN впереди стоящих нулей можно использовать [[Функции языка форматирования ИРБИС#Функция F(выр-1, выр-2, выр-3)|функцию F]].
-===Команды режима вывода===
+====Строковый литерал====
 Система может выводить данные в трех различных режимах: '''''режим проверки''''', '''''режим заголовка''''', '''''режим данных'''''.
@@ Строка 228: / Строка 249: @@
 |}
-===Команды горизонтального и вертикального размещения===
+====Команды вывода новой строки, пробелов, табуляции====
-В языке форматирования имеются следующие команды для управления горизонтальным и вертикальным размещением данных:
+В языке форматирования имеются следующие команды для форматирования ''плоского'' текста при помощи новых строк, пробелов, табуляции:
 * '''<tt>Xn</tt>''' – вставляет <tt>n</tt> пробелов;
 * '''<tt>Cn</tt>''' – табуляция в позицию <tt>n</tt>;
@@ Строка 253: / Строка 274: @@
 Команду <tt>Сn</tt> имеет смысл применять только в случае использования моноширинных шрифтов. Команды <tt>/</tt> <tt>#</tt> <tt>%</tt> не применимы в случае использования в форматах показа средств RTF или HTML. Команды <tt>Сn</tt> и <tt>Xn</tt> не работают в [[HTML-форматах]].
-===Литералы===
+====Форматирование текста при помощи повторяющихся и условных литералов====
-Литерал – это строка символов, заключенная в соответствующие ограничители, которая вносится в выводимый текст в таком виде, как она приведена в формате. Литералы могут использоваться, например, для именования полей.
+'''''Условный литерал''''' определяет текст, который будет выведен только в случае присутствия в записи соответствующего ему поля/подполя. Если поле является повторяющимся, то текст будет выведен только один раз, независимо от количества экземпляров поля/подполя. Условные литералы заключаются в двойные кавычки, например:
-Существуют литералы трех типов:
+'''''Повторяющийся литерал''''' определяет текст, который будет выведен только в случае присутствия в записи соответствующего ему поля или подполя. Однако, если поле повторяющееся, литерал будет выводиться для каждого экземпляра поля/подполя. Ограничителем для повторяющихся литералов служит символ вертикальной черты:
   |Автор: |
 Условные и/или повторяющиеся литералы связываются с полем или подполем своим расположением в формате. Литералы, предшествующие команде вывода поля/подполя, называемые '''''префикс-литералами''''', выводятся перед содержимым поля/подполя, в то время, как литералы, следующие за командой вывода поля/подполя, называемые '''''суффикс-литералами''''', выводятся после содержимого поля/подполя.
@@ Строка 285: / Строка 298: @@
 '''''Пустые литералы''''' – литералы нулевой длины, такие, как <tt>""</tt> или <tt>||</tt> вполне допустимы и могут использоваться, как префикс-литералы для обеспечения условного вертикального размещения или как суффикс-литералы для временного подавления автоматической пунктуации, которая обеспечивается в режиме данных.
 Примеры различных типов литералов:
@@ Строка 320: / Строка 331: @@
 ====Команды фиктивного вывода поля====
-Команды фиктивного вывода поля реализует условный вывод литералов в зависимости от наличия или отсутствия данного поля или подполя без вывода содержимого самого поля. Задаются они следующим образом: '''<tt>Dt</tt>''' или '''<tt>Dt^x</tt>''' или '''<tt>Nt</tt>''' или '''<tt>Nt^x</tt>''', где:
+Команда фиктивного вывода поля реализует условный вывод литералов в зависимости от наличия или отсутствия данного поля или подполя без вывода содержимого самого поля. Задаются они следующим образом: '''<tt>Dt</tt>''' или '''<tt>Dt^x</tt>''' или '''<tt>Nt</tt>''' или '''<tt>Nt^x</tt>''', где:
 * '''<tt>D</tt>''' указывает, что все соответствующие ей условные литералы должны выводиться только при наличии поля,
 * '''<tt>N</tt>''' указывает, что они должны выводиться только при отсутствии поля;
@@ Строка 390: / Строка 401: @@
 '''''Строковым выражением''''' являются:
-* [[#Литералы|Безусловный литерал]], например <tt>'некоторый текст'</tt>.
+* [[#Строковый литерал|Безусловный литерал]], например <tt>'некоторый текст'</tt>.
 * [[#Команды вывода полей|Команда вывода поля/подполя]], которая может включать [[#Вывод фрагмента поля или подполя|команду смещение/длина]], например <tt>v26^c*2.2</tt>.
 * [[Функции языка форматирования ИРБИС#Строковые функции|Строковая функция]], например <tt>S(v24,v25,v26)</tt>.

← Предыдущая		Версия 15:38, 20 мая 2016
Строка 563:		Строка 563:

	Об области видимости глобальных переменных см. в [[#Контекст форматёра\|подразделе ''Контекст форматёра'']].		Об области видимости глобальных переменных см. в [[#Контекст форматёра\|подразделе ''Контекст форматёра'']].
−
−	~~==Вложенные форматы==~~
−
−	~~Механизм вложенных форматов позволяет избегать дублирования программного кода.~~
−
−	В качестве ссылки на вложенный формат используется имя файла формата без расширения, обозначенное символами ASCII с кодами <tt>1C</tt> (File Separator) и <tt>1D</tt> (Group Separator). <tt>1C</tt> указывают непосредственно перед именем формата, а <tt>1D</tt> – непосредственно после.
−
−	~~В процессе интерпретации вместо таких ссылок на файлы вложенных форматов вставляется их содержимое.~~
−
−	Альтернативным способом выполнения файла форматов является использование [[UNIFOR\|форматного выхода <tt>&uf('6…</tt>]].

	==Использование команд (тэгов) RTF и HTML==		==Использование команд (тэгов) RTF и HTML==

← Предыдущая		Версия 16:39, 18 марта 2016
Строка 54:		Строка 54:

	Таким образом, в контексте выполнения формата нельзя рассчитывать на то, что до присвоения глобальным переменным каких либо значений они будут пустыми.		Таким образом, в контексте выполнения формата нельзя рассчитывать на то, что до присвоения глобальным переменным каких либо значений они будут пустыми.
		+
		+	==Кодировка==
		+
		+	Формат может начинаться с маркера кодировки UTF-8, в качестве данного маркера служит восклицательный знак.
		+
		+	Если формат начинается с восклицательного знака, то система ИРБИС при чтении данного формата будет использовать кодировку UTF-8, в противном случае Windows-1251.
		+
		+	Этот же механизм используется и при [[Технология Веб-ИРБИС#Фрейм как язык разметки\|вставке формата внутри фрейма]].

	==Запись в базе данных, используемая в примерах==		==Запись в базе данных, используемая в примерах==

@@ Строка 304: / Строка 304: @@
 |}
-==Команды фиктивного вывода поля==
+===Команды фиктивного вывода поля===
 Команды фиктивного вывода поля реализует условный вывод литералов в зависимости от наличия или отсутствия данного поля или подполя без вывода содержимого самого поля. Задаются они следующим образом: '''<tt>Dt</tt>''' или '''<tt>Dt^x</tt>''' или '''<tt>Nt</tt>''' или '''<tt>Nt^x</tt>''', где:

@@ Строка 42: / Строка 42: @@
 * в некоторых случаях клиентское приложение передаёт формат на исполнение серверному форматёру, при этом взаимодействие осуществляется через [[TCP/IP сервер ИРБИС 64|сервер ИРБИС]].
-====Экземпляр форматёра====
+====Контекст форматёра====
 Значения глобальных переменных хранятся в конкретном запущенном экземпляре форматёра. Таким образом, область видимости переменных оказывается в непосредственной связи с экземпляром форматёра:
@@ Строка 554: / Строка 554: @@
 Команда '''g''' в некоторых случаях может служить краткой альтернативой форматным выходам для чтения глобальных переменных.
-Об области видимости глобальных переменных см. в [[#Экземпляр форматёра|подразделе ''Экземпляр форматёра'']].
+Об области видимости глобальных переменных см. в [[#Контекст форматёра|подразделе ''Контекст форматёра'']].
 ==Вложенные форматы==

@@ Строка 30: / Строка 30: @@
 ====Форматёр====
-''Форматёр'' – модуль, реализующий несколько способов обработки данных с использованием языка форматирования.
+''Форматёр'' – модуль, реализующий набор функций для обработки данных с использованием языка форматирования.
 В системе ИРБИС 64 присутствует несколько реализаций форматёра:

@@ Строка 30: / Строка 30: @@
 ====Форматёр====
-''Форматёр'' - модуль, служащий для выполнения формата.
+''Форматёр'' – модуль, реализующий несколько способов обработки данных с использованием языка форматирования.
 В системе ИРБИС 64 присутствует несколько реализаций форматёра:
-* серверный форматёр, входящий в библиотеку [[IRBIS64.dll|<tt>IRBIS64.dll</tt>]],
+* серверный форматёр – [[IRBIS64.dll#Функции форматёра|входит в библиотеку <tt>IRBIS64.dll</tt>]],
-* клиентский форматёр, включённый в код клиентских приложений.
+* клиентский форматёр – включён в код клиентских приложений.
 Клиентский форматёр используется клиентскими приложениями.
@@ Строка 46: / Строка 46: @@
 Значения глобальных переменных хранятся в конкретном запущенном экземпляре форматёра. Таким образом, область видимости переменных оказывается в непосредственной связи с экземпляром форматёра:
 * В рамках одного экземпляра форматёра значения глобальных переменных, инициализированные в одном формате, доступны в другом формате.
-* В разных экземплярах форматёра - собственные наборы глобальных переменных.
+* В разных экземплярах форматёра – собственные наборы глобальных переменных.
 Например:

@@ Строка 26: / Строка 26: @@
 В форматах могут присутствовать комментарии. Признаком начала комментария является комбинация символов /*. В качестве комментария принимается часть строки от признака начала комментария до конца строки.
-===Запись в базе данных, используемая в примерах===
+===Выполнение формата===
 Если не оговорено противное, то все примеры по форматированию в последующих разделах ссылаются на запись, приведенную ниже. Эта запись присутствует в базе данных IBIS, поставляемой в дистрибутивном варианте системы в качестве учебной.
@@ Строка 524: / Строка 553: @@
 Команда '''g''' в некоторых случаях может служить краткой альтернативой форматным выходам для чтения глобальных переменных.
 ==Вложенные форматы==