instance methods
|
[ ] |
mtch[i] -> anObject mtch[start, length] -> anArray mtch[aRange] -> anArray
|
|
Match Reference---MatchData acts as an array, and may
be accessed using the normal array indexing techniques.
mtch[0] is equivalent to the special variable $& , and
returns the entire matched string. mtch[1], mtch[2], and so
on return the
values of the matched backreferences (portions of the pattern
between parentheses).
m = /(.)(.)(\d+)(\d)/.match("THX1138.") |
m[0] |
» |
"HX1138" |
m[1, 2] |
» |
["H", "X"] |
m[1..3] |
» |
["H", "X", "113"] |
m[-3, 2] |
» |
["X", "113"] |
| begin |
mtch.begin( n ) -> anInteger
|
|
Returns the offset of the start of the nth element of the
match array in the string.
m = /(.)(.)(\d+)(\d)/.match("THX1138.") |
m.begin(0) |
» |
1 |
m.begin(2) |
» |
2 |
| end |
mtch.end( n ) -> anInteger
|
|
Returns the offset of the character immediately following the
end of the nth element of the match array in the string.
m = /(.)(.)(\d+)(\d)/.match("THX1138.") |
m.end(0) |
» |
7 |
m.end(2) |
» |
3 |
| length |
mtch.length -> anInteger
|
|
Returns the number of elements in the match array.
m = /(.)(.)(\d+)(\d)/.match("THX1138.") |
m.length |
» |
5 |
m.size |
» |
5 |
| offset |
mtch.offset( n ) -> anArray
|
|
Returns a two-element array containing the beginning and ending
offsets of the nth match.
m = /(.)(.)(\d+)(\d)/.match("THX1138.") |
m.offset(0) |
» |
[1, 7] |
m.offset(4) |
» |
[6, 7] |
| post_match |
mtch.post_match -> aString
|
|
Returns the portion of the original string after the current
match. Equivalent to the special variable $' .
m = /(.)(.)(\d+)(\d)/.match("THX1138: The Movie") |
m.post_match |
» |
": The Movie" |
| pre_match |
mtch.pre_match -> aString
|
|
Returns the portion of the original string before the current
match. Equivalent to the special variable $` .
m = /(.)(.)(\d+)(\d)/.match("THX1138.") |
m.pre_match |
» |
"T" |
| size |
mtch.size -> anInteger
|
|
A synonym for MatchData#length .
| string |
mtch.string -> aString
|
|
Returns a frozen copy of the string passed in to match .
m = /(.)(.)(\d+)(\d)/.match("THX1138.") |
m.string |
» |
"THX1138." |
| to_a |
mtch.to_a -> anArray
|
|
Returns the array of matches.
m = /(.)(.)(\d+)(\d)/.match("THX1138.") |
m.to_a |
» |
["HX1138", "H", "X", "113", "8"] |
| to_s |
mtch.to_s -> aString
|
|
Returns the entire matched string.
m = /(.)(.)(\d+)(\d)/.match("THX1138.") |
m.to_s |
» |
"HX1138" |
|