diff options
author | Burdette Lamar <BurdetteLamar@Yahoo.com> | 2022-04-18 13:02:35 -0500 |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-04-18 13:02:35 -0500 |
commit | b074bc3d614cd4e783dc77e3602c424110230495 (patch) | |
tree | 20d2ffd9307486a3fb2fd780e0680bca1a5efcbd /doc | |
parent | 9d1dd7a9ed189475730254fbfee52f890759afaf (diff) |
[DOC] Enhanced RDoc for MatchData (#5819)
Treats:
#begin
#end
#match
#match_length
Notes
Notes:
Merged-By: BurdetteLamar <BurdetteLamar@Yahoo.com>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/matchdata/begin.rdoc | 30 | ||||
-rw-r--r-- | doc/matchdata/end.rdoc | 30 | ||||
-rw-r--r-- | doc/matchdata/offset.rdoc | 1 |
3 files changed, 60 insertions, 1 deletions
diff --git a/doc/matchdata/begin.rdoc b/doc/matchdata/begin.rdoc new file mode 100644 index 0000000000..8046dd9d55 --- /dev/null +++ b/doc/matchdata/begin.rdoc @@ -0,0 +1,30 @@ +Returns the offset (in characters) of the beginning of the specified match. + +When non-negative integer argument +n+ is given, +returns the offset of the beginning of the <tt>n</tt>th match: + + m = /(.)(.)(\d+)(\d)/.match("THX1138.") + # => #<MatchData "HX1138" 1:"H" 2:"X" 3:"113" 4:"8"> + m[0] # => "HX1138" + m.begin(0) # => 1 + m[3] # => "113" + m.begin(3) # => 3 + + m = /(т)(е)(с)/.match('тест') + # => #<MatchData "тес" 1:"т" 2:"е" 3:"с"> + m[0] # => "тес" + m.begin(0) # => 0 + m[3] # => "с" + m.begin(3) # => 2 + +When string or symbol argument +name+ is given, +returns the offset of the beginning for the named match: + + m = /(?<foo>.)(.)(?<bar>.)/.match("hoge") + # => #<MatchData "hog" foo:"h" bar:"g"> + m[:foo] # => "h" + m.begin('foo') # => 0 + m[:bar] # => "g" + m.begin(:bar) # => 2 + +Related: MatchData#end, MatchData#offset, MatchData#byteoffset. diff --git a/doc/matchdata/end.rdoc b/doc/matchdata/end.rdoc new file mode 100644 index 0000000000..0209b2d2fc --- /dev/null +++ b/doc/matchdata/end.rdoc @@ -0,0 +1,30 @@ +Returns the offset (in characters) of the end of the specified match. + +When non-negative integer argument +n+ is given, +returns the offset of the end of the <tt>n</tt>th match: + + m = /(.)(.)(\d+)(\d)/.match("THX1138.") + # => #<MatchData "HX1138" 1:"H" 2:"X" 3:"113" 4:"8"> + m[0] # => "HX1138" + m.end(0) # => 7 + m[3] # => "113" + m.end(3) # => 6 + + m = /(т)(е)(с)/.match('тест') + # => #<MatchData "тес" 1:"т" 2:"е" 3:"с"> + m[0] # => "тес" + m.end(0) # => 3 + m[3] # => "с" + m.end(3) # => 3 + +When string or symbol argument +name+ is given, +returns the offset of the end for the named match: + + m = /(?<foo>.)(.)(?<bar>.)/.match("hoge") + # => #<MatchData "hog" foo:"h" bar:"g"> + m[:foo] # => "h" + m.end('foo') # => 1 + m[:bar] # => "g" + m.end(:bar) # => 3 + +Related: MatchData#begin, MatchData#offset, MatchData#byteoffset. diff --git a/doc/matchdata/offset.rdoc b/doc/matchdata/offset.rdoc index bbf157548a..0985316d76 100644 --- a/doc/matchdata/offset.rdoc +++ b/doc/matchdata/offset.rdoc @@ -29,4 +29,3 @@ returns the starting and ending offsets for the named match: m.offset(:bar) # => [2, 3] Related: MatchData#byteoffset, MatchData#begin, MatchData#end. - |