const class sys::Regex
sys::Obj sys::Regex
@Serializable { simple=true }
Regex represents a regular expression.
- defVal
-
const static Regex defVal
Default value is Regex("").
- equals
-
virtual override Bool equals(Obj? obj)
Equality is based on pattern string and flags.
- flags
-
Str flags()
Return flags string
- fromStr
-
static new fromStr(Str pattern, Str flags := "")
Compile a regular expression pattern string. Flags is a string of ASCII chars. In JavaScript the flags are passed directly to RegExp. In Java the flags are matched against known constants or ignored. The following cross-platform flags are supported:
i
: case insensitivem
: multi-line support for start/end matchings
: dot all to allow "." to match newlines
- glob
-
static Regex glob(Str pattern)
Make a Regex which will match a glob pattern:
- "?": match one unknown char (maps to "." in regex)
- "*": match zero or more unknown char (maps to ".*" in regex)
- any other character is matched exactly
- hash
-
virtual override Int hash()
Return
toStr.hash
. - matcher
-
RegexMatcher matcher(Str s)
Return a
RegexMatcher
instance to use for matching operations against the specified string. - matches
-
Convenience for
matcher(s).matches
. - quote
-
Make a Regex that matches the given string exactly. All non-alpha numeric characters are escaped.
- split
-
Str[] split(Str s, Int limit := 0)
Split the specified string around matches of this pattern. The
limit
parameter specifies how many times to apply the pattern:- If
limit
is greater than zero, the pattern is applied at mostlimit-1
times and any remaining input will be returned as the list's last item. - If
limit
is less than zero, then the pattern is matched as many times as possible. - If
limit
is zero, then the pattern is matched as many times as possible, but trailing empty strings are discarded.
- If
- toStr
-
virtual override Str toStr()
Return the regular expression pattern string.