Match String against Regex. On success, Sub is a dict containing
integer keys for the numbered capture group and atom keys for the
named capture groups. The entire match string has the key 0. The
associated value is determined by the capture_type(Type) option
passed to re_compile/3, or by flags if Regex is of the form
Pattern/Flags; and may be specified at the level of individual
captures using a naming convention for the caption name. See
re_compile/3 for details.
The example below exploits the typed groups to parse a date
specification:
?- re_matchsub("(?<date> (?<year_I>(?:\\d\\d)?\\d\\d) -
(?<month_I>\\d\\d) - (?<day_I>\\d\\d) )"/x,
"2017-04-20", Sub, []).
Sub = re_match{0:"2017-04-20", date:"2017-04-20",
day:20, month:4, year:2017}.
- Arguments:
-
| Both | - compilation and execution options are processed. See
re_compile/3 and re_match/3 for the set of options. In addition,
some compilation options may passed as /Flags to Regex - see
re_match/3 for the list of flags. |
| Regex | - See re_match/2 for a description of this argument. |
