bytecode.c 43.8 KB
Newer Older
Jim Blandy's avatar
Jim Blandy committed
1
/* Execution of byte code produced by bytecomp.el.
Paul Eggert's avatar
Paul Eggert committed
2
   Copyright (C) 1985-1988, 1993, 2000-2016 Free Software Foundation,
3
   Inc.
Jim Blandy's avatar
Jim Blandy committed
4 5 6

This file is part of GNU Emacs.

7
GNU Emacs is free software: you can redistribute it and/or modify
Jim Blandy's avatar
Jim Blandy committed
8
it under the terms of the GNU General Public License as published by
9 10
the Free Software Foundation, either version 3 of the License, or (at
your option) any later version.
Jim Blandy's avatar
Jim Blandy committed
11 12 13 14 15 16 17

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
18
along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.  */
Jim Blandy's avatar
Jim Blandy committed
19

20
/*
21
hacked on by jwz@lucid.com 17-jun-91
Jim Blandy's avatar
Jim Blandy committed
22 23
  o  added a compile-time switch to turn on simple sanity checking;
  o  put back the obsolete byte-codes for error-detection;
24
  o  added a new instruction, unbind_all, which I will use for
Jim Blandy's avatar
Jim Blandy committed
25
     tail-recursion elimination;
26
  o  made temp_output_buffer_show be called with the right number
Jim Blandy's avatar
Jim Blandy committed
27 28 29 30 31
     of args;
  o  made the new bytecodes be called with args in the right order;
  o  added metering support.

by Hallvard:
32
  o  added relative jump instructions;
Jim Blandy's avatar
Jim Blandy committed
33 34 35
  o  all conditionals now only do QUIT if they jump.
 */

36
#include <config.h>
37

Jim Blandy's avatar
Jim Blandy committed
38
#include "lisp.h"
Paul Eggert's avatar
Paul Eggert committed
39
#include "blockinput.h"
40
#include "character.h"
41
#include "buffer.h"
Paul Eggert's avatar
Paul Eggert committed
42
#include "keyboard.h"
Jim Blandy's avatar
Jim Blandy committed
43
#include "syntax.h"
Stefan Monnier's avatar
Stefan Monnier committed
44
#include "window.h"
Jim Blandy's avatar
Jim Blandy committed
45

46 47 48 49 50
#ifdef CHECK_FRAME_FONT
#include "frame.h"
#include "xterm.h"
#endif

51
/*
52
 * define BYTE_CODE_SAFE to enable some minor sanity checking (useful for
53 54
 * debugging the byte compiler...)
 *
55
 * define BYTE_CODE_METER to enable generation of a byte-op usage histogram.
Jim Blandy's avatar
Jim Blandy committed
56
 */
57 58
/* #define BYTE_CODE_SAFE */
/* #define BYTE_CODE_METER */
Jim Blandy's avatar
Jim Blandy committed
59

Tom Tromey's avatar
Tom Tromey committed
60 61 62 63
/* If BYTE_CODE_THREADED is defined, then the interpreter will be
   indirect threaded, using GCC's computed goto extension.  This code,
   as currently implemented, is incompatible with BYTE_CODE_SAFE and
   BYTE_CODE_METER.  */
Paul Eggert's avatar
Paul Eggert committed
64 65
#if (defined __GNUC__ && !defined __STRICT_ANSI__ \
     && !defined BYTE_CODE_SAFE && !defined BYTE_CODE_METER)
Tom Tromey's avatar
Tom Tromey committed
66 67 68
#define BYTE_CODE_THREADED
#endif

Jim Blandy's avatar
Jim Blandy committed
69 70 71

#ifdef BYTE_CODE_METER

72 73
#define METER_2(code1, code2) AREF (AREF (Vbyte_code_meter, code1), code2)
#define METER_1(code) METER_2 (0, code)
74

75 76 77 78
#define METER_CODE(last_code, this_code)				\
{									\
  if (byte_metering_on)							\
    {									\
79 80 81
      if (XFASTINT (METER_1 (this_code)) < MOST_POSITIVE_FIXNUM)	\
        XSETFASTINT (METER_1 (this_code),				\
		     XFASTINT (METER_1 (this_code)) + 1);		\
82
      if (last_code							\
83 84 85 86
	  && (XFASTINT (METER_2 (last_code, this_code))			\
	      < MOST_POSITIVE_FIXNUM))					\
        XSETFASTINT (METER_2 (last_code, this_code),			\
		     XFASTINT (METER_2 (last_code, this_code)) + 1);	\
87
    }									\
88
}
Jim Blandy's avatar
Jim Blandy committed
89

90
#endif /* BYTE_CODE_METER */
Jim Blandy's avatar
Jim Blandy committed
91 92 93 94


/*  Byte codes: */

Tom Tromey's avatar
Tom Tromey committed
95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144
#define BYTE_CODES							\
DEFINE (Bstack_ref, 0) /* Actually, Bstack_ref+0 is not implemented: use dup.  */ \
DEFINE (Bstack_ref1, 1)							\
DEFINE (Bstack_ref2, 2)							\
DEFINE (Bstack_ref3, 3)							\
DEFINE (Bstack_ref4, 4)							\
DEFINE (Bstack_ref5, 5)							\
DEFINE (Bstack_ref6, 6)							\
DEFINE (Bstack_ref7, 7)							\
DEFINE (Bvarref, 010)							\
DEFINE (Bvarref1, 011)							\
DEFINE (Bvarref2, 012)							\
DEFINE (Bvarref3, 013)							\
DEFINE (Bvarref4, 014)							\
DEFINE (Bvarref5, 015)							\
DEFINE (Bvarref6, 016)							\
DEFINE (Bvarref7, 017)							\
DEFINE (Bvarset, 020)							\
DEFINE (Bvarset1, 021)							\
DEFINE (Bvarset2, 022)							\
DEFINE (Bvarset3, 023)							\
DEFINE (Bvarset4, 024)							\
DEFINE (Bvarset5, 025)							\
DEFINE (Bvarset6, 026)							\
DEFINE (Bvarset7, 027)							\
DEFINE (Bvarbind, 030)							\
DEFINE (Bvarbind1, 031)							\
DEFINE (Bvarbind2, 032)							\
DEFINE (Bvarbind3, 033)							\
DEFINE (Bvarbind4, 034)							\
DEFINE (Bvarbind5, 035)							\
DEFINE (Bvarbind6, 036)							\
DEFINE (Bvarbind7, 037)							\
DEFINE (Bcall, 040)							\
DEFINE (Bcall1, 041)							\
DEFINE (Bcall2, 042)							\
DEFINE (Bcall3, 043)							\
DEFINE (Bcall4, 044)							\
DEFINE (Bcall5, 045)							\
DEFINE (Bcall6, 046)							\
DEFINE (Bcall7, 047)							\
DEFINE (Bunbind, 050)							\
DEFINE (Bunbind1, 051)							\
DEFINE (Bunbind2, 052)							\
DEFINE (Bunbind3, 053)							\
DEFINE (Bunbind4, 054)							\
DEFINE (Bunbind5, 055)							\
DEFINE (Bunbind6, 056)							\
DEFINE (Bunbind7, 057)							\
									\
145 146 147 148
DEFINE (Bpophandler, 060)						\
DEFINE (Bpushconditioncase, 061)					\
DEFINE (Bpushcatch, 062)						\
									\
Tom Tromey's avatar
Tom Tromey committed
149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291
DEFINE (Bnth, 070)							\
DEFINE (Bsymbolp, 071)							\
DEFINE (Bconsp, 072)							\
DEFINE (Bstringp, 073)							\
DEFINE (Blistp, 074)							\
DEFINE (Beq, 075)							\
DEFINE (Bmemq, 076)							\
DEFINE (Bnot, 077)							\
DEFINE (Bcar, 0100)							\
DEFINE (Bcdr, 0101)							\
DEFINE (Bcons, 0102)							\
DEFINE (Blist1, 0103)							\
DEFINE (Blist2, 0104)							\
DEFINE (Blist3, 0105)							\
DEFINE (Blist4, 0106)							\
DEFINE (Blength, 0107)							\
DEFINE (Baref, 0110)							\
DEFINE (Baset, 0111)							\
DEFINE (Bsymbol_value, 0112)						\
DEFINE (Bsymbol_function, 0113)						\
DEFINE (Bset, 0114)							\
DEFINE (Bfset, 0115)							\
DEFINE (Bget, 0116)							\
DEFINE (Bsubstring, 0117)						\
DEFINE (Bconcat2, 0120)							\
DEFINE (Bconcat3, 0121)							\
DEFINE (Bconcat4, 0122)							\
DEFINE (Bsub1, 0123)							\
DEFINE (Badd1, 0124)							\
DEFINE (Beqlsign, 0125)							\
DEFINE (Bgtr, 0126)							\
DEFINE (Blss, 0127)							\
DEFINE (Bleq, 0130)							\
DEFINE (Bgeq, 0131)							\
DEFINE (Bdiff, 0132)							\
DEFINE (Bnegate, 0133)							\
DEFINE (Bplus, 0134)							\
DEFINE (Bmax, 0135)							\
DEFINE (Bmin, 0136)							\
DEFINE (Bmult, 0137)							\
									\
DEFINE (Bpoint, 0140)							\
/* Was Bmark in v17.  */						\
DEFINE (Bsave_current_buffer, 0141) /* Obsolete.  */			\
DEFINE (Bgoto_char, 0142)						\
DEFINE (Binsert, 0143)							\
DEFINE (Bpoint_max, 0144)						\
DEFINE (Bpoint_min, 0145)						\
DEFINE (Bchar_after, 0146)						\
DEFINE (Bfollowing_char, 0147)						\
DEFINE (Bpreceding_char, 0150)						\
DEFINE (Bcurrent_column, 0151)						\
DEFINE (Bindent_to, 0152)						\
DEFINE (Beolp, 0154)							\
DEFINE (Beobp, 0155)							\
DEFINE (Bbolp, 0156)							\
DEFINE (Bbobp, 0157)							\
DEFINE (Bcurrent_buffer, 0160)						\
DEFINE (Bset_buffer, 0161)						\
DEFINE (Bsave_current_buffer_1, 0162) /* Replacing Bsave_current_buffer.  */ \
DEFINE (Binteractive_p, 0164) /* Obsolete since Emacs-24.1.  */		\
									\
DEFINE (Bforward_char, 0165)						\
DEFINE (Bforward_word, 0166)						\
DEFINE (Bskip_chars_forward, 0167)					\
DEFINE (Bskip_chars_backward, 0170)					\
DEFINE (Bforward_line, 0171)						\
DEFINE (Bchar_syntax, 0172)						\
DEFINE (Bbuffer_substring, 0173)					\
DEFINE (Bdelete_region, 0174)						\
DEFINE (Bnarrow_to_region, 0175)					\
DEFINE (Bwiden, 0176)							\
DEFINE (Bend_of_line, 0177)						\
									\
DEFINE (Bconstant2, 0201)						\
DEFINE (Bgoto, 0202)							\
DEFINE (Bgotoifnil, 0203)						\
DEFINE (Bgotoifnonnil, 0204)						\
DEFINE (Bgotoifnilelsepop, 0205)					\
DEFINE (Bgotoifnonnilelsepop, 0206)					\
DEFINE (Breturn, 0207)							\
DEFINE (Bdiscard, 0210)							\
DEFINE (Bdup, 0211)							\
									\
DEFINE (Bsave_excursion, 0212)						\
DEFINE (Bsave_window_excursion, 0213) /* Obsolete since Emacs-24.1.  */	\
DEFINE (Bsave_restriction, 0214)					\
DEFINE (Bcatch, 0215)							\
									\
DEFINE (Bunwind_protect, 0216)						\
DEFINE (Bcondition_case, 0217)						\
DEFINE (Btemp_output_buffer_setup, 0220) /* Obsolete since Emacs-24.1.  */ \
DEFINE (Btemp_output_buffer_show, 0221)  /* Obsolete since Emacs-24.1.  */ \
									\
DEFINE (Bunbind_all, 0222)	/* Obsolete.  Never used.  */		\
									\
DEFINE (Bset_marker, 0223)						\
DEFINE (Bmatch_beginning, 0224)						\
DEFINE (Bmatch_end, 0225)						\
DEFINE (Bupcase, 0226)							\
DEFINE (Bdowncase, 0227)						\
									\
DEFINE (Bstringeqlsign, 0230)						\
DEFINE (Bstringlss, 0231)						\
DEFINE (Bequal, 0232)							\
DEFINE (Bnthcdr, 0233)							\
DEFINE (Belt, 0234)							\
DEFINE (Bmember, 0235)							\
DEFINE (Bassq, 0236)							\
DEFINE (Bnreverse, 0237)						\
DEFINE (Bsetcar, 0240)							\
DEFINE (Bsetcdr, 0241)							\
DEFINE (Bcar_safe, 0242)						\
DEFINE (Bcdr_safe, 0243)						\
DEFINE (Bnconc, 0244)							\
DEFINE (Bquo, 0245)							\
DEFINE (Brem, 0246)							\
DEFINE (Bnumberp, 0247)							\
DEFINE (Bintegerp, 0250)						\
									\
DEFINE (BRgoto, 0252)							\
DEFINE (BRgotoifnil, 0253)						\
DEFINE (BRgotoifnonnil, 0254)						\
DEFINE (BRgotoifnilelsepop, 0255)					\
DEFINE (BRgotoifnonnilelsepop, 0256)					\
									\
DEFINE (BlistN, 0257)							\
DEFINE (BconcatN, 0260)							\
DEFINE (BinsertN, 0261)							\
									\
/* Bstack_ref is code 0.  */						\
DEFINE (Bstack_set,  0262)						\
DEFINE (Bstack_set2, 0263)						\
DEFINE (BdiscardN,   0266)						\
									\
DEFINE (Bconstant, 0300)

enum byte_code_op
{
#define DEFINE(name, value) name = value,
    BYTE_CODES
#undef DEFINE

292
#ifdef BYTE_CODE_SAFE
Tom Tromey's avatar
Tom Tromey committed
293
    Bscan_buffer = 0153, /* No longer generated as of v18.  */
Paul Eggert's avatar
Paul Eggert committed
294
    Bset_mark = 0163, /* this loser is no longer generated as of v18 */
295
#endif
Tom Tromey's avatar
Tom Tromey committed
296
};
Gerd Moellmann's avatar
Gerd Moellmann committed
297

298
/* Whether to maintain a `top' and `bottom' field in the stack frame.  */
299
#define BYTE_MAINTAIN_TOP BYTE_CODE_SAFE
300

Gerd Moellmann's avatar
Gerd Moellmann committed
301 302 303 304 305 306 307
/* Structure describing a value stack used during byte-code execution
   in Fbyte_code.  */

struct byte_stack
{
  /* Program counter.  This points into the byte_string below
     and is relocated when that string is relocated.  */
308
  const unsigned char *pc;
Gerd Moellmann's avatar
Gerd Moellmann committed
309 310 311

  /* Top and bottom of stack.  The bottom points to an area of memory
     allocated with alloca in Fbyte_code.  */
312
#if BYTE_MAINTAIN_TOP
Gerd Moellmann's avatar
Gerd Moellmann committed
313
  Lisp_Object *top, *bottom;
314
#endif
Gerd Moellmann's avatar
Gerd Moellmann committed
315 316 317 318 319

  /* The string containing the byte-code, and its current address.
     Storing this here protects it from GC because mark_byte_stack
     marks it.  */
  Lisp_Object byte_string;
320
  const unsigned char *byte_string_start;
Gerd Moellmann's avatar
Gerd Moellmann committed
321 322 323 324 325 326 327

  /* Next entry in byte_stack_list.  */
  struct byte_stack *next;
};

/* A list of currently active byte-code execution value stacks.
   Fbyte_code adds an entry to the head of this list before it starts
328
   processing byte-code, and it removes the entry again when it is
329
   done.  Signaling an error truncates the list.  */
Gerd Moellmann's avatar
Gerd Moellmann committed
330 331 332

struct byte_stack *byte_stack_list;

333

334 335
/* Relocate program counters in the stacks on byte_stack_list.  Called
   when GC has completed.  */
Gerd Moellmann's avatar
Gerd Moellmann committed
336

337
void
338
relocate_byte_stack (void)
Gerd Moellmann's avatar
Gerd Moellmann committed
339 340 341 342
{
  struct byte_stack *stack;

  for (stack = byte_stack_list; stack; stack = stack->next)
343
    {
344
      if (stack->byte_string_start != SDATA (stack->byte_string))
345
	{
346
	  ptrdiff_t offset = stack->pc - stack->byte_string_start;
347
	  stack->byte_string_start = SDATA (stack->byte_string);
348 349 350
	  stack->pc = stack->byte_string_start + offset;
	}
    }
Gerd Moellmann's avatar
Gerd Moellmann committed
351 352
}

Jim Blandy's avatar
Jim Blandy committed
353

354
/* Fetch the next byte from the bytecode stream.  */
Jim Blandy's avatar
Jim Blandy committed
355

356 357 358
#ifdef BYTE_CODE_SAFE
#define FETCH (eassert (stack.byte_string_start == SDATA (stack.byte_string)), *stack.pc++)
#else
Gerd Moellmann's avatar
Gerd Moellmann committed
359
#define FETCH *stack.pc++
360
#endif
Jim Blandy's avatar
Jim Blandy committed
361

362
/* Fetch two bytes from the bytecode stream and make a 16-bit number
363
   out of them.  */
Jim Blandy's avatar
Jim Blandy committed
364 365 366

#define FETCH2 (op = FETCH, op + (FETCH << 8))

367 368 369 370
/* Push x onto the execution stack.  This used to be #define PUSH(x)
   (*++stackp = (x)) This oddity is necessary because Alliant can't be
   bothered to compile the preincrement operator properly, as of 4/91.
   -JimB */
Gerd Moellmann's avatar
Gerd Moellmann committed
371 372

#define PUSH(x) (top++, *top = (x))
Jim Blandy's avatar
Jim Blandy committed
373 374 375

/* Pop a value off the execution stack.  */

Gerd Moellmann's avatar
Gerd Moellmann committed
376
#define POP (*top--)
Jim Blandy's avatar
Jim Blandy committed
377 378 379

/* Discard n values from the execution stack.  */

Gerd Moellmann's avatar
Gerd Moellmann committed
380 381 382
#define DISCARD(n) (top -= (n))

/* Get the value which is at the top of the execution stack, but don't
383
   pop it.  */
Gerd Moellmann's avatar
Gerd Moellmann committed
384 385

#define TOP (*top)
Jim Blandy's avatar
Jim Blandy committed
386

387
/* Actions that must be performed before and after calling a function
Gerd Moellmann's avatar
Gerd Moellmann committed
388
   that might GC.  */
Jim Blandy's avatar
Jim Blandy committed
389

390 391 392 393
#if !BYTE_MAINTAIN_TOP
#define BEFORE_POTENTIAL_GC()	((void)0)
#define AFTER_POTENTIAL_GC()	((void)0)
#else
Gerd Moellmann's avatar
Gerd Moellmann committed
394 395
#define BEFORE_POTENTIAL_GC()	stack.top = top
#define AFTER_POTENTIAL_GC()	stack.top = NULL
396
#endif
Jim Blandy's avatar
Jim Blandy committed
397

Richard M. Stallman's avatar
Richard M. Stallman committed
398 399 400
/* Garbage collect if we have consed enough since the last time.
   We do this at every branch, to avoid loops that never GC.  */

401 402 403 404 405
#define MAYBE_GC()		\
  do {				\
   BEFORE_POTENTIAL_GC ();	\
   maybe_gc ();			\
   AFTER_POTENTIAL_GC ();	\
406
 } while (0)
407

408
/* Check for jumping out of range.  */
Gerd Moellmann's avatar
Gerd Moellmann committed
409 410 411

#ifdef BYTE_CODE_SAFE

412
#define CHECK_RANGE(ARG) \
413
  if (ARG >= bytestr_length) emacs_abort ()
414

415
#else /* not BYTE_CODE_SAFE */
Gerd Moellmann's avatar
Gerd Moellmann committed
416 417 418

#define CHECK_RANGE(ARG)

419
#endif /* not BYTE_CODE_SAFE */
Gerd Moellmann's avatar
Gerd Moellmann committed
420

Gerd Moellmann's avatar
Gerd Moellmann committed
421 422 423 424 425 426 427
/* A version of the QUIT macro which makes sure that the stack top is
   set before signaling `quit'.  */

#define BYTE_CODE_QUIT					\
  do {							\
    if (!NILP (Vquit_flag) && NILP (Vinhibit_quit))	\
      {							\
428
        Lisp_Object flag = Vquit_flag;			\
Gerd Moellmann's avatar
Gerd Moellmann committed
429 430
	Vquit_flag = Qnil;				\
        BEFORE_POTENTIAL_GC ();				\
431
	if (EQ (Vthrow_on_input, flag))			\
432
	  Fthrow (Vthrow_on_input, Qt);			\
Gerd Moellmann's avatar
Gerd Moellmann committed
433
	Fsignal (Qquit, Qnil);				\
434
	AFTER_POTENTIAL_GC ();				\
Gerd Moellmann's avatar
Gerd Moellmann committed
435
      }							\
436 437
    else if (pending_signals)				\
      process_pending_signals ();			\
Gerd Moellmann's avatar
Gerd Moellmann committed
438 439
  } while (0)

Gerd Moellmann's avatar
Gerd Moellmann committed
440

Jim Blandy's avatar
Jim Blandy committed
441
DEFUN ("byte-code", Fbyte_code, Sbyte_code, 3, 3, 0,
442 443 444 445 446
       doc: /* Function used internally in byte-compiled code.
The first argument, BYTESTR, is a string of byte code;
the second, VECTOR, a vector of constants;
the third, MAXDEPTH, the maximum stack depth used in this function.
If the third argument is incorrect, Emacs may crash.  */)
Dan Nicolaescu's avatar
Dan Nicolaescu committed
447
  (Lisp_Object bytestr, Lisp_Object vector, Lisp_Object maxdepth)
448
{
449
  return exec_byte_code (bytestr, vector, maxdepth, Qnil, 0, NULL);
450 451
}

452 453 454 455 456 457
static void
bcall0 (Lisp_Object f)
{
  Ffuncall (1, &f);
}

458 459 460 461 462 463 464 465 466
/* Execute the byte-code in BYTESTR.  VECTOR is the constant vector, and
   MAXDEPTH is the maximum stack depth used (if MAXDEPTH is incorrect,
   emacs may crash!).  If ARGS_TEMPLATE is non-nil, it should be a lisp
   argument list (including &rest, &optional, etc.), and ARGS, of size
   NARGS, should be a vector of the actual arguments.  The arguments in
   ARGS are pushed on the stack according to ARGS_TEMPLATE before
   executing BYTESTR.  */

Lisp_Object
Stefan Monnier's avatar
Stefan Monnier committed
467
exec_byte_code (Lisp_Object bytestr, Lisp_Object vector, Lisp_Object maxdepth,
468
		Lisp_Object args_template, ptrdiff_t nargs, Lisp_Object *args)
Jim Blandy's avatar
Jim Blandy committed
469
{
470
  ptrdiff_t count = SPECPDL_INDEX ();
Jim Blandy's avatar
Jim Blandy committed
471
#ifdef BYTE_CODE_METER
472
  int volatile this_op = 0;
Jim Blandy's avatar
Jim Blandy committed
473 474
  int prev_op;
#endif
Gerd Moellmann's avatar
Gerd Moellmann committed
475
  int op;
476
  /* Lisp_Object v1, v2; */
477
  Lisp_Object *vectorp;
Jim Blandy's avatar
Jim Blandy committed
478
#ifdef BYTE_CODE_SAFE
479 480 481
  ptrdiff_t const_length;
  Lisp_Object *stacke;
  ptrdiff_t bytestr_length;
482
#endif
Gerd Moellmann's avatar
Gerd Moellmann committed
483 484
  struct byte_stack stack;
  Lisp_Object *top;
485
  Lisp_Object result;
486
  enum handlertype type;
Jim Blandy's avatar
Jim Blandy committed
487

488
#if 0 /* CHECK_FRAME_FONT */
489 490 491 492 493
 {
   struct frame *f = SELECTED_FRAME ();
   if (FRAME_X_P (f)
       && FRAME_FONT (f)->direction != 0
       && FRAME_FONT (f)->direction != 1)
494
     emacs_abort ();
495 496 497
 }
#endif

498
  CHECK_STRING (bytestr);
Kim F. Storm's avatar
Kim F. Storm committed
499
  CHECK_VECTOR (vector);
500
  CHECK_NATNUM (maxdepth);
Jim Blandy's avatar
Jim Blandy committed
501

502
#ifdef BYTE_CODE_SAFE
503
  const_length = ASIZE (vector);
504 505
#endif

506 507 508 509 510
  if (STRING_MULTIBYTE (bytestr))
    /* BYTESTR must have been produced by Emacs 20.2 or the earlier
       because they produced a raw 8-bit string for byte-code and now
       such a byte-code string is loaded as multibyte while raw 8-bit
       characters converted to multibyte form.  Thus, now we must
511
       convert them back to the originally intended unibyte form.  */
512
    bytestr = Fstring_as_unibyte (bytestr);
513

514
#ifdef BYTE_CODE_SAFE
515
  bytestr_length = SBYTES (bytestr);
516
#endif
Paul Eggert's avatar
Paul Eggert committed
517
  vectorp = XVECTOR (vector)->contents;
518

Gerd Moellmann's avatar
Gerd Moellmann committed
519
  stack.byte_string = bytestr;
520
  stack.pc = stack.byte_string_start = SDATA (bytestr);
521
  if (MAX_ALLOCA / word_size <= XFASTINT (maxdepth))
522
    memory_full (SIZE_MAX);
523
  top = alloca ((XFASTINT (maxdepth) + 1) * sizeof *top);
524
#if BYTE_MAINTAIN_TOP
525
  stack.bottom = top + 1;
Gerd Moellmann's avatar
Gerd Moellmann committed
526
  stack.top = NULL;
527
#endif
Gerd Moellmann's avatar
Gerd Moellmann committed
528 529
  stack.next = byte_stack_list;
  byte_stack_list = &stack;
Jim Blandy's avatar
Jim Blandy committed
530

Gerd Moellmann's avatar
Gerd Moellmann committed
531 532 533
#ifdef BYTE_CODE_SAFE
  stacke = stack.bottom - 1 + XFASTINT (maxdepth);
#endif
534

535
  if (INTEGERP (args_template))
536
    {
537
      ptrdiff_t at = XINT (args_template);
538
      bool rest = (at & 128) != 0;
539
      int mandatory = at & 127;
540
      ptrdiff_t nonrest = at >> 8;
541 542 543
      eassert (mandatory <= nonrest);
      if (nargs <= nonrest)
	{
544
	  ptrdiff_t i;
545 546 547 548 549
	  for (i = 0 ; i < nargs; i++, args++)
	    PUSH (*args);
	  if (nargs < mandatory)
	    /* Too few arguments.  */
	    Fsignal (Qwrong_number_of_arguments,
550
		     list2 (Fcons (make_number (mandatory),
551
				   rest ? Qand_rest : make_number (nonrest)),
552
			    make_number (nargs)));
553 554 555 556 557 558 559 560 561 562
	  else
	    {
	      for (; i < nonrest; i++)
		PUSH (Qnil);
	      if (rest)
		PUSH (Qnil);
	    }
	}
      else if (rest)
	{
563
	  ptrdiff_t i;
564 565 566 567 568 569
	  for (i = 0 ; i < nonrest; i++, args++)
	    PUSH (*args);
	  PUSH (Flist (nargs - nonrest, args));
	}
      else
	/* Too many arguments.  */
570
	Fsignal (Qwrong_number_of_arguments,
571 572
		 list2 (Fcons (make_number (mandatory), make_number (nonrest)),
			make_number (nargs)));
573 574 575 576 577
    }
  else if (! NILP (args_template))
    /* We should push some arguments on the stack.  */
    {
      error ("Unknown args template!");
578 579
    }

Jim Blandy's avatar
Jim Blandy committed
580 581 582
  while (1)
    {
#ifdef BYTE_CODE_SAFE
583
      if (top > stacke)
584
	emacs_abort ();
Gerd Moellmann's avatar
Gerd Moellmann committed
585
      else if (top < stack.bottom - 1)
586
	emacs_abort ();
Jim Blandy's avatar
Jim Blandy committed
587 588 589 590 591 592 593
#endif

#ifdef BYTE_CODE_METER
      prev_op = this_op;
      this_op = op = FETCH;
      METER_CODE (prev_op, op);
#else
Tom Tromey's avatar
Tom Tromey committed
594
#ifndef BYTE_CODE_THREADED
595
      op = FETCH;
Jim Blandy's avatar
Jim Blandy committed
596
#endif
Tom Tromey's avatar
Tom Tromey committed
597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638
#endif

      /* The interpreter can be compiled one of two ways: as an
	 ordinary switch-based interpreter, or as a threaded
	 interpreter.  The threaded interpreter relies on GCC's
	 computed goto extension, so it is not available everywhere.
	 Threading provides a performance boost.  These macros are how
	 we allow the code to be compiled both ways.  */
#ifdef BYTE_CODE_THREADED
      /* The CASE macro introduces an instruction's body.  It is
	 either a label or a case label.  */
#define CASE(OP) insn_ ## OP
      /* NEXT is invoked at the end of an instruction to go to the
	 next instruction.  It is either a computed goto, or a
	 plain break.  */
#define NEXT goto *(targets[op = FETCH])
      /* FIRST is like NEXT, but is only used at the start of the
	 interpreter body.  In the switch-based interpreter it is the
	 switch, so the threaded definition must include a semicolon.  */
#define FIRST NEXT;
      /* Most cases are labeled with the CASE macro, above.
	 CASE_DEFAULT is one exception; it is used if the interpreter
	 being built requires a default case.  The threaded
	 interpreter does not, because the dispatch table is
	 completely filled.  */
#define CASE_DEFAULT
      /* This introduces an instruction that is known to call abort.  */
#define CASE_ABORT CASE (Bstack_ref): CASE (default)
#else
      /* See above for the meaning of the various defines.  */
#define CASE(OP) case OP
#define NEXT break
#define FIRST switch (op)
#define CASE_DEFAULT case 255: default:
#define CASE_ABORT case 0
#endif

#ifdef BYTE_CODE_THREADED

      /* A convenience define that saves us a lot of typing and makes
	 the table clearer.  */
#define LABEL(OP) [OP] = &&insn_ ## OP
Jim Blandy's avatar
Jim Blandy committed
639

640
#if GNUC_PREREQ (4, 6, 0)
641 642
# pragma GCC diagnostic push
# pragma GCC diagnostic ignored "-Woverride-init"
643 644 645
#elif defined __clang__
# pragma GCC diagnostic push
# pragma GCC diagnostic ignored "-Winitializer-overrides"
646 647
#endif

Tom Tromey's avatar
Tom Tromey committed
648 649
      /* This is the dispatch table for the threaded interpreter.  */
      static const void *const targets[256] =
650
	{
Tom Tromey's avatar
Tom Tromey committed
651 652 653 654 655 656 657
	  [0 ... (Bconstant - 1)] = &&insn_default,
	  [Bconstant ... 255] = &&insn_Bconstant,

#define DEFINE(name, value) LABEL (name) ,
	  BYTE_CODES
#undef DEFINE
	};
658

659
#if GNUC_PREREQ (4, 6, 0) || defined __clang__
660 661 662
# pragma GCC diagnostic pop
#endif

Tom Tromey's avatar
Tom Tromey committed
663 664 665 666 667 668
#endif


      FIRST
	{
	CASE (Bvarref7):
Jim Blandy's avatar
Jim Blandy committed
669 670 671
	  op = FETCH2;
	  goto varref;

Tom Tromey's avatar
Tom Tromey committed
672 673 674 675 676 677
	CASE (Bvarref):
	CASE (Bvarref1):
	CASE (Bvarref2):
	CASE (Bvarref3):
	CASE (Bvarref4):
	CASE (Bvarref5):
Jim Blandy's avatar
Jim Blandy committed
678
	  op = op - Bvarref;
679 680 681 682
	  goto varref;

	/* This seems to be the most frequently executed byte-code
	   among the Bvarref's, so avoid a goto here.  */
Tom Tromey's avatar
Tom Tromey committed
683
	CASE (Bvarref6):
684
	  op = FETCH;
Jim Blandy's avatar
Jim Blandy committed
685
	varref:
686 687 688 689 690 691
	  {
	    Lisp_Object v1, v2;

	    v1 = vectorp[op];
	    if (SYMBOLP (v1))
	      {
692 693 694
		if (XSYMBOL (v1)->redirect != SYMBOL_PLAINVAL
		    || (v2 = SYMBOL_VAL (XSYMBOL (v1)),
			EQ (v2, Qunbound)))
695 696 697 698 699
		  {
		    BEFORE_POTENTIAL_GC ();
		    v2 = Fsymbol_value (v1);
		    AFTER_POTENTIAL_GC ();
		  }
700 701
	      }
	    else
702 703 704 705 706
	      {
		BEFORE_POTENTIAL_GC ();
		v2 = Fsymbol_value (v1);
		AFTER_POTENTIAL_GC ();
	      }
707
	    PUSH (v2);
Tom Tromey's avatar
Tom Tromey committed
708
	    NEXT;
709 710
	  }

Tom Tromey's avatar
Tom Tromey committed
711
	CASE (Bgotoifnil):
712 713 714 715 716 717 718 719 720 721 722
	  {
	    Lisp_Object v1;
	    MAYBE_GC ();
	    op = FETCH2;
	    v1 = POP;
	    if (NILP (v1))
	      {
		BYTE_CODE_QUIT;
		CHECK_RANGE (op);
		stack.pc = stack.byte_string_start + op;
	      }
Tom Tromey's avatar
Tom Tromey committed
723
	    NEXT;
724
	  }
Jim Blandy's avatar
Jim Blandy committed
725

Tom Tromey's avatar
Tom Tromey committed
726
	CASE (Bcar):
727 728 729
	  {
	    Lisp_Object v1;
	    v1 = TOP;
730 731 732 733 734 735 736 737 738
	    if (CONSP (v1))
	      TOP = XCAR (v1);
	    else if (NILP (v1))
	      TOP = Qnil;
	    else
	      {
		BEFORE_POTENTIAL_GC ();
		wrong_type_argument (Qlistp, v1);
	      }
Tom Tromey's avatar
Tom Tromey committed
739
	    NEXT;
740 741
	  }

Tom Tromey's avatar
Tom Tromey committed
742
	CASE (Beq):
743 744 745 746
	  {
	    Lisp_Object v1;
	    v1 = POP;
	    TOP = EQ (v1, TOP) ? Qt : Qnil;
Tom Tromey's avatar
Tom Tromey committed
747
	    NEXT;
748 749
	  }

Tom Tromey's avatar
Tom Tromey committed
750
	CASE (Bmemq):
751 752
	  {
	    Lisp_Object v1;
753
	    BEFORE_POTENTIAL_GC ();
754 755
	    v1 = POP;
	    TOP = Fmemq (TOP, v1);
756
	    AFTER_POTENTIAL_GC ();
Tom Tromey's avatar
Tom Tromey committed
757
	    NEXT;
758 759
	  }

Tom Tromey's avatar
Tom Tromey committed
760
	CASE (Bcdr):
761 762 763
	  {
	    Lisp_Object v1;
	    v1 = TOP;
764 765 766 767 768 769 770 771 772
	    if (CONSP (v1))
	      TOP = XCDR (v1);
	    else if (NILP (v1))
	      TOP = Qnil;
	    else
	      {
		BEFORE_POTENTIAL_GC ();
		wrong_type_argument (Qlistp, v1);
	      }
Tom Tromey's avatar
Tom Tromey committed
773
	    NEXT;
774
	  }
Jim Blandy's avatar
Jim Blandy committed
775

Tom Tromey's avatar
Tom Tromey committed
776 777 778 779 780 781
	CASE (Bvarset):
	CASE (Bvarset1):
	CASE (Bvarset2):
	CASE (Bvarset3):
	CASE (Bvarset4):
	CASE (Bvarset5):
782
	  op -= Bvarset;
Jim Blandy's avatar
Jim Blandy committed
783 784
	  goto varset;

Tom Tromey's avatar
Tom Tromey committed
785
	CASE (Bvarset7):
786
	  op = FETCH2;
787 788
	  goto varset;

Tom Tromey's avatar
Tom Tromey committed
789
	CASE (Bvarset6):
790
	  op = FETCH;
Jim Blandy's avatar
Jim Blandy committed
791
	varset:
792 793
	  {
	    Lisp_Object sym, val;
794

795
	    sym = vectorp[op];
796
	    val = TOP;
797 798 799 800

	    /* Inline the most common case.  */
	    if (SYMBOLP (sym)
		&& !EQ (val, Qunbound)
801 802
		&& !XSYMBOL (sym)->redirect
		&& !SYMBOL_CONSTANT_P (sym))
803
	      SET_SYMBOL_VAL (XSYMBOL (sym), val);
804
	    else
805 806
	      {
		BEFORE_POTENTIAL_GC ();
807
		set_internal (sym, val, Qnil, 0);
808 809
		AFTER_POTENTIAL_GC ();
	      }
810
	  }
811
	  (void) POP;
Tom Tromey's avatar
Tom Tromey committed
812
	  NEXT;
Jim Blandy's avatar
Jim Blandy committed
813

Tom Tromey's avatar
Tom Tromey committed
814
	CASE (Bdup):
815 816 817 818
	  {
	    Lisp_Object v1;
	    v1 = TOP;
	    PUSH (v1);
Tom Tromey's avatar
Tom Tromey committed
819
	    NEXT;
820 821 822 823
	  }

	/* ------------------ */

Tom Tromey's avatar
Tom Tromey committed
824
	CASE (Bvarbind6):
Jim Blandy's avatar
Jim Blandy committed
825 826 827
	  op = FETCH;
	  goto varbind;

Tom Tromey's avatar
Tom Tromey committed
828
	CASE (Bvarbind7):
Jim Blandy's avatar
Jim Blandy committed
829 830 831
	  op = FETCH2;
	  goto varbind;

Tom Tromey's avatar
Tom Tromey committed
832 833 834 835 836 837
	CASE (Bvarbind):
	CASE (Bvarbind1):
	CASE (Bvarbind2):
	CASE (Bvarbind3):
	CASE (Bvarbind4):
	CASE (Bvarbind5):
Jim Blandy's avatar
Jim Blandy committed
838 839
	  op -= Bvarbind;
	varbind:
840 841
	  /* Specbind can signal and thus GC.  */
	  BEFORE_POTENTIAL_GC ();
Jim Blandy's avatar
Jim Blandy committed
842
	  specbind (vectorp[op], POP);
843
	  AFTER_POTENTIAL_GC ();
Tom Tromey's avatar
Tom Tromey committed
844
	  NEXT;
Jim Blandy's avatar
Jim Blandy committed
845

Tom Tromey's avatar
Tom Tromey committed
846
	CASE (Bcall6):
Jim Blandy's avatar
Jim Blandy committed
847 848 849
	  op = FETCH;
	  goto docall;

Tom Tromey's avatar
Tom Tromey committed
850
	CASE (Bcall7):
Jim Blandy's avatar
Jim Blandy committed
851 852 853
	  op = FETCH2;
	  goto docall;

Tom Tromey's avatar
Tom Tromey committed
854 855 856 857 858 859
	CASE (Bcall):
	CASE (Bcall1):
	CASE (Bcall2):
	CASE (Bcall3):
	CASE (Bcall4):
	CASE (Bcall5):
Jim Blandy's avatar
Jim Blandy committed
860 861
	  op -= Bcall;
	docall:
862
	  {
863
	    BEFORE_POTENTIAL_GC ();
864
	    DISCARD (op);
865
#ifdef BYTE_CODE_METER
866 867 868 869 870 871 872
	    if (byte_metering_on && SYMBOLP (TOP))
	      {
		Lisp_Object v1, v2;

		v1 = TOP;
		v2 = Fget (v1, Qbyte_code_meter);
		if (INTEGERP (v2)
873
		    && XINT (v2) < MOST_POSITIVE_FIXNUM)
874 875 876 877 878
		  {
		    XSETINT (v2, XINT (v2) + 1);
		    Fput (v1, Qbyte_code_meter, v2);
		  }
	      }
879
#endif
880 881
	    TOP = Ffuncall (op + 1, &TOP);
	    AFTER_POTENTIAL_GC ();
Tom Tromey's avatar
Tom Tromey committed
882
	    NEXT;
883
	  }
Jim Blandy's avatar
Jim Blandy committed
884

Tom Tromey's avatar
Tom Tromey committed
885
	CASE (Bunbind6):
Jim Blandy's avatar
Jim Blandy committed
886 887 888
	  op = FETCH;
	  goto dounbind;

Tom Tromey's avatar
Tom Tromey committed
889
	CASE (Bunbind7):
Jim Blandy's avatar
Jim Blandy committed
890 891 892
	  op = FETCH2;
	  goto dounbind;

Tom Tromey's avatar
Tom Tromey committed
893 894 895 896 897 898
	CASE (Bunbind):
	CASE (Bunbind1):
	CASE (Bunbind2):
	CASE (Bunbind3):
	CASE (Bunbind4):
	CASE (Bunbind5):
Jim Blandy's avatar
Jim Blandy committed
899 900
	  op -= Bunbind;
	dounbind:
Gerd Moellmann's avatar
Gerd Moellmann committed
901
	  BEFORE_POTENTIAL_GC ();
Juanma Barranquero's avatar
Juanma Barranquero committed
902
	  unbind_to (SPECPDL_INDEX () - op, Qnil);
Gerd Moellmann's avatar
Gerd Moellmann committed
903
	  AFTER_POTENTIAL_GC ();
Tom Tromey's avatar
Tom Tromey committed
904
	  NEXT;
Jim Blandy's avatar
Jim Blandy committed
905

Tom Tromey's avatar
Tom Tromey committed
906
	CASE (Bunbind_all):	/* Obsolete.  Never used.  */
Jim Blandy's avatar
Jim Blandy committed
907
	  /* To unbind back to the beginning of this frame.  Not used yet,
908
	     but will be needed for tail-recursion elimination.  */
Gerd Moellmann's avatar
Gerd Moellmann committed
909
	  BEFORE_POTENTIAL_GC ();
Jim Blandy's avatar
Jim Blandy committed
910
	  unbind_to (count, Qnil);
Gerd Moellmann's avatar
Gerd Moellmann committed
911
	  AFTER_POTENTIAL_GC ();
Tom Tromey's avatar
Tom Tromey committed
912
	  NEXT;
Jim Blandy's avatar
Jim Blandy committed
913

Tom Tromey's avatar
Tom Tromey committed
914
	CASE (Bgoto):
Richard M. Stallman's avatar
Richard M. Stallman committed
915
	  MAYBE_GC ();
Gerd Moellmann's avatar
Gerd Moellmann committed
916
	  BYTE_CODE_QUIT;
Jim Blandy's avatar
Jim Blandy committed
917
	  op = FETCH2;    /* pc = FETCH2 loses since FETCH2 contains pc++ */
918
	  CHECK_RANGE (op);
Gerd Moellmann's avatar
Gerd Moellmann committed
919
	  stack.pc = stack.byte_string_start + op;
Tom Tromey's avatar
Tom Tromey committed
920
	  NEXT;
Jim Blandy's avatar
Jim Blandy committed
921

Tom Tromey's avatar
Tom Tromey committed
922
	CASE (Bgotoifnonnil):
923 924 925 926 927 928 929 930 931 932 933
	  {
	    Lisp_Object v1;
	    MAYBE_GC ();
	    op = FETCH2;
	    v1 = POP;
	    if (!NILP (v1))
	      {
		BYTE_CODE_QUIT;
		CHECK_RANGE (op);
		stack.pc = stack.byte_string_start + op;
	      }
Tom Tromey's avatar
Tom Tromey committed
934
	    NEXT;
935
	  }
Jim Blandy's avatar
Jim Blandy committed
936

Tom Tromey's avatar
Tom Tromey committed
937
	CASE (Bgotoifnilelsepop):
Richard M. Stallman's avatar
Richard M. Stallman committed
938
	  MAYBE_GC ();
Jim Blandy's avatar
Jim Blandy committed
939
	  op = FETCH2;
Joseph Arceneaux's avatar
Joseph Arceneaux committed
940
	  if (NILP (TOP))
Jim Blandy's avatar
Jim Blandy committed
941
	    {
Gerd Moellmann's avatar
Gerd Moellmann committed
942
	      BYTE_CODE_QUIT;
943
	      CHECK_RANGE (op);
Gerd Moellmann's avatar
Gerd Moellmann committed
944
	      stack.pc = stack.byte_string_start + op;
Jim Blandy's avatar
Jim Blandy committed
945
	    }
946
	  else DISCARD (1);
Tom Tromey's avatar
Tom Tromey committed
947
	  NEXT;
Jim Blandy's avatar
Jim Blandy committed
948

Tom Tromey's avatar
Tom Tromey committed
949
	CASE (Bgotoifnonnilelsepop):
Richard M. Stallman's avatar
Richard M. Stallman committed
950
	  MAYBE_GC ();
Jim Blandy's avatar
Jim Blandy committed
951
	  op = FETCH2;
Joseph Arceneaux's avatar
Joseph Arceneaux committed
952
	  if (!NILP (TOP))
Jim Blandy's avatar
Jim Blandy committed
953
	    {
Gerd Moellmann's avatar
Gerd Moellmann committed
954
	      BYTE_CODE_QUIT;
955
	      CHECK_RANGE (op);
Gerd Moellmann's avatar
Gerd Moellmann committed
956
	      stack.pc = stack.byte_string_start + op;
Jim Blandy's avatar
Jim Blandy committed
957
	    }
958
	  else DISCARD (1);
Tom Tromey's avatar
Tom Tromey committed
959
	  NEXT;
960

Tom Tromey's avatar
Tom Tromey committed
961
	CASE (BRgoto):
Richard M. Stallman's avatar
Richard M. Stallman committed
962
	  MAYBE_GC ();
Gerd Moellmann's avatar
Gerd Moellmann committed
963
	  BYTE_CODE_QUIT;
Gerd Moellmann's avatar
Gerd Moellmann committed
964
	  stack.pc += (int) *stack.pc - 127;
Tom Tromey's avatar
Tom Tromey committed
965
	  NEXT;
966

Tom Tromey's avatar
Tom Tromey committed
967
	CASE (BRgotoifnil):
968 969 970 971 972 973 974 975 976 977
	  {
	    Lisp_Object v1;
	    MAYBE_GC ();
	    v1 = POP;
	    if (NILP (v1))
	      {
		BYTE_CODE_QUIT;
		stack.pc += (int) *stack.pc - 128;
	      }
	    stack.pc++;
Tom Tromey's avatar
Tom Tromey committed
978
	    NEXT;
979
	  }
980

Tom Tromey's avatar
Tom Tromey committed
981
	CASE (BRgotoifnonnil):
982 983 984 985 986 987 988 989 990 991
	  {
	    Lisp_Object v1;
	    MAYBE_GC ();
	    v1 = POP;
	    if (!NILP (v1))
	      {
		BYTE_CODE_QUIT;
		stack.pc += (int) *stack.pc - 128;
	      }
	    stack.pc++;
Tom Tromey's avatar
Tom Tromey committed
992
	    NEXT;
993
	  }
994

Tom Tromey's avatar
Tom Tromey committed
995
	CASE (BRgotoifnilelsepop):
Richard M. Stallman's avatar
Richard M. Stallman committed
996
	  MAYBE_GC ();
Gerd Moellmann's avatar
Gerd Moellmann committed
997
	  op = *stack.pc++;
998 999
	  if (NILP (TOP))
	    {
Gerd Moellmann's avatar
Gerd Moellmann committed
1000
	      BYTE_CODE_QUIT;
Gerd Moellmann's avatar
Gerd Moellmann committed
1001
	      stack.pc += op - 128;
1002 1003
	    }
	  else DISCARD (1);
Tom Tromey's avatar
Tom Tromey committed
1004
	  NEXT;
1005

Tom Tromey's avatar
Tom Tromey committed
1006
	CASE (BRgotoifnonnilelsepop):