This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
complement can have OPpTARGET_MY
[perl5.git] / regen / opcodes
CommitLineData
f8a58b02
NC
1# New ops always go at the end
2# The restriction on having custom as the last op has been removed
3
4# A recapitulation of the format of this file:
5# The file consists of five columns: the name of the op, an English
6# description, the name of the "check" routine used to optimize this
7# operation, some flags, and a description of the operands.
8
9# The flags consist of options followed by a mandatory op class signifier
10
11# The classes are:
12# baseop - 0 unop - 1 binop - 2
13# logop - | listop - @ pmop - /
14# padop/svop - $ padop - # (unused) loop - {
15# baseop/unop - % loopexop - } filestatop - -
b46e009d 16# pvop/svop - " cop - ; methop - .
2f7c6295 17# unop_aux - +
f8a58b02
NC
18
19# Other options are:
738ec380
DM
20# needs stack mark - m (OA_MARK)
21# needs constant folding - f (OA_FOLDCONST)
22# produces a scalar - s (OA_RETSCALAR)
23# produces an integer - i (unused)
24# needs a target - t (OA_TARGET)
25# target can be in a pad - T (OA_TARGET|OA_TARGLEX)
26# has a corresponding integer version - I (OA_OTHERINT)
e791f90a 27# make temp copy in list assignment - d (OA_DANGEROUS)
738ec380 28# uses $_ if no argument given - u (OA_DEFGV)
f8a58b02
NC
29
30# Values for the operands are:
31# scalar - S list - L array - A
32# hash - H sub (CV) - C file - F
33# socket - Fs filetest - F- filetest_access - F-+
332c2eac 34# num-compare - S< dirhandle - DF
f8a58b02
NC
35
36# reference - R
37# "?" denotes an optional operand.
38
39# Nothing.
40
41null null operation ck_null 0
42stub stub ck_null 0
43scalar scalar ck_fun s% S
44
45# Pushy stuff.
46
47pushmark pushmark ck_null s0
48wantarray wantarray ck_null is0
49
50const constant item ck_svconst s$
51
52gvsv scalar variable ck_null ds$
53gv glob value ck_null ds$
6e372f32 54gelem glob elem ck_null ds2 S S
f8a58b02
NC
55padsv private variable ck_null ds0
56padav private array ck_null d0
57padhv private hash ck_null d0
58padany private value ck_null d0
59
60pushre push regexp ck_null d/
61
62# References and stuff.
63
64rv2gv ref-to-glob cast ck_rvconst ds1
65rv2sv scalar dereference ck_rvconst ds1
66av2arylen array length ck_null is1
67rv2cv subroutine dereference ck_rvconst d1
01762542 68anoncode anonymous subroutine ck_anoncode s$
eb4ec35b 69prototype subroutine prototype ck_prototype su% S?
f8a58b02
NC
70refgen reference constructor ck_spair m1 L
71srefgen single ref constructor ck_null fs1 S
72ref reference-type operator ck_fun stu% S?
73bless bless ck_fun s@ S S?
74
75# Pushy I/O.
76
9ce1fb7d 77backtick quoted execution (``, qx) ck_backtick tu% S?
f8a58b02
NC
78# glob defaults its first arg to $_
79glob glob ck_glob t@ S?
80readline <HANDLE> ck_readline t% F?
81rcatline append I/O operator ck_null t$
82
83# Bindable operators.
84
85regcmaybe regexp internal guard ck_fun s1 S
86regcreset regexp internal reset ck_fun s1 S
87regcomp regexp compilation ck_null s| S
9d99d451 88match pattern match (m//) ck_match /
f8a58b02 89qr pattern quote (qr//) ck_match s/
7f581e76
FC
90subst substitution (s///) ck_match is/ S
91substcont substitution iterator ck_null is|
f8a58b02 92trans transliteration (tr///) ck_match is" S
bfa14884
NC
93# y///r
94transr transliteration (tr///) ck_match is" S
f8a58b02
NC
95
96# Lvalue operators.
97# sassign is special-cased for op class
98
99sassign scalar assignment ck_sassign s0
100aassign list assignment ck_null t2 L L
101
102chop chop ck_spair mts% L
103schop scalar chop ck_null stu% S?
104chomp chomp ck_spair mTs% L
105schomp scalar chomp ck_null sTu% S?
106defined defined operator ck_defined isu% S?
89c5c07e 107undef undef operator ck_fun s% R?
f8a58b02 108study study ck_fun su% S?
abe56f58 109pos match position ck_fun stu% R?
f8a58b02
NC
110
111preinc preincrement (++) ck_lfun dIs1 S
112i_preinc integer preincrement (++) ck_lfun dis1 S
113predec predecrement (--) ck_lfun dIs1 S
114i_predec integer predecrement (--) ck_lfun dis1 S
3baa0581
FC
115postinc postincrement (++) ck_lfun Ist1 S
116i_postinc integer postincrement (++) ck_lfun ist1 S
117postdec postdecrement (--) ck_lfun Ist1 S
118i_postdec integer postdecrement (--) ck_lfun ist1 S
f8a58b02
NC
119
120# Ordinary operators.
121
122pow exponentiation (**) ck_null fsT2 S S
123
124multiply multiplication (*) ck_null IfsT2 S S
125i_multiply integer multiplication (*) ck_null ifsT2 S S
126divide division (/) ck_null IfsT2 S S
127i_divide integer division (/) ck_null ifsT2 S S
128modulo modulus (%) ck_null IifsT2 S S
129i_modulo integer modulus (%) ck_null ifsT2 S S
6abbd373 130repeat repeat (x) ck_repeat fmT2 L S
f8a58b02
NC
131
132add addition (+) ck_null IfsT2 S S
133i_add integer addition (+) ck_null ifsT2 S S
134subtract subtraction (-) ck_null IfsT2 S S
135i_subtract integer subtraction (-) ck_null ifsT2 S S
136concat concatenation (.) or string ck_concat fsT2 S S
73f4c4fe 137stringify string ck_stringify fsT@ S
f8a58b02
NC
138
139left_shift left bitshift (<<) ck_bitop fsT2 S S
140right_shift right bitshift (>>) ck_bitop fsT2 S S
141
89474f50
FC
142lt numeric lt (<) ck_cmp Iifs2 S S<
143i_lt integer lt (<) ck_cmp ifs2 S S<
144gt numeric gt (>) ck_cmp Iifs2 S S<
145i_gt integer gt (>) ck_cmp ifs2 S S<
146le numeric le (<=) ck_cmp Iifs2 S S<
147i_le integer le (<=) ck_cmp ifs2 S S<
148ge numeric ge (>=) ck_cmp Iifs2 S S<
149i_ge integer ge (>=) ck_cmp ifs2 S S<
2b420b63
JC
150eq numeric eq (==) ck_null Iifs2 S S<
151i_eq integer eq (==) ck_null ifs2 S S<
152ne numeric ne (!=) ck_null Iifs2 S S<
153i_ne integer ne (!=) ck_null ifs2 S S<
154ncmp numeric comparison (<=>) ck_null Iifst2 S S<
d1455c67 155i_ncmp integer comparison (<=>) ck_null ifsT2 S S<
f8a58b02
NC
156
157slt string lt ck_null ifs2 S S
158sgt string gt ck_null ifs2 S S
159sle string le ck_null ifs2 S S
160sge string ge ck_null ifs2 S S
161seq string eq ck_null ifs2 S S
162sne string ne ck_null ifs2 S S
d1455c67 163scmp string comparison (cmp) ck_null ifsT2 S S
f8a58b02
NC
164
165bit_and bitwise and (&) ck_bitop fst2 S S
166bit_xor bitwise xor (^) ck_bitop fst2 S S
167bit_or bitwise or (|) ck_bitop fst2 S S
168
169negate negation (-) ck_null Ifst1 S
a9dec3fe 170i_negate integer negation (-) ck_null ifst1 S
f8a58b02 171not not ck_null ifs1 S
33de0f79 172complement 1's complement (~) ck_bitop fsT1 S
f8a58b02
NC
173
174smartmatch smart match ck_smartmatch s2
175
176# High falutin' math.
177
178atan2 atan2 ck_fun fsT@ S S
179sin sin ck_fun fsTu% S?
180cos cos ck_fun fsTu% S?
181rand rand ck_fun sT% S?
182srand srand ck_fun sT% S?
183exp exp ck_fun fsTu% S?
184log log ck_fun fsTu% S?
185sqrt sqrt ck_fun fsTu% S?
186
187# Lowbrow math.
188
189int int ck_fun fsTu% S?
190hex hex ck_fun fsTu% S?
191oct oct ck_fun fsTu% S?
192abs abs ck_fun fsTu% S?
193
194# String stuff.
195
e508c8a4 196length length ck_length ifsTu% S?
f8a58b02 197substr substr ck_substr st@ S S S? S?
db098081 198vec vec ck_fun isT@ S S S
f8a58b02
NC
199
200index index ck_index isT@ S S S?
201rindex rindex ck_index isT@ S S S?
202
69974ce6 203sprintf sprintf ck_lfun fmst@ S L
f8a58b02
NC
204formline formline ck_fun ms@ S L
205ord ord ck_fun ifsTu% S?
206chr chr ck_fun fsTu% S?
207crypt crypt ck_fun fsT@ S S
208ucfirst ucfirst ck_fun fstu% S?
209lcfirst lcfirst ck_fun fstu% S?
210uc uc ck_fun fstu% S?
211lc lc ck_fun fstu% S?
212quotemeta quotemeta ck_fun fstu% S?
213
214# Arrays.
215
216rv2av array dereference ck_rvconst dt1
689d8423 217aelemfast constant array element ck_null ds$ A S
bfa14884 218aelemfast_lex constant lexical array element ck_null d0 A S
f8a58b02
NC
219aelem array element ck_null s2 A S
220aslice array slice ck_null m@ A L
6dd3e0f2 221kvaslice index/value array slice ck_null m@ A L
f8a58b02 222
d86b3122 223aeach each on array ck_each d% A
f8a58b02 224akeys keys on array ck_each t% A
d86b3122 225avalues values on array ck_each dt% A
f8a58b02
NC
226
227# Hashes.
228
d86b3122
FC
229each each ck_each d% H
230values values ck_each dt% H
f8a58b02
NC
231keys keys ck_each t% H
232delete delete ck_delete % S
233exists exists ck_exists is% S
1a8bdda9 234rv2hv hash dereference ck_rvconst d1
f8a58b02
NC
235helem hash element ck_null s2 H S
236hslice hash slice ck_null m@ H L
5cae3edb 237kvhslice key/value hash slice ck_null m@ H L
f8a58b02 238
fedf30e1
DM
239# mixed array and hash access
240
241multideref array or hash lookup ck_null ds+
242
f8a58b02
NC
243# Explosives and implosives.
244
ea5703f4 245unpack unpack ck_fun u@ S S?
dd9a6ccf 246pack pack ck_fun fmst@ S L
d8cdf573 247split split ck_split T@ S S S
987c9691 248join join or string ck_join fmst@ S L
f8a58b02
NC
249
250# List operators.
251
252list list ck_null m@ L
253lslice list slice ck_null 2 H L L
26321c2d 254anonlist anonymous array ([]) ck_fun ms@ L
f8a58b02
NC
255anonhash anonymous hash ({}) ck_fun ms@ L
256
d4fc4415
FC
257splice splice ck_fun m@ A S? S? L
258push push ck_fun imsT@ A L
f8a58b02
NC
259pop pop ck_shift s% A?
260shift shift ck_shift s% A?
d4fc4415 261unshift unshift ck_fun imsT@ A L
61aeaf96 262sort sort ck_sort m@ C? L
f8a58b02
NC
263reverse reverse ck_fun mt@ L
264
f39944c1
FC
265grepstart grep ck_grep m@ C L
266grepwhile grep iterator ck_null t|
f8a58b02 267
f39944c1
FC
268mapstart map ck_grep m@ C L
269mapwhile map iterator ck_null t|
f8a58b02
NC
270
271# Range stuff.
272
273range flipflop ck_null | S S
274flip range (or flip) ck_null 1 S S
275flop range (or flop) ck_null 1
276
277# Control.
278
279and logical and (&&) ck_null |
280or logical or (||) ck_null |
281xor logical xor ck_null fs2 S S
282dor defined or (//) ck_null |
aafd37e7 283cond_expr conditional expression ck_null |
f8a58b02
NC
284andassign logical and assignment (&&=) ck_null s|
285orassign logical or assignment (||=) ck_null s|
286dorassign defined or assignment (//=) ck_null s|
287
b46e009d 288method method lookup ck_method d.
57ee255e 289entersub subroutine entry ck_subr dm1 L
f8a58b02
NC
290leavesub subroutine exit ck_null 1
291leavesublv lvalue subroutine return ck_null 1
292caller caller ck_fun t% S?
293warn warn ck_fun imst@ L
2eb51413 294die die ck_fun imst@ L
f8a58b02
NC
295reset symbol reset ck_fun is% S?
296
297lineseq line sequence ck_null @
298nextstate next statement ck_null s;
299dbstate debug next statement ck_null s;
300unstack iteration finalizer ck_null s0
301enter block entry ck_null 0
302leave block exit ck_null @
303scope block ck_null @
304enteriter foreach loop entry ck_null d{
305iter foreach loop iterator ck_null 0
306enterloop loop entry ck_null d{
307leaveloop loop exit ck_null 2
b31e13ff
FC
308return return ck_return m@ L
309last last ck_null s}
310next next ck_null s}
311redo redo ck_null s}
f8a58b02 312dump dump ck_null ds}
b31e13ff 313goto goto ck_null s}
26812b4a 314exit exit ck_fun s% S?
b46e009d 315method_named method with known name ck_null d.
7d6c333c 316method_super super with known name ck_null d.
810bd8b7 317method_redir redirect method with known name ck_null d.
318method_redir_super redirect super method with known name ck_null d.
f8a58b02
NC
319
320entergiven given() ck_null d|
321leavegiven leave given block ck_null 1
322enterwhen when() ck_null d|
323leavewhen leave when block ck_null 1
324break break ck_null 0
325continue continue ck_null 0
326
327# I/O.
328
329open open ck_open ismt@ F S? L
330close close ck_fun is% F?
331pipe_op pipe ck_fun is@ F F
332
333fileno fileno ck_fun ist% F
334umask umask ck_fun ist% S?
335binmode binmode ck_fun s@ F S?
336
337tie tie ck_fun idms@ R S L
338untie untie ck_fun is% R
6575cde0 339tied tied ck_fun ds% R
f8a58b02
NC
340dbmopen dbmopen ck_fun is@ H S S
341dbmclose dbmclose ck_fun is% H
342
343sselect select system call ck_select t@ S S S S
344select select ck_select st@ F?
345
346getc getc ck_eof st% F?
347read read ck_fun imst@ F R S S?
fc5ae97d 348enterwrite write ck_fun is% F?
f8a58b02
NC
349leavewrite write exit ck_null 1
350
351prtf printf ck_listiob ims@ F? L
352print print ck_listiob ims@ F? L
353say say ck_listiob ims@ F? L
354
355sysopen sysopen ck_fun s@ F S S S?
356sysseek sysseek ck_fun s@ F S S
357sysread sysread ck_fun imst@ F R S S?
358syswrite syswrite ck_fun imst@ F S S? S?
359
360eof eof ck_eof is% F?
8dc99089 361tell tell ck_tell st% F?
423e8af5 362seek seek ck_tell s@ F S S
f8a58b02
NC
363# truncate really behaves as if it had both "S S" and "F S"
364truncate truncate ck_trunc is@ S S
365
366fcntl fcntl ck_fun st@ F S S
367ioctl ioctl ck_fun st@ F S S
368flock flock ck_fun isT@ F S
369
370# Sockets. OP_IS_SOCKET wants them consecutive (so moved 1st 2)
371
372send send ck_fun imst@ Fs S S S?
373recv recv ck_fun imst@ Fs R S S
374
375socket socket ck_fun is@ Fs S S S
376sockpair socketpair ck_fun is@ Fs Fs S S S
377
378bind bind ck_fun is@ Fs S
379connect connect ck_fun is@ Fs S
380listen listen ck_fun is@ Fs S
381accept accept ck_fun ist@ Fs Fs
382shutdown shutdown ck_fun ist@ Fs S
383
384gsockopt getsockopt ck_fun is@ Fs S S
385ssockopt setsockopt ck_fun is@ Fs S S S
386
387getsockname getsockname ck_fun is% Fs
388getpeername getpeername ck_fun is% Fs
389
390# Stat calls. OP_IS_FILETEST wants them consecutive.
391
465bc0f5
FC
392lstat lstat ck_ftst u- F?
393stat stat ck_ftst u- F?
f8a58b02
NC
394ftrread -R ck_ftst isu- F-+
395ftrwrite -W ck_ftst isu- F-+
396ftrexec -X ck_ftst isu- F-+
397fteread -r ck_ftst isu- F-+
398ftewrite -w ck_ftst isu- F-+
399fteexec -x ck_ftst isu- F-+
400ftis -e ck_ftst isu- F-
401ftsize -s ck_ftst istu- F-
402ftmtime -M ck_ftst stu- F-
403ftatime -A ck_ftst stu- F-
404ftctime -C ck_ftst stu- F-
405ftrowned -O ck_ftst isu- F-
406fteowned -o ck_ftst isu- F-
407ftzero -z ck_ftst isu- F-
408ftsock -S ck_ftst isu- F-
409ftchr -c ck_ftst isu- F-
410ftblk -b ck_ftst isu- F-
411ftfile -f ck_ftst isu- F-
412ftdir -d ck_ftst isu- F-
413ftpipe -p ck_ftst isu- F-
414ftsuid -u ck_ftst isu- F-
415ftsgid -g ck_ftst isu- F-
416ftsvtx -k ck_ftst isu- F-
417ftlink -l ck_ftst isu- F-
418fttty -t ck_ftst is- F-
419fttext -T ck_ftst isu- F-
420ftbinary -B ck_ftst isu- F-
421
422# File calls.
423
424# chdir really behaves as if it had both "S?" and "F?"
8777c9be 425chdir chdir ck_trunc isT% S?
f8a58b02
NC
426chown chown ck_fun imsT@ L
427chroot chroot ck_fun isTu% S?
428unlink unlink ck_fun imsTu@ L
429chmod chmod ck_fun imsT@ L
430utime utime ck_fun imsT@ L
431rename rename ck_fun isT@ S S
432link link ck_fun isT@ S S
433symlink symlink ck_fun isT@ S S
434readlink readlink ck_fun stu% S?
435mkdir mkdir ck_fun isTu@ S? S?
436rmdir rmdir ck_fun isTu% S?
437
438# Directory calls.
439
440open_dir opendir ck_fun is@ F S
332c2eac
JC
441readdir readdir ck_fun % DF
442telldir telldir ck_fun st% DF
443seekdir seekdir ck_fun s@ DF S
444rewinddir rewinddir ck_fun s% DF
445closedir closedir ck_fun is% DF
f8a58b02
NC
446
447# Process control.
448
449fork fork ck_null ist0
450wait wait ck_null isT0
451waitpid waitpid ck_fun isT@ S S
452system system ck_exec imsT@ S? L
1062548a 453exec exec ck_exec imsT@ S? L
9618b155 454kill kill ck_fun imsT@ L
f8a58b02
NC
455getppid getppid ck_null isT0
456getpgrp getpgrp ck_fun isT% S?
457setpgrp setpgrp ck_fun isT@ S? S?
458getpriority getpriority ck_fun isT@ S S
459setpriority setpriority ck_fun isT@ S S S
460
461# Time calls.
462
f8a58b02
NC
463time time ck_null isT0
464tms times ck_null 0
465localtime localtime ck_fun t% S?
466gmtime gmtime ck_fun t% S?
467alarm alarm ck_fun istu% S?
468sleep sleep ck_fun isT% S?
469
470# Shared memory.
471
472shmget shmget ck_fun imst@ S S S
473shmctl shmctl ck_fun imst@ S S S
474shmread shmread ck_fun imst@ S S S S
475shmwrite shmwrite ck_fun imst@ S S S S
476
477# Message passing.
478
479msgget msgget ck_fun imst@ S S
480msgctl msgctl ck_fun imst@ S S S
481msgsnd msgsnd ck_fun imst@ S S S
482msgrcv msgrcv ck_fun imst@ S S S S S
483
484# Semaphores.
485
486semop semop ck_fun imst@ S S
487semget semget ck_fun imst@ S S S
488semctl semctl ck_fun imst@ S S S S
489
490# Eval.
491
353d8d11 492require require ck_require dsu% S?
f8a58b02
NC
493dofile do "file" ck_fun d1 S
494hintseval eval hints ck_svconst s$
7d789282 495entereval eval "string" ck_eval du% S?
f8a58b02 496leaveeval eval "string" exit ck_null 1 S
f8a58b02
NC
497entertry eval {block} ck_eval d|
498leavetry eval {block} exit ck_null @
499
500# Get system info.
501
502ghbyname gethostbyname ck_fun % S
503ghbyaddr gethostbyaddr ck_fun @ S S
504ghostent gethostent ck_null 0
505gnbyname getnetbyname ck_fun % S
506gnbyaddr getnetbyaddr ck_fun @ S S
507gnetent getnetent ck_null 0
508gpbyname getprotobyname ck_fun % S
509gpbynumber getprotobynumber ck_fun @ S
510gprotoent getprotoent ck_null 0
511gsbyname getservbyname ck_fun @ S S
512gsbyport getservbyport ck_fun @ S S
513gservent getservent ck_null 0
514shostent sethostent ck_fun is% S
515snetent setnetent ck_fun is% S
516sprotoent setprotoent ck_fun is% S
517sservent setservent ck_fun is% S
518ehostent endhostent ck_null is0
519enetent endnetent ck_null is0
520eprotoent endprotoent ck_null is0
521eservent endservent ck_null is0
522gpwnam getpwnam ck_fun % S
523gpwuid getpwuid ck_fun % S
524gpwent getpwent ck_null 0
525spwent setpwent ck_null is0
526epwent endpwent ck_null is0
527ggrnam getgrnam ck_fun % S
528ggrgid getgrgid ck_fun % S
529ggrent getgrent ck_null 0
530sgrent setgrent ck_null is0
531egrent endgrent ck_null is0
532getlogin getlogin ck_null st0
533
534# Miscellaneous.
535
536syscall syscall ck_fun imst@ S L
537
538# For multi-threading
539lock lock ck_rfun s% R
540
541# For state support
542
543once once ck_null |
544
545custom unknown custom operator ck_null 0
546
547# For smart dereference for each/keys/values
d86b3122 548reach each on reference ck_each d% S
f8a58b02 549rkeys keys on reference ck_each t% S
d86b3122 550rvalues values on reference ck_each dt% S
deb8a388
FC
551
552# For CORE:: subs
553coreargs CORE:: subroutine ck_null $
84ed0108
FC
554
555runcv __SUB__ ck_null s0
838f2281
BF
556
557# fc and \F
558fc fc ck_fun fstu% S?
ac217057
FC
559
560padcv private subroutine ck_null d0
ecf9c8b7 561introcv private subroutine ck_null d0
13f89586 562clonecv private subroutine ck_null d0
a7fd8ef6 563padrange list of private variables ck_null d0
6e372f32 564refassign lvalue ref assignment ck_refassign ds2
4b6cf48b 565lvref lvalue ref assignment ck_null d%
16b99412 566lvrefslice lvalue ref assignment ck_null d@
2882b3ff 567lvavref lvalue array reference ck_null d%