my ($first_char, $last_char, @all) = $search->matches(
text => $search_text,
regex => $search_regexp,
from => $from,
to => $to,
backwards => $reverse,
* The text in which we need to search
* The regular expression
* The offset within the text where we the last match started so the next
forward match must start after this.
* The offset within the text where we the last match ended so the next
backward match must end before this.
* backward bit (1 = search backward, 0 = search forward)