From 28a4bd7a0db5985fe5d432455e9169468c1d9732 Mon Sep 17 00:00:00 2001
From: Tejas Bubane <tejasbubane@gmail.com>
Date: Sun, 29 Mar 2020 23:44:30 +0530
Subject: [PATCH] Refer named regexp captures by name

cop idea issue: https://github.com/rubocop-hq/rubocop/issues/7754
---
 README.adoc | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/README.adoc b/README.adoc
index c04efca54..9e996485d 100644
--- a/README.adoc
+++ b/README.adoc
@@ -4385,6 +4385,23 @@ p m[1] # => "FOO"
 p m[2] # => "BAR"
 ----
 
+=== Refer named regexp captures by name [[refer-named-regexp-captures-by-name]]
+
+Prefer using names to refer named regexp captures instead of numbers.
+
+[source,ruby]
+----
+# bad
+m = /(?<foo>FOO)(?<bar>BAR)/.match('FOOBAR')
+p m[1] # => "FOO"
+p m[2] # => "BAR"
+
+# good
+m = /(?<foo>FOO)(?<bar>BAR)/.match('FOOBAR')
+p m[:foo] # => "FOO"
+p m[:bar] # => "BAR"
+----
+
 === No Perl Regexp Last Matchers [[no-perl-regexp-last-matchers]]
 
 Don't use the cryptic Perl-legacy variables denoting last regexp group matches (`$1`, `$2`, etc).