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