class Regexp::Scanner

def self.scan(input_object, &block)

--------------------------------------------------------------------------
This method may raise errors if a syntax error is encountered.

given, it gets called for each emitted token.
emitted token into an array that gets returned at the end. If a block is
Scans the given regular expression text, or Regexp object and collects the
def self.scan(input_object, &block)
  new.scan(input_object, &block)
end