Ruby 3.1 adds MatchData#match and MatchData#match_length


When working with strings,
we come across cases where we need to match
string characters or words using regular expressions.
We use regular expressions widely for matching
email and phone numbers formats.

A regex for a valid email address is as below –

VALID_EMAIL_REGEX = /A[w+-.][email protected][a-zd-]+(.[a-z]+)*.[a-z]+z/i

result = VALID_EMAIL_REGEX.match("[email protected]")
=> #<MatchData "[email protected]" 1:nil>

result = VALID_EMAIL_REGEX.match("invalid_email")
=> nil

Before

Ruby returns an object of class MatchData where we can use the [] function
on the result object.
The [] function will expect either an index or symbol as an argument.
We can also access multiple matches by passing a range of indexes to the MatchData#[] method.

Let’s take an example to understand the integer, range, and symbol cases.

result = /$(?<dollars>d+).(?<cents>d+)/.match("$1.95")
=> #<MatchData "$1.95" dollars:"1" cents:"95">

result[0]
=> "$1.95"

result[0..2]
=> ["$1.95", "1", "95"]

result[3]
=> nil

result[:dollars]
=> "1"

result[:cents]
=> "95"

result[:cents].length
=> 2

To access the length,
we had to chain .length on [] method of MatchData class.

After

With the recent change in Ruby 3.1,
we have two methods to access the match data and its length.
Both MatchData#match and MatchData#match_length accept either an index
or a symbol as an argument.

So the above example will change as below:

result = /$(?<dollars>d+).(?<cents>d+)/.match("$1.95")
=> #<MatchData "$1.95" dollars:"1" cents:"95">

result.match(0)
=> "$1.95"

result.match(1)
=> "1"

result.match(:dollars)
=> "1"

result.match(:cents)
=> "95"

result.match_length(:cents)
=> 2

Note:

MatchData#match is not same as MatchData[].
MatchData[] accepts an integer, range, or symbol as an argument,
but #match allows only a single index or symbol.
Passing a range to match method will raise an error as below:

result.match(0..2)
(irb):44:in `match': no implicit conversion of Range into Integer (TypeError)

For more discussion related to this change,
please refer to this
PR.



Source link

Latest articles

Related articles

Leave a reply

Please enter your comment!
Please enter your name here