This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlre: Note a way to continue long regexes across lines
authorKarl Williamson <khw@cpan.org>
Wed, 27 Dec 2017 01:00:57 +0000 (18:00 -0700)
committerKarl Williamson <khw@cpan.org>
Sat, 30 Dec 2017 05:45:14 +0000 (22:45 -0700)
This documents a usage to include \n chars within (?#\n) to easily
break long patterns into smaller chunks that fit on a line.  I was not
familiar with this technique until I saw it used, in some of our core
code, so am documenting it for others.

pod/perlre.pod

index 7a1d405..993a08e 100644 (file)
@@ -1360,6 +1360,10 @@ an escape sequence.   Examples:
  # for the  closing ')' to match
  qr/\(?#the backslash means this isn't a comment)p{Any}/
 
+ # Comments can be used to fold long patterns into multiple lines
+ qr/First part of a long regex(?#
+   )remaining part/
+
 =item C<(?adlupimnsx-imnsx)>
 
 =item C<(?^alupimnsx)>