data.c 75.8 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"
Karl Heuer's avatar
Karl Heuer committed
27
#include "charset.h"
Jim Blandy's avatar
Jim Blandy committed
28 29 30

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

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

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

38
#ifdef STDC_HEADERS
39
#include <float.h>
40 41
#include <stdlib.h>
#endif
42

43 44 45 46 47 48 49 50 51 52
/* If IEEE_FLOATING_POINT isn't defined, default it from FLT_*. */
#ifndef IEEE_FLOATING_POINT
#if (FLT_RADIX == 2 && FLT_MANT_DIG == 24 \
     && FLT_MIN_EXP == -125 && FLT_MAX_EXP == 128)
#define IEEE_FLOATING_POINT 1
#else
#define IEEE_FLOATING_POINT 0
#endif
#endif

53 54 55 56 57 58 59 60 61 62
/* 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
63 64 65
#include <math.h>
#endif /* LISP_FLOAT_TYPE */

66 67 68 69
#if !defined (atof)
extern double atof ();
#endif /* !atof */

Jim Blandy's avatar
Jim Blandy committed
70 71 72
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
73
Lisp_Object Qvoid_variable, Qvoid_function, Qcyclic_function_indirection;
Jim Blandy's avatar
Jim Blandy committed
74 75
Lisp_Object Qsetting_constant, Qinvalid_read_syntax;
Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch;
Roland McGrath's avatar
Roland McGrath committed
76
Lisp_Object Qend_of_file, Qarith_error, Qmark_inactive;
Jim Blandy's avatar
Jim Blandy committed
77
Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_read_only;
78
Lisp_Object Qintegerp, Qnatnump, Qwholenump, Qsymbolp, Qlistp, Qconsp;
Jim Blandy's avatar
Jim Blandy committed
79 80
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
81
Lisp_Object Qbuffer_or_string_p;
Jim Blandy's avatar
Jim Blandy committed
82
Lisp_Object Qboundp, Qfboundp;
83
Lisp_Object Qchar_table_p, Qvector_or_char_table_p;
84

Jim Blandy's avatar
Jim Blandy committed
85
Lisp_Object Qcdr;
86
Lisp_Object Qad_advice_info, Qad_activate;
Jim Blandy's avatar
Jim Blandy committed
87

88 89 90
Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
Lisp_Object Qoverflow_error, Qunderflow_error;

Jim Blandy's avatar
Jim Blandy committed
91
#ifdef LISP_FLOAT_TYPE
92
Lisp_Object Qfloatp;
Jim Blandy's avatar
Jim Blandy committed
93 94 95
Lisp_Object Qnumberp, Qnumber_or_marker_p;
#endif

96
static Lisp_Object Qinteger, Qsymbol, Qstring, Qcons, Qmarker, Qoverlay;
Karl Heuer's avatar
Karl Heuer committed
97 98
static Lisp_Object Qfloat, Qwindow_configuration, Qwindow;
Lisp_Object Qprocess;
99
static Lisp_Object Qcompiled_function, Qbuffer, Qframe, Qvector;
100
static Lisp_Object Qchar_table, Qbool_vector;
101

Jim Blandy's avatar
Jim Blandy committed
102 103
static Lisp_Object swap_in_symval_forwarding ();

104 105
Lisp_Object set_internal ();

Jim Blandy's avatar
Jim Blandy committed
106 107 108 109 110 111 112 113 114
Lisp_Object
wrong_type_argument (predicate, value)
     register Lisp_Object predicate, value;
{
  register Lisp_Object tem;
  do
    {
      if (!EQ (Vmocklisp_arguments, Qt))
	{
115
	 if (STRINGP (value) &&
Jim Blandy's avatar
Jim Blandy committed
116
	     (EQ (predicate, Qintegerp) || EQ (predicate, Qinteger_or_marker_p)))
117
	   return Fstring_to_number (value, Qnil);
118
	 if (INTEGERP (value) && EQ (predicate, Qstringp))
119
	   return Fnumber_to_string (value);
Jim Blandy's avatar
Jim Blandy committed
120
	}
121 122 123

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

Jim Blandy's avatar
Jim Blandy committed
127 128 129
      value = Fsignal (Qwrong_type_argument, Fcons (predicate, Fcons (value, Qnil)));
      tem = call1 (predicate, value);
    }
Jim Blandy's avatar
Jim Blandy committed
130
  while (NILP (tem));
Jim Blandy's avatar
Jim Blandy committed
131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163
  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)
164
     EMACS_INT num;
Jim Blandy's avatar
Jim Blandy committed
165
{
166 167
  if (num & (((EMACS_INT) 1) << (VALBITS - 1)))
    return num | (((EMACS_INT) (-1)) << VALBITS);
Jim Blandy's avatar
Jim Blandy committed
168
  else
169
    return num & ((((EMACS_INT) 1) << VALBITS) - 1);
Jim Blandy's avatar
Jim Blandy committed
170 171 172 173 174 175 176 177 178 179 180 181 182 183 184
}

/* 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.")
185 186
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
187
{
188
  if (NILP (object))
Jim Blandy's avatar
Jim Blandy committed
189 190 191 192
    return Qt;
  return Qnil;
}

193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214
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:
215
      switch (XMISCTYPE (object))
216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238
	{
	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;
239 240 241 242
      if (GC_CHAR_TABLE_P (object))
	return Qchar_table;
      if (GC_BOOL_VECTOR_P (object))
	return Qbool_vector;
243 244 245 246 247 248 249 250 251 252 253 254 255 256
      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
257
DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0, "T if OBJECT is a cons cell.")
258 259
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
260
{
261
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
262 263 264 265 266
    return Qt;
  return Qnil;
}

DEFUN ("atom", Fatom, Satom, 1, 1, 0, "T if OBJECT is not a cons cell.  This includes nil.")
267 268
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
269
{
270
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
271 272 273 274 275
    return Qnil;
  return Qt;
}

DEFUN ("listp", Flistp, Slistp, 1, 1, 0, "T if OBJECT is a list.  This includes nil.")
276 277
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
278
{
279
  if (CONSP (object) || NILP (object))
Jim Blandy's avatar
Jim Blandy committed
280 281 282 283 284
    return Qt;
  return Qnil;
}

DEFUN ("nlistp", Fnlistp, Snlistp, 1, 1, 0, "T if OBJECT is not a list.  Lists include nil.")
285 286
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
287
{
288
  if (CONSP (object) || NILP (object))
Jim Blandy's avatar
Jim Blandy committed
289 290 291 292 293
    return Qnil;
  return Qt;
}

DEFUN ("symbolp", Fsymbolp, Ssymbolp, 1, 1, 0, "T if OBJECT is a symbol.")
294 295
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
296
{
297
  if (SYMBOLP (object))
Jim Blandy's avatar
Jim Blandy committed
298 299 300 301 302
    return Qt;
  return Qnil;
}

DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0, "T if OBJECT is a vector.")
303 304
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
305
{
306
  if (VECTORP (object))
Jim Blandy's avatar
Jim Blandy committed
307 308 309 310 311
    return Qt;
  return Qnil;
}

DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0, "T if OBJECT is a string.")
312 313
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
314
{
315
  if (STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
316 317 318 319
    return Qt;
  return Qnil;
}

320 321 322 323 324 325 326 327 328
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;
}

329 330 331 332 333 334 335 336 337 338 339
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;
}

340 341 342 343 344 345 346 347 348
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
349
DEFUN ("arrayp", Farrayp, Sarrayp, 1, 1, 0, "T if OBJECT is an array (string or vector).")
350 351
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
352
{
353
  if (VECTORP (object) || STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
354 355 356 357 358 359
    return Qt;
  return Qnil;
}

DEFUN ("sequencep", Fsequencep, Ssequencep, 1, 1, 0,
  "T if OBJECT is a sequence (list or array).")
360 361
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
362
{
363 364
  if (CONSP (object) || NILP (object) || VECTORP (object) || STRINGP (object)
      || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
Jim Blandy's avatar
Jim Blandy committed
365 366 367 368 369
    return Qt;
  return Qnil;
}

DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0, "T if OBJECT is an editor buffer.")
370 371
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
372
{
373
  if (BUFFERP (object))
Jim Blandy's avatar
Jim Blandy committed
374 375 376 377 378
    return Qt;
  return Qnil;
}

DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0, "T if OBJECT is a marker (editor pointer).")
379 380
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
381
{
382
  if (MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
383 384 385 386 387
    return Qt;
  return Qnil;
}

DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0, "T if OBJECT is a built-in function.")
388 389
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
390
{
391
  if (SUBRP (object))
Jim Blandy's avatar
Jim Blandy committed
392 393 394 395
    return Qt;
  return Qnil;
}

Jim Blandy's avatar
Jim Blandy committed
396 397
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.")
398 399
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
400
{
401
  if (COMPILEDP (object))
Jim Blandy's avatar
Jim Blandy committed
402 403 404 405
    return Qt;
  return Qnil;
}

406 407
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.")
408 409
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
410
{
411
  if (INTEGERP (object) || STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
412 413 414 415
    return Qt;
  return Qnil;
}

416
DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0, "T if OBJECT is an integer.")
417 418
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
419
{
420
  if (INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
421 422 423 424
    return Qt;
  return Qnil;
}

425 426
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).")
427 428
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
429
{
430
  if (MARKERP (object) || INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
431 432 433 434
    return Qt;
  return Qnil;
}

435 436
DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0,
  "T if OBJECT is a nonnegative integer.")
437 438
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
439
{
440
  if (NATNUMP (object))
Jim Blandy's avatar
Jim Blandy committed
441 442 443 444 445 446
    return Qt;
  return Qnil;
}

DEFUN ("numberp", Fnumberp, Snumberp, 1, 1, 0,
       "T if OBJECT is a number (floating point or integer).")
447 448
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
449
{
450
  if (NUMBERP (object))
Jim Blandy's avatar
Jim Blandy committed
451
    return Qt;
Jim Blandy's avatar
Jim Blandy committed
452 453
  else
    return Qnil;
Jim Blandy's avatar
Jim Blandy committed
454 455 456 457 458
}

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.")
459 460
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
461
{
462
  if (NUMBERP (object) || MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
463 464 465
    return Qt;
  return Qnil;
}
466 467 468 469

#ifdef LISP_FLOAT_TYPE
DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
       "T if OBJECT is a floating point number.")
470 471
  (object)
     Lisp_Object object;
472
{
473
  if (FLOATP (object))
474 475 476
    return Qt;
  return Qnil;
}
Jim Blandy's avatar
Jim Blandy committed
477 478 479 480 481
#endif /* LISP_FLOAT_TYPE */

/* Extract and set components of lists */

DEFUN ("car", Fcar, Scar, 1, 1, 0,
482
  "Return the car of LIST.  If arg is nil, return nil.\n\
Jim Blandy's avatar
Jim Blandy committed
483 484 485 486 487 488
Error if arg is not nil and not a cons cell.  See also `car-safe'.")
  (list)
     register Lisp_Object list;
{
  while (1)
    {
489
      if (CONSP (list))
Jim Blandy's avatar
Jim Blandy committed
490 491 492 493 494 495 496 497 498 499 500 501 502
	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;
{
503
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
504 505 506 507 508 509
    return XCONS (object)->car;
  else
    return Qnil;
}

DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
510
  "Return the cdr of LIST.  If arg is nil, return nil.\n\
Jim Blandy's avatar
Jim Blandy committed
511 512 513 514 515 516 517
Error if arg is not nil and not a cons cell.  See also `cdr-safe'.")

  (list)
     register Lisp_Object list;
{
  while (1)
    {
518
      if (CONSP (list))
Jim Blandy's avatar
Jim Blandy committed
519 520 521 522 523 524 525 526 527
	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,
528
  "Return the cdr of OBJECT if it is a cons cell, or else nil.")
Jim Blandy's avatar
Jim Blandy committed
529 530 531
  (object)
     Lisp_Object object;
{
532
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
533 534 535 536 537 538
    return XCONS (object)->cdr;
  else
    return Qnil;
}

DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0,
539
  "Set the car of CELL to be NEWCAR.  Returns NEWCAR.")
Jim Blandy's avatar
Jim Blandy committed
540 541 542
  (cell, newcar)
     register Lisp_Object cell, newcar;
{
543
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
544 545 546 547 548 549 550 551
    cell = wrong_type_argument (Qconsp, cell);

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

DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
552
  "Set the cdr of CELL to be NEWCDR.  Returns NEWCDR.")
Jim Blandy's avatar
Jim Blandy committed
553 554 555
  (cell, newcdr)
     register Lisp_Object cell, newcdr;
{
556
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
557 558 559 560 561 562 563 564 565 566
    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.")
567 568
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
569 570
{
  Lisp_Object valcontents;
571
  CHECK_SYMBOL (symbol, 0);
Jim Blandy's avatar
Jim Blandy committed
572

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

Karl Heuer's avatar
Karl Heuer committed
575 576
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
577
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
578

579
  return (EQ (valcontents, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
580 581 582
}

DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0, "T if SYMBOL's function definition is not void.")
583 584
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
585
{
586 587
  CHECK_SYMBOL (symbol, 0);
  return (EQ (XSYMBOL (symbol)->function, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
588 589 590
}

DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0, "Make SYMBOL's value be void.")
591 592
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
593
{
594 595 596 597 598
  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
599 600 601
}

DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0, "Make SYMBOL's function definition be void.")
602 603
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
604
{
605 606 607 608 609
  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
610 611 612 613
}

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
614 615
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
616
{
Jim Blandy's avatar
Jim Blandy committed
617 618 619 620
  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
621 622 623
}

DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0, "Return SYMBOL's property list.")
624 625
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
626
{
627 628
  CHECK_SYMBOL (symbol, 0);
  return XSYMBOL (symbol)->plist;
Jim Blandy's avatar
Jim Blandy committed
629 630 631
}

DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0, "Return SYMBOL's name, a string.")
632 633
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
634 635 636
{
  register Lisp_Object name;

637 638
  CHECK_SYMBOL (symbol, 0);
  XSETSTRING (name, XSYMBOL (symbol)->name);
Jim Blandy's avatar
Jim Blandy committed
639 640 641 642
  return name;
}

DEFUN ("fset", Ffset, Sfset, 2, 2, 0,
643 644 645
  "Set SYMBOL's function definition to DEFINITION, and return DEFINITION.")
  (symbol, definition)
     register Lisp_Object symbol, definition;
646 647 648 649 650 651
{
  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
652
			     Vautoload_queue);
653
  XSYMBOL (symbol)->function = definition;
654
  /* Handle automatic advice activation */
655
  if (CONSP (XSYMBOL (symbol)->plist) && !NILP (Fget (symbol, Qad_advice_info)))
656
    {
657
      call2 (Qad_activate, symbol, Qnil);
658
      definition = XSYMBOL (symbol)->function;
659
    }
660
  return definition;
Jim Blandy's avatar
Jim Blandy committed
661 662
}

663
DEFUN ("defalias", Fdefalias, Sdefalias, 2, 2, 0,
664
  "Set SYMBOL's function definition to DEFINITION, and return DEFINITION.\n\
665
Associates the function with the current load file, if any.")
666 667
  (symbol, definition)
     register Lisp_Object symbol, definition;
668
{
669 670 671
  CHECK_SYMBOL (symbol, 0);
  if (!NILP (Vautoload_queue) && !EQ (XSYMBOL (symbol)->function, Qunbound))
    Vautoload_queue = Fcons (Fcons (symbol, XSYMBOL (symbol)->function),
672
			     Vautoload_queue);
673
  XSYMBOL (symbol)->function = definition;
674
  /* Handle automatic advice activation */
675
  if (CONSP (XSYMBOL (symbol)->plist) && !NILP (Fget (symbol, Qad_advice_info)))
676
    {
677
      call2 (Qad_activate, symbol, Qnil);
678
      definition = XSYMBOL (symbol)->function;
679
    }
680
  LOADHIST_ATTACH (symbol);
681
  return definition;
682 683
}

Jim Blandy's avatar
Jim Blandy committed
684 685
DEFUN ("setplist", Fsetplist, Ssetplist, 2, 2, 0,
  "Set SYMBOL's property list to NEWVAL, and return NEWVAL.")
686 687
  (symbol, newplist)
     register Lisp_Object symbol, newplist;
Jim Blandy's avatar
Jim Blandy committed
688
{
689 690
  CHECK_SYMBOL (symbol, 0);
  XSYMBOL (symbol)->plist = newplist;
Jim Blandy's avatar
Jim Blandy committed
691 692
  return newplist;
}
Jim Blandy's avatar
Jim Blandy committed
693

Jim Blandy's avatar
Jim Blandy committed
694 695 696 697 698 699 700 701 702 703 704 705 706

/* 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;
707 708
  int offset;
  if (MISCP (valcontents))
709
    switch (XMISCTYPE (valcontents))
710 711 712 713
      {
      case Lisp_Misc_Intfwd:
	XSETINT (val, *XINTFWD (valcontents)->intvar);
	return val;
Jim Blandy's avatar
Jim Blandy committed
714

715 716
      case Lisp_Misc_Boolfwd:
	return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
717

718 719
      case Lisp_Misc_Objfwd:
	return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
720

721 722 723
      case Lisp_Misc_Buffer_Objfwd:
	offset = XBUFFER_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_buffer);
724

725 726 727
      case Lisp_Misc_Kboard_Objfwd:
	offset = XKBOARD_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_kboard);
728
      }
Jim Blandy's avatar
Jim Blandy committed
729 730 731
  return valcontents;
}

732 733
/* 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
734 735 736 737
   buffer-independent contents of the value cell: forwarded just one
   step past the buffer-localness.  */

void
738 739
store_symval_forwarding (symbol, valcontents, newval)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
740 741
     register Lisp_Object valcontents, newval;
{
742
  switch (SWITCH_ENUM_CAST (XTYPE (valcontents)))
Jim Blandy's avatar
Jim Blandy committed
743
    {
744
    case Lisp_Misc:
745
      switch (XMISCTYPE (valcontents))
746 747 748 749
	{
	case Lisp_Misc_Intfwd:
	  CHECK_NUMBER (newval, 1);
	  *XINTFWD (valcontents)->intvar = XINT (newval);
750 751
	  if (*XINTFWD (valcontents)->intvar != XINT (newval))
	    error ("Value out of range for variable `%s'",
752
		   XSYMBOL (symbol)->name->data);
753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774
	  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;
	  }
775 776
	  break;

777 778 779
	case Lisp_Misc_Kboard_Objfwd:
	  (*(Lisp_Object *)((char *)current_kboard
			    + XKBOARD_OBJFWD (valcontents)->offset))
780 781 782
	    = newval;
	  break;

783 784 785
	default:
	  goto def;
	}
Jim Blandy's avatar
Jim Blandy committed
786 787 788
      break;

    default:
789
    def:
790
      valcontents = XSYMBOL (symbol)->value;
791 792
      if (BUFFER_LOCAL_VALUEP (valcontents)
	  || SOME_BUFFER_LOCAL_VALUEP (valcontents))
793
	XBUFFER_LOCAL_VALUE (valcontents)->car = newval;
Jim Blandy's avatar
Jim Blandy committed
794
      else
795
	XSYMBOL (symbol)->value = newval;
Jim Blandy's avatar
Jim Blandy committed
796 797 798
    }
}

799
/* Set up the buffer-local symbol SYMBOL for validity in the current
Jim Blandy's avatar
Jim Blandy committed
800 801 802 803
   buffer.  VALCONTENTS is the contents of its value cell.
   Return the value forwarded one step past the buffer-local indicator.  */

static Lisp_Object
804 805
swap_in_symval_forwarding (symbol, valcontents)
     Lisp_Object symbol, valcontents;
Jim Blandy's avatar
Jim Blandy committed
806
{
807
  /* valcontents is a pointer to a struct resembling the cons
Jim Blandy's avatar
Jim Blandy committed
808
     (REALVALUE BUFFER CURRENT-ALIST-ELEMENT . DEFAULT-VALUE)).
809

Jim Blandy's avatar
Jim Blandy committed
810
     CURRENT-ALIST-ELEMENT is a pointer to an element of BUFFER's
811 812 813 814 815 816 817 818 819 820 821
     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
822 823 824
     Note that REALVALUE can be a forwarding pointer. */

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

Jim Blandy's avatar
Jim Blandy committed
827
  if (NILP (tem1) || current_buffer != XBUFFER (tem1))
Jim Blandy's avatar
Jim Blandy committed
828
    {
829 830 831
      tem1 = XCONS (XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->cdr)->car;
      Fsetcdr (tem1,
	       do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->car));
832
      tem1 = assq_no_quit (symbol, current_buffer->local_var_alist);
Jim Blandy's avatar
Jim Blandy committed
833
      if (NILP (tem1))
834 835 836 837
	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);
838
      store_symval_forwarding (symbol, XBUFFER_LOCAL_VALUE (valcontents)->car,
839
			       Fcdr (tem1));
Jim Blandy's avatar
Jim Blandy committed
840
    }
841
  return XBUFFER_LOCAL_VALUE (valcontents)->car;
Jim Blandy's avatar
Jim Blandy committed
842 843
}

Jim Blandy's avatar
Jim Blandy committed
844 845
/* 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
846
   if it has one, without signaling an error.
Jim Blandy's avatar
Jim Blandy committed
847 848
   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
849

Jim Blandy's avatar
Jim Blandy committed
850
Lisp_Object
851 852
find_symbol_value (symbol)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
853 854 855
{
  register Lisp_Object valcontents, tem1;
  register Lisp_Object val;
856 857
  CHECK_SYMBOL (symbol, 0);
  valcontents = XSYMBOL (symbol)->value;
Jim Blandy's avatar
Jim Blandy committed
858

Karl Heuer's avatar
Karl Heuer committed
859 860
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
861
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
862

863 864
  if (MISCP (valcontents))
    {
865
      switch (XMISCTYPE (valcontents))
866 867 868 869
	{
	case Lisp_Misc_Intfwd:
	  XSETINT (val, *XINTFWD (valcontents)->intvar);
	  return val;
Jim Blandy's avatar
Jim Blandy committed
870

871 872
	case Lisp_Misc_Boolfwd:
	  return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
873

874 875
	case Lisp_Misc_Objfwd:
	  return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
876

877 878 879
	case Lisp_Misc_Buffer_Objfwd:
	  return *(Lisp_Object *)(XBUFFER_OBJFWD (valcontents)->offset
				  + (char *)current_buffer);
880

881 882 883
	case Lisp_Misc_Kboard_Objfwd:
	  return *(Lisp_Object *)(XKBOARD_OBJFWD (valcontents)->offset
				  + (char *)current_kboard);
884
	}
Jim Blandy's avatar
Jim Blandy committed
885 886 887 888 889
    }

  return valcontents;
}

Jim Blandy's avatar
Jim Blandy committed
890 891
DEFUN ("symbol-value", Fsymbol_value, Ssymbol_value, 1, 1, 0,
  "Return SYMBOL's value.  Error if that is void.")
892 893
  (symbol)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
894
{
895
  Lisp_Object val;
Jim Blandy's avatar
Jim Blandy committed
896

897
  val = find_symbol_value (symbol);
Jim Blandy's avatar
Jim Blandy committed
898
  if (EQ (val, Qunbound))
899
    return Fsignal (Qvoid_variable, Fcons (symbol, Qnil));
Jim Blandy's avatar
Jim Blandy committed
900 901 902 903
  else
    return val;
}

Jim Blandy's avatar
Jim Blandy committed
904 905
DEFUN ("set", Fset, Sset, 2, 2, 0,
  "Set SYMBOL's value to NEWVAL, and return NEWVAL.")
906 907
  (symbol, newval)
     register Lisp_Object symbol, newval;
908 909 910 911 912 913 914 915 916 917 918 919 920
{
  return set_internal (symbol, newval, 0);
}

/* Stpre the value NEWVAL into SYMBOL.
   If BINDFLAG is zero, then if this symbol is supposed to become
   local in every buffer where it is set, then we make it local.
   If BINDFLAG is nonzero, we don't do that.  */

Lisp_Object
set_internal (symbol, newval, bindflag)
     register Lisp_Object symbol, newval;
     int bindflag;
Jim Blandy's avatar
Jim Blandy committed
921
{
922
  int voide = EQ (newval, Qunbound);
Jim Blandy's avatar
Jim Blandy committed
923 924 925

  register Lisp_Object valcontents, tem1, current_alist_element;

926 927 928 929
  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
930

931
  if (BUFFER_OBJFWDP (valcontents))
Jim Blandy's avatar
Jim Blandy committed
932
    {
933
      register int idx = XBUFFER_OBJFWD (valcontents)->offset;
934 935
      register int mask = XINT (*((Lisp_Object *)
				  (idx + (char *)&buffer_local_flags)));
Jim Blandy's avatar
Jim Blandy committed
936 937 938 939
      if (mask > 0)
	current_buffer->local_var_flags |= mask;
    }

940 941
  else if (BUFFER_LOCAL_VALUEP (valcontents)
	   || SOME_BUFFER_LOCAL_VALUEP (valcontents))
Jim Blandy's avatar
Jim Blandy committed
942
    {
943 944
      /* valcontents is actually a pointer to a struct resembling a cons,
	 with contents something like:
Jim Blandy's avatar
Jim Blandy committed
945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972
	 (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