Debian Codegraph @

upstream/debian-unstable/man1/perlexperiment.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "PERLEXPERIMENT 1"
58 .TH PERLEXPERIMENT 1 2025-11-16 "perl v5.40.1" "Perl Programmers Reference Guide"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 perlexperiment \- A listing of experimental features in Perl
65 .SH DESCRIPTION
66 .IX Header "DESCRIPTION"
67 This document lists the current and past experimental features in the perl
68 core. Although all of these are documented with their appropriate topics,
69 this succinct listing gives you an overview and basic facts about their
70 status.
71 .PP
72 So far we've merely tried to find and list the experimental features and infer
73 their inception, versions, etc. There's a lot of speculation here.
74 .SS "Current experiments"
75 .IX Subsection "Current experiments"
76 .ie n .IP "Smart match (""~~"")" 8
77 .el .IP "Smart match (\f(CW~~\fR)" 8
78 .IX Item "Smart match (~~)"
79 Introduced in Perl 5.10.0
80 .Sp
81 Modified in Perl 5.10.1, 5.12.0
82 .Sp
83 Deprecated in 5.38.0
84 .Sp
85 Will be removed in 5.42.0
86 .Sp
87 Using this feature triggers warnings in the category
88 \&\f(CW\*(C`deprecated\*(C'\fR.
89 .Sp
90 The ticket for this experiment is
91 [perl #13173] <https://github.com/Perl/perl5/issues/13173>.
92 .IP "Pluggable keywords" 8
93 .IX Item "Pluggable keywords"
94 Introduced in Perl 5.11.2
95 .Sp
96 See "PL_keyword_plugin" in perlapi for the mechanism.
97 .Sp
98 The ticket for this experiment is
99 [perl #13199] <https://github.com/Perl/perl5/issues/13199>.
100 .IP "Aliasing via reference" 8
101 .IX Item "Aliasing via reference"
102 Introduced in Perl 5.22.0
103 .Sp
104 Using this feature triggers warnings in the category
105 \&\f(CW\*(C`experimental::refaliasing\*(C'\fR.
106 .Sp
107 The ticket for this experiment is
108 [perl #14150] <https://github.com/Perl/perl5/issues/14150>.
109 .Sp
110 See also: "Assigning to References" in perlref
111 .IP "use re 'strict';" 8
112 .IX Item "use re 'strict';"
113 Introduced in Perl 5.22.0
114 .Sp
115 Using this feature triggers warnings in the category
116 \&\f(CW\*(C`experimental::re_strict\*(C'\fR.
117 .Sp
118 The ticket for this experiment is
119 [perl #18755] <https://github.com/Perl/perl5/issues/18755>
120 .Sp
121 See "'strict' mode" in re
122 .IP "Declaring a reference to a variable" 8
123 .IX Item "Declaring a reference to a variable"
124 Introduced in Perl 5.26.0
125 .Sp
126 Using this feature triggers warnings in the category
127 \&\f(CW\*(C`experimental::declared_refs\*(C'\fR.
128 .Sp
129 The ticket for this experiment is
130 [perl #15458] <https://github.com/Perl/perl5/issues/15458>.
131 .Sp
132 See also: "Declaring a Reference to a Variable" in perlref
133 .ie n .IP "There is an ""installhtml"" target in the Makefile." 8
134 .el .IP "There is an \f(CWinstallhtml\fR target in the Makefile." 8
135 .IX Item "There is an installhtml target in the Makefile."
136 The ticket for this experiment is
137 [perl #12726] <https://github.com/Perl/perl5/issues/12726>.
138 .IP "(Limited) Variable-length look-behind" 8
139 .IX Item "(Limited) Variable-length look-behind"
140 Introduced in Perl 5.30.0.
141 .Sp
142 Variability of up to 255 characters is handled.
143 .Sp
144 Using this feature triggers warnings in the category
145 \&\f(CW\*(C`experimental::vlb\*(C'\fR.
146 .Sp
147 The ticket for this experiment is
148 [perl #18756] <https://github.com/Perl/perl5/issues/18756>.
149 .Sp
150 See also: "(*positive_lookbehind:\fIpattern\fR)" in perlre and
151 "(*negative_lookbehind:\fIpattern\fR)" in perlre
152 .IP "Unicode private use character hooks" 8
153 .IX Item "Unicode private use character hooks"
154 Introduced in Perl 5.30.0.
155 .Sp
156 This feature is part of an interface intended for internal and experimental
157 use by the perl5 developers. You are unlikely to encounter it in the wild.
158 .Sp
159 Using this feature triggers warnings in the category
160 \&\f(CW\*(C`experimental::private_use\*(C'\fR.
161 .Sp
162 The ticket for this experiment is
163 [perl #18758] <https://github.com/Perl/perl5/issues/18758>.
164 .IP "Unicode property wildcards" 8
165 .IX Item "Unicode property wildcards"
166 Introduced in Perl 5.30.0.
167 .Sp
168 This feature allows regular expression matching against Unicode character
169 properties to be expressed more concisely.
170 .Sp
171 Using this feature triggers warnings in the category
172 \&\f(CW\*(C`experimental::uniprop_wildcards\*(C'\fR.
173 .Sp
174 The ticket for this experiment is
175 [perl #18759] <https://github.com/Perl/perl5/issues/18759>.
176 .IP "try/catch control structure" 8
177 .IX Item "try/catch control structure"
178 Introduced in Perl 5.34.0.
179 .Sp
180 Using the optional \f(CW\*(C`finally\*(C'\fR block part of this feature triggers warnings in
181 the category \f(CW\*(C`experimental::try\*(C'\fR.
182 .Sp
183 The ticket for this experiment is
184 [perl #18760] <https://github.com/Perl/perl5/issues/18760>
185 .ie n .IP "Use of @_ within subroutine signatures" 8
186 .el .IP "Use of \f(CW@_\fR within subroutine signatures" 8
187 .IX Item "Use of @_ within subroutine signatures"
188 Introduced in Perl 5.36.0 as part of a reduction in the scope of experimental
189 subroutine signatures.
190 .Sp
191 Using the default arguments array (\f(CW@_\fR) within a subroutine that uses
192 signatures will emit a warning in the category
193 \&\f(CW\*(C`experimental::args_array_with_signatures\*(C'\fR. This includes \f(CW@_\fR directly,
194 elements of it such as \f(CW$_[$index]\fR, or situations where the default
195 arguments array is accessed implicitly such as \f(CW\*(C`shift\*(C'\fR or \f(CW\*(C`pop\*(C'\fR without
196 arguments.
197 .IP "The builtin namespace" 8
198 .IX Item "The builtin namespace"
199 Introduced in Perl 5.36.0.
200 .Sp
201 Using certain functions of this feature triggers warnings in the category
202 \&\f(CW\*(C`experimental::builtin\*(C'\fR.
203 .Sp
204 In Perl 5.36.0, a new namespace, \f(CW\*(C`builtin\*(C'\fR, was created for new core functions
205 that will not be present in every namespace, but will be available for
206 importing. The namespace itself was considered experimental until Perl 5.39.2.
207 Some specific functions within it remain experimental.
208 .Sp
209 The ticket for this experiment is
210 [perl #19764] <https://github.com/Perl/perl5/issues/19764>.
211 .IP "The defer block modifier" 8
212 .IX Item "The defer block modifier"
213 Introduced in Perl 5.36.0
214 .Sp
215 Using this feature triggers warnings in the category \f(CW\*(C`experimental::defer\*(C'\fR.
216 .Sp
217 This feature adds a new kind of block, a \f(CW\*(C`defer\*(C'\fR block, which will not be
218 executed until the containing block is being exited.
219 .Sp
220 The ticket for this experiment is
221 [perl #17949] <https://github.com/Perl/perl5/issues/17949>.
222 .IP "Extra paired delimiters for quote-like operators" 8
223 .IX Item "Extra paired delimiters for quote-like operators"
224 Introduced in Perl 5.36.0
225 .Sp
226 Using this feature triggers warnings in the category
227 \&\f(CW\*(C`experimental::extra_paired_delimiters\*(C'\fR.
228 .Sp
229 This feature allows for many non-ASCII pairs of mirroring delimiters, for
230 example:
231 .Sp
232 .Vb 1
233 \& my @array = qw« tinker tailor soldier spy »;
234 .Ve
235 .Sp
236 The ticket for this experiment is
237 [perl #19765] <https://github.com/Perl/perl5/issues/19765>.
238 .SS "Accepted features"
239 .IX Subsection "Accepted features"
240 These features were so wildly successful and played so well with others that
241 we decided to remove their experimental status and admit them as full, stable
242 features in the world of Perl, lavishing all the benefits and luxuries thereof.
243 They are also awarded +5 Stability and +3 Charisma.
244 .IP "64\-bit support" 8
245 .IX Item "64-bit support"
246 Introduced in Perl 5.005
247 .IP "die accepts a reference" 8
248 .IX Item "die accepts a reference"
249 Introduced in Perl 5.005
250 .IP "DB module" 8
251 .IX Item "DB module"
252 Introduced in Perl 5.6.0
253 .Sp
254 See also perldebug, perldebtut
255 .IP "Weak references" 8
256 .IX Item "Weak references"
257 Introduced in Perl 5.6.0
258 .IP "Internal file glob" 8
259 .IX Item "Internal file glob"
260 Introduced in Perl 5.6.0
261 .IP "\fBfork()\fR emulation" 8
262 .IX Item "fork() emulation"
263 Introduced in Perl 5.6.1
264 .Sp
265 See also perlfork
266 .IP "\-Dusemultiplicity \-Duseithreads" 8
267 .IX Item "-Dusemultiplicity -Duseithreads"
268 Introduced in Perl 5.6.0
269 .Sp
270 Accepted in Perl 5.8.0
271 .IP "Support for long doubles" 8
272 .IX Item "Support for long doubles"
273 Introduced in Perl 5.6.0
274 .Sp
275 Accepted in Perl 5.8.1
276 .ie n .IP "The ""\eN"" regex character class" 8
277 .el .IP "The \f(CW\eN\fR regex character class" 8
278 .IX Item "The N regex character class"
279 The \f(CW\*(C`\eN\*(C'\fR character class, not to be confused with the named character
280 sequence \f(CW\*(C`\eN{NAME}\*(C'\fR, denotes any non-newline character in a regular
281 expression.
282 .Sp
283 Introduced in Perl 5.12
284 .Sp
285 Exact version of acceptance unclear, but no later than Perl 5.18.
286 .ie n .IP """(?{code})"" and ""(??{ code })""" 8
287 .el .IP "\f(CW(?{code})\fR and \f(CW(??{ code })\fR" 8
288 .IX Item "(?{code}) and (??{ code })"
289 Introduced in Perl 5.6.0
290 .Sp
291 Accepted in Perl 5.20.0
292 .Sp
293 See also perlre
294 .IP "Linux abstract Unix domain sockets" 8
295 .IX Item "Linux abstract Unix domain sockets"
296 Introduced in Perl 5.9.2
297 .Sp
298 Accepted before Perl 5.20.0. The Socket library is now primarily maintained
299 on CPAN, rather than in the perl core.
300 .Sp
301 See also Socket
302 .IP "Lvalue subroutines" 8
303 .IX Item "Lvalue subroutines"
304 Introduced in Perl 5.6.0
305 .Sp
306 Accepted in Perl 5.20.0
307 .Sp
308 See also perlsub
309 .IP "Backtracking control verbs" 8
310 .IX Item "Backtracking control verbs"
311 \&\f(CW\*(C`(*ACCEPT)\*(C'\fR
312 .Sp
313 Introduced in Perl 5.10
314 .Sp
315 Accepted in Perl 5.20.0
316 .ie n .IP "The "":pop"" IO pseudolayer" 8
317 .el .IP "The \f(CW:pop\fR IO pseudolayer" 8
318 .IX Item "The :pop IO pseudolayer"
319 See also "PERLIO" in perlrun
320 .Sp
321 Accepted in Perl 5.20.0
322 .ie n .IP """\es"" in regexp matches vertical tab" 8
323 .el .IP "\f(CW\es\fR in regexp matches vertical tab" 8
324 .IX Item "s in regexp matches vertical tab"
325 Accepted in Perl 5.22.0
326 .IP "Postfix dereference syntax" 8
327 .IX Item "Postfix dereference syntax"
328 Introduced in Perl 5.20.0
329 .Sp
330 Accepted in Perl 5.24.0
331 .IP "Lexical subroutines" 8
332 .IX Item "Lexical subroutines"
333 Introduced in Perl 5.18.0
334 .Sp
335 Accepted in Perl 5.26.0
336 .IP "String\- and number-specific bitwise operators" 8
337 .IX Item "String- and number-specific bitwise operators"
338 Introduced in Perl 5.22.0
339 .Sp
340 Accepted in Perl 5.28.0
341 .IP "Alphabetic assertions" 8
342 .IX Item "Alphabetic assertions"
343 Introduced in Perl 5.28.0
344 .Sp
345 Accepted in Perl 5.32.0
346 .IP "Script runs" 8
347 .IX Item "Script runs"
348 Introduced in Perl 5.28.0
349 .Sp
350 Accepted in Perl 5.32.0
351 .ie n .IP "The infix ""isa"" operator" 8
352 .el .IP "The infix \f(CWisa\fR operator" 8
353 .IX Item "The infix isa operator"
354 Introduced in Perl 5.32.0
355 .Sp
356 Accepted in Perl 5.36.0
357 .IP "Subroutine signatures" 8
358 .IX Item "Subroutine signatures"
359 Introduced in Perl 5.20.0
360 .Sp
361 Accepted in Perl 5.36.0
362 .IP "Regular Expression Set Operations" 8
363 .IX Item "Regular Expression Set Operations"
364 Introduced in Perl 5.18
365 .Sp
366 Accepted in Perl 5.36
367 .Sp
368 See : "Extended Bracketed Character Classes" in perlrecharclass
369 .IP "try/catch control structure" 8
370 .IX Item "try/catch control structure"
371 Introduced in Perl 5.34.0.
372 .Sp
373 Accepted in Perl 5.40 when not using the optional \f(CW\*(C`finally\*(C'\fR block.
374 .IP "The ""const"" attribute" 8
375 .IX Item "The ""const"" attribute"
376 Introduced in Perl 5.22.0
377 .Sp
378 Accepted in Perl 5.40
379 .Sp
380 See also: "Constant Functions" in perlsub
381 .IP "for loop with multiple iteration variables" 8
382 .IX Item "for loop with multiple iteration variables"
383 Introduced in Perl 5.36.0.
384 .Sp
385 Accepted in Perl 5.40.
386 .Sp
387 This feature enables a parenthesized list of iteration variables for \f(CW\*(C`for\*(C'\fR
388 rather than a single variable.
389 .SS "Removed features"
390 .IX Subsection "Removed features"
391 These features are no longer considered experimental and their functionality
392 has disappeared. It's your own fault if you wrote production programs using
393 these features after we explicitly told you not to (see perlpolicy).
394 .IP "5.005\-style threading" 8
395 .IX Item "5.005-style threading"
396 Introduced in Perl 5.005
397 .Sp
398 Removed in Perl 5.10
399 .IP perlcc 8
400 .IX Item "perlcc"
401 Introduced in Perl 5.005
402 .Sp
403 Moved from Perl 5.9.0 to CPAN
404 .IP "The pseudo-hash data type" 8
405 .IX Item "The pseudo-hash data type"
406 Introduced in Perl 5.6.0
407 .Sp
408 Removed in Perl 5.9.0
409 .IP "GetOpt::Long Options can now take multiple values at once (experimental)" 8
410 .IX Item "GetOpt::Long Options can now take multiple values at once (experimental)"
411 \&\f(CW\*(C`Getopt::Long\*(C'\fR upgraded to version 2.35
412 .Sp
413 Removed in Perl 5.8.8
414 .IP Assertions 8
415 .IX Item "Assertions"
416 The \f(CW\*(C`\-A\*(C'\fR command line switch
417 .Sp
418 Introduced in Perl 5.9.0
419 .Sp
420 Removed in Perl 5.9.5
421 .IP Test::Harness::Straps 8
422 .IX Item "Test::Harness::Straps"
423 Moved from Perl 5.10.1 to CPAN
424 .ie n .IP """legacy""" 8
425 .el .IP \f(CWlegacy\fR 8
426 .IX Item "legacy"
427 The experimental \f(CW\*(C`legacy\*(C'\fR pragma was swallowed by the \f(CW\*(C`feature\*(C'\fR pragma.
428 .Sp
429 Introduced in Perl 5.11.2
430 .Sp
431 Removed in Perl 5.11.3
432 .ie n .IP "Lexical $_" 8
433 .el .IP "Lexical \f(CW$_\fR" 8
434 .IX Item "Lexical $_"
435 Using this feature triggered warnings in the category
436 \&\f(CW\*(C`experimental::lexical_topic\*(C'\fR.
437 .Sp
438 Introduced in Perl 5.10.0
439 .Sp
440 Removed in Perl 5.24.0
441 .IP "Array and hash container functions accept references" 8
442 .IX Item "Array and hash container functions accept references"
443 Using this feature triggered warnings in the category
444 \&\f(CW\*(C`experimental::autoderef\*(C'\fR.
445 .Sp
446 Superseded by "Postfix dereference syntax".
447 .Sp
448 Introduced in Perl 5.14.0
449 .Sp
450 Removed in Perl 5.24.0
451 .ie n .IP """our"" can have an experimental optional attribute ""unique""" 8
452 .el .IP "\f(CWour\fR can have an experimental optional attribute \f(CWunique\fR" 8
453 .IX Item "our can have an experimental optional attribute unique"
454 Introduced in Perl 5.8.0
455 .Sp
456 Deprecated in Perl 5.10.0
457 .Sp
458 Removed in Perl 5.28.0
459 .ie n .IP "The "":win32"" IO pseudolayer" 8
460 .el .IP "The \f(CW:win32\fR IO pseudolayer" 8
461 .IX Item "The :win32 IO pseudolayer"
462 Introduced in Perl 5.8.0 (or before)
463 .Sp
464 Removed in Perl 5.36.0
465 .SH "SEE ALSO"
466 .IX Header "SEE ALSO"
467 For a complete list of features check feature.
468 .SH AUTHORS
469 .IX Header "AUTHORS"
470 brian d foy \f(CW\*(C`<[email protected]>\*(C'\fR
471 .PP
472 Sébastien Aperghis-Tramoni \f(CW\*(C`<[email protected]>\*(C'\fR
473 .SH COPYRIGHT
474 .IX Header "COPYRIGHT"
475 Copyright 2010, brian d foy \f(CW\*(C`<[email protected]>\*(C'\fR
476 .SH LICENSE
477 .IX Header "LICENSE"
478 You can use and redistribute this document under the same terms as Perl
479 itself.