mirror of
https://github.com/nim-lang/Nim.git
synced 2025-12-29 17:34:43 +00:00
7c31b6a47b
* Fixes for jsre to make it more safe at runtime on some edge cases * https://github.com/nim-lang/Nim/pull/19917#issuecomment-1162692893
92 lines
4.1 KiB
Nim
92 lines
4.1 KiB
Nim
## 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.
|
|
|
|
|
|
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 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"
|
|
let digitsRegex: RegExp = newRegExp(r"\d")
|
|
assert "foo".match(digitsRegex) == @[]
|