ClsRuby::TagScalar

Класс тега для парсинга скалярных значений с возможными ограничениями на них.

Конструктор поддерживает следующие дополнительные ключи в хэше params:

:format

объект, реализующий интерфейс ScalarFormat. Этот объект будет использован для для преобразования токенов входного потока в значения нужного пользователю типа.

:constraint

объект, реализующий интерфейс ScalarChecker. Этот объект, если он задан, будет использован для проверки извлекаемых из входного потока значений.

:value

значение тега. Если этот параметр указан, то тег сразу объявляется определенным. Корректность значения не проверятся.

Пример использования:

Пусть необходимо парсить следующую структуру:
{params
  {min <int:1..100>}
  {max <int:100..1000>}
  {password <str>}
}

Для этого можно применить тег:
class TagParams < ClsRuby::Tag
  def initialize( params )
    super( params )

    @min = ClsRuby::TagScalar.new(
        :name => 'min', :owner => self, :mandatory => true,
        :format => ClsRuby::SCALAR_INT,
        :constraint => 1..100 )
    @max = ClsRuby::TagScalar.new(
        :name => 'max', :owner => self, :mandatory => true,
        :format => ClsRuby::SCALAR_INT,
        :constraint => 100..1000 )
    @password = ClsRuby::TagScalar.new(
        :name => 'password', :owner => self, :mandatory => true,
        :format => ClsRuby::SCALAR_STRING )
  end
end

Для извлечения значения следует воспользоваться методом TagScalar#value. Но, если тег не был определен, то TagScalar#value возвратит значение nil. Для упрощения работы с необязательными тегами можно воспользоваться методом fetch:

|| Парсит тег формата:
|| {age [{hours <uint>}] [{minutes <uint>]} [{seconds <uint>}]}
|| и возвращает в методе value значение в секундах.
class TagAge < ClsRuby::TagNoValue
  child_tag :hours, ClsRuby::TagUintScalar, :constraint => 1..24
  child_tag :minutes, ClsRuby::TagUintScalar, :constraint => 1...60
  child_tag :seconds, ClsRuby::TagUintScalar, :constraint => 1...60

  def value
    @hours.fetch( 0 ) * 3600 +
    @minutes.fetch( 0 ) * 60 +
    @seconds.fetch( 0 )
  end
end