PREDICATE-DECLARE — TOULMIN Codec, объявляющий предикат (формулу вердикта). Раскладка — EXPR. EXPR — раскладка для записи условных выражений из Rules в TANGEUL. Дерево условного выражения хранится развёрнутым в прямом порядке, а строки внутри выражения указываются через таблицу меток внутри записи. Поэтому запись самодостаточна и не требует записей TEXT.

ПунктЗначение
ИмяPREDICATE-DECLARE (BIND PREDICATE-DECLARE документа спецификации)
TAG ID0x101L
Codec ID0x00001010
Документ спецификации0x00000000/codecs/0x00001010/ (объект DECLARE 1010)
Раздел8 1000 (Edge TOULMIN), смещение внутри раздела C = 1
KindEdge · семейство: TOULMIN, группа: объявление, раскладка: EXPR
TAG WORD0001 0000 0001 LLLL (000K KKKC CCCC LLLL)
Описание в индексеобъявление предиката. Функции и формулы вердикта, критерий (Spec), контракт фактов (Ground)
Сторона Hugoedge/toulmin/expr.md

Раскладка

ID                     запись LOCAL Reference (Edge Id)
Число узлов 1 WORD     общее число записей выражения
Число меток 1 WORD
Метка × число меток    запись UTF8-TEXT Value
Запись выражения × число узлов   в прямом порядке
  • Метка — строка: имя поля, строковое значение, шаг пути, имя функции. Пустая строка тоже может быть меткой. Запись выражения указывает на метку индексом (1 WORD), нумерация с 0.
  • Записи выражения идут так: родитель, затем его дочерние по порядку (прямой порядок). Число дочерних в каждой записи и этот порядок однозначно задают дерево.

Запись выражения

Запись выражения начинается с заголовка в 1 WORD.

Заголовок 1 WORD      младшие 2 бита вида (b15–14) | старший 1 бит вида (b13) | число дочерних 13 бит (b12–0)

Вид = (b13 << 2) | b15–14.

ВидИмяЧисло дочернихПосле заголовка
0COMPARE0оператор сравнения 1 WORD, метка поля 1 WORD, место значения
1LOGICnоператор логики 1 WORD
2NOT1нет
3EITHERnнет
4EXISTS1оператор квантификации 1 WORD, операнд-объект, метка имени связывания 1 WORD
5CALL0метка алиаса 1 WORD, метка имени функции 1 WORD
6COMPARE-X0оператор сравнения 1 WORD, метка поля 1 WORD, левый признак 1 WORD [+ операнд], место значения
7Reserved
  • Дочерние записи следуют после полей, идущих за заголовком. У EXISTS дочернее — одно условие.
  • COMPARE — сравнение <поле> <оператор> <значение> без операндов с обеих сторон. Если операнд есть хотя бы с одной стороны, используется COMPARE-X.
  • Если левый признак COMPARE-X равен 1, за ним следует операнд, если 0 — нет. Если левый операнд есть, метка поля — пустая строка.
  • CALL — вызов функции хоста на месте предиката. Если функция из этого документа, метка алиаса — пустая строка.

Место значения

Вид значения 1 WORD    0 число, 1 строка, 2 операнд
Значение               0: запись UNSIGNED-INTEGER Value
                       1: метка 1 WORD
                       2: операнд (только в COMPARE-X)
  • Если строка значения в точности равна канонической десятичной записи неотрицательного целого, она записывается как UNSIGNED-INTEGER Value. Все остальные значения записываются меткой. Благодаря этому строка значения восстанавливается как есть.

Операнд

Вид операнда 1 WORD    0 путь, 1 ссылка на критерий, 2 вызов функции
Путь, ссылка на критерий   число шагов 1 WORD + метка 1 WORD × число шагов
Вызов функции          метка алиаса 1 WORD + метка имени функции 1 WORD
  • Путь — путь во входных данных, ссылка на критерий — путь критерия (SPEC), внедрённого через with.

Коды операторов

КодОператор сравнения
0x0301is empty
0x0302is not empty
0x0303equals
0x0304is in
0x0305is greater than
0x0306is less than
0x0307is at most
0x0308is at least
КодЛогический оператор
0x0311and
0x0312or
КодОператор квантификации
0x0321any

Вычисление при неизвестном входе

Если вход — маркер места, операторы сравнения вычисляются в трёхзначной логике (истина, ложь, неопределённо U). Для NO-VALUE is empty истинно, остальные сравнения ложны. Для UNKNOWN-VALUE is not empty истинно, а equals, is in и сравнения по величине дают U. Для ABSENT и отсутствия описания все операторы дают U. Логические операторы следуют сильной трёхзначной логике Клини, а если предикат даёт U, вердикт узла — Review. Это вычисление — неизменное ядро (TOULMIN).

Интерпретация и действительность

  • Число узлов должно равняться числу развёрнутых записей выражения. Позиция после чтения последней записи выражения должна в точности совпадать с концом записи.
  • Если индекс метки не меньше числа меток, запись отклоняется.
  • Число дочерних у NOT и EXISTS должно быть 1.
  • Неизвестный вид (7), неизвестный вид значения или вид операнда отклоняются.
  • Число дочерних занимает 13 бит (максимум 8191).

Документ Codec

Документ Codec содержит DECLARE (объект 1010). Раскладку EXPR нельзя объявить через FIELD, потому что предшествующие простые значения (число узлов, число меток) задают число повторений, поэтому объявление полей остаётся открытой проблемой (повтор DECLARE).

Связанные страницы

Исходный текст документа спецификации

Так выглядит документ спецификации 0x00000000/codecs/0x00001010/latest.geul, прочитанный через geul show (шестнадцатеричные значения в верхнем регистре).

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000101000000000
BODY
#1 DECLARE 0x1010
#2 BIND #1 "PREDICATE-DECLARE"