doc regexp_replace replacement string \n does not explained properly - Mailing list pgsql-hackers

From jian he
Subject doc regexp_replace replacement string \n does not explained properly
Date
Msg-id CACJufxE5Jp35TSy+Cq+q77ohf1rae0+FrqfMQehJRc2vQM0fWg@mail.gmail.com
Whole thread Raw
Responses Re: doc regexp_replace replacement string \n does not explained properly
List pgsql-hackers
hi.

https://www.postgresql.org/docs/current/functions-matching.html#FUNCTIONS-POSIX-REGEXP
<<<start_quote
The regexp_replace function provides substitution of new text for
substrings that match POSIX regular expression patterns. It has the
syntax regexp_replace(source, pattern, replacement [, start [, N ]] [,
flags ]). (Notice that N cannot be specified unless start is, but
flags can be given in any case.) The source string is returned
unchanged if there is no match to the pattern. If there is a match,
the source string is returned with the replacement string substituted
for the matching substring. The replacement string can contain \n,
where n is 1 through 9, to indicate that the source substring matching
the n'th parenthesized subexpression of the pattern should be
inserted, and it can contain \& to indicate that the substring
matching the entire pattern should be inserted.
<<<end_quote

<<
The replacement string can contain \n, where n is 1 through 9,
to indicate that the source substring matching the n'th parenthesized
subexpression of the pattern should be inserted
<<
i think it explained example like:
SELECT regexp_replace('foobarbaz', 'b(..)', 'X\1Y', 'g');

but it does not seem to explain cases like:
SELECT regexp_replace('foobarbaz', 'b(..)', 'X\2Y', 'g');
?


I think it means that 'b(..)', (..) the parenthesized subexpression is
1, the whole expression is (n+1) parenthesized subexpression.
so it is equivalent to
SELECT regexp_replace('foobarbaz', 'b..', 'XY', 'g');



pgsql-hackers by date:

Previous
From: Alexander Lakhin
Date:
Subject: Re: Cleaning up perl code
Next
From: "David G. Johnston"
Date:
Subject: Re: doc regexp_replace replacement string \n does not explained properly