Scans the stringuntil
the pattern is matched.
Advances the scanpointer if
advance_pointer_p, otherwise not. Returns the matchedstring if return_string_p is
true, otherwise returns the number of bytes advanced. This method does
affect the match register.