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