regex-extract iterate (HTML docs)

doc/manpage.html

@@ -327,18 +327,18 @@ OPTIONS
 
    FUNCTION LIST
 	+ + - - * / // .+ .+ .- .- .* ./ .// % ** | ^ & ~ << >> bitcount == != =~ !=~
-	> >= < <= && || ^^ ! ? : . gsub strlen sub ssub substr tolower toupper abs
-	acos acosh asin asinh atan atan2 atanh cbrt ceil cos cosh erf erfc exp expm1
-	floor invqnorm log log10 log1p logifit madd max mexp min mmul msub pow qnorm
-	round roundm sgn sin sinh sqrt tan tanh urand urand32 urandint dhms2fsec
-	dhms2sec fsec2dhms fsec2hms gmt2sec localtime2sec hms2fsec hms2sec sec2dhms
-	sec2gmt sec2gmt sec2gmtdate sec2localtime sec2localtime sec2localdate sec2hms
-	strftime strftime_local strptime strptime_local systime is_absent is_bool
-	is_boolean is_empty is_empty_map is_float is_int is_map is_nonempty_map
-	is_not_empty is_not_map is_not_null is_null is_numeric is_present is_string
-	asserting_absent asserting_bool asserting_boolean asserting_empty
-	asserting_empty_map asserting_float asserting_int asserting_map
-	asserting_nonempty_map asserting_not_empty asserting_not_map
+	> >= < <= && || ^^ ! ? : . gsub regex_extract strlen sub ssub substr tolower
+	toupper abs acos acosh asin asinh atan atan2 atanh cbrt ceil cos cosh erf erfc
+	exp expm1 floor invqnorm log log10 log1p logifit madd max mexp min mmul msub
+	pow qnorm round roundm sgn sin sinh sqrt tan tanh urand urand32 urandint
+	dhms2fsec dhms2sec fsec2dhms fsec2hms gmt2sec localtime2sec hms2fsec hms2sec
+	sec2dhms sec2gmt sec2gmt sec2gmtdate sec2localtime sec2localtime sec2localdate
+	sec2hms strftime strftime_local strptime strptime_local systime is_absent
+	is_bool is_boolean is_empty is_empty_map is_float is_int is_map
+	is_nonempty_map is_not_empty is_not_map is_not_null is_null is_numeric
+	is_present is_string asserting_absent asserting_bool asserting_boolean
+	asserting_empty asserting_empty_map asserting_float asserting_int
+	asserting_map asserting_nonempty_map asserting_not_empty asserting_not_map
 	asserting_not_null asserting_null asserting_numeric asserting_present
 	asserting_string boolean float fmtnum hexfmt int string typeof depth haskey
 	joink joinkv joinv leafcount length mapdiff mapexcept mapselect mapsum splitkv
@@ -1579,6 +1579,10 @@ FUNCTIONS FOR FILTER/PUT
        (class=string #args=3): Example: '$name=gsub($name, "old", "new")'
        (replace all).
 
+   regex_extract
+       (class=string #args=2): Example: '$name=regex_extract($name, "[A-Z]{3}[0-9]{2}")'
+       .
+
    strlen
        (class=string #args=1): String length.
 
@@ -2371,7 +2375,7 @@ SEE ALSO
 
 
 
-				  2018-04-29			     MILLER(1)
+				  2018-08-26			     MILLER(1)
 </pre>
 </div>
 <p/>

doc/manpage.txt

@@ -133,18 +133,18 @@ OPTIONS
 
    FUNCTION LIST
 	+ + - - * / // .+ .+ .- .- .* ./ .// % ** | ^ & ~ << >> bitcount == != =~ !=~
-	> >= < <= && || ^^ ! ? : . gsub strlen sub ssub substr tolower toupper abs
-	acos acosh asin asinh atan atan2 atanh cbrt ceil cos cosh erf erfc exp expm1
-	floor invqnorm log log10 log1p logifit madd max mexp min mmul msub pow qnorm
-	round roundm sgn sin sinh sqrt tan tanh urand urand32 urandint dhms2fsec
-	dhms2sec fsec2dhms fsec2hms gmt2sec localtime2sec hms2fsec hms2sec sec2dhms
-	sec2gmt sec2gmt sec2gmtdate sec2localtime sec2localtime sec2localdate sec2hms
-	strftime strftime_local strptime strptime_local systime is_absent is_bool
-	is_boolean is_empty is_empty_map is_float is_int is_map is_nonempty_map
-	is_not_empty is_not_map is_not_null is_null is_numeric is_present is_string
-	asserting_absent asserting_bool asserting_boolean asserting_empty
-	asserting_empty_map asserting_float asserting_int asserting_map
-	asserting_nonempty_map asserting_not_empty asserting_not_map
+	> >= < <= && || ^^ ! ? : . gsub regex_extract strlen sub ssub substr tolower
+	toupper abs acos acosh asin asinh atan atan2 atanh cbrt ceil cos cosh erf erfc
+	exp expm1 floor invqnorm log log10 log1p logifit madd max mexp min mmul msub
+	pow qnorm round roundm sgn sin sinh sqrt tan tanh urand urand32 urandint
+	dhms2fsec dhms2sec fsec2dhms fsec2hms gmt2sec localtime2sec hms2fsec hms2sec
+	sec2dhms sec2gmt sec2gmt sec2gmtdate sec2localtime sec2localtime sec2localdate
+	sec2hms strftime strftime_local strptime strptime_local systime is_absent
+	is_bool is_boolean is_empty is_empty_map is_float is_int is_map
+	is_nonempty_map is_not_empty is_not_map is_not_null is_null is_numeric
+	is_present is_string asserting_absent asserting_bool asserting_boolean
+	asserting_empty asserting_empty_map asserting_float asserting_int
+	asserting_map asserting_nonempty_map asserting_not_empty asserting_not_map
 	asserting_not_null asserting_null asserting_numeric asserting_present
 	asserting_string boolean float fmtnum hexfmt int string typeof depth haskey
 	joink joinkv joinv leafcount length mapdiff mapexcept mapselect mapsum splitkv
@@ -1385,6 +1385,10 @@ FUNCTIONS FOR FILTER/PUT
        (class=string #args=3): Example: '$name=gsub($name, "old", "new")'
        (replace all).
 
+   regex_extract
+       (class=string #args=2): Example: '$name=regex_extract($name, "[A-Z]{3}[0-9]{2}")'
+       .
+
    strlen
        (class=string #args=1): String length.
 
@@ -2177,4 +2181,4 @@ SEE ALSO
 
 
 
-				  2018-04-29			     MILLER(1)
+				  2018-08-26			     MILLER(1)

doc/reference-dsl.html

@@ -4804,6 +4804,17 @@ qnorm (class=math #args=1): Normal cumulative distribution function.
 </div>
 
 
+<h2>regex_extract</h2>
+
+<p/>
+<div class="pokipanel">
+<pre>
+regex_extract (class=string #args=2): Example: '$name=regex_extract($name, "[A-Z]{3}[0-9]{2}")'
+.
+</pre>
+</div>
+
+
 <h2>round</h2>
 
 <p/>

doc/reference.html

@@ -1447,16 +1447,16 @@ Verbs:
 
 Functions for the filter and put verbs:
    + + - - * / // .+ .+ .- .- .* ./ .// % ** | ^ & ~ << >> bitcount == != =~
-   !=~ > >= < <= && || ^^ ! ? : . gsub strlen sub ssub substr tolower toupper
-   abs acos acosh asin asinh atan atan2 atanh cbrt ceil cos cosh erf erfc exp
-   expm1 floor invqnorm log log10 log1p logifit madd max mexp min mmul msub pow
-   qnorm round roundm sgn sin sinh sqrt tan tanh urand urand32 urandint
-   dhms2fsec dhms2sec fsec2dhms fsec2hms gmt2sec localtime2sec hms2fsec hms2sec
-   sec2dhms sec2gmt sec2gmt sec2gmtdate sec2localtime sec2localtime
-   sec2localdate sec2hms strftime strftime_local strptime strptime_local
-   systime is_absent is_bool is_boolean is_empty is_empty_map is_float is_int
-   is_map is_nonempty_map is_not_empty is_not_map is_not_null is_null
-   is_numeric is_present is_string asserting_absent asserting_bool
+   !=~ > >= < <= && || ^^ ! ? : . gsub regex_extract strlen sub ssub substr
+   tolower toupper abs acos acosh asin asinh atan atan2 atanh cbrt ceil cos
+   cosh erf erfc exp expm1 floor invqnorm log log10 log1p logifit madd max mexp
+   min mmul msub pow qnorm round roundm sgn sin sinh sqrt tan tanh urand
+   urand32 urandint dhms2fsec dhms2sec fsec2dhms fsec2hms gmt2sec localtime2sec
+   hms2fsec hms2sec sec2dhms sec2gmt sec2gmt sec2gmtdate sec2localtime
+   sec2localtime sec2localdate sec2hms strftime strftime_local strptime
+   strptime_local systime is_absent is_bool is_boolean is_empty is_empty_map
+   is_float is_int is_map is_nonempty_map is_not_empty is_not_map is_not_null
+   is_null is_numeric is_present is_string asserting_absent asserting_bool
    asserting_boolean asserting_empty asserting_empty_map asserting_float
    asserting_int asserting_map asserting_nonempty_map asserting_not_empty
    asserting_not_map asserting_not_null asserting_null asserting_numeric