data.c 73.4 KB
Newer Older
Jim Blandy's avatar
Jim Blandy committed
1
/* Primitive operations on Lisp data types for GNU Emacs Lisp interpreter.
2
   Copyright (C) 1985, 86, 88, 93, 94, 95 Free Software Foundation, Inc.
Jim Blandy's avatar
Jim Blandy committed
3 4 5 6 7

This file is part of GNU Emacs.

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

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
along with GNU Emacs; see the file COPYING.  If not, write to
18 19
the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.  */
Jim Blandy's avatar
Jim Blandy committed
20 21 22 23


#include <signal.h>

24
#include <config.h>
Jim Blandy's avatar
Jim Blandy committed
25
#include "lisp.h"
Jim Blandy's avatar
Jim Blandy committed
26
#include "puresize.h"
Jim Blandy's avatar
Jim Blandy committed
27 28 29

#ifndef standalone
#include "buffer.h"
Richard M. Stallman's avatar
Richard M. Stallman committed
30
#include "keyboard.h"
Jim Blandy's avatar
Jim Blandy committed
31 32
#endif

Jim Blandy's avatar
Jim Blandy committed
33
#include "syssignal.h"
Jim Blandy's avatar
Jim Blandy committed
34

Jim Blandy's avatar
Jim Blandy committed
35
#ifdef LISP_FLOAT_TYPE
36

37 38 39
#ifdef STDC_HEADERS
#include <stdlib.h>
#endif
40 41 42 43 44 45 46 47 48 49 50

/* Work around a problem that happens because math.h on hpux 7
   defines two static variables--which, in Emacs, are not really static,
   because `static' is defined as nothing.  The problem is that they are
   here, in floatfns.c, and in lread.c.
   These macros prevent the name conflict.  */
#if defined (HPUX) && !defined (HPUX8)
#define _MAXLDBL data_c_maxldbl
#define _NMAXLDBL data_c_nmaxldbl
#endif

Jim Blandy's avatar
Jim Blandy committed
51 52 53
#include <math.h>
#endif /* LISP_FLOAT_TYPE */

54 55 56 57
#if !defined (atof)
extern double atof ();
#endif /* !atof */

Jim Blandy's avatar
Jim Blandy committed
58 59 60
Lisp_Object Qnil, Qt, Qquote, Qlambda, Qsubr, Qunbound;
Lisp_Object Qerror_conditions, Qerror_message, Qtop_level;
Lisp_Object Qerror, Qquit, Qwrong_type_argument, Qargs_out_of_range;
Jim Blandy's avatar
Jim Blandy committed
61
Lisp_Object Qvoid_variable, Qvoid_function, Qcyclic_function_indirection;
Jim Blandy's avatar
Jim Blandy committed
62 63
Lisp_Object Qsetting_constant, Qinvalid_read_syntax;
Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch;
Roland McGrath's avatar
Roland McGrath committed
64
Lisp_Object Qend_of_file, Qarith_error, Qmark_inactive;
Jim Blandy's avatar
Jim Blandy committed
65
Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_read_only;
66
Lisp_Object Qintegerp, Qnatnump, Qwholenump, Qsymbolp, Qlistp, Qconsp;
Jim Blandy's avatar
Jim Blandy committed
67 68
Lisp_Object Qstringp, Qarrayp, Qsequencep, Qbufferp;
Lisp_Object Qchar_or_string_p, Qmarkerp, Qinteger_or_marker_p, Qvectorp;
Joseph Arceneaux's avatar
Joseph Arceneaux committed
69
Lisp_Object Qbuffer_or_string_p;
Jim Blandy's avatar
Jim Blandy committed
70
Lisp_Object Qboundp, Qfboundp;
71
Lisp_Object Qchar_table_p, Qvector_or_char_table_p;
72

Jim Blandy's avatar
Jim Blandy committed
73
Lisp_Object Qcdr;
74
Lisp_Object Qad_advice_info, Qad_activate;
Jim Blandy's avatar
Jim Blandy committed
75

76 77 78
Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
Lisp_Object Qoverflow_error, Qunderflow_error;

Jim Blandy's avatar
Jim Blandy committed
79
#ifdef LISP_FLOAT_TYPE
80
Lisp_Object Qfloatp;
Jim Blandy's avatar
Jim Blandy committed
81 82 83
Lisp_Object Qnumberp, Qnumber_or_marker_p;
#endif

84 85 86
static Lisp_Object Qinteger, Qsymbol, Qstring, Qcons, Qmarker, Qoverlay;
static Lisp_Object Qfloat, Qwindow_configuration, Qprocess, Qwindow;
static Lisp_Object Qcompiled_function, Qbuffer, Qframe, Qvector;
87
static Lisp_Object Qchar_table, Qbool_vector;
88

Jim Blandy's avatar
Jim Blandy committed
89 90 91 92 93 94 95 96 97 98 99
static Lisp_Object swap_in_symval_forwarding ();

Lisp_Object
wrong_type_argument (predicate, value)
     register Lisp_Object predicate, value;
{
  register Lisp_Object tem;
  do
    {
      if (!EQ (Vmocklisp_arguments, Qt))
	{
100
	 if (STRINGP (value) &&
Jim Blandy's avatar
Jim Blandy committed
101
	     (EQ (predicate, Qintegerp) || EQ (predicate, Qinteger_or_marker_p)))
102
	   return Fstring_to_number (value);
103
	 if (INTEGERP (value) && EQ (predicate, Qstringp))
104
	   return Fnumber_to_string (value);
Jim Blandy's avatar
Jim Blandy committed
105
	}
106 107 108

      /* If VALUE is not even a valid Lisp object, abort here
	 where we can get a backtrace showing where it came from.  */
109
      if ((unsigned int) XGCTYPE (value) >= Lisp_Type_Limit)
110 111
	abort ();

Jim Blandy's avatar
Jim Blandy committed
112 113 114
      value = Fsignal (Qwrong_type_argument, Fcons (predicate, Fcons (value, Qnil)));
      tem = call1 (predicate, value);
    }
Jim Blandy's avatar
Jim Blandy committed
115
  while (NILP (tem));
Jim Blandy's avatar
Jim Blandy committed
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 145 146 147 148
  return value;
}

pure_write_error ()
{
  error ("Attempt to modify read-only object");
}

void
args_out_of_range (a1, a2)
     Lisp_Object a1, a2;
{
  while (1)
    Fsignal (Qargs_out_of_range, Fcons (a1, Fcons (a2, Qnil)));
}

void
args_out_of_range_3 (a1, a2, a3)
     Lisp_Object a1, a2, a3;
{
  while (1)
    Fsignal (Qargs_out_of_range, Fcons (a1, Fcons (a2, Fcons (a3, Qnil))));
}

/* On some machines, XINT needs a temporary location.
   Here it is, in case it is needed.  */

int sign_extend_temp;

/* On a few machines, XINT can only be done by calling this.  */

int
sign_extend_lisp_int (num)
149
     EMACS_INT num;
Jim Blandy's avatar
Jim Blandy committed
150
{
151 152
  if (num & (((EMACS_INT) 1) << (VALBITS - 1)))
    return num | (((EMACS_INT) (-1)) << VALBITS);
Jim Blandy's avatar
Jim Blandy committed
153
  else
154
    return num & ((((EMACS_INT) 1) << VALBITS) - 1);
Jim Blandy's avatar
Jim Blandy committed
155 156 157 158 159 160 161 162 163 164 165 166 167 168 169
}

/* Data type predicates */

DEFUN ("eq", Feq, Seq, 2, 2, 0,
  "T if the two args are the same Lisp object.")
  (obj1, obj2)
     Lisp_Object obj1, obj2;
{
  if (EQ (obj1, obj2))
    return Qt;
  return Qnil;
}

DEFUN ("null", Fnull, Snull, 1, 1, 0, "T if OBJECT is nil.")
170 171
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
172
{
173
  if (NILP (object))
Jim Blandy's avatar
Jim Blandy committed
174 175 176 177
    return Qt;
  return Qnil;
}

178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199
DEFUN ("type-of", Ftype_of, Stype_of, 1, 1, 0,
  "Return a symbol representing the type of OBJECT.\n\
The symbol returned names the object's basic type;\n\
for example, (type-of 1) returns `integer'.")
  (object)
     Lisp_Object object;
{
  switch (XGCTYPE (object))
    {
    case Lisp_Int:
      return Qinteger;

    case Lisp_Symbol:
      return Qsymbol;

    case Lisp_String:
      return Qstring;

    case Lisp_Cons:
      return Qcons;

    case Lisp_Misc:
200
      switch (XMISCTYPE (object))
201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223
	{
	case Lisp_Misc_Marker:
	  return Qmarker;
	case Lisp_Misc_Overlay:
	  return Qoverlay;
	case Lisp_Misc_Float:
	  return Qfloat;
	}
      abort ();

    case Lisp_Vectorlike:
      if (GC_WINDOW_CONFIGURATIONP (object))
	return Qwindow_configuration;
      if (GC_PROCESSP (object))
	return Qprocess;
      if (GC_WINDOWP (object))
	return Qwindow;
      if (GC_SUBRP (object))
	return Qsubr;
      if (GC_COMPILEDP (object))
	return Qcompiled_function;
      if (GC_BUFFERP (object))
	return Qbuffer;
224 225 226 227
      if (GC_CHAR_TABLE_P (object))
	return Qchar_table;
      if (GC_BOOL_VECTOR_P (object))
	return Qbool_vector;
228 229 230 231 232 233 234 235 236 237 238 239 240 241
      if (GC_FRAMEP (object))
	return Qframe;
      return Qvector;

#ifdef LISP_FLOAT_TYPE
    case Lisp_Float:
      return Qfloat;
#endif

    default:
      abort ();
    }
}

Jim Blandy's avatar
Jim Blandy committed
242
DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0, "T if OBJECT is a cons cell.")
243 244
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
245
{
246
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
247 248 249 250 251
    return Qt;
  return Qnil;
}

DEFUN ("atom", Fatom, Satom, 1, 1, 0, "T if OBJECT is not a cons cell.  This includes nil.")
252 253
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
254
{
255
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
256 257 258 259 260
    return Qnil;
  return Qt;
}

DEFUN ("listp", Flistp, Slistp, 1, 1, 0, "T if OBJECT is a list.  This includes nil.")
261 262
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
263
{
264
  if (CONSP (object) || NILP (object))
Jim Blandy's avatar
Jim Blandy committed
265 266 267 268 269
    return Qt;
  return Qnil;
}

DEFUN ("nlistp", Fnlistp, Snlistp, 1, 1, 0, "T if OBJECT is not a list.  Lists include nil.")
270 271
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
272
{
273
  if (CONSP (object) || NILP (object))
Jim Blandy's avatar
Jim Blandy committed
274 275 276 277 278
    return Qnil;
  return Qt;
}

DEFUN ("symbolp", Fsymbolp, Ssymbolp, 1, 1, 0, "T if OBJECT is a symbol.")
279 280
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
281
{
282
  if (SYMBOLP (object))
Jim Blandy's avatar
Jim Blandy committed
283 284 285 286 287
    return Qt;
  return Qnil;
}

DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0, "T if OBJECT is a vector.")
288 289
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
290
{
291
  if (VECTORP (object))
Jim Blandy's avatar
Jim Blandy committed
292 293 294 295 296
    return Qt;
  return Qnil;
}

DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0, "T if OBJECT is a string.")
297 298
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
299
{
300
  if (STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
301 302 303 304
    return Qt;
  return Qnil;
}

305 306 307 308 309 310 311 312 313
DEFUN ("char-table-p", Fchar_table_p, Schar_table_p, 1, 1, 0, "T if OBJECT is a char-table.")
  (object)
     Lisp_Object object;
{
  if (CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

314 315 316 317 318 319 320 321 322 323 324
DEFUN ("vector-or-char-table-p", Fvector_or_char_table_p,
       Svector_or_char_table_p, 1, 1, 0,
       "T if OBJECT is a char-table or vector.")
  (object)
     Lisp_Object object;
{
  if (VECTORP (object) || CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

325 326 327 328 329 330 331 332 333
DEFUN ("bool-vector-p", Fbool_vector_p, Sbool_vector_p, 1, 1, 0, "T if OBJECT is a bool-vector.")
  (object)
     Lisp_Object object;
{
  if (BOOL_VECTOR_P (object))
    return Qt;
  return Qnil;
}

Jim Blandy's avatar
Jim Blandy committed
334
DEFUN ("arrayp", Farrayp, Sarrayp, 1, 1, 0, "T if OBJECT is an array (string or vector).")
335 336
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
337
{
338
  if (VECTORP (object) || STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
339 340 341 342 343 344
    return Qt;
  return Qnil;
}

DEFUN ("sequencep", Fsequencep, Ssequencep, 1, 1, 0,
  "T if OBJECT is a sequence (list or array).")
345 346
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
347
{
348 349
  if (CONSP (object) || NILP (object) || VECTORP (object) || STRINGP (object)
      || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
Jim Blandy's avatar
Jim Blandy committed
350 351 352 353 354
    return Qt;
  return Qnil;
}

DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0, "T if OBJECT is an editor buffer.")
355 356
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
357
{
358
  if (BUFFERP (object))
Jim Blandy's avatar
Jim Blandy committed
359 360 361 362 363
    return Qt;
  return Qnil;
}

DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0, "T if OBJECT is a marker (editor pointer).")
364 365
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
366
{
367
  if (MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
368 369 370 371 372
    return Qt;
  return Qnil;
}

DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0, "T if OBJECT is a built-in function.")
373 374
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
375
{
376
  if (SUBRP (object))
Jim Blandy's avatar
Jim Blandy committed
377 378 379 380
    return Qt;
  return Qnil;
}

Jim Blandy's avatar
Jim Blandy committed
381 382
DEFUN ("byte-code-function-p", Fbyte_code_function_p, Sbyte_code_function_p,
       1, 1, 0, "T if OBJECT is a byte-compiled function object.")
383 384
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
385
{
386
  if (COMPILEDP (object))
Jim Blandy's avatar
Jim Blandy committed
387 388 389 390
    return Qt;
  return Qnil;
}

391 392
DEFUN ("char-or-string-p", Fchar_or_string_p, Schar_or_string_p, 1, 1, 0,
  "T if OBJECT is a character (an integer) or a string.")
393 394
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
395
{
396
  if (INTEGERP (object) || STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
397 398 399 400
    return Qt;
  return Qnil;
}

401
DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0, "T if OBJECT is an integer.")
402 403
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
404
{
405
  if (INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
406 407 408 409
    return Qt;
  return Qnil;
}

410 411
DEFUN ("integer-or-marker-p", Finteger_or_marker_p, Sinteger_or_marker_p, 1, 1, 0,
  "T if OBJECT is an integer or a marker (editor pointer).")
412 413
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
414
{
415
  if (MARKERP (object) || INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
416 417 418 419
    return Qt;
  return Qnil;
}

420 421
DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0,
  "T if OBJECT is a nonnegative integer.")
422 423
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
424
{
425
  if (NATNUMP (object))
Jim Blandy's avatar
Jim Blandy committed
426 427 428 429 430 431
    return Qt;
  return Qnil;
}

DEFUN ("numberp", Fnumberp, Snumberp, 1, 1, 0,
       "T if OBJECT is a number (floating point or integer).")
432 433
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
434
{
435
  if (NUMBERP (object))
Jim Blandy's avatar
Jim Blandy committed
436
    return Qt;
Jim Blandy's avatar
Jim Blandy committed
437 438
  else
    return Qnil;
Jim Blandy's avatar
Jim Blandy committed
439 440 441 442 443
}

DEFUN ("number-or-marker-p", Fnumber_or_marker_p,
       Snumber_or_marker_p, 1, 1, 0,
       "T if OBJECT is a number or a marker.")
444 445
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
446
{
447
  if (NUMBERP (object) || MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
448 449 450
    return Qt;
  return Qnil;
}
451 452 453 454

#ifdef LISP_FLOAT_TYPE
DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
       "T if OBJECT is a floating point number.")
455 456
  (object)
     Lisp_Object object;
457
{
458
  if (FLOATP (object))
459 460 461
    return Qt;
  return Qnil;
}
Jim Blandy's avatar
Jim Blandy committed
462 463 464 465 466
#endif /* LISP_FLOAT_TYPE */

/* Extract and set components of lists */

DEFUN ("car", Fcar, Scar, 1, 1, 0,
467
  "Return the car of LIST.  If arg is nil, return nil.\n\
Jim Blandy's avatar
Jim Blandy committed
468 469 470 471 472 473
Error if arg is not nil and not a cons cell.  See also `car-safe'.")
  (list)
     register Lisp_Object list;
{
  while (1)
    {
474
      if (CONSP (list))
Jim Blandy's avatar
Jim Blandy committed
475 476 477 478 479 480 481 482 483 484 485 486 487
	return XCONS (list)->car;
      else if (EQ (list, Qnil))
	return Qnil;
      else
	list = wrong_type_argument (Qlistp, list);
    }
}

DEFUN ("car-safe", Fcar_safe, Scar_safe, 1, 1, 0,
  "Return the car of OBJECT if it is a cons cell, or else nil.")
  (object)
     Lisp_Object object;
{
488
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
489 490 491 492 493 494
    return XCONS (object)->car;
  else
    return Qnil;
}

DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
495
  "Return the cdr of LIST.  If arg is nil, return nil.\n\
Jim Blandy's avatar
Jim Blandy committed
496 497 498 499 500 501 502
Error if arg is not nil and not a cons cell.  See also `cdr-safe'.")

  (list)
     register Lisp_Object list;
{
  while (1)
    {
503
      if (CONSP (list))
Jim Blandy's avatar
Jim Blandy committed
504 505 506 507 508 509 510 511 512
	return XCONS (list)->cdr;
      else if (EQ (list, Qnil))
	return Qnil;
      else
	list = wrong_type_argument (Qlistp, list);
    }
}

DEFUN ("cdr-safe", Fcdr_safe, Scdr_safe, 1, 1, 0,
513
  "Return the cdr of OBJECT if it is a cons cell, or else nil.")
Jim Blandy's avatar
Jim Blandy committed
514 515 516
  (object)
     Lisp_Object object;
{
517
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
518 519 520 521 522 523
    return XCONS (object)->cdr;
  else
    return Qnil;
}

DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0,
524
  "Set the car of CELL to be NEWCAR.  Returns NEWCAR.")
Jim Blandy's avatar
Jim Blandy committed
525 526 527
  (cell, newcar)
     register Lisp_Object cell, newcar;
{
528
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
529 530 531 532 533 534 535 536
    cell = wrong_type_argument (Qconsp, cell);

  CHECK_IMPURE (cell);
  XCONS (cell)->car = newcar;
  return newcar;
}

DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
537
  "Set the cdr of CELL to be NEWCDR.  Returns NEWCDR.")
Jim Blandy's avatar
Jim Blandy committed
538 539 540
  (cell, newcdr)
     register Lisp_Object cell, newcdr;
{
541
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
542 543 544 545 546 547 548 549 550 551
    cell = wrong_type_argument (Qconsp, cell);

  CHECK_IMPURE (cell);
  XCONS (cell)->cdr = newcdr;
  return newcdr;
}

/* Extract and set components of symbols */

DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0, "T if SYMBOL's value is not void.")
552 553
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
554 555
{
  Lisp_Object valcontents;
556
  CHECK_SYMBOL (symbol, 0);
Jim Blandy's avatar
Jim Blandy committed
557

558
  valcontents = XSYMBOL (symbol)->value;
Jim Blandy's avatar
Jim Blandy committed
559

Karl Heuer's avatar
Karl Heuer committed
560 561
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
562
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
563

564
  return (EQ (valcontents, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
565 566 567
}

DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0, "T if SYMBOL's function definition is not void.")
568 569
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
570
{
571 572
  CHECK_SYMBOL (symbol, 0);
  return (EQ (XSYMBOL (symbol)->function, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
573 574 575
}

DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0, "Make SYMBOL's value be void.")
576 577
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
578
{
579 580 581 582 583
  CHECK_SYMBOL (symbol, 0);
  if (NILP (symbol) || EQ (symbol, Qt))
    return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
  Fset (symbol, Qunbound);
  return symbol;
Jim Blandy's avatar
Jim Blandy committed
584 585 586
}

DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0, "Make SYMBOL's function definition be void.")
587 588
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
589
{
590 591 592 593 594
  CHECK_SYMBOL (symbol, 0);
  if (NILP (symbol) || EQ (symbol, Qt))
    return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
  XSYMBOL (symbol)->function = Qunbound;
  return symbol;
Jim Blandy's avatar
Jim Blandy committed
595 596 597 598
}

DEFUN ("symbol-function", Fsymbol_function, Ssymbol_function, 1, 1, 0,
  "Return SYMBOL's function definition.  Error if that is void.")
Jim Blandy's avatar
Jim Blandy committed
599 600
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
601
{
Jim Blandy's avatar
Jim Blandy committed
602 603 604 605
  CHECK_SYMBOL (symbol, 0);
  if (EQ (XSYMBOL (symbol)->function, Qunbound))
    return Fsignal (Qvoid_function, Fcons (symbol, Qnil));
  return XSYMBOL (symbol)->function;
Jim Blandy's avatar
Jim Blandy committed
606 607 608
}

DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0, "Return SYMBOL's property list.")
609 610
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
611
{
612 613
  CHECK_SYMBOL (symbol, 0);
  return XSYMBOL (symbol)->plist;
Jim Blandy's avatar
Jim Blandy committed
614 615 616
}

DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0, "Return SYMBOL's name, a string.")
617 618
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
619 620 621
{
  register Lisp_Object name;

622 623
  CHECK_SYMBOL (symbol, 0);
  XSETSTRING (name, XSYMBOL (symbol)->name);
Jim Blandy's avatar
Jim Blandy committed
624 625 626 627
  return name;
}

DEFUN ("fset", Ffset, Sfset, 2, 2, 0,
628 629 630
  "Set SYMBOL's function definition to DEFINITION, and return DEFINITION.")
  (symbol, definition)
     register Lisp_Object symbol, definition;
631 632 633 634 635 636
{
  CHECK_SYMBOL (symbol, 0);
  if (NILP (symbol) || EQ (symbol, Qt))
    return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
  if (!NILP (Vautoload_queue) && !EQ (XSYMBOL (symbol)->function, Qunbound))
    Vautoload_queue = Fcons (Fcons (symbol, XSYMBOL (symbol)->function),
Jim Blandy's avatar
Jim Blandy committed
637
			     Vautoload_queue);
638
  XSYMBOL (symbol)->function = definition;
639
  /* Handle automatic advice activation */
640
  if (CONSP (XSYMBOL (symbol)->plist) && !NILP (Fget (symbol, Qad_advice_info)))
641
    {
642
      call2 (Qad_activate, symbol, Qnil);
643
      definition = XSYMBOL (symbol)->function;
644
    }
645
  return definition;
Jim Blandy's avatar
Jim Blandy committed
646 647
}

648
DEFUN ("defalias", Fdefalias, Sdefalias, 2, 2, 0,
649
  "Set SYMBOL's function definition to DEFINITION, and return DEFINITION.\n\
650
Associates the function with the current load file, if any.")
651 652
  (symbol, definition)
     register Lisp_Object symbol, definition;
653
{
654 655 656
  CHECK_SYMBOL (symbol, 0);
  if (!NILP (Vautoload_queue) && !EQ (XSYMBOL (symbol)->function, Qunbound))
    Vautoload_queue = Fcons (Fcons (symbol, XSYMBOL (symbol)->function),
657
			     Vautoload_queue);
658
  XSYMBOL (symbol)->function = definition;
659
  /* Handle automatic advice activation */
660
  if (CONSP (XSYMBOL (symbol)->plist) && !NILP (Fget (symbol, Qad_advice_info)))
661
    {
662
      call2 (Qad_activate, symbol, Qnil);
663
      definition = XSYMBOL (symbol)->function;
664
    }
665
  LOADHIST_ATTACH (symbol);
666
  return definition;
667 668
}

Jim Blandy's avatar
Jim Blandy committed
669 670
DEFUN ("setplist", Fsetplist, Ssetplist, 2, 2, 0,
  "Set SYMBOL's property list to NEWVAL, and return NEWVAL.")
671 672
  (symbol, newplist)
     register Lisp_Object symbol, newplist;
Jim Blandy's avatar
Jim Blandy committed
673
{
674 675
  CHECK_SYMBOL (symbol, 0);
  XSYMBOL (symbol)->plist = newplist;
Jim Blandy's avatar
Jim Blandy committed
676 677
  return newplist;
}
Jim Blandy's avatar
Jim Blandy committed
678

Jim Blandy's avatar
Jim Blandy committed
679 680 681 682 683 684 685 686 687 688 689 690 691

/* Getting and setting values of symbols */

/* Given the raw contents of a symbol value cell,
   return the Lisp value of the symbol.
   This does not handle buffer-local variables; use
   swap_in_symval_forwarding for that.  */

Lisp_Object
do_symval_forwarding (valcontents)
     register Lisp_Object valcontents;
{
  register Lisp_Object val;
692 693
  int offset;
  if (MISCP (valcontents))
694
    switch (XMISCTYPE (valcontents))
695 696 697 698
      {
      case Lisp_Misc_Intfwd:
	XSETINT (val, *XINTFWD (valcontents)->intvar);
	return val;
Jim Blandy's avatar
Jim Blandy committed
699

700 701
      case Lisp_Misc_Boolfwd:
	return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
702

703 704
      case Lisp_Misc_Objfwd:
	return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
705

706 707 708
      case Lisp_Misc_Buffer_Objfwd:
	offset = XBUFFER_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_buffer);
709

710 711 712
      case Lisp_Misc_Kboard_Objfwd:
	offset = XKBOARD_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_kboard);
713
      }
Jim Blandy's avatar
Jim Blandy committed
714 715 716
  return valcontents;
}

717 718
/* Store NEWVAL into SYMBOL, where VALCONTENTS is found in the value cell
   of SYMBOL.  If SYMBOL is buffer-local, VALCONTENTS should be the
Jim Blandy's avatar
Jim Blandy committed
719 720 721 722
   buffer-independent contents of the value cell: forwarded just one
   step past the buffer-localness.  */

void
723 724
store_symval_forwarding (symbol, valcontents, newval)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
725 726
     register Lisp_Object valcontents, newval;
{
727
  switch (SWITCH_ENUM_CAST (XTYPE (valcontents)))
Jim Blandy's avatar
Jim Blandy committed
728
    {
729
    case Lisp_Misc:
730
      switch (XMISCTYPE (valcontents))
731 732 733 734
	{
	case Lisp_Misc_Intfwd:
	  CHECK_NUMBER (newval, 1);
	  *XINTFWD (valcontents)->intvar = XINT (newval);
735 736
	  if (*XINTFWD (valcontents)->intvar != XINT (newval))
	    error ("Value out of range for variable `%s'",
737
		   XSYMBOL (symbol)->name->data);
738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759
	  break;

	case Lisp_Misc_Boolfwd:
	  *XBOOLFWD (valcontents)->boolvar = NILP (newval) ? 0 : 1;
	  break;

	case Lisp_Misc_Objfwd:
	  *XOBJFWD (valcontents)->objvar = newval;
	  break;

	case Lisp_Misc_Buffer_Objfwd:
	  {
	    int offset = XBUFFER_OBJFWD (valcontents)->offset;
	    Lisp_Object type;

	    type = *(Lisp_Object *)(offset + (char *)&buffer_local_types);
	    if (! NILP (type) && ! NILP (newval)
		&& XTYPE (newval) != XINT (type))
	      buffer_slot_type_mismatch (offset);

	    *(Lisp_Object *)(offset + (char *)current_buffer) = newval;
	  }
760 761
	  break;

762 763 764
	case Lisp_Misc_Kboard_Objfwd:
	  (*(Lisp_Object *)((char *)current_kboard
			    + XKBOARD_OBJFWD (valcontents)->offset))
765 766 767
	    = newval;
	  break;

768 769 770
	default:
	  goto def;
	}
Jim Blandy's avatar
Jim Blandy committed
771 772 773
      break;

    default:
774
    def:
775
      valcontents = XSYMBOL (symbol)->value;
776 777
      if (BUFFER_LOCAL_VALUEP (valcontents)
	  || SOME_BUFFER_LOCAL_VALUEP (valcontents))
778
	XBUFFER_LOCAL_VALUE (valcontents)->car = newval;
Jim Blandy's avatar
Jim Blandy committed
779
      else
780
	XSYMBOL (symbol)->value = newval;
Jim Blandy's avatar
Jim Blandy committed
781 782 783
    }
}

784
/* Set up the buffer-local symbol SYMBOL for validity in the current
Jim Blandy's avatar
Jim Blandy committed
785 786 787 788
   buffer.  VALCONTENTS is the contents of its value cell.
   Return the value forwarded one step past the buffer-local indicator.  */

static Lisp_Object
789 790
swap_in_symval_forwarding (symbol, valcontents)
     Lisp_Object symbol, valcontents;
Jim Blandy's avatar
Jim Blandy committed
791
{
792
  /* valcontents is a pointer to a struct resembling the cons
Jim Blandy's avatar
Jim Blandy committed
793
     (REALVALUE BUFFER CURRENT-ALIST-ELEMENT . DEFAULT-VALUE)).
794

Jim Blandy's avatar
Jim Blandy committed
795
     CURRENT-ALIST-ELEMENT is a pointer to an element of BUFFER's
796 797 798 799 800 801 802 803 804 805 806
     local_var_alist, that being the element whose car is this
     variable.  Or it can be a pointer to the
     (CURRENT-ALIST-ELEMENT . DEFAULT-VALUE), if BUFFER does not have
     an element in its alist for this variable.

     If the current buffer is not BUFFER, we store the current
     REALVALUE value into CURRENT-ALIST-ELEMENT, then find the
     appropriate alist element for the buffer now current and set up
     CURRENT-ALIST-ELEMENT.  Then we set REALVALUE out of that
     element, and store into BUFFER.

Jim Blandy's avatar
Jim Blandy committed
807 808 809
     Note that REALVALUE can be a forwarding pointer. */

  register Lisp_Object tem1;
810
  tem1 = XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->car;
Jim Blandy's avatar
Jim Blandy committed
811

Jim Blandy's avatar
Jim Blandy committed
812
  if (NILP (tem1) || current_buffer != XBUFFER (tem1))
Jim Blandy's avatar
Jim Blandy committed
813
    {
814 815 816
      tem1 = XCONS (XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->cdr)->car;
      Fsetcdr (tem1,
	       do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->car));
817
      tem1 = assq_no_quit (symbol, current_buffer->local_var_alist);
Jim Blandy's avatar
Jim Blandy committed
818
      if (NILP (tem1))
819 820 821 822
	tem1 = XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->cdr;
      XCONS (XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->cdr)->car = tem1;
      XSETBUFFER (XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->car,
		  current_buffer);
823
      store_symval_forwarding (symbol, XBUFFER_LOCAL_VALUE (valcontents)->car,
824
			       Fcdr (tem1));
Jim Blandy's avatar
Jim Blandy committed
825
    }
826
  return XBUFFER_LOCAL_VALUE (valcontents)->car;
Jim Blandy's avatar
Jim Blandy committed
827 828
}

Jim Blandy's avatar
Jim Blandy committed
829 830
/* Find the value of a symbol, returning Qunbound if it's not bound.
   This is helpful for code which just wants to get a variable's value
Karl Heuer's avatar
Karl Heuer committed
831
   if it has one, without signaling an error.
Jim Blandy's avatar
Jim Blandy committed
832 833
   Note that it must not be possible to quit
   within this function.  Great care is required for this.  */
Jim Blandy's avatar
Jim Blandy committed
834

Jim Blandy's avatar
Jim Blandy committed
835
Lisp_Object
836 837
find_symbol_value (symbol)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
838 839 840
{
  register Lisp_Object valcontents, tem1;
  register Lisp_Object val;
841 842
  CHECK_SYMBOL (symbol, 0);
  valcontents = XSYMBOL (symbol)->value;
Jim Blandy's avatar
Jim Blandy committed
843

Karl Heuer's avatar
Karl Heuer committed
844 845
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
846
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
847

848 849
  if (MISCP (valcontents))
    {
850
      switch (XMISCTYPE (valcontents))
851 852 853 854
	{
	case Lisp_Misc_Intfwd:
	  XSETINT (val, *XINTFWD (valcontents)->intvar);
	  return val;
Jim Blandy's avatar
Jim Blandy committed
855

856 857
	case Lisp_Misc_Boolfwd:
	  return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
858

859 860
	case Lisp_Misc_Objfwd:
	  return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
861

862 863 864
	case Lisp_Misc_Buffer_Objfwd:
	  return *(Lisp_Object *)(XBUFFER_OBJFWD (valcontents)->offset
				  + (char *)current_buffer);
865

866 867 868
	case Lisp_Misc_Kboard_Objfwd:
	  return *(Lisp_Object *)(XKBOARD_OBJFWD (valcontents)->offset
				  + (char *)current_kboard);
869
	}
Jim Blandy's avatar
Jim Blandy committed
870 871 872 873 874
    }

  return valcontents;
}

Jim Blandy's avatar
Jim Blandy committed
875 876
DEFUN ("symbol-value", Fsymbol_value, Ssymbol_value, 1, 1, 0,
  "Return SYMBOL's value.  Error if that is void.")
877 878
  (symbol)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
879
{
880
  Lisp_Object val;
Jim Blandy's avatar
Jim Blandy committed
881

882
  val = find_symbol_value (symbol);
Jim Blandy's avatar
Jim Blandy committed
883
  if (EQ (val, Qunbound))
884
    return Fsignal (Qvoid_variable, Fcons (symbol, Qnil));
Jim Blandy's avatar
Jim Blandy committed
885 886 887 888
  else
    return val;
}

Jim Blandy's avatar
Jim Blandy committed
889 890
DEFUN ("set", Fset, Sset, 2, 2, 0,
  "Set SYMBOL's value to NEWVAL, and return NEWVAL.")
891 892
  (symbol, newval)
     register Lisp_Object symbol, newval;
Jim Blandy's avatar
Jim Blandy committed
893
{
894
  int voide = EQ (newval, Qunbound);
Jim Blandy's avatar
Jim Blandy committed
895 896 897

  register Lisp_Object valcontents, tem1, current_alist_element;

898 899 900 901
  CHECK_SYMBOL (symbol, 0);
  if (NILP (symbol) || EQ (symbol, Qt))
    return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
  valcontents = XSYMBOL (symbol)->value;
Jim Blandy's avatar
Jim Blandy committed
902

903
  if (BUFFER_OBJFWDP (valcontents))
Jim Blandy's avatar
Jim Blandy committed
904
    {
905
      register int idx = XBUFFER_OBJFWD (valcontents)->offset;
906 907
      register int mask = XINT (*((Lisp_Object *)
				  (idx + (char *)&buffer_local_flags)));
Jim Blandy's avatar
Jim Blandy committed
908 909 910 911
      if (mask > 0)
	current_buffer->local_var_flags |= mask;
    }

912 913
  else if (BUFFER_LOCAL_VALUEP (valcontents)
	   || SOME_BUFFER_LOCAL_VALUEP (valcontents))
Jim Blandy's avatar
Jim Blandy committed
914
    {
915 916
      /* valcontents is actually a pointer to a struct resembling a cons,
	 with contents something like:
Jim Blandy's avatar
Jim Blandy committed
917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944
	 (REALVALUE BUFFER CURRENT-ALIST-ELEMENT . DEFAULT-VALUE).

	 BUFFER is the last buffer for which this symbol's value was
	 made up to date.

	 CURRENT-ALIST-ELEMENT is a pointer to an element of BUFFER's
	 local_var_alist, that being the element whose car is this
	 variable.  Or it can be a pointer to the
	 (CURRENT-ALIST-ELEMENT . DEFAULT-VALUE), if BUFFER does not
	 have an element in its alist for this variable (that is, if
	 BUFFER sees the default value of this variable).

	 If we want to examine or set the value and BUFFER is current,
	 we just examine or set REALVALUE. If BUFFER is not current, we
	 store the current REALVALUE value into CURRENT-ALIST-ELEMENT,
	 then find the appropriate alist element for the buffer now
	 current and set up CURRENT-ALIST-ELEMENT.  Then we set
	 REALVALUE out of that element, and store into BUFFER.

	 If we are setting the variable and the current buffer does
	 not have an alist entry for this variable, an alist entry is
	 created.

	 Note that REALVALUE can be a forwarding pointer.  Each time
	 it is examined or set, forwarding must be done.  */

      /* What value are we caching right now?  */
      current_alist_element =
945
	XCONS (XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->cdr)->car;
Jim Blandy's avatar
Jim Blandy committed
946 947 948 949 950 951

      /* If the current buffer is not the buffer whose binding is
	 currently cached, or if it's a Lisp_Buffer_Local_Value and
	 we're looking at the default value, the cache is invalid; we
	 need to write it out, and find the new CURRENT-ALIST-ELEMENT.  */
      if ((current_buffer
952
	   != XBUFFER (XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->car))
953
	  || (BUFFER_LOCAL_VALUEP (valcontents)
954 955
	      && EQ (XCONS (current_alist_element)->car,
		     current_alist_element)))
Jim Blandy's avatar
Jim Blandy committed
956
	{
Jim Blandy's avatar
Jim Blandy committed
957 958 959 960
	  /* Write out the cached value for the old buffer; copy it
	     back to its alist element.  This works if the current
	     buffer only sees the default value, too.  */
          Fsetcdr (current_alist_element,
961
		   do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->car));
Jim Blandy's avatar
Jim Blandy committed
962

Jim Blandy's avatar
Jim Blandy committed
963
	  /* Find the new value for CURRENT-ALIST-ELEMENT.  */