transformParser<R> function

  1. @useResult
Parser<R> transformParser<R>(
  1. Parser<R> parser,
  2. TransformationHandler handler
)

Transforms all parsers reachable from parser with the given handler. The identity function returns a copy of the the incoming parser.

The implementation first creates a copy of each parser reachable in the input grammar; then the resulting grammar is traversed until all references to old parsers are replaced with the transformed ones.

Implementation

@useResult
Parser<R> transformParser<R>(Parser<R> parser, TransformationHandler handler) {
  final mapping = Map<Parser, Parser>.identity();
  for (final each in allParser(parser)) {
    mapping[each] = each.copy().captureResultGeneric(handler);
  }
  final todo = [...mapping.values];
  final seen = {...mapping.values};
  while (todo.isNotEmpty) {
    final parent = todo.removeLast();
    for (final child in parent.children) {
      if (mapping.containsKey(child)) {
        parent.replace(child, mapping[child]!);
      } else if (seen.add(child)) {
        todo.add(child);
      }
    }
  }
  return mapping[parser] as Parser<R>;
}