Class: Rley::Syntax::Production

Inherits:
Object
  • Object
show all
Defined in:
lib/rley/syntax/production.rb

Overview

In a context-free grammar, a production is a rule in which its left-hand side (LHS) consists solely of a non-terminal symbol and the right-hand side (RHS) consists of a sequence of symbols. The symbols in RHS can be either terminal or non-terminal symbols. The rule stipulates that the LHS is equivalent to the RHS, in other words every occurrence of the LHS can be substituted to corresponding RHS.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(aNonTerminal, theSymbols) ⇒ Production

Create a Production instance.

Parameters:



42
43
44
45
 
# File 'lib/rley/syntax/production.rb', line 42

def initialize(aNonTerminal, theSymbols)
  @lhs = valid_lhs(aNonTerminal)
  @rhs = valid_rhs(theSymbols)
end

Instance Attribute Details

#generative=(value) ⇒ Boolean (writeonly)

rhs members are generative (that is, they can each generate/derive a non-empty string of terminals).

Returns:

  • (Boolean) —

    A production is generative when all of its



28
29
30
 
# File 'lib/rley/syntax/production.rb', line 28

def generative=(value)
  @generative = value
end

#lhs ⇒ NonTerminal (readonly) Also known as: head

Returns The left-hand side of the rule.

Returns:



19
20
21
 
# File 'lib/rley/syntax/production.rb', line 19

def lhs
  @lhs
end

#name ⇒ String

Returns The name of the production rule. It must be unique in a grammar.

Returns:

  • (String) —

    The name of the production rule. It must be unique in a grammar.



23
24
25
 
# File 'lib/rley/syntax/production.rb', line 23

def name
  @name
end

#nullable=(value) ⇒ Boolean (writeonly)

Returns A production is nullable when all of its rhs members are nullable.

Returns:

  • (Boolean) —

    A production is nullable when all of its rhs members are nullable.



32
33
34
 
# File 'lib/rley/syntax/production.rb', line 32

def nullable=(value)
  @nullable = value
end

#rhs ⇒ SymbolSeq (readonly) Also known as: body

Returns The right-hand side (rhs).

Returns:



16
17
18
 
# File 'lib/rley/syntax/production.rb', line 16

def rhs
  @rhs
end

Instance Method Details

#as(aName) ⇒ Object

A setter for the production name

Parameters:

  • aName (String) —

    the name of the production



80
81
82
 
# File 'lib/rley/syntax/production.rb', line 80

def as(aName)
  @name = aName
end

#empty? ⇒ Boolean

Is the rhs empty?

Returns:

  • (Boolean) —

    true if the rhs has no members.



49
50
51
 
# File 'lib/rley/syntax/production.rb', line 49

def empty?()
  return rhs.empty?
end

#generative? ⇒ Boolean

Return true iff the production is generative

Returns:

  • (Boolean) 


54
55
56
57
58
59
 
# File 'lib/rley/syntax/production.rb', line 54

def generative?()
  if @generative.nil?
  end

  return @generative
end

#inspect ⇒ String

Returns a string containing a human-readable representation of the production.

Returns:

  • (String) 


69
70
71
72
73
74
75
76
 
# File 'lib/rley/syntax/production.rb', line 69

def inspect()
  result = +"#<#{self.class.name}:#{object_id}"
  result << " @name=\"#{name}\""
  result << " @lhs=#{lhs.name}"
  result << " @rhs=#{rhs.inspect}"
  result << " @generative=#{@generative}>"
  return result
end

#nullable? ⇒ Boolen

Returns true iff the production is nullable.

Returns:

  • (Boolen) —

    true iff the production is nullable



62
63
64
 
# File 'lib/rley/syntax/production.rb', line 62

def nullable?()
  return @nullable
end