replace- 수신자
- Regex
- 최소 인자 수
- 2
- 최대 인자 수
- 2
Declaration and parameters
링크사용 조건
기본 포함 · 미정
Import std.regex in language mode 5.21.
The current compiler selects std/regex.tpz for this language mode. Availability in other released editions and inclusion in each installed distribution are Pending.
수신자
Regex
매개변수 제약
Regex.split returns the input portions between the matches selected by findAll. Delimiters disappear and capture groups are not inserted. Empty portions at either end and between adjacent delimiters are retained. No match produces an array containing the original input.
Regex.replaceAll replaces the same nonoverlapping matches while copying all text between them unchanged. No match returns the original text. The operation does not search inserted replacement text.
Replacement references use a dollar sign followed by a braced capture number or name. Capture zero denotes the complete match. An unknown or nonparticipating capture expands to an empty string. Two dollar signs produce one literal dollar.
A replacement selector is a nonnegative decimal capture number or an ASCII capture name. Dollar text that is neither a double dollar nor a well-formed braced selector is literal. Unbraced dollar names and numbers do not form references. Expansion is performed once and captured dollar text is not expanded again.
An empty pattern splits at every scalar boundary and inserts replacement text at those same boundaries. The adjacent-empty-match rule from findAll also applies when a nonempty match is followed by an empty candidate.
The receiver is evaluated once before text and replacement arguments, which are evaluated once from left to right. Splitting and replacement leave the original string and Regex unchanged. They have no external effects and do not call a user callback.
관련 규칙 · Split and replace using the shared match sequence →결과
The declared result type is string.
효과
실패
Result and effects
링크Replaces the selected matches and expands braced capture references.
Resolved contracts
링크Related entries
링크Split and replace using the shared match sequence
링크Split and replace using the shared match sequence
Regex.split returns the input portions between the matches selected by findAll. Delimiters disappear and capture groups are not inserted. Empty portions at either end and between adjacent delimiters are retained. No match produces an array containing the original input.
Regex.replaceAll replaces the same nonoverlapping matches while copying all text between them unchanged. No match returns the original text. The operation does not search inserted replacement text.
Replacement references use a dollar sign followed by a braced capture number or name. Capture zero denotes the complete match. An unknown or nonparticipating capture expands to an empty string. Two dollar signs produce one literal dollar.
A replacement selector is a nonnegative decimal capture number or an ASCII capture name. Dollar text that is neither a double dollar nor a well-formed braced selector is literal. Unbraced dollar names and numbers do not form references. Expansion is performed once and captured dollar text is not expanded again.
An empty pattern splits at every scalar boundary and inserts replacement text at those same boundaries. The adjacent-empty-match rule from findAll also applies when a nonempty match is followed by an empty candidate.
The receiver is evaluated once before text and replacement arguments, which are evaluated once from left to right. Splitting and replacement leave the original string and Regex unchanged. They have no external effects and do not call a user callback.
이유
Using one match sequence prevents a search from disagreeing with a later replacement. Braced capture references have one spelling and an explicit end, so a capture name cannot absorb following replacement text.
Retain empty split fields without inserting captures
링크import std.regex { Regex }import std.iomatch (Regex.compile("(,)")) {case Ok(pattern) => {for field in (pattern.split(",a,,b,")) {io.writeLine("[{field}]")}for field in (pattern.split("plain")) {io.writeLine("[{field}]")}}case Err(_) => io.writeLine("compile failed")}
[]
[a]
[]
[b]
[]
[plain]
기대 결과
기대 결과
실행을 마칩니다. 종료 코드 0.
[][a][][b][][plain]
Expand braced capture references and a literal dollar
링크import std.regex { Regex }import std.iomatch (Regex.compile("(?<word>[a-z]+)([0-9]+)?")) {case Ok(pattern) => {let replacement = "$\{word\}/$\{0\}/$\{2\}/$\{missing\}/$$"io.writeLine(pattern.replaceAll("a1 b", replacement))io.writeLine(pattern.replaceAll("123", replacement))}case Err(_) => io.writeLine("compile failed")}
a/a1/1//$ b/b///$
123
기대 결과
기대 결과
실행을 마칩니다. 종료 코드 0.
a/a1/1//$ b/b///$123
Preserve text that is not a braced reference
링크import std.regex { Regex }import std.iomatch (Regex.compile("a")) {case Ok(pattern) => io.writeLine(pattern.replaceAll("a", "$word $1 $ $\{\} $\{bad-name\}"))case Err(_) => io.writeLine("compile failed")}
$word $1 $ ${} ${bad-name}
기대 결과
기대 결과
실행을 마칩니다. 종료 코드 0.
$word $1 $ ${} ${bad-name}
Split and replace at each empty-pattern boundary
링크import std.regex { Regex }import std.iomatch (Regex.compile("")) {case Ok(pattern) => {for field in (pattern.split("ab")) {io.writeLine("[{field}]")}io.writeLine(pattern.replaceAll("ab", "-"))}case Err(_) => io.writeLine("compile failed")}
[]
[a]
[b]
[]
-a-b-
기대 결과
기대 결과
실행을 마칩니다. 종료 코드 0.
[][a][b][]-a-b-
Share the adjacent-empty-match rule across transformations
링크import std.regex { Regex }import std.iomatch (Regex.compile("a*")) {case Ok(pattern) => {for field in (pattern.split("ab")) {io.writeLine("[{field}]")}io.writeLine(pattern.replaceAll("ab", "-"))}case Err(_) => io.writeLine("compile failed")}
[]
[b]
[]
-b-
기대 결과
기대 결과
실행을 마칩니다. 종료 코드 0.
[][b][]-b-
Evaluate receiver and replacement inputs once in source order
링크import std.regex { Regex }import std.testimport std.iofunction makePattern() -> Regex {io.writeLine("receiver")return test.assertOk(Regex.compile("a"))}function inputText() -> string {io.writeLine("text")return "a"}function replacementText() -> string {io.writeLine("replacement")return "b"}io.writeLine(makePattern().replaceAll(inputText(), replacementText()))
receiver
text
replacement
b
기대 결과
기대 결과
실행을 마칩니다. 종료 코드 0.
receivertextreplacementb