+
Point of view
All features
deferred class PARSE_TERMINAL [C_ -> PARSE_CONTEXT]
Summary
A terminal meant to be put in a PARSE_TABLE.
Direct parents
Inherit list: PARSE_ATOM
Insert list: LOGGING
Known children
Inherit list: DESCENDING_TERMINAL, PACKRAT_TERMINAL
Class invariant
Overview
Features
{ANY}
{PARSE_TABLE}
{PARSER_FACET}
  • parse (context: C_): TRISTATE
    The Result is yes if the parsing succeeded, no if there was a syntax error, or maybe if the parse could complete with some more text.
{}
{ANY}
{PARSE_TABLE}
{}
{ANY}
{}
  • log: LOGGER
    There is one logger per concrete type; for performance reasons it is cached in each instance.
  • log_memory__0_: LOGGER
    The cached logger.
out_in_tagged_out_memory
effective procedure
{ANY}
Append terse printable representation of current object in tagged_out_memory.
require
    • locked: tagged_out_locked
      • locked: tagged_out_locked
      • locked: tagged_out_locked
ensure
  • still_locked: tagged_out_locked
  • not_cleared: tagged_out_memory.count >= old tagged_out_memory.count
  • append_only: old tagged_out_memory.twin.is_equal(tagged_out_memory.substring(1, old tagged_out_memory.count))
is_coherent: BOOLEAN
is True
constant attribute
{ANY}
require
  • table /= Void
ensure
  • must_be_coherent: Result
set_default_tree_builders (non_terminal_builder: PROCEDURE[TUPLE 2[FIXED_STRING, TRAVERSABLE[FIXED_STRING]]], terminal_builder: PROCEDURE[TUPLE 2[FIXED_STRING, PARSER_IMAGE]])
effective procedure
require
  • is_coherent
parse (context: C_): TRISTATE
effective function
The Result is yes if the parsing succeeded, no if there was a syntax error, or maybe if the parse could complete with some more text.
require
  • context /= Void
ensure
  • context.actions.count >= old context.actions.count
  • not Result.is_equal(yes) implies context.buffer.current_index = old context.buffer.current_index and then context.actions.count = old context.actions.count
effective procedure
{}
a_parser is used to parse the input buffer; it must return Void if the terminal cannot be parsed, or a STRING containing the corresponding image that will be passed to the action if the terminal is reduced.
require
  • a_parser /= Void
ensure
writable attribute
{}
writable attribute
{}
call_action (image: PARSER_IMAGE)
effective procedure
{}
require
call_terminal_builder (terminal_builder: PROCEDURE[TUPLE 2[FIXED_STRING, PARSER_IMAGE]], image: PARSER_IMAGE)
effective procedure
{}
writable attribute
{ANY}
table: PARSE_TABLE[C_]
writable attribute
{ANY}
pretty_print_on (stream: OUTPUT_STREAM)
deferred procedure
{ANY}
require
  • stream.is_connected
set (a_name: ABSTRACT_STRING, a_table: PARSE_TABLE[C_])
effective procedure
require
  • name = Void
  • table = Void
  • not a_name.is_empty
  • a_table /= Void
ensure
set_table (a_table: PARSE_TABLE[C_])
effective procedure
require
  • a_table /= Void
ensure
add_error_position (error: STRING, buffer: MINI_PARSER_BUFFER)
effective procedure
{}
print_error_position (o: OUTPUT_STREAM, buffer: MINI_PARSER_BUFFER)
effective procedure
{}
yes: TRISTATE
effective function
{ANY}
effective function
{ANY}
maybe: TRISTATE
effective function
{ANY}
log: LOGGER
effective function
{}
There is one logger per concrete type; for performance reasons it is cached in each instance.
ensure
  • Result /= Void
log_memory__0_: LOGGER
writable attribute
{}
The cached logger.
The ugly name is intentional. Don't use directly.