## Regular Expressions for the JavaScript target.
## * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions
when not defined(js):
{.error: "This module only works on the JavaScript platform".}
type RegExp* = ref object of JsRoot
## Regular Expressions for JavaScript target.
## See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp
flags*: cstring ## cstring that contains the flags of the RegExp object.
dotAll*: bool ## Whether `.` matches newlines or not.
global*: bool ## Whether to test against all possible matches in a string, or only against the first.
ignoreCase*: bool ## Whether to ignore case while attempting a match in a string.
multiline*: bool ## Whether to search in strings across multiple lines.
source*: cstring ## The text of the pattern.
sticky*: bool ## Whether the search is sticky.
unicode*: bool ## Whether Unicode features are enabled.
lastIndex*: cint ## Index at which to start the next match (read/write property).
input*: cstring ## Read-only and modified on successful match.
lastMatch*: cstring ## Ditto.
lastParen*: cstring ## Ditto.
leftContext*: cstring ## Ditto.
rightContext*: cstring ## Ditto.
hasIndices*: bool ## https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/hasIndices
func newRegExp*(pattern: cstring; flags: cstring): RegExp {.importjs: "new RegExp(@)".}
## Creates a new RegExp object.
func newRegExp*(pattern: cstring): RegExp {.importjs: "new RegExp(@)".}
func compile*(self: RegExp; pattern: cstring; flags: cstring) {.importjs: "#.compile(@)".}
## Recompiles a regular expression during execution of a script.
func replace*(pattern: cstring; self: RegExp; replacement: cstring): cstring {.importjs: "#.replace(#, #)".}
## Returns a new string with some or all matches of a pattern replaced by given replacement
func replace*(pattern: cstring, self: RegExp, cb: proc (args: varargs[cstring]): cstring): cstring {.importcpp.}
## Returns a new string with some or all matches of a pattern replaced by given callback function
func split*(pattern: cstring; self: RegExp): seq[cstring] {.importjs: "(#.split(#) || [])".}
## Divides a string into an ordered list of substrings and returns the array
func match*(pattern: cstring; self: RegExp): seq[cstring] {.importjs: "(#.match(#) || [])".}
## Returns an array of matches of a RegExp against given string
func exec*(self: RegExp; pattern: cstring): seq[cstring] {.importjs: "(#.exec(#) || [])".}
## Executes a search for a match in its string parameter.
func toCstring*(self: RegExp): cstring {.importjs: "#.toString()".}
## Returns a string representing the RegExp object.
func `$`*(self: RegExp): string = $toCstring(self)
func contains*(pattern: cstring; self: RegExp): bool =
## Tests for a substring match in its string parameter.
runnableExamples:
let jsregex: RegExp = newRegExp(r"bc$", r"i")
assert jsregex in r"abc"
assert jsregex notin r"abcd"
assert "xabc".contains jsregex
asm "`result` = `self`.test(`pattern`);"
func startsWith*(pattern: cstring; self: RegExp): bool =
## Tests if string starts with given RegExp
runnableExamples:
let jsregex: RegExp = newRegExp(r"abc", r"i")
assert "abcd".startsWith jsregex
pattern.contains(newRegExp(("^" & $(self.source)).cstring, self.flags))
func endsWith*(pattern: cstring; self: RegExp): bool =
## Tests if string ends with given RegExp
runnableExamples:
let jsregex: RegExp = newRegExp(r"bcd", r"i")
assert "abcd".endsWith jsregex
pattern.contains(newRegExp(($(self.source) & "$").cstring, self.flags))
runnableExamples:
let jsregex: RegExp = newRegExp(r"\s+", r"i")
jsregex.compile(r"\w+", r"i")
assert "nim javascript".contains jsregex
assert jsregex.exec(r"nim javascript") == @["nim".cstring]
assert jsregex.toCstring() == r"/\w+/i"
jsregex.compile(r"[0-9]", r"i")
assert "0123456789abcd".contains jsregex
assert $jsregex == "/[0-9]/i"
jsregex.compile(r"abc", r"i")
assert "abcd".startsWith jsregex
assert "dabc".endsWith jsregex
jsregex.compile(r"\d", r"i")
assert "do1ne".split(jsregex) == @["do".cstring, "ne".cstring]
jsregex.compile(r"[lw]", r"i")
assert "hello world".replace(jsregex,"X") == "heXlo world"
jsregex.compile(r"([a-z])\1*", r"g")
assert "abbcccdddd".replace(jsregex, proc (m: varargs[cstring]): cstring = ($m[0] & $(m.len)).cstring) == "a1b2c3d4"
let digitsRegex: RegExp = newRegExp(r"\d")
assert "foo".match(digitsRegex) == @[]