This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
RE: compile warnings w/ PM_SETRE and ReREFCNT_inc
[perl5.git] / opcode.pl
CommitLineData
d6480c9d
NC
1#!/usr/bin/perl -w
2use strict;
3
36bb303b
NC
4BEGIN {
5 # Get function prototypes
9ad884cb 6 require 'regen_lib.pl';
36bb303b 7}
79072805 8
d6480c9d
NC
9my $opcode_new = 'opcode.h-new';
10my $opname_new = 'opnames.h-new';
bb6f4497 11open(OC, ">$opcode_new") || die "Can't create $opcode_new: $!\n";
dfb1454f 12binmode OC;
bb6f4497 13open(ON, ">$opname_new") || die "Can't create $opname_new: $!\n";
dfb1454f 14binmode ON;
79072805
LW
15select OC;
16
17# Read data.
18
d6480c9d
NC
19my %seen;
20my (@ops, %desc, %check, %ckname, %flags, %args);
21
79072805
LW
22while (<DATA>) {
23 chop;
24 next unless $_;
25 next if /^#/;
d6480c9d
NC
26 my ($key, $desc, $check, $flags, $args) = split(/\t+/, $_, 5);
27 $args = '' unless defined $args;
c07a80fd
PP
28
29 warn qq[Description "$desc" duplicates $seen{$desc}\n] if $seen{$desc};
30 die qq[Opcode "$key" duplicates $seen{$key}\n] if $seen{$key};
31 $seen{$desc} = qq[description of opcode "$key"];
32 $seen{$key} = qq[opcode "$key"];
33
79072805 34 push(@ops, $key);
c07a80fd 35 $desc{$key} = $desc;
79072805
LW
36 $check{$key} = $check;
37 $ckname{$check}++;
38 $flags{$key} = $flags;
39 $args{$key} = $args;
40}
41
1d5774de
NC
42# Set up aliases
43
44my %alias;
45
46# Format is "this function" => "does these op names"
47my @raw_alias = (
6faeeb49 48 Perl_do_kv => [qw( keys values )],
d83386fa 49 Perl_unimplemented_op => [qw(padany mapstart custom)],
0b612f93
NC
50 # All the ops with a body of { return NORMAL; }
51 Perl_pp_null => [qw(scalar regcmaybe lineseq scope)],
52
53 Perl_pp_goto => ['dump'],
54 Perl_pp_require => ['dofile'],
55 Perl_pp_untie => ['dbmclose'],
56 Perl_pp_sysread => [qw(read recv)],
57 Perl_pp_sysseek => ['seek'],
58 Perl_pp_ioctl => ['fcntl'],
59 Perl_pp_ssockopt => ['gsockopt'],
60 Perl_pp_getpeername => ['getsockname'],
61 Perl_pp_stat => ['lstat'],
f1cb2d48 62 Perl_pp_ftrowned => [qw(fteowned ftzero ftsock ftchr ftblk
17ad201a
NC
63 ftfile ftdir ftpipe ftsuid ftsgid
64 ftsvtx)],
0b612f93
NC
65 Perl_pp_fttext => ['ftbinary'],
66 Perl_pp_gmtime => ['localtime'],
67 Perl_pp_semget => [qw(shmget msgget)],
68 Perl_pp_semctl => [qw(shmctl msgctl)],
0b612f93
NC
69 Perl_pp_ghostent => [qw(ghbyname ghbyaddr)],
70 Perl_pp_gnetent => [qw(gnbyname gnbyaddr)],
71 Perl_pp_gprotoent => [qw(gpbyname gpbynumber)],
72 Perl_pp_gservent => [qw(gsbyname gsbyport)],
73 Perl_pp_gpwent => [qw(gpwnam gpwuid)],
74 Perl_pp_ggrent => [qw(ggrnam ggrgid)],
957b0e1d 75 Perl_pp_ftis => [qw(ftsize ftmtime ftatime ftctime)],
605b9385 76 Perl_pp_chown => [qw(unlink chmod utime kill)],
ce6987d0 77 Perl_pp_link => ['symlink'],
af9e49b4
NC
78 Perl_pp_ftrread => [qw(ftrwrite ftrexec fteread ftewrite
79 fteexec)],
ca563b4e 80 Perl_pp_shmwrite => [qw(shmread msgsnd msgrcv semop)],
64a1bc8e 81 Perl_pp_send => ['syswrite'],
c960fc3b 82 Perl_pp_defined => [qw(dor dorassign)],
62726f23
SP
83 Perl_pp_and => ['andassign'],
84 Perl_pp_or => ['orassign'],
12e9c124 85 Perl_pp_ucfirst => ['lcfirst'],
afd9910b 86 Perl_pp_sle => [qw(slt sgt sge)],
0d863452 87 Perl_pp_print => ['say'],
2723d216 88 Perl_pp_index => ['rindex'],
daa2adfd 89 Perl_pp_oct => ['hex'],
789b4bc9 90 Perl_pp_shift => ['pop'],
71302fe3 91 Perl_pp_sin => [qw(cos exp log sqrt)],
3658c1f1 92 Perl_pp_bit_or => ['bit_xor'],
17ab7946 93 Perl_pp_rv2av => ['rv2hv'],
878d132a 94 Perl_pp_akeys => ['avalues'],
605b9385 95 );
1d5774de
NC
96
97while (my ($func, $names) = splice @raw_alias, 0, 2) {
6faeeb49 98 $alias{$_} = $func for @$names;
1d5774de
NC
99}
100
79072805
LW
101# Emit defines.
102
748a9306 103print <<"END";
37442d52
RGS
104/* -*- buffer-read-only: t -*-
105 *
d6376244
JH
106 * opcode.h
107 *
699a97de
RGS
108 * Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
109 * 2001, 2002, 2003, 2004, 2005, 2006, 2007 by Larry Wall and others
d6376244
JH
110 *
111 * You may distribute under the terms of either the GNU General Public
112 * License or the Artistic License, as specified in the README file.
113 *
114 * !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
115 * This file is built by opcode.pl from its data. Any changes made here
116 * will be lost!
117 */
a27f85b3 118
27da23d5
JH
119#ifndef PERL_GLOBAL_STRUCT_INIT
120
864dbfa3
GS
121#define Perl_pp_i_preinc Perl_pp_preinc
122#define Perl_pp_i_predec Perl_pp_predec
123#define Perl_pp_i_postinc Perl_pp_postinc
124#define Perl_pp_i_postdec Perl_pp_postdec
748a9306 125
65bca31a
NC
126PERL_PPDEF(Perl_unimplemented_op)
127
748a9306 128END
abdd5c84
GS
129
130print ON <<"END";
37442d52
RGS
131/* -*- buffer-read-only: t -*-
132 *
d6376244
JH
133 * opnames.h
134 *
cfc85103 135 * Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
699a97de 136 * 2007 by Larry Wall and others
d6376244
JH
137 *
138 * You may distribute under the terms of either the GNU General Public
139 * License or the Artistic License, as specified in the README file.
140 *
141 *
142 * !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
143 * This file is built by opcode.pl from its data. Any changes made here
144 * will be lost!
145 */
abdd5c84
GS
146
147typedef enum opcode {
148END
149
d6480c9d 150my $i = 0;
79072805 151for (@ops) {
abdd5c84 152 print ON "\t", &tab(3,"OP_\U$_,"), "/* ", $i++, " */\n";
79072805 153}
abdd5c84
GS
154print ON "\t", &tab(3,"OP_max"), "\n";
155print ON "} opcode;\n";
4c80c0b2
NC
156print ON "\n#define MAXO ", scalar @ops, "\n";
157print ON "#define OP_phoney_INPUT_ONLY -1\n";
158print ON "#define OP_phoney_OUTPUT_ONLY -2\n\n";
79072805 159
c07a80fd 160# Emit op names and descriptions.
79072805
LW
161
162print <<END;
73c4f7a1
GS
163START_EXTERN_C
164
4a36906c
RGS
165#define OP_NAME(o) ((o)->op_type == OP_CUSTOM ? custom_op_name(o) : \\
166 PL_op_name[(o)->op_type])
167#define OP_DESC(o) ((o)->op_type == OP_CUSTOM ? custom_op_desc(o) : \\
168 PL_op_desc[(o)->op_type])
53e06cf0 169
79072805 170#ifndef DOINIT
27da23d5 171EXTCONST char* const PL_op_name[];
79072805 172#else
27da23d5 173EXTCONST char* const PL_op_name[] = {
79072805
LW
174END
175
176for (@ops) {
c07a80fd
PP
177 print qq(\t"$_",\n);
178}
179
180print <<END;
181};
182#endif
183
184END
185
186print <<END;
187#ifndef DOINIT
27da23d5 188EXTCONST char* const PL_op_desc[];
c07a80fd 189#else
27da23d5 190EXTCONST char* const PL_op_desc[] = {
c07a80fd
PP
191END
192
193for (@ops) {
42d38218
MS
194 my($safe_desc) = $desc{$_};
195
a567e93b 196 # Have to escape double quotes and escape characters.
42d38218
MS
197 $safe_desc =~ s/(^|[^\\])([\\"])/$1\\$2/g;
198
199 print qq(\t"$safe_desc",\n);
79072805
LW
200}
201
202print <<END;
203};
204#endif
205
73c4f7a1
GS
206END_EXTERN_C
207
27da23d5 208#endif /* !PERL_GLOBAL_STRUCT_INIT */
22c35a8c 209END
79072805 210
22c35a8c 211# Emit function declarations.
79072805 212
22c35a8c 213#for (sort keys %ckname) {
cea2e8a9 214# print "OP *\t", &tab(3,$_),"(pTHX_ OP* o);\n";
22c35a8c
GS
215#}
216#
217#print "\n";
218#
219#for (@ops) {
cea2e8a9 220# print "OP *\t", &tab(3, "pp_$_"), "(pTHX);\n";
22c35a8c 221#}
79072805
LW
222
223# Emit ppcode switch array.
224
225print <<END;
226
73c4f7a1
GS
227START_EXTERN_C
228
27da23d5 229#ifdef PERL_GLOBAL_STRUCT_INIT
97aff369 230# define PERL_PPADDR_INITED
27da23d5 231static const Perl_ppaddr_t Gppaddr[]
79072805 232#else
27da23d5 233# ifndef PERL_GLOBAL_STRUCT
97aff369 234# define PERL_PPADDR_INITED
27da23d5
JH
235EXT Perl_ppaddr_t PL_ppaddr[] /* or perlvars.h */
236# endif
237#endif /* PERL_GLOBAL_STRUCT */
238#if (defined(DOINIT) && !defined(PERL_GLOBAL_STRUCT)) || defined(PERL_GLOBAL_STRUCT_INIT)
97aff369 239# define PERL_PPADDR_INITED
27da23d5 240= {
79072805
LW
241END
242
243for (@ops) {
6faeeb49
MB
244 if (my $name = $alias{$_}) {
245 print "\tMEMBER_TO_FPTR($name),\t/* Perl_pp_$_ */\n";
246 }
247 else {
248 print "\tMEMBER_TO_FPTR(Perl_pp_$_),\n";
249 }
79072805
LW
250}
251
252print <<END;
27da23d5 253}
79072805 254#endif
97aff369 255#ifdef PERL_PPADDR_INITED
27da23d5 256;
97aff369 257#endif
79072805
LW
258
259END
260
261# Emit check routines.
262
263print <<END;
27da23d5 264#ifdef PERL_GLOBAL_STRUCT_INIT
97aff369 265# define PERL_CHECK_INITED
27da23d5 266static const Perl_check_t Gcheck[]
79072805 267#else
27da23d5 268# ifndef PERL_GLOBAL_STRUCT
97aff369 269# define PERL_CHECK_INITED
27da23d5
JH
270EXT Perl_check_t PL_check[] /* or perlvars.h */
271# endif
272#endif
273#if (defined(DOINIT) && !defined(PERL_GLOBAL_STRUCT)) || defined(PERL_GLOBAL_STRUCT_INIT)
97aff369 274# define PERL_CHECK_INITED
27da23d5 275= {
79072805
LW
276END
277
278for (@ops) {
2b260de0 279 print "\t", &tab(3, "MEMBER_TO_FPTR(Perl_$check{$_}),"), "\t/* $_ */\n";
79072805
LW
280}
281
282print <<END;
27da23d5 283}
79072805 284#endif
97aff369 285#ifdef PERL_CHECK_INITED
27da23d5 286;
97aff369 287#endif /* #ifdef PERL_CHECK_INITED */
79072805
LW
288
289END
290
291# Emit allowed argument types.
292
293print <<END;
27da23d5
JH
294#ifndef PERL_GLOBAL_STRUCT_INIT
295
79072805 296#ifndef DOINIT
1ccb7c8d 297EXTCONST U32 PL_opargs[];
79072805 298#else
1ccb7c8d 299EXTCONST U32 PL_opargs[] = {
79072805
LW
300END
301
d6480c9d
NC
302my %argnum = (
303 'S', 1, # scalar
304 'L', 2, # list
305 'A', 3, # array value
306 'H', 4, # hash value
307 'C', 5, # code value
308 'F', 6, # file value
309 'R', 7, # scalar reference
79072805
LW
310);
311
d6480c9d 312my %opclass = (
db173bac
MB
313 '0', 0, # baseop
314 '1', 1, # unop
315 '2', 2, # binop
316 '|', 3, # logop
1a67a97c
SM
317 '@', 4, # listop
318 '/', 5, # pmop
350de78d 319 '$', 6, # svop_or_padop
7934575e 320 '#', 7, # padop
1a67a97c
SM
321 '"', 8, # pvop_or_svop
322 '{', 9, # loop
323 ';', 10, # cop
324 '%', 11, # baseop_or_unop
325 '-', 12, # filestatop
326 '}', 13, # loopexop
db173bac
MB
327);
328
a85d93d9
JH
329my %OP_IS_SOCKET;
330my %OP_IS_FILETEST;
331
79072805 332for (@ops) {
d6480c9d
NC
333 my $argsum = 0;
334 my $flags = $flags{$_};
79072805
LW
335 $argsum |= 1 if $flags =~ /m/; # needs stack mark
336 $argsum |= 2 if $flags =~ /f/; # fold constants
337 $argsum |= 4 if $flags =~ /s/; # always produces scalar
338 $argsum |= 8 if $flags =~ /t/; # needs target scalar
b162f9ea 339 $argsum |= (8|256) if $flags =~ /T/; # ... which may be lexical
79072805
LW
340 $argsum |= 16 if $flags =~ /i/; # always produces integer
341 $argsum |= 32 if $flags =~ /I/; # has corresponding int op
342 $argsum |= 64 if $flags =~ /d/; # danger, unknown side effects
a0d0e21e 343 $argsum |= 128 if $flags =~ /u/; # defaults to $_
8be7d673 344 $flags =~ /([\W\d_])/ or die qq[Opcode "$_" has no class indicator];
b162f9ea 345 $argsum |= $opclass{$1} << 9;
d6480c9d
NC
346 my $mul = 0x2000; # 2 ^ OASHIFT
347 for my $arg (split(' ',$args{$_})) {
a85d93d9
JH
348 if ($arg =~ /^F/) {
349 $OP_IS_SOCKET{$_} = 1 if $arg =~ s/s//;
350 $OP_IS_FILETEST{$_} = 1 if $arg =~ s/-//;
351 }
d6480c9d 352 my $argnum = ($arg =~ s/\?//) ? 8 : 0;
a85d93d9 353 die "op = $_, arg = $arg\n" unless length($arg) == 1;
79072805 354 $argnum += $argnum{$arg};
b162f9ea
IZ
355 warn "# Conflicting bit 32 for '$_'.\n"
356 if $argnum & 8 and $mul == 0x10000000;
79072805
LW
357 $argsum += $argnum * $mul;
358 $mul <<= 4;
359 }
360 $argsum = sprintf("0x%08x", $argsum);
db173bac 361 print "\t", &tab(3, "$argsum,"), "/* $_ */\n";
79072805
LW
362}
363
364print <<END;
365};
366#endif
73c4f7a1 367
bae1192d
JH
368#endif /* !PERL_GLOBAL_STRUCT_INIT */
369
73c4f7a1 370END_EXTERN_C
27da23d5 371
79072805
LW
372END
373
a85d93d9
JH
374if (keys %OP_IS_SOCKET) {
375 print ON "\n#define OP_IS_SOCKET(op) \\\n\t(";
376 print ON join(" || \\\n\t ",
377 map { "(op) == OP_" . uc() } sort keys %OP_IS_SOCKET);
378 print ON ")\n\n";
379}
380
381if (keys %OP_IS_FILETEST) {
382 print ON "\n#define OP_IS_FILETEST(op) \\\n\t(";
383 print ON join(" || \\\n\t ",
384 map { "(op) == OP_" . uc() } sort keys %OP_IS_FILETEST);
385 print ON ")\n\n";
386}
387
37442d52
RGS
388print OC "/* ex: set ro: */\n";
389print ON "/* ex: set ro: */\n";
390
735e0d5c 391close OC or die "Error closing opcode.h: $!";
abdd5c84 392close ON or die "Error closing opnames.h: $!";
735e0d5c 393
36bb303b
NC
394foreach ('opcode.h', 'opnames.h') {
395 safer_rename_silent $_, "$_-old";
396}
397safer_rename $opcode_new, 'opcode.h';
398safer_rename $opname_new, 'opnames.h';
46f659cb 399
d6480c9d
NC
400my $pp_proto_new = 'pp_proto.h-new';
401my $pp_sym_new = 'pp.sym-new';
bb6f4497
CL
402
403open PP, ">$pp_proto_new" or die "Error creating $pp_proto_new: $!";
dfb1454f 404binmode PP;
bb6f4497 405open PPSYM, ">$pp_sym_new" or die "Error creating $pp_sym_new: $!";
dfb1454f 406binmode PPSYM;
22c35a8c 407
a27f85b3 408print PP <<"END";
37442d52
RGS
409/* -*- buffer-read-only: t -*-
410 !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
a27f85b3
GS
411 This file is built by opcode.pl from its data. Any changes made here
412 will be lost!
413*/
414
415END
416
417print PPSYM <<"END";
37442d52 418# -*- buffer-read-only: t -*-
a27f85b3 419#
a567e93b 420# !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
a27f85b3
GS
421# This file is built by opcode.pl from its data. Any changes made here
422# will be lost!
423#
424
425END
426
427
22c35a8c 428for (sort keys %ckname) {
864dbfa3
GS
429 print PP "PERL_CKDEF(Perl_$_)\n";
430 print PPSYM "Perl_$_\n";
20ce7b12 431#OP *\t", &tab(3,$_),"(OP* o);\n";
22c35a8c
GS
432}
433
434print PP "\n\n";
435
735e0d5c 436for (@ops) {
15e52e56 437 next if /^i_(pre|post)(inc|dec)$/;
53e06cf0 438 next if /^custom$/;
864dbfa3
GS
439 print PP "PERL_PPDEF(Perl_pp_$_)\n";
440 print PPSYM "Perl_pp_$_\n";
735e0d5c 441}
37442d52
RGS
442print PP "\n/* ex: set ro: */\n";
443print PPSYM "\n# ex: set ro:\n";
735e0d5c
IZ
444
445close PP or die "Error closing pp_proto.h: $!";
22c35a8c 446close PPSYM or die "Error closing pp.sym: $!";
735e0d5c 447
36bb303b
NC
448foreach ('pp_proto.h', 'pp.sym') {
449 safer_rename_silent $_, "$_-old";
450}
451safer_rename $pp_proto_new, 'pp_proto.h';
452safer_rename $pp_sym_new, 'pp.sym';
46f659cb 453
24600adc
JH
454END {
455 foreach ('opcode.h', 'opnames.h', 'pp_proto.h', 'pp.sym') {
456 1 while unlink "$_-old";
457 }
458}
459
79072805
LW
460###########################################################################
461sub tab {
d6480c9d 462 my ($l, $t) = @_;
79072805
LW
463 $t .= "\t" x ($l - (length($t) + 1) / 8);
464 $t;
465}
466###########################################################################
b162f9ea
IZ
467
468# Some comments about 'T' opcode classifier:
469
470# Safe to set if the ppcode uses:
471# tryAMAGICbin, tryAMAGICun, SETn, SETi, SETu, PUSHn, PUSHTARG, SETTARG,
472# SETs(TARG), XPUSHn, XPUSHu,
473
474# Unsafe to set if the ppcode uses dTARG or [X]RETPUSH[YES|NO|UNDEF]
475
476# lt and friends do SETs (including ncmp, but not scmp)
477
21f5b33c
GS
478# Additional mode of failure: the opcode can modify TARG before it "used"
479# all the arguments (or may call an external function which does the same).
480# If the target coincides with one of the arguments ==> kaboom.
481
b162f9ea
IZ
482# pp.c pos substr each not OK (RETPUSHUNDEF)
483# substr vec also not OK due to LV to target (are they???)
484# ref not OK (RETPUSHNO)
485# trans not OK (dTARG; TARG = sv_newmortal();)
486# ucfirst etc not OK: TMP arg processed inplace
69b47968 487# quotemeta not OK (unsafe when TARG == arg)
91e74348 488# each repeat not OK too due to list context
b162f9ea 489# pack split - unknown whether they are safe
dae78bb1
IZ
490# sprintf: is calling do_sprintf(TARG,...) which can act on TARG
491# before other args are processed.
b162f9ea 492
21f5b33c
GS
493# Suspicious wrt "additional mode of failure" (and only it):
494# schop, chop, postinc/dec, bit_and etc, negate, complement.
495
496# Also suspicious: 4-arg substr, sprintf, uc/lc (POK_only), reverse, pack.
497
498# substr/vec: doing TAINT_off()???
499
b162f9ea
IZ
500# pp_hot.c
501# readline - unknown whether it is safe
502# match subst not OK (dTARG)
503# grepwhile not OK (not always setting)
69b47968 504# join not OK (unsafe when TARG == arg)
b162f9ea 505
21f5b33c
GS
506# Suspicious wrt "additional mode of failure": concat (dealt with
507# in ck_sassign()), join (same).
508
b162f9ea
IZ
509# pp_ctl.c
510# mapwhile flip caller not OK (not always setting)
511
512# pp_sys.c
513# backtick glob warn die not OK (not always setting)
514# warn not OK (RETPUSHYES)
515# open fileno getc sysread syswrite ioctl accept shutdown
516# ftsize(etc) readlink telldir fork alarm getlogin not OK (RETPUSHUNDEF)
517# umask select not OK (XPUSHs(&PL_sv_undef);)
518# fileno getc sysread syswrite tell not OK (meth("FILENO" "GETC"))
519# sselect shm* sem* msg* syscall - unknown whether they are safe
520# gmtime not OK (list context)
521
21f5b33c
GS
522# Suspicious wrt "additional mode of failure": warn, die, select.
523
79072805
LW
524__END__
525
d83386fa
NC
526# New ops always go at the end
527# The restriction on having custom as the last op has been removed
7399586d 528
64b99527
SC
529# A recapitulation of the format of this file:
530# The file consists of five columns: the name of the op, an English
531# description, the name of the "check" routine used to optimize this
532# operation, some flags, and a description of the operands.
533
534# The flags consist of options followed by a mandatory op class signifier
535
536# The classes are:
537# baseop - 0 unop - 1 binop - 2
538# logop - | listop - @ pmop - /
539# padop/svop - $ padop - # (unused) loop - {
540# baseop/unop - % loopexop - } filestatop - -
3508218b 541# pvop/svop - " cop - ;
64b99527
SC
542
543# Other options are:
544# needs stack mark - m
545# needs constant folding - f
546# produces a scalar - s
547# produces an integer - i
548# needs a target - t
549# target can be in a pad - T
550# has a corresponding integer version - I
551# has side effects - d
552# uses $_ if no argument given - u
553
554# Values for the operands are:
555# scalar - S list - L array - A
556# hash - H sub (CV) - C file - F
557# socket - Fs filetest - F- reference - R
558# "?" denotes an optional operand.
559
79072805
LW
560# Nothing.
561
562null null operation ck_null 0
93a17b20 563stub stub ck_null 0
db173bac 564scalar scalar ck_fun s% S
79072805
LW
565
566# Pushy stuff.
567
db173bac
MB
568pushmark pushmark ck_null s0
569wantarray wantarray ck_null is0
79072805 570
db173bac 571const constant item ck_svconst s$
79072805 572
7934575e
GS
573gvsv scalar variable ck_null ds$
574gv glob value ck_null ds$
db173bac
MB
575gelem glob elem ck_null d2 S S
576padsv private variable ck_null ds0
577padav private array ck_null d0
578padhv private hash ck_null d0
f1612b5c 579padany private value ck_null d0
79072805 580
1167e5da 581pushre push regexp ck_null d/
79072805
LW
582
583# References and stuff.
584
db173bac 585rv2gv ref-to-glob cast ck_rvconst ds1
b89fed5f 586rv2sv scalar dereference ck_rvconst ds1
db173bac 587av2arylen array length ck_null is1
b89fed5f 588rv2cv subroutine dereference ck_rvconst d1
db173bac
MB
589anoncode anonymous subroutine ck_anoncode $
590prototype subroutine prototype ck_null s% S
5d11ae5e 591refgen reference constructor ck_spair m1 L
dfa0f641 592srefgen single ref constructor ck_null fs1 S
db173bac
MB
593ref reference-type operator ck_fun stu% S?
594bless bless ck_fun s@ S S?
79072805
LW
595
596# Pushy I/O.
597
01f5bc1b 598backtick quoted execution (``, qx) ck_open tu% S?
0a753a76 599# glob defaults its first arg to $_
649da076 600glob glob ck_glob t@ S?
e4b7ebf3 601readline <HANDLE> ck_readline t% F?
5fc9b9e4 602rcatline append I/O operator ck_null t$
79072805
LW
603
604# Bindable operators.
605
f1612b5c
GS
606regcmaybe regexp internal guard ck_fun s1 S
607regcreset regexp internal reset ck_fun s1 S
608regcomp regexp compilation ck_null s| S
609match pattern match (m//) ck_match d/
610qr pattern quote (qr//) ck_match s/
59f00321 611subst substitution (s///) ck_match dis/ S
f1612b5c 612substcont substitution iterator ck_null dis|
59f00321 613trans transliteration (tr///) ck_match is" S
79072805
LW
614
615# Lvalue operators.
db173bac
MB
616# sassign is special-cased for op class
617
b162f9ea 618sassign scalar assignment ck_sassign s0
db173bac
MB
619aassign list assignment ck_null t2 L L
620
21f5b33c
GS
621chop chop ck_spair mts% L
622schop scalar chop ck_null stu% S?
f1612b5c
GS
623chomp chomp ck_spair mTs% L
624schomp scalar chomp ck_null sTu% S?
69794302 625defined defined operator ck_defined isu% S?
db173bac
MB
626undef undef operator ck_lfun s% S?
627study study ck_fun su% S?
628pos match position ck_lfun stu% S?
629
42d38218
MS
630preinc preincrement (++) ck_lfun dIs1 S
631i_preinc integer preincrement (++) ck_lfun dis1 S
632predec predecrement (--) ck_lfun dIs1 S
633i_predec integer predecrement (--) ck_lfun dis1 S
21f5b33c 634postinc postincrement (++) ck_lfun dIst1 S
42d38218 635i_postinc integer postincrement (++) ck_lfun disT1 S
21f5b33c 636postdec postdecrement (--) ck_lfun dIst1 S
42d38218 637i_postdec integer postdecrement (--) ck_lfun disT1 S
79072805
LW
638
639# Ordinary operators.
640
42d38218
MS
641pow exponentiation (**) ck_null fsT2 S S
642
f1612b5c 643multiply multiplication (*) ck_null IfsT2 S S
42d38218
MS
644i_multiply integer multiplication (*) ck_null ifsT2 S S
645divide division (/) ck_null IfsT2 S S
646i_divide integer division (/) ck_null ifsT2 S S
647modulo modulus (%) ck_null IifsT2 S S
648i_modulo integer modulus (%) ck_null ifsT2 S S
649repeat repeat (x) ck_repeat mt2 L S
650
651add addition (+) ck_null IfsT2 S S
652i_add integer addition (+) ck_null ifsT2 S S
653subtract subtraction (-) ck_null IfsT2 S S
654i_subtract integer subtraction (-) ck_null ifsT2 S S
df91b2c5 655concat concatenation (.) or string ck_concat fsT2 S S
b162f9ea 656stringify string ck_fun fsT@ S
db173bac 657
42d38218
MS
658left_shift left bitshift (<<) ck_bitop fsT2 S S
659right_shift right bitshift (>>) ck_bitop fsT2 S S
660
661lt numeric lt (<) ck_null Iifs2 S S
662i_lt integer lt (<) ck_null ifs2 S S
663gt numeric gt (>) ck_null Iifs2 S S
664i_gt integer gt (>) ck_null ifs2 S S
665le numeric le (<=) ck_null Iifs2 S S
666i_le integer le (<=) ck_null ifs2 S S
667ge numeric ge (>=) ck_null Iifs2 S S
668i_ge integer ge (>=) ck_null ifs2 S S
669eq numeric eq (==) ck_null Iifs2 S S
670i_eq integer eq (==) ck_null ifs2 S S
671ne numeric ne (!=) ck_null Iifs2 S S
672i_ne integer ne (!=) ck_null ifs2 S S
673ncmp numeric comparison (<=>) ck_null Iifst2 S S
674i_ncmp integer comparison (<=>) ck_null ifst2 S S
db173bac 675
2de3dbcc
JH
676slt string lt ck_null ifs2 S S
677sgt string gt ck_null ifs2 S S
678sle string le ck_null ifs2 S S
679sge string ge ck_null ifs2 S S
db173bac
MB
680seq string eq ck_null ifs2 S S
681sne string ne ck_null ifs2 S S
2de3dbcc 682scmp string comparison (cmp) ck_null ifst2 S S
db173bac 683
21f5b33c
GS
684bit_and bitwise and (&) ck_bitop fst2 S S
685bit_xor bitwise xor (^) ck_bitop fst2 S S
686bit_or bitwise or (|) ck_bitop fst2 S S
db173bac 687
21f5b33c 688negate negation (-) ck_null Ifst1 S
f1612b5c 689i_negate integer negation (-) ck_null ifsT1 S
db173bac 690not not ck_null ifs1 S
21f5b33c 691complement 1's complement (~) ck_bitop fst1 S
79072805 692
fdecdb95
NC
693smartmatch smart match ck_smartmatch s2
694
79072805
LW
695# High falutin' math.
696
f1612b5c
GS
697atan2 atan2 ck_fun fsT@ S S
698sin sin ck_fun fsTu% S?
699cos cos ck_fun fsTu% S?
700rand rand ck_fun sT% S?
701srand srand ck_fun s% S?
702exp exp ck_fun fsTu% S?
703log log ck_fun fsTu% S?
704sqrt sqrt ck_fun fsTu% S?
79072805 705
cf26c822
CS
706# Lowbrow math.
707
b162f9ea
IZ
708int int ck_fun fsTu% S?
709hex hex ck_fun fsTu% S?
710oct oct ck_fun fsTu% S?
711abs abs ck_fun fsTu% S?
79072805
LW
712
713# String stuff.
714
b162f9ea 715length length ck_lengthconst isTu% S?
35fba0d9 716substr substr ck_substr st@ S S S? S?
db173bac 717vec vec ck_fun ist@ S S S
79072805 718
b162f9ea
IZ
719index index ck_index isT@ S S S?
720rindex rindex ck_index isT@ S S S?
79072805 721
fc7325bb 722sprintf sprintf ck_fun mst@ S L
db173bac 723formline formline ck_fun ms@ S L
b162f9ea
IZ
724ord ord ck_fun ifsTu% S?
725chr chr ck_fun fsTu% S?
726crypt crypt ck_fun fsT@ S S
2de3dbcc
JH
727ucfirst ucfirst ck_fun fstu% S?
728lcfirst lcfirst ck_fun fstu% S?
729uc uc ck_fun fstu% S?
730lc lc ck_fun fstu% S?
69b47968 731quotemeta quotemeta ck_fun fstu% S?
79072805
LW
732
733# Arrays.
734
f1612b5c 735rv2av array dereference ck_rvconst dt1
7934575e 736aelemfast constant array element ck_null s$ A S
db173bac
MB
737aelem array element ck_null s2 A S
738aslice array slice ck_null m@ A L
79072805 739
878d132a
NC
740aeach each on array ck_each % A
741akeys keys on array ck_each t% A
742avalues values on array ck_each t% A
743
aa689395 744# Hashes.
79072805 745
878d132a
NC
746each each ck_each % H
747values values ck_each t% H
748keys keys ck_each t% H
db173bac 749delete delete ck_delete % S
42d38218 750exists exists ck_exists is% S
f1612b5c
GS
751rv2hv hash dereference ck_rvconst dt1
752helem hash element ck_null s2@ H S
db173bac 753hslice hash slice ck_null m@ H L
79072805
LW
754
755# Explosives and implosives.
756
bab9c0ac 757unpack unpack ck_unpack @ S S?
db173bac
MB
758pack pack ck_fun mst@ S L
759split split ck_split t@ S S S
297b36dc 760join join or string ck_join mst@ S L
79072805
LW
761
762# List operators.
763
db173bac
MB
764list list ck_null m@ L
765lslice list slice ck_null 2 H L L
42d38218
MS
766anonlist anonymous list ([]) ck_fun ms@ L
767anonhash anonymous hash ({}) ck_fun ms@ L
79072805 768
db173bac 769splice splice ck_fun m@ A S? S? L
b162f9ea 770push push ck_fun imsT@ A L
26f600bc
RGS
771pop pop ck_shift s% A?
772shift shift ck_shift s% A?
b162f9ea 773unshift unshift ck_fun imsT@ A L
9850bf21 774sort sort ck_sort dm@ C? L
db173bac 775reverse reverse ck_fun mt@ L
79072805 776
f1612b5c
GS
777grepstart grep ck_grep dm@ C L
778grepwhile grep iterator ck_null dt|
79072805 779
f1612b5c
GS
780mapstart map ck_grep dm@ C L
781mapwhile map iterator ck_null dt|
a0d0e21e 782
79072805
LW
783# Range stuff.
784
1a67a97c 785range flipflop ck_null | S S
db173bac
MB
786flip range (or flip) ck_null 1 S S
787flop range (or flop) ck_null 1
79072805
LW
788
789# Control.
790
42d38218 791and logical and (&&) ck_null |
f1612b5c
GS
792or logical or (||) ck_null |
793xor logical xor ck_null fs2 S S
fdecdb95 794dor defined or (//) ck_null |
f1612b5c 795cond_expr conditional expression ck_null d|
42d38218
MS
796andassign logical and assignment (&&=) ck_null s|
797orassign logical or assignment (||=) ck_null s|
fdecdb95 798dorassign defined or assignment (//=) ck_null s|
db173bac 799
f5d5a27c 800method method lookup ck_method d1
db173bac
MB
801entersub subroutine entry ck_subr dmt1 L
802leavesub subroutine exit ck_null 1
78f9721b 803leavesublv lvalue subroutine return ck_null 1
db173bac
MB
804caller caller ck_fun t% S?
805warn warn ck_fun imst@ L
96e176bf 806die die ck_die dimst@ L
f1612b5c 807reset symbol reset ck_fun is% S?
db173bac
MB
808
809lineseq line sequence ck_null @
722969e2
DM
810nextstate next statement ck_null s;
811dbstate debug next statement ck_null s;
e9c54c90 812unstack iteration finalizer ck_null s0
79072805 813enter block entry ck_null 0
db173bac
MB
814leave block exit ck_null @
815scope block ck_null @
816enteriter foreach loop entry ck_null d{
79072805 817iter foreach loop iterator ck_null 0
db173bac
MB
818enterloop loop entry ck_null d{
819leaveloop loop exit ck_null 2
78f9721b 820return return ck_return dm@ L
db173bac
MB
821last last ck_null ds}
822next next ck_null ds}
823redo redo ck_null ds}
824dump dump ck_null ds}
825goto goto ck_null ds}
d98f61e7 826exit exit ck_exit ds% S?
fdecdb95
NC
827setstate set statement info ck_null s;
828method_named method with known name ck_null d$
829
830entergiven given() ck_null d|
831leavegiven leave given block ck_null 1
832enterwhen when() ck_null d|
833leavewhen leave when block ck_null 1
834break break ck_null 0
835continue continue ck_null 0
79072805 836
79072805
LW
837# I/O.
838
a567e93b 839open open ck_open ismt@ F S? L
db173bac
MB
840close close ck_fun is% F?
841pipe_op pipe ck_fun is@ F F
79072805 842
db173bac 843fileno fileno ck_fun ist% F
a86a20aa 844umask umask ck_fun ist% S?
1c1fc3ea 845binmode binmode ck_fun s@ F S?
79072805 846
db173bac
MB
847tie tie ck_fun idms@ R S L
848untie untie ck_fun is% R
849tied tied ck_fun s% R
850dbmopen dbmopen ck_fun is@ H S S
851dbmclose dbmclose ck_fun is% H
79072805 852
db173bac
MB
853sselect select system call ck_select t@ S S S S
854select select ck_select st@ F?
79072805 855
db173bac 856getc getc ck_eof st% F?
d1a002d4 857read read ck_fun imst@ F R S S?
db173bac
MB
858enterwrite write ck_fun dis% F?
859leavewrite write exit ck_null 1
79072805 860
db173bac
MB
861prtf printf ck_listiob ims@ F? L
862print print ck_listiob ims@ F? L
fdecdb95 863say say ck_listiob ims@ F? L
79072805 864
db173bac
MB
865sysopen sysopen ck_fun s@ F S S S?
866sysseek sysseek ck_fun s@ F S S
d1a002d4 867sysread sysread ck_fun imst@ F R S S?
145d37e2 868syswrite syswrite ck_fun imst@ F S S? S?
79072805 869
a85d93d9
JH
870send send ck_fun imst@ Fs S S S?
871recv recv ck_fun imst@ Fs R S S
79072805 872
db173bac
MB
873eof eof ck_eof is% F?
874tell tell ck_fun st% F?
875seek seek ck_fun s@ F S S
9b01e405 876# truncate really behaves as if it had both "S S" and "F S"
db173bac 877truncate truncate ck_trunc is@ S S
79072805 878
db173bac
MB
879fcntl fcntl ck_fun st@ F S S
880ioctl ioctl ck_fun st@ F S S
b162f9ea 881flock flock ck_fun isT@ F S
79072805
LW
882
883# Sockets.
884
a85d93d9
JH
885socket socket ck_fun is@ Fs S S S
886sockpair socketpair ck_fun is@ Fs Fs S S S
79072805 887
a85d93d9
JH
888bind bind ck_fun is@ Fs S
889connect connect ck_fun is@ Fs S
890listen listen ck_fun is@ Fs S
891accept accept ck_fun ist@ Fs Fs
892shutdown shutdown ck_fun ist@ Fs S
79072805 893
a85d93d9
JH
894gsockopt getsockopt ck_fun is@ Fs S S
895ssockopt setsockopt ck_fun is@ Fs S S S
79072805 896
a85d93d9
JH
897getsockname getsockname ck_fun is% Fs
898getpeername getpeername ck_fun is% Fs
79072805
LW
899
900# Stat calls.
901
db173bac
MB
902lstat lstat ck_ftst u- F
903stat stat ck_ftst u- F
a85d93d9
JH
904ftrread -R ck_ftst isu- F-
905ftrwrite -W ck_ftst isu- F-
906ftrexec -X ck_ftst isu- F-
907fteread -r ck_ftst isu- F-
908ftewrite -w ck_ftst isu- F-
909fteexec -x ck_ftst isu- F-
910ftis -e ck_ftst isu- F-
a85d93d9
JH
911ftsize -s ck_ftst istu- F-
912ftmtime -M ck_ftst stu- F-
913ftatime -A ck_ftst stu- F-
914ftctime -C ck_ftst stu- F-
7834bb7e
NC
915ftrowned -O ck_ftst isu- F-
916fteowned -o ck_ftst isu- F-
917ftzero -z ck_ftst isu- F-
a85d93d9
JH
918ftsock -S ck_ftst isu- F-
919ftchr -c ck_ftst isu- F-
920ftblk -b ck_ftst isu- F-
921ftfile -f ck_ftst isu- F-
922ftdir -d ck_ftst isu- F-
923ftpipe -p ck_ftst isu- F-
a85d93d9
JH
924ftsuid -u ck_ftst isu- F-
925ftsgid -g ck_ftst isu- F-
926ftsvtx -k ck_ftst isu- F-
7834bb7e 927ftlink -l ck_ftst isu- F-
a85d93d9
JH
928fttty -t ck_ftst is- F-
929fttext -T ck_ftst isu- F-
930ftbinary -B ck_ftst isu- F-
79072805
LW
931
932# File calls.
933
d4ac975e
GA
934# chdir really behaves as if it had both "S?" and "F?"
935chdir chdir ck_chdir isT% S?
b162f9ea
IZ
936chown chown ck_fun imsT@ L
937chroot chroot ck_fun isTu% S?
938unlink unlink ck_fun imsTu@ L
a86a20aa 939chmod chmod ck_fun imsT@ L
b162f9ea
IZ
940utime utime ck_fun imsT@ L
941rename rename ck_fun isT@ S S
942link link ck_fun isT@ S S
943symlink symlink ck_fun isT@ S S
db173bac 944readlink readlink ck_fun stu% S?
491873e5 945mkdir mkdir ck_fun isTu@ S? S?
b162f9ea 946rmdir rmdir ck_fun isTu% S?
79072805
LW
947
948# Directory calls.
949
1e2c6ed7 950open_dir opendir ck_fun is@ F S
db173bac
MB
951readdir readdir ck_fun % F
952telldir telldir ck_fun st% F
953seekdir seekdir ck_fun s@ F S
954rewinddir rewinddir ck_fun s% F
955closedir closedir ck_fun is% F
79072805
LW
956
957# Process control.
958
db173bac 959fork fork ck_null ist0
b162f9ea
IZ
960wait wait ck_null isT0
961waitpid waitpid ck_fun isT@ S S
962system system ck_exec imsT@ S? L
963exec exec ck_exec dimsT@ S? L
964kill kill ck_fun dimsT@ L
965getppid getppid ck_null isT0
966getpgrp getpgrp ck_fun isT% S?
967setpgrp setpgrp ck_fun isT@ S? S?
968getpriority getpriority ck_fun isT@ S S
969setpriority setpriority ck_fun isT@ S S S
79072805
LW
970
971# Time calls.
972
cd39f2b6
JH
973# NOTE: MacOS patches the 'i' of time() away later when the interpreter
974# is created because in MacOS time() is already returning times > 2**31-1,
975# that is, non-integers.
976
b162f9ea 977time time ck_null isT0
79072805 978tms times ck_null 0
db173bac
MB
979localtime localtime ck_fun t% S?
980gmtime gmtime ck_fun t% S?
981alarm alarm ck_fun istu% S?
b162f9ea 982sleep sleep ck_fun isT% S?
79072805
LW
983
984# Shared memory.
985
db173bac
MB
986shmget shmget ck_fun imst@ S S S
987shmctl shmctl ck_fun imst@ S S S
988shmread shmread ck_fun imst@ S S S S
989shmwrite shmwrite ck_fun imst@ S S S S
79072805
LW
990
991# Message passing.
992
db173bac
MB
993msgget msgget ck_fun imst@ S S
994msgctl msgctl ck_fun imst@ S S S
995msgsnd msgsnd ck_fun imst@ S S S
996msgrcv msgrcv ck_fun imst@ S S S S S
79072805
LW
997
998# Semaphores.
999
7834bb7e 1000semop semop ck_fun imst@ S S
db173bac
MB
1001semget semget ck_fun imst@ S S S
1002semctl semctl ck_fun imst@ S S S S
79072805
LW
1003
1004# Eval.
1005
db173bac 1006require require ck_require du% S?
b3f4d674
GS
1007dofile do "file" ck_fun d1 S
1008entereval eval "string" ck_eval d% S
1009leaveeval eval "string" exit ck_null 1 S
db173bac 1010#evalonce eval constant string ck_null d1 S
42d38218 1011entertry eval {block} ck_null |
f1612b5c 1012leavetry eval {block} exit ck_null @
79072805
LW
1013
1014# Get system info.
1015
db173bac
MB
1016ghbyname gethostbyname ck_fun % S
1017ghbyaddr gethostbyaddr ck_fun @ S S
79072805 1018ghostent gethostent ck_null 0
db173bac
MB
1019gnbyname getnetbyname ck_fun % S
1020gnbyaddr getnetbyaddr ck_fun @ S S
79072805 1021gnetent getnetent ck_null 0
db173bac
MB
1022gpbyname getprotobyname ck_fun % S
1023gpbynumber getprotobynumber ck_fun @ S
79072805 1024gprotoent getprotoent ck_null 0
db173bac
MB
1025gsbyname getservbyname ck_fun @ S S
1026gsbyport getservbyport ck_fun @ S S
79072805 1027gservent getservent ck_null 0
db173bac
MB
1028shostent sethostent ck_fun is% S
1029snetent setnetent ck_fun is% S
1030sprotoent setprotoent ck_fun is% S
1031sservent setservent ck_fun is% S
1032ehostent endhostent ck_null is0
1033enetent endnetent ck_null is0
1034eprotoent endprotoent ck_null is0
1035eservent endservent ck_null is0
1036gpwnam getpwnam ck_fun % S
1037gpwuid getpwuid ck_fun % S
79072805 1038gpwent getpwent ck_null 0
db173bac
MB
1039spwent setpwent ck_null is0
1040epwent endpwent ck_null is0
1041ggrnam getgrnam ck_fun % S
1042ggrgid getgrgid ck_fun % S
79072805 1043ggrent getgrent ck_null 0
db173bac
MB
1044sgrent setgrent ck_null is0
1045egrent endgrent ck_null is0
1046getlogin getlogin ck_null st0
79072805
LW
1047
1048# Miscellaneous.
1049
db173bac 1050syscall syscall ck_fun imst@ S L
c0329465
MB
1051
1052# For multi-threading
5a47f09b 1053lock lock ck_rfun s% R
7399586d 1054
c5917253
NC
1055# For state support
1056
1057once once ck_null |
1058
53e06cf0 1059custom unknown custom operator ck_null 0