latin: palm graffiti font placeholder
[sheet.git] / perl.inc.pl
index ae02b3a135783867ee9f22207a451bf5440f2aea..9d416eb4de5b626a6f7eb6f651e15f8b03375900 100644 (file)
@@ -80,9 +80,11 @@ use utf8;
                        ['<code>given</code>', 'switch statement to smart-match with <code>when</code>/<code>default</code>', {feature => 'switch', experimental => 'smartmatch'}],
                        ['<code>/(?&lt;name>)/</code>', 'named capture buffers into <code>%+</code>'],
                        ['<code>/(?1)/</code>', 'recursive regular expression patterns'],
+                       ['<code>/(?|)/</code>', 'resets capture numbering for each contained branch'],
                        ['<code>/.++/</code>', 'possessive quantifiers <code>?+</code>, <code>*+</code>, <code>++</code> to match greedily'],
                        ['<code>s/keep\K//</code>', 'floating positive lookbehind, efficient alternative for <code>s/(keep)/$1/</code>'],
-                       ['<code>/\v/, /\h/</code>', 'vertical and horizontal whitespace escapes'],
+                       ['<code>/p</code>', 'optionally preserve <code>${^MATCH}</code> variables (avoiding <code>$&</code> penalty until COW in v5.20)'],
+                       ['<code>/\v/, /\h/</code>', 'vertical and horizontal whitespace escapes (<code>\V</code> <code>\H</code> to invert); also <code>/\R/</code> for newlines'],
                        ['<code>my $_</code>', 'lexically scoped version of the default variable', {experimental => 'lexical_topic', dropped => v5.23.4}],
                        ['<code>state</code>', 'persistent <code>my</code> variables', {feature => 'state'}],
                ],
@@ -120,11 +122,13 @@ use utf8;
        v5.14 => {
                new => [
                        ['<code>s///r</code>', 'non-destructive substitution'],
-                       ['<code>/(?^)/</code>', 'construct to reset to default modifiers'],
                        ['<code>/(?{ m() })/</code>', 'regular expressions can be nested in <code>/(?{})/</code> and <code>/(??{})/</code>', {experimental => 0, stable => v5.20}],
+                       ['<code>/dalu</code>', 'regexp modifiers to restrict character classes: either <strong>d</strong>efault, <strong>a</strong>scii, <strong>l</strong>ocale, or <strong>u</strong>nicode semantics.'],
                        [q"<code>use re '/flags'</code>", 'customise default modifiers'],
+                       ['<code>/(?^)/</code>', 'construct to reset to default modifiers'],
                        ['<code>each $ref</code> e.a.', 'array and hash container functions accept references', {experimental => 'postderef', dropped => v5.23.1}],
                        ['<code>FH->method</code>', 'filehandle method calls load IO::File on demand (eg. <code>STDOUT->flush</code>)'],
+                       ['<code>\o{}</code>', 'escape sequence for octal values beyond \777'],
                ],
                release => '2011-05-14',
                distro => {
@@ -192,9 +196,10 @@ use utf8;
                        ['<code>&lt;&lt;>></code>', 'safe <code>readline</code> ignoring open flags in arguments'],
                        ['<code>/()/n</code>', 'flag to disable numbered capturing, turning <code>()</code> into <code>(?:)</code>'],
                        ['<code>/\b{}/</code>', 'boundary types: <em>gcb</em> (grapheme cluster), <em>sb</em> (sentence), <em>wb</em> (word)'],
-                       ['<code>&.</code>', '<code>& | ^ ~</code> consistently numeric, dotted operators for strings', {experimental => 'bitwise'}],
+                       ['<code>&.</code>', '<code>& | ^ ~</code> consistently numeric, dotted operators for strings', {feature => 'bitwise', experimental => 'bitwise', stable => v5.28}],
                        [q"<code>use re 'strict'</code>", 'apply stricter syntax rules to regular expression patterns', {experimental => 're_strict'}],
                        ['<code>0x.beep+0</code>', q"hexadecimal floating point notation with binary power; <code>printf '%a'</code> to display"],
+                       ['<code><s>??</s></code>', 'single match shorthand (deprecated since v5.14) requires the operator <code><em>m</em>?PATTERN?</code>'],
                ],
                unicode => '7.0',
                release => '2015-06-01',
@@ -230,4 +235,55 @@ use utf8;
                        ubuntu => '17.10', # artful
                },
        },
+
+       v5.28 => {
+               new => [
+                       ['<code>delete %hash{…}</code>', 'hash slices can be deleted with key+value pairs'],
+                       ['<code>/(*…)/</code>', 'alphabetic synonyms for assertions, e.g. <code>(*atomic:…)</code> for <code>(?&gt;…)</code> and <code>(*nlb:…)</code> for <code>(?&lt;!…)</code>', {experimental => 'alpha_assertions', stable => v5.31.6}],
+                       ['<code>/(*script_run:)/</code>', 'enforces all characters to be from the same script', {experimental => 'script_run', stable => v5.31.6}],
+                       ['<code>state @a</code>', 'persistent lexical array or hash variables'],
+                       ['<code>perl -i -pe die</code>', 'safe in-place editing: files are replaced only after successful completion'],
+                       ['<code>${^SAFE_LOCALES}</code>', 'locales are thread-safe on supported systems, indicated by this variable'],
+               ],
+               unicode => '10.0',
+               release => '2018-06-22',
+               distro => {
+               },
+       },
+
+       v5.30 => {
+               new => [
+                       ['<code>/(?<=var+)</code>', 'variable length lookbehind assertions', {experimental => 'vlb'}],
+                       ['<code>m(\p{nv=/.*/})</code>', 'match unicode properties by regular expressions', {experimental => 'uniprop_wildcards'}],
+                       ['<code><s>my $state if 0</s></code>', 'workaround for <code>state</code> (deprecated since v5.10!) is now prohibited'],
+                       [q"<code>qr'\N'</code>", 'Delimiters must be graphemes; unescaped { illegal; \N in single quotes'],
+               ],
+               unicode => '12.1',
+               release => '2019-05-22',
+       },
+
+       v5.32 => {
+               new => [
+                       ['<code>isa</code>', 'infix operator to check class instance'],
+                       ['<code>$min &lt; $_ &lt;= $max</code>', 'chained comparison repeats inner part as <code>$min &lt; $_ and $_ &lt;= $max</code>'],
+                       ['<code>/\p{Name=$var}/</code>', 'match Unicode Name property like \N{} but with interpolation and subpatterns'],
+                       [q"<code>open F, '+&gt;&gt;', undef</code>", 'respect append mode on temporary files with mixed access'],
+                       ["<code>no feature 'indirect'</code>", 'disable indirect object notation such as <code>new Class</code> instead of <code>Class-&gt;new</code>'],
+                       ['streamzip', 'program distributed with core IO::Compress::Base to compress stdin into a zip container'],
+               ],
+               unicode => '13.0',
+               release => '2020-06-20',
+               details => 'https://www.effectiveperlprogramming.com/2020/01/perl-v5-32-new-features/',
+       },
+
+       v5.34 => {
+               new => [
+                       ['<code>try {} catch</code>', 'exception handling similar to eval blocks', {experimental => 'try'}],
+                       ['<code>/{,<i>n</i>}/</code>', 'empty lower bound quantifier is accepted as shorthand for 0'],
+                       ['<code>\x{ … }</code>', 'insignificant space within curly braces, also for <code>\b{}</code>, <code>\g{}</code>, <code>\k{}</code>, <code>\N{}</code>, <code>\o{}</code> as well as <code>/{m,n}/</code> quantifiers'],
+                       ['<code>0o0</code>', 'octal prefix <code>0o</code> alternative to <code>0…</code> and <code>oct</code>'],
+                       ['<code>re::optimization(qr//)</code>', 'debug regular expression optimization information discovered at compile time'],
+               ],
+               release => '2021-05-20',
+       },
 }