Contents

module Rley # This module is used as a namespace
  module GFG # This module is used as a namespace
    # Abstract class. Represents a vertex in a grammar flow graph
    # Responsibilities:
    # - To know its outgoing edges
    # - To know its label
    class Vertex
      # The edges linking the successor vertices to this one.
      # @return [Array<Edge>] The edge(s) linking this vertex to successor(s)
      attr_reader :edges
      
      # Constructor to extend in subclasses.
      def initialize()
        @edges = []
      end
      
      # Add an graph edge to this vertex.
      # @param anEdge [Edge] the edge to be added.
      def add_edge(anEdge)
        arrow = check_add_edge(anEdge)
        edges << arrow
      end
      
      # Determine if the vertex corresponds to an dotted item that has 
      # its dot at the end of a production (i.e. is a reduced item).
      # @return [Boolean] true iff vertex corresponds to reduced item.
      def complete?()
        return false # Default implementation
      end
      
      # Retrieve the grammar symbol before the dot.
      # @return [GrmSymbol, NilClass] The symbol or otherwise nil.
      def prev_symbol()
        return nil # Default implementation
      end      
      
      # Retrieve the grammar symbol after the dot.
      # @return [GrmSymbol, NilClass] The symbol or otherwise nil. 
      def next_symbol()
        return nil # Default implementation
      end
      
      protected

      # Validation method for adding an outgoing edge to the vertex.
      # Vertices will accept an indegree and outdegree of at most one
      # unless this method is overridden in subclasses
      def check_add_edge(anEdge)
        raise StandardError, 'At most one edge accepted' unless edges.empty?
        return anEdge
      end
    end # class
  end # module
end # module

# End of file

Version data entries

5 entries across 5 versions & 1 rubygems

Version	Path
rley-0.5.10	lib/rley/gfg/vertex.rb
rley-0.5.09	lib/rley/gfg/vertex.rb
rley-0.5.08	lib/rley/gfg/vertex.rb
rley-0.5.07	lib/rley/gfg/vertex.rb
rley-0.5.06	lib/rley/gfg/vertex.rb