Class: EBNF::LL1::Lexer::Token

Inherits:
Object
  • Object
show all
Defined in:
lib/ebnf/ll1/lexer.rb

Overview

Represents a lexer token.

Examples:

Creating a new token

token = EBNF::LL1::Lexer::Token.new(:LANGTAG, "en")
token.type   #=> :LANGTAG
token.value  #=> "en"

See Also:

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(type, value, options = {}) ⇒ Token

Initializes a new token instance.

Parameters:

  • type (Symbol)
  • value (String)
  • options (Hash{Symbol => Object}) (defaults to: {})

Options Hash (options):

  • :lineno (Integer) — default: nil 


399
400
401
402
403
404
 
# File 'lib/ebnf/ll1/lexer.rb', line 399

def initialize(type, value, options = {})
  @type = type.to_s.to_sym if type
  @value = value.to_s
  @options = options.dup
  @lineno  = @options.delete(:lineno)
end

Instance Attribute Details

#lineno ⇒ Integer (readonly)

The line number where the token was encountered.

Returns:

  • (Integer) 


384
385
386
 
# File 'lib/ebnf/ll1/lexer.rb', line 384

def lineno
  @lineno
end

#options ⇒ Hash (readonly)

Any additional options for the token.

Returns:

  • (Hash) 


390
391
392
 
# File 'lib/ebnf/ll1/lexer.rb', line 390

def options
  @options
end

#type ⇒ Symbol (readonly)

The token’s symbol type.

Returns:

  • (Symbol) 


372
373
374
 
# File 'lib/ebnf/ll1/lexer.rb', line 372

def type
  @type
end

#value ⇒ String (readonly)

The token’s value.

Returns:

  • (String) 


378
379
380
 
# File 'lib/ebnf/ll1/lexer.rb', line 378

def value
  @value
end

Instance Method Details

#===(value) ⇒ Boolean

Returns ‘true` if the given `value` matches either the type or value of this token.

Examples:

Matching using the symbolic type

EBNF::LL1::Lexer::Token.new(:NIL) === :NIL     #=> true

Matching using the string value

EBNF::LL1::Lexer::Token.new(nil, "{") === "{"  #=> true

Parameters:

  • value (Symbol, String)

Returns:

  • (Boolean) 


432
433
434
435
436
437
438
439
440
 
# File 'lib/ebnf/ll1/lexer.rb', line 432

def ===(value)
  case value
    when Symbol
      value == @type
    when ::String
      @value == (@options[:case_insensitive] ? value.to_s.downcase : value.to_s)
    else value == @value
  end
end

#[](key) ⇒ Object

Returns the attribute named by ‘key`.

Parameters:

  • key (Symbol)

Returns:

  • (Object) 


411
412
413
414
415
416
417
418
 
# File 'lib/ebnf/ll1/lexer.rb', line 411

def [](key)
  key = key.to_s.to_sym unless key.is_a?(Integer) || key.is_a?(Symbol)
  case key
    when 0, :type    then @type
    when 1, :value   then @value
    else nil
  end
end

#inspect ⇒ String

Returns a developer-friendly representation of this token.

Returns:

  • (String) 


474
475
476
 
# File 'lib/ebnf/ll1/lexer.rb', line 474

def inspect
  "#{@value.inspect}#{'(' + @type.to_s + ')' if @type}"
end

#representation ⇒ Object

Returns type, if not nil, otherwise value



458
459
460
 
# File 'lib/ebnf/ll1/lexer.rb', line 458

def representation
  @type ? @type : @value
end

#to_a ⇒ Array

Returns an array representation of this token.

Returns:

  • (Array) 


466
467
468
 
# File 'lib/ebnf/ll1/lexer.rb', line 466

def to_a
  [@type, @value]
end

#to_hash ⇒ Hash

Returns a hash table representation of this token.

Returns:

  • (Hash) 


446
447
448
 
# File 'lib/ebnf/ll1/lexer.rb', line 446

def to_hash
  {:type => @type, :value => @value}
end

#to_s ⇒ Object

Readable version of token



452
453
454
 
# File 'lib/ebnf/ll1/lexer.rb', line 452

def to_s
  @type ? @type.inspect : @value
end