match()->first()

[danon]

Example: (list of people, some with ages)

Clark, Brian 23, Olivia, Jane 24, Marcin 26

New API:

• Returns a group from the first match or throws exception

  pattern('[a-z]+(?: (?<age>\d+))?')->match($s)->group('age')->first();

  Throw GroupNotMatchedException if subject matched, but group wasn't.

[danon]

Right now, the only way to conrol both match and might be group:

pattern('xd')->match($subject)
    ->forFirst(function (Match $match) {
        $match->group('age')->orElse();    // subject matched, group not
        $match->group('age')->orReturn();
        $match->group('age')->orThrow();
    })
  ->orDefault('Nothing');