This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Upgrade to PathTools-3.23.
[perl5.git] / pod / perl595delta.pod
CommitLineData
f6eae373
RGS
1=head1 NAME
2
3perldelta - what is new for perl v5.9.5
4
5=head1 DESCRIPTION
6
7This document describes differences between the 5.9.4 and the 5.9.5
8development releases. See L<perl590delta>, L<perl591delta>,
9L<perl592delta>, L<perl593delta> and L<perl594delta> for the differences
10between 5.8.0 and 5.9.4.
11
12=head1 Incompatible Changes
13
14=head1 Core Enhancements
15
072f65b4
RGS
16=head2 Regular expressions
17
18=over 4
19
20=item Recursive Patterns
21
22It is now possible to write recursive patterns without using the C<(??{})>
23construct. This new way is more efficient, and in many cases easier to
24read.
25
26Each capturing parenthesis can now be treated as an independent pattern
27that can be entered by using the C<(?PARNO)> syntax (C<PARNO> standing for
28"parenthesis number"). For example, the following pattern will match
29nested balanced angle brackets:
30
31 /
32 ^ # start of line
33 ( # start capture buffer 1
34 < # match an opening angle bracket
35 (?: # match one of:
36 (?> # don't backtrack over the inside of this group
37 [^<>]+ # one or more non angle brackets
38 ) # end non backtracking group
39 | # ... or ...
40 (?1) # recurse to bracket 1 and try it again
41 )* # 0 or more times.
42 > # match a closing angle bracket
43 ) # end capture buffer one
44 $ # end of line
45 /x
46
47Note, users experienced with PCRE will find that the Perl implementation
48of this feature differs from the PCRE one in that it is possible to
49backtrack into a recursed pattern, whereas in PCRE the recursion is
50atomic or "possessive" in nature.
51
52=item Named Capture Buffers
53
54It is now possible to name capturing parenthesis in a pattern and refer to
55the captured contents by name. The naming syntax is C<< (?<NAME>....) >>.
56It's possible to backreference to a named buffer with the C<< \k<NAME> >>
57syntax. In code, the new magical hash C<%+> can be used to access the
58contents of the buffers.
59
60Thus, to replace all doubled chars, one could write
61
62 s/(?<letter>.)\k<letter>/$+{letter}/g
63
64Only buffers with defined contents will be "visible" in the hash, so
65it's possible to do something like
66
67 foreach my $name (keys %+) {
68 print "content of buffer '$name' is $+{$name}\n";
69 }
70
71Users exposed to the .NET regex engine will find that the perl
72implementation differs in that the numerical ordering of the buffers
73is sequential, and not "unnamed first, then named". Thus in the pattern
74
75 /(A)(?<B>B)(C)(?<D>D)/
76
77$1 will be 'A', $2 will be 'B', $3 will be 'C' and $4 will be 'D' and not
78$1 is 'A', $2 is 'C' and $3 is 'B' and $4 is 'D' that a .NET programmer
79would expect. This is considered a feature. :-)
80
81=back
82
f6eae373
RGS
83=head1 Modules and Pragmas
84
85=head2 New Core Modules
86
87=head1 Utility Changes
88
89=head1 Documentation
90
91=head1 Performance Enhancements
92
93=head1 Installation and Configuration Improvements
94
95=head1 Selected Bug Fixes
96
97=head1 New or Changed Diagnostics
98
99=head1 Changed Internals
100
101=head1 Known Problems
102
103=head2 Platform Specific Problems
104
105=head1 Reporting Bugs
106
107If you find what you think is a bug, you might check the articles
108recently posted to the comp.lang.perl.misc newsgroup and the perl
109bug database at http://rt.perl.org/rt3/ . There may also be
110information at http://www.perl.org/ , the Perl Home Page.
111
112If you believe you have an unreported bug, please run the B<perlbug>
113program included with your release. Be sure to trim your bug down
114to a tiny but sufficient test case. Your bug report, along with the
115output of C<perl -V>, will be sent off to perlbug@perl.org to be
116analysed by the Perl porting team.
117
118=head1 SEE ALSO
119
120The F<Changes> file for exhaustive details on what changed.
121
122The F<INSTALL> file for how to build Perl.
123
124The F<README> file for general stuff.
125
126The F<Artistic> and F<Copying> files for copyright information.
127
128=cut