next | previous | forward | backward | up | top | index | toc | home

Macaulay2 > The Macaulay2 language > strings and nets > regular expressions > regex > regex(String,String)

regex(String,String) -- regular expression matching

Synopsis

Usage:
z = regex(p,s)
Function: regex
Inputs:
- p, a string, a regular expression describing a pattern
- s, a string, a subject string to be searched
Outputs:
- z, a list, a list of pairs of integers describing the first substring of s found that matches the pattern, or null if nothing matched

Description

The value returned is a list of pairs of integers corresponding to the parenthesized subexpressions successfully matched. If no matching substring was found, then null is returned. The first member of each pair is the offset within s of the substring matched, and the second is the length.

See also

regex(String,ZZ,String) -- regular expression matching
regular expressions
match -- regular expression matching
replace -- regular expression replacement