data.c 77.5 KB
Newer Older
Jim Blandy's avatar
Jim Blandy committed
1
/* Primitive operations on Lisp data types for GNU Emacs Lisp interpreter.
Richard M. Stallman's avatar
Richard M. Stallman committed
2
   Copyright (C) 1985,86,88,93,94,95,97, 1998 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 39
#ifdef STDC_HEADERS
#include <stdlib.h>
40
#include <float.h>
41
#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
}

/* Data type predicates */

DEFUN ("eq", Feq, Seq, 2, 2, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
175
  "Return t if the two args are the same Lisp object.")
Jim Blandy's avatar
Jim Blandy committed
176 177 178 179 180 181 182 183
  (obj1, obj2)
     Lisp_Object obj1, obj2;
{
  if (EQ (obj1, obj2))
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
184
DEFUN ("null", Fnull, Snull, 1, 1, 0, "Return 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 ();
    }
}

Richard M. Stallman's avatar
Richard M. Stallman committed
257
DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0, "Return 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
    return Qt;
  return Qnil;
}

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

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

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

306 307
DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0,
       "Return t if OBJECT is a vector.")
308 309
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
310
{
311
  if (VECTORP (object))
Jim Blandy's avatar
Jim Blandy committed
312 313 314 315
    return Qt;
  return Qnil;
}

316 317
DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0,
       "Return t if OBJECT is a string.")
318 319
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
320
{
321
  if (STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
322 323 324 325
    return Qt;
  return Qnil;
}

326 327 328 329 330 331 332 333 334 335 336 337
DEFUN ("multibyte-string-p", Fmultibyte_string_p, Smultibyte_string_p,
       1, 1, 0, "Return t if OBJECT is a multibyte string.")
  (object)
     Lisp_Object object;
{
  if (STRINGP (object) && STRING_MULTIBYTE (object))
    return Qt;
  return Qnil;
}

DEFUN ("char-table-p", Fchar_table_p, Schar_table_p, 1, 1, 0,
       "Return t if OBJECT is a char-table.")
338 339 340 341 342 343 344 345
  (object)
     Lisp_Object object;
{
  if (CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

346 347
DEFUN ("vector-or-char-table-p", Fvector_or_char_table_p,
       Svector_or_char_table_p, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
348
       "Return t if OBJECT is a char-table or vector.")
349 350 351 352 353 354 355 356
  (object)
     Lisp_Object object;
{
  if (VECTORP (object) || CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
357
DEFUN ("bool-vector-p", Fbool_vector_p, Sbool_vector_p, 1, 1, 0, "Return t if OBJECT is a bool-vector.")
358 359 360 361 362 363 364 365
  (object)
     Lisp_Object object;
{
  if (BOOL_VECTOR_P (object))
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
366
DEFUN ("arrayp", Farrayp, Sarrayp, 1, 1, 0, "Return t if OBJECT is an array (string or vector).")
367 368
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
369
{
370 371
  if (VECTORP (object) || STRINGP (object)
      || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
Jim Blandy's avatar
Jim Blandy committed
372 373 374 375 376
    return Qt;
  return Qnil;
}

DEFUN ("sequencep", Fsequencep, Ssequencep, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
377
  "Return t if OBJECT is a sequence (list or array).")
378 379
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
380
{
381 382
  if (CONSP (object) || NILP (object) || VECTORP (object) || STRINGP (object)
      || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
Jim Blandy's avatar
Jim Blandy committed
383 384 385 386
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
387
DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0, "Return t if OBJECT is an editor buffer.")
388 389
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
390
{
391
  if (BUFFERP (object))
Jim Blandy's avatar
Jim Blandy committed
392 393 394 395
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
396
DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0, "Return t if OBJECT is a marker (editor pointer).")
397 398
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
399
{
400
  if (MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
401 402 403 404
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
405
DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0, "Return t if OBJECT is a built-in function.")
406 407
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
408
{
409
  if (SUBRP (object))
Jim Blandy's avatar
Jim Blandy committed
410 411 412 413
    return Qt;
  return Qnil;
}

Jim Blandy's avatar
Jim Blandy committed
414
DEFUN ("byte-code-function-p", Fbyte_code_function_p, Sbyte_code_function_p,
Richard M. Stallman's avatar
Richard M. Stallman committed
415
       1, 1, 0, "Return t if OBJECT is a byte-compiled function object.")
416 417
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
418
{
419
  if (COMPILEDP (object))
Jim Blandy's avatar
Jim Blandy committed
420 421 422 423
    return Qt;
  return Qnil;
}

424
DEFUN ("char-or-string-p", Fchar_or_string_p, Schar_or_string_p, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
425
  "Return t if OBJECT is a character (an integer) or a string.")
426 427
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
428
{
429
  if (INTEGERP (object) || STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
430 431 432 433
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
434
DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0, "Return t if OBJECT is an integer.")
435 436
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
437
{
438
  if (INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
439 440 441 442
    return Qt;
  return Qnil;
}

443
DEFUN ("integer-or-marker-p", Finteger_or_marker_p, Sinteger_or_marker_p, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
444
  "Return t if OBJECT is an integer or a marker (editor pointer).")
445 446
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
447
{
448
  if (MARKERP (object) || INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
449 450 451 452
    return Qt;
  return Qnil;
}

453
DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
454
  "Return t if OBJECT is a nonnegative integer.")
455 456
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
457
{
458
  if (NATNUMP (object))
Jim Blandy's avatar
Jim Blandy committed
459 460 461 462 463
    return Qt;
  return Qnil;
}

DEFUN ("numberp", Fnumberp, Snumberp, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
464
       "Return t if OBJECT is a number (floating point or integer).")
465 466
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
467
{
468
  if (NUMBERP (object))
Jim Blandy's avatar
Jim Blandy committed
469
    return Qt;
Jim Blandy's avatar
Jim Blandy committed
470 471
  else
    return Qnil;
Jim Blandy's avatar
Jim Blandy committed
472 473 474 475
}

DEFUN ("number-or-marker-p", Fnumber_or_marker_p,
       Snumber_or_marker_p, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
476
       "Return t if OBJECT is a number or a marker.")
477 478
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
479
{
480
  if (NUMBERP (object) || MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
481 482 483
    return Qt;
  return Qnil;
}
484 485 486

#ifdef LISP_FLOAT_TYPE
DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
487
       "Return t if OBJECT is a floating point number.")
488 489
  (object)
     Lisp_Object object;
490
{
491
  if (FLOATP (object))
492 493 494
    return Qt;
  return Qnil;
}
Jim Blandy's avatar
Jim Blandy committed
495 496 497 498 499
#endif /* LISP_FLOAT_TYPE */

/* Extract and set components of lists */

DEFUN ("car", Fcar, Scar, 1, 1, 0,
500
  "Return the car of LIST.  If arg is nil, return nil.\n\
Jim Blandy's avatar
Jim Blandy committed
501 502 503 504 505 506
Error if arg is not nil and not a cons cell.  See also `car-safe'.")
  (list)
     register Lisp_Object list;
{
  while (1)
    {
507
      if (CONSP (list))
Jim Blandy's avatar
Jim Blandy committed
508 509 510 511 512 513 514 515 516 517 518 519 520
	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;
{
521
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
522 523 524 525 526 527
    return XCONS (object)->car;
  else
    return Qnil;
}

DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
528
  "Return the cdr of LIST.  If arg is nil, return nil.\n\
Jim Blandy's avatar
Jim Blandy committed
529 530 531 532 533 534 535
Error if arg is not nil and not a cons cell.  See also `cdr-safe'.")

  (list)
     register Lisp_Object list;
{
  while (1)
    {
536
      if (CONSP (list))
Jim Blandy's avatar
Jim Blandy committed
537 538 539 540 541 542 543 544 545
	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,
546
  "Return the cdr of OBJECT if it is a cons cell, or else nil.")
Jim Blandy's avatar
Jim Blandy committed
547 548 549
  (object)
     Lisp_Object object;
{
550
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
551 552 553 554 555 556
    return XCONS (object)->cdr;
  else
    return Qnil;
}

DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0,
557
  "Set the car of CELL to be NEWCAR.  Returns NEWCAR.")
Jim Blandy's avatar
Jim Blandy committed
558 559 560
  (cell, newcar)
     register Lisp_Object cell, newcar;
{
561
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
562 563 564 565 566 567 568 569
    cell = wrong_type_argument (Qconsp, cell);

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

DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
570
  "Set the cdr of CELL to be NEWCDR.  Returns NEWCDR.")
Jim Blandy's avatar
Jim Blandy committed
571 572 573
  (cell, newcdr)
     register Lisp_Object cell, newcdr;
{
574
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
575 576 577 578 579 580 581 582 583
    cell = wrong_type_argument (Qconsp, cell);

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

Richard M. Stallman's avatar
Richard M. Stallman committed
584
DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0, "Return t if SYMBOL's value is not void.")
585 586
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
587 588
{
  Lisp_Object valcontents;
589
  CHECK_SYMBOL (symbol, 0);
Jim Blandy's avatar
Jim Blandy committed
590

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

Karl Heuer's avatar
Karl Heuer committed
593 594
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
595
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
596

597
  return (EQ (valcontents, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
598 599
}

Richard M. Stallman's avatar
Richard M. Stallman committed
600
DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0, "Return t if SYMBOL's function definition is not void.")
601 602
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
603
{
604 605
  CHECK_SYMBOL (symbol, 0);
  return (EQ (XSYMBOL (symbol)->function, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
606 607 608
}

DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0, "Make SYMBOL's value be void.")
609 610
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
611
{
612 613 614 615 616
  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
617 618 619
}

DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0, "Make SYMBOL's function definition be void.")
620 621
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
622
{
623 624 625 626 627
  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
628 629 630 631
}

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
632 633
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
634
{
Jim Blandy's avatar
Jim Blandy committed
635 636 637 638
  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
639 640 641
}

DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0, "Return SYMBOL's property list.")
642 643
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
644
{
645 646
  CHECK_SYMBOL (symbol, 0);
  return XSYMBOL (symbol)->plist;
Jim Blandy's avatar
Jim Blandy committed
647 648 649
}

DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0, "Return SYMBOL's name, a string.")
650 651
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
652 653 654
{
  register Lisp_Object name;

655 656
  CHECK_SYMBOL (symbol, 0);
  XSETSTRING (name, XSYMBOL (symbol)->name);
Jim Blandy's avatar
Jim Blandy committed
657 658 659 660
  return name;
}

DEFUN ("fset", Ffset, Sfset, 2, 2, 0,
661 662 663
  "Set SYMBOL's function definition to DEFINITION, and return DEFINITION.")
  (symbol, definition)
     register Lisp_Object symbol, definition;
664 665 666 667 668 669
{
  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
670
			     Vautoload_queue);
671
  XSYMBOL (symbol)->function = definition;
672
  /* Handle automatic advice activation */
673
  if (CONSP (XSYMBOL (symbol)->plist) && !NILP (Fget (symbol, Qad_advice_info)))
674
    {
675
      call2 (Qad_activate, symbol, Qnil);
676
      definition = XSYMBOL (symbol)->function;
677
    }
678
  return definition;
Jim Blandy's avatar
Jim Blandy committed
679 680
}

681
DEFUN ("defalias", Fdefalias, Sdefalias, 2, 2, 0,
682
  "Set SYMBOL's function definition to DEFINITION, and return DEFINITION.\n\
683
Associates the function with the current load file, if any.")
684 685
  (symbol, definition)
     register Lisp_Object symbol, definition;
686
{
687 688 689
  CHECK_SYMBOL (symbol, 0);
  if (!NILP (Vautoload_queue) && !EQ (XSYMBOL (symbol)->function, Qunbound))
    Vautoload_queue = Fcons (Fcons (symbol, XSYMBOL (symbol)->function),
690
			     Vautoload_queue);
691
  XSYMBOL (symbol)->function = definition;
692
  /* Handle automatic advice activation */
693
  if (CONSP (XSYMBOL (symbol)->plist) && !NILP (Fget (symbol, Qad_advice_info)))
694
    {
695
      call2 (Qad_activate, symbol, Qnil);
696
      definition = XSYMBOL (symbol)->function;
697
    }
698
  LOADHIST_ATTACH (symbol);
699
  return definition;
700 701
}

Jim Blandy's avatar
Jim Blandy committed
702 703
DEFUN ("setplist", Fsetplist, Ssetplist, 2, 2, 0,
  "Set SYMBOL's property list to NEWVAL, and return NEWVAL.")
704 705
  (symbol, newplist)
     register Lisp_Object symbol, newplist;
Jim Blandy's avatar
Jim Blandy committed
706
{
707 708
  CHECK_SYMBOL (symbol, 0);
  XSYMBOL (symbol)->plist = newplist;
Jim Blandy's avatar
Jim Blandy committed
709 710
  return newplist;
}
Jim Blandy's avatar
Jim Blandy committed
711

Jim Blandy's avatar
Jim Blandy committed
712 713 714 715 716 717 718 719 720 721 722 723 724

/* 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;
725 726
  int offset;
  if (MISCP (valcontents))
727
    switch (XMISCTYPE (valcontents))
728 729 730 731
      {
      case Lisp_Misc_Intfwd:
	XSETINT (val, *XINTFWD (valcontents)->intvar);
	return val;
Jim Blandy's avatar
Jim Blandy committed
732

733 734
      case Lisp_Misc_Boolfwd:
	return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
735

736 737
      case Lisp_Misc_Objfwd:
	return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
738

739 740 741
      case Lisp_Misc_Buffer_Objfwd:
	offset = XBUFFER_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_buffer);
742

743 744 745
      case Lisp_Misc_Kboard_Objfwd:
	offset = XKBOARD_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_kboard);
746
      }
Jim Blandy's avatar
Jim Blandy committed
747 748 749
  return valcontents;
}

750 751
/* 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
752 753 754 755
   buffer-independent contents of the value cell: forwarded just one
   step past the buffer-localness.  */

void
756 757
store_symval_forwarding (symbol, valcontents, newval)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
758 759
     register Lisp_Object valcontents, newval;
{
760
  switch (SWITCH_ENUM_CAST (XTYPE (valcontents)))
Jim Blandy's avatar
Jim Blandy committed
761
    {
762
    case Lisp_Misc:
763
      switch (XMISCTYPE (valcontents))
764 765 766 767
	{
	case Lisp_Misc_Intfwd:
	  CHECK_NUMBER (newval, 1);
	  *XINTFWD (valcontents)->intvar = XINT (newval);
768 769
	  if (*XINTFWD (valcontents)->intvar != XINT (newval))
	    error ("Value out of range for variable `%s'",
770
		   XSYMBOL (symbol)->name->data);
771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792
	  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;
	  }
793 794
	  break;

795 796 797
	case Lisp_Misc_Kboard_Objfwd:
	  (*(Lisp_Object *)((char *)current_kboard
			    + XKBOARD_OBJFWD (valcontents)->offset))
798 799 800
	    = newval;
	  break;

801 802 803
	default:
	  goto def;
	}
Jim Blandy's avatar
Jim Blandy committed
804 805 806
      break;

    default:
807
    def:
808
      valcontents = XSYMBOL (symbol)->value;
809 810
      if (BUFFER_LOCAL_VALUEP (valcontents)
	  || SOME_BUFFER_LOCAL_VALUEP (valcontents))
811
	XBUFFER_LOCAL_VALUE (valcontents)->car = newval;
Jim Blandy's avatar
Jim Blandy committed
812
      else
813
	XSYMBOL (symbol)->value = newval;
Jim Blandy's avatar
Jim Blandy committed
814 815 816
    }
}

817
/* Set up the buffer-local symbol SYMBOL for validity in the current
Jim Blandy's avatar
Jim Blandy committed
818 819 820 821
   buffer.  VALCONTENTS is the contents of its value cell.
   Return the value forwarded one step past the buffer-local indicator.  */

static Lisp_Object
822 823
swap_in_symval_forwarding (symbol, valcontents)
     Lisp_Object symbol, valcontents;
Jim Blandy's avatar
Jim Blandy committed
824
{
825
  /* valcontents is a pointer to a struct resembling the cons
Jim Blandy's avatar
Jim Blandy committed
826
     (REALVALUE BUFFER CURRENT-ALIST-ELEMENT . DEFAULT-VALUE)).
827

Jim Blandy's avatar
Jim Blandy committed
828
     CURRENT-ALIST-ELEMENT is a pointer to an element of BUFFER's
829 830 831 832 833 834 835 836 837 838 839
     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
840 841 842
     Note that REALVALUE can be a forwarding pointer. */

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

Jim Blandy's avatar
Jim Blandy committed
845
  if (NILP (tem1) || current_buffer != XBUFFER (tem1))
Jim Blandy's avatar
Jim Blandy committed
846
    {
847 848 849
      tem1 = XCONS (XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->cdr)->car;
      Fsetcdr (tem1,
	       do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->car));
850
      tem1 = assq_no_quit (symbol, current_buffer->local_var_alist);
Jim Blandy's avatar
Jim Blandy committed
851
      if (NILP (tem1))
852 853 854 855
	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);
856
      store_symval_forwarding (symbol, XBUFFER_LOCAL_VALUE (valcontents)->car,
857
			       Fcdr (tem1));
Jim Blandy's avatar
Jim Blandy committed
858
    }
859
  return XBUFFER_LOCAL_VALUE (valcontents)->car;
Jim Blandy's avatar
Jim Blandy committed
860 861
}

Jim Blandy's avatar
Jim Blandy committed
862 863
/* 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
864
   if it has one, without signaling an error.
Jim Blandy's avatar
Jim Blandy committed
865 866
   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
867

Jim Blandy's avatar
Jim Blandy committed
868
Lisp_Object
869 870
find_symbol_value (symbol)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
871 872 873
{
  register Lisp_Object valcontents, tem1;
  register Lisp_Object val;
874 875
  CHECK_SYMBOL (symbol, 0);
  valcontents = XSYMBOL (symbol)->value;
Jim Blandy's avatar
Jim Blandy committed
876

Karl Heuer's avatar
Karl Heuer committed
877 878
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
879
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
880

881 882
  if (MISCP (valcontents))
    {
883
      switch (XMISCTYPE (valcontents))
884 885 886 887
	{
	case Lisp_Misc_Intfwd:
	  XSETINT (val, *XINTFWD (valcontents)->intvar);
	  return val;
Jim Blandy's avatar
Jim Blandy committed
888

889 890
	case Lisp_Misc_Boolfwd:
	  return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
891

892 893
	case Lisp_Misc_Objfwd:
	  return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
894

895 896 897
	case Lisp_Misc_Buffer_Objfwd:
	  return *(Lisp_Object *)(XBUFFER_OBJFWD (valcontents)->offset
				  + (char *)current_buffer);
898

899 900 901
	case Lisp_Misc_Kboard_Objfwd:
	  return *(Lisp_Object *)(XKBOARD_OBJFWD (valcontents)->offset
				  + (char *)current_kboard);
902
	}
Jim Blandy's avatar
Jim Blandy committed
903 904 905 906 907
    }

  return valcontents;
}

Jim Blandy's avatar
Jim Blandy committed
908 909
DEFUN ("symbol-value", Fsymbol_value, Ssymbol_value, 1, 1, 0,
  "Return SYMBOL's value.  Error if that is void.")
910 911
  (symbol)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
912
{
913
  Lisp_Object val;
Jim Blandy's avatar
Jim Blandy committed
914

915
  val = find_symbol_value (symbol);
Jim Blandy's avatar
Jim Blandy committed
916
  if (EQ (val, Qunbound))
917
    return Fsignal (Qvoid_variable, Fcons (symbol, Qnil));
Jim Blandy's avatar
Jim Blandy committed
918 919 920 921
  else
    return val;
}

Jim Blandy's avatar
Jim Blandy committed
922 923
DEFUN ("set", Fset, Sset, 2, 2, 0,
  "Set SYMBOL's value to NEWVAL, and return NEWVAL.")
924 925
  (symbol, newval)
     register Lisp_Object symbol, newval;
926 927 928 929
{