diff options
author | James E Keenan <jkeenan@cpan.org> | 2013-08-05 21:12:55 -0400 |
---|---|---|
committer | James E Keenan <jkeenan@cpan.org> | 2013-08-07 21:04:40 -0400 |
commit | 171e73191c72028adf3c184a3ef5a0abaee34a73 (patch) | |
tree | 7136efe5ee88cdb0e214ff2772c02961fb9e4805 /pod/perlre.pod | |
parent | cc42383380dce0d2e3c98f9f467a21c936902a8d (diff) | |
download | perl-171e73191c72028adf3c184a3ef5a0abaee34a73.tar.gz |
Document non-destructive substitution: the '/r' modifier.
Per bug report filed by Jacinta Richardson++.
For: RT #119151
Diffstat (limited to 'pod/perlre.pod')
-rw-r--r-- | pod/perlre.pod | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/pod/perlre.pod b/pod/perlre.pod index 3b3f7276f8..404fc31109 100644 --- a/pod/perlre.pod +++ b/pod/perlre.pod @@ -111,6 +111,15 @@ These modifiers, all new in 5.14, affect which character-set semantics (Unicode, etc.) are used, as described below in L</Character set modifiers>. +=item r +X</r> + +Non-destructive substitution. Unlike regular substitution, the entity to +which the substitution is bound is B<not> modified in place. Rather, the +B<result> of the substitution is returned as a plain string. See +L<perlop/"s/PATTERN/REPLACEMENT/msixpodualgcer"> for further explanation of +the C</r> modifier. + =back Regular expression modifiers are usually written in documentation |