Конвертеры

подсказка

Конвертеры — скрипты, которые используются для интерпретации значений текста в каждом токене.

Конвертеры позволяют преобразовать данные токена, помещаемые в $parseTree.

Объявление

Объявление конвертера:

• при объявлении паттерна;

patterns:
        $four = четыре || converter = function() {return 4}

• в тегах init;

init:
    function amountConverter(pt) {
        var ret = pt.Number[0].value;
        return ret
    }

• в файле .js-библиотек, например converters.js.

    function amountConverter(pt) {
        var ret = pt.Number[0].value;
        return ret
    }

В функции конвертеров передается $parseTree первым аргументом.

Вы можете использовать внутри конвертера переменную, в которую передается $parseTree. Для этого задайте её имя первым аргументом функции, вторым аргументом передается контекст.

Применение

Применение конвертеров:

• Формирование значения из текста.

Сценарий:

$Digit = $regexp<\d+> || converter = numberConverterDigit

.js-файл:

function numberConverterDigit(parseTree) {
        return parseInt(parseTree.text);
        }

• Преобразование значения из маппинга.

Сценарий:

$Numeral = (один:1|...) || converter = valueToNumberConverter

.js-файл:

function valueToNumberConverter(parseTree) {
        return parseInt(parseTree.value);
        }

• Формирование значения из вложенных токенов.

Сценарий:

$Numeral = (один:1|...)
$Minutes = $Numeral || converter = minutesConverter

.js-файл:

function minutesConverter(parseTree) {
         return parseInt(parseTree.Numeral.value)
        };

• Формирование значения из справочников.

Сценарий:

$City = $entity<Cities> || converter = сityConverter

.js-файл:

function сityConverter(parseTree) {
        var id = parseTree.City[0].value;
        return Cities[id].value;
    }

предупреждение

Правило $entity записывает в value только идентификатор сущности, а список ассоциированных значений содержится в справочнике.