diff options
author | knu <knu@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2016-01-08 13:34:52 +0000 |
---|---|---|
committer | knu <knu@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2016-01-08 13:34:52 +0000 |
commit | 066b825400349c559aa3c1ca7769516c967c41b9 (patch) | |
tree | c5a6f99b63e0f188938bb480111aaa09a9ec6edd /doc/regexp.rdoc | |
parent | b6261054cda125869a481d8e51cc86fd3631b9d6 (diff) | |
download | ruby-066b825400349c559aa3c1ca7769516c967c41b9.tar.gz |
* doc/regexp.rdoc: [DOC] Elaborate on the \G anchor. [ci skip]
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@53467 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Diffstat (limited to 'doc/regexp.rdoc')
-rw-r--r-- | doc/regexp.rdoc | 14 |
1 files changed, 13 insertions, 1 deletions
diff --git a/doc/regexp.rdoc b/doc/regexp.rdoc index 02a5f300ee..4722f2e7f5 100644 --- a/doc/regexp.rdoc +++ b/doc/regexp.rdoc @@ -470,7 +470,19 @@ characters, <i>anchoring</i> the match to a specific position. * <tt>\Z</tt> - Matches end of string. If string ends with a newline, it matches just before newline * <tt>\z</tt> - Matches end of string -* <tt>\G</tt> - Matches point where last match finished +* <tt>\G</tt> - Matches first matching position: + + In methods like <tt>String#gsub</tt> and <tt>String#scan</tt>, it changes on each iteration. + It initially matches the beginning of subject, and in each following iteration it matches where the last match finished. + + " a b c".gsub(/ /, '_') #=> "____a_b_c" + " a b c".gsub(/\G /, '_') #=> "____a b c" + + In methods like <tt>Regexp#match</tt> and <tt>String#match</tt> that take an (optional) offset, it matches where the search begins. + + "hello, world".match(/,/, 3) #=> #<MatchData ","> + "hello, world".match(/\G,/, 3) #=> nil + * <tt>\b</tt> - Matches word boundaries when outside brackets; backspace (0x08) when inside brackets * <tt>\B</tt> - Matches non-word boundaries |