Конвертеры


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

Конвертеры позволяют преобразовать данные токена, помещаемые в $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 только идентификатор сущности, а список ассоциированных значений содержится в справочнике.

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней