data.c 82.1 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,97,98, 1999 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
#include <config.h>
23
#include <signal.h>
24
#include <stdio.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"
32
#include "frame.h"
Jim Blandy's avatar
Jim Blandy committed
33 34
#endif

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

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

39
#ifdef STDC_HEADERS
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 */

70 71 72 73
/* Nonzero means it is an error to set a symbol whose name starts with
   colon.  */
int keyword_symbols_constant_flag;

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

Jim Blandy's avatar
Jim Blandy committed
89
Lisp_Object Qcdr;
90
Lisp_Object Qad_advice_info, Qad_activate;
Jim Blandy's avatar
Jim Blandy committed
91

92 93 94
Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
Lisp_Object Qoverflow_error, Qunderflow_error;

Jim Blandy's avatar
Jim Blandy committed
95
#ifdef LISP_FLOAT_TYPE
96
Lisp_Object Qfloatp;
Jim Blandy's avatar
Jim Blandy committed
97 98 99
Lisp_Object Qnumberp, Qnumber_or_marker_p;
#endif

100
static Lisp_Object Qinteger, Qsymbol, Qstring, Qcons, Qmarker, Qoverlay;
Karl Heuer's avatar
Karl Heuer committed
101 102
static Lisp_Object Qfloat, Qwindow_configuration, Qwindow;
Lisp_Object Qprocess;
103
static Lisp_Object Qcompiled_function, Qbuffer, Qframe, Qvector;
104
static Lisp_Object Qchar_table, Qbool_vector;
105

Jim Blandy's avatar
Jim Blandy committed
106 107
static Lisp_Object swap_in_symval_forwarding ();

108 109
Lisp_Object set_internal ();

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

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

Jim Blandy's avatar
Jim Blandy committed
131 132 133
      value = Fsignal (Qwrong_type_argument, Fcons (predicate, Fcons (value, Qnil)));
      tem = call1 (predicate, value);
    }
Jim Blandy's avatar
Jim Blandy committed
134
  while (NILP (tem));
Jim Blandy's avatar
Jim Blandy committed
135 136 137
  return value;
}

Andreas Schwab's avatar
Andreas Schwab committed
138
void
Jim Blandy's avatar
Jim Blandy committed
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 164 165 166 167 168
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)
169
     EMACS_INT num;
Jim Blandy's avatar
Jim Blandy committed
170
{
171 172
  if (num & (((EMACS_INT) 1) << (VALBITS - 1)))
    return num | (((EMACS_INT) (-1)) << VALBITS);
Jim Blandy's avatar
Jim Blandy committed
173
  else
174
    return num & ((((EMACS_INT) 1) << VALBITS) - 1);
Jim Blandy's avatar
Jim Blandy committed
175 176 177 178 179
}

/* Data type predicates */

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

Richard M. Stallman's avatar
Richard M. Stallman committed
189
DEFUN ("null", Fnull, Snull, 1, 1, 0, "Return t if OBJECT is nil.")
190 191
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
192
{
193
  if (NILP (object))
Jim Blandy's avatar
Jim Blandy committed
194 195 196 197
    return Qt;
  return Qnil;
}

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

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

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

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

311 312
DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0,
       "Return t if OBJECT is a vector.")
313 314
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
315
{
316
  if (VECTORP (object))
Jim Blandy's avatar
Jim Blandy committed
317 318 319 320
    return Qt;
  return Qnil;
}

321 322
DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0,
       "Return t if OBJECT is a string.")
323 324
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
325
{
326
  if (STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
327 328 329 330
    return Qt;
  return Qnil;
}

331 332 333 334 335 336 337 338 339 340 341 342
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.")
343 344 345 346 347 348 349 350
  (object)
     Lisp_Object object;
{
  if (CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

351 352
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
353
       "Return t if OBJECT is a char-table or vector.")
354 355 356 357 358 359 360 361
  (object)
     Lisp_Object object;
{
  if (VECTORP (object) || CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

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

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

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

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

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

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

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

429
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
430
  "Return t if OBJECT is a character (an integer) or a string.")
431 432
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
433
{
434
  if (INTEGERP (object) || STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
435 436 437 438
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
439
DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0, "Return t if OBJECT is an integer.")
440 441
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
442
{
443
  if (INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
444 445 446 447
    return Qt;
  return Qnil;
}

448
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
449
  "Return t if OBJECT is an integer or a marker (editor pointer).")
450 451
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
452
{
453
  if (MARKERP (object) || INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
454 455 456 457
    return Qt;
  return Qnil;
}

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

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

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
481
       "Return t if OBJECT is a number or a marker.")
482 483
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
484
{
485
  if (NUMBERP (object) || MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
486 487 488
    return Qt;
  return Qnil;
}
489 490 491

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

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

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

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

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

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

DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
575
  "Set the cdr of CELL to be NEWCDR.  Returns NEWCDR.")
Jim Blandy's avatar
Jim Blandy committed
576 577 578
  (cell, newcdr)
     register Lisp_Object cell, newcdr;
{
579
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
580 581 582 583 584 585 586 587 588
    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
589
DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0, "Return t if SYMBOL's value is not void.")
590 591
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
592 593
{
  Lisp_Object valcontents;
594
  CHECK_SYMBOL (symbol, 0);
Jim Blandy's avatar
Jim Blandy committed
595

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

Karl Heuer's avatar
Karl Heuer committed
598 599
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
600
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
601

602
  return (EQ (valcontents, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
603 604
}

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

DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0, "Make SYMBOL's value be void.")
614 615
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
616
{
617
  CHECK_SYMBOL (symbol, 0);
618 619
  if (NILP (symbol) || EQ (symbol, Qt)
      || (XSYMBOL (symbol)->name->data[0] == ':'
620
	  && EQ (XSYMBOL (symbol)->obarray, initial_obarray)
621
	  && keyword_symbols_constant_flag))
622 623 624
    return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
  Fset (symbol, Qunbound);
  return symbol;
Jim Blandy's avatar
Jim Blandy committed
625 626 627
}

DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0, "Make SYMBOL's function definition be void.")
628 629
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
630
{
631 632 633 634 635
  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
636 637 638 639
}

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
640 641
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
642
{
Jim Blandy's avatar
Jim Blandy committed
643 644 645 646
  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
647 648 649
}

DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0, "Return SYMBOL's property list.")
650 651
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
652
{
653 654
  CHECK_SYMBOL (symbol, 0);
  return XSYMBOL (symbol)->plist;
Jim Blandy's avatar
Jim Blandy committed
655 656 657
}

DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0, "Return SYMBOL's name, a string.")
658 659
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
660 661 662
{
  register Lisp_Object name;

663 664
  CHECK_SYMBOL (symbol, 0);
  XSETSTRING (name, XSYMBOL (symbol)->name);
Jim Blandy's avatar
Jim Blandy committed
665 666 667 668
  return name;
}

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

689
DEFUN ("defalias", Fdefalias, Sdefalias, 2, 2, 0,
690
  "Set SYMBOL's function definition to DEFINITION, and return DEFINITION.\n\
691
Associates the function with the current load file, if any.")
692 693
  (symbol, definition)
     register Lisp_Object symbol, definition;
694
{
695
  definition = Ffset (symbol, definition);
696
  LOADHIST_ATTACH (symbol);
697
  return definition;
698 699
}

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

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

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

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

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

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

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

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

788 789 790 791 792 793
	    if (! NILP (type) && ! NILP (newval)
		&& XTYPE (newval) != XINT (type))
	      buffer_slot_type_mismatch (offset);

	    *(Lisp_Object *)(offset + (char *)current_buffer) = newval;
	  }
794 795
	  break;

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

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

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

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

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

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

  register Lisp_Object tem1;
844
  tem1 = XBUFFER_LOCAL_VALUE (valcontents)->buffer;
Jim Blandy's avatar
Jim Blandy committed
845

846
  if (NILP (tem1) || current_buffer != XBUFFER (tem1)
847
      || !EQ (selected_frame, XBUFFER_LOCAL_VALUE (valcontents)->frame))
Jim Blandy's avatar
Jim Blandy committed
848
    {
849
      tem1 = XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->car;
850
      Fsetcdr (tem1,
851
	       do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
852
      tem1 = assq_no_quit (symbol, current_buffer->local_var_alist);
853 854
      XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
      XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
Jim Blandy's avatar
Jim Blandy committed
855
      if (NILP (tem1))
856 857
	{
	  if (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
858
	    tem1 = assq_no_quit (symbol, XFRAME (selected_frame)->param_alist);
859 860 861 862 863 864 865 866 867 868
	  if (! NILP (tem1))
	    XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 1;
	  else
	    tem1 = XBUFFER_LOCAL_VALUE (valcontents)->cdr;
	}
      else
	XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 1;

      XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->car = tem1;
      XSETBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer, current_buffer);
869
      XBUFFER_LOCAL_VALUE (valcontents)->frame = selected_frame;
870 871
      store_symval_forwarding (symbol,
			       XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
872
			       Fcdr (tem1));
Jim Blandy's avatar
Jim Blandy committed
873
    }
874
  return XBUFFER_LOCAL_VALUE (valcontents)->realvalue;
Jim Blandy's avatar
Jim Blandy committed
875 876
}

Jim Blandy's avatar
Jim Blandy committed
877 878
/* 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
879
   if it has one, without signaling an error.
Jim Blandy's avatar
Jim Blandy committed
880 881
   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
882

Jim Blandy's avatar
Jim Blandy committed
883
Lisp_Object
884 885
find_symbol_value (symbol)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
886
{
887
  register Lisp_Object valcontents;
Jim Blandy's avatar
Jim Blandy committed
888
  register Lisp_Object val;
889 890
  CHECK_SYMBOL (symbol, 0);
  valcontents = XSYMBOL (symbol)->value;
Jim Blandy's avatar
Jim Blandy committed
891

Karl Heuer's avatar
Karl Heuer committed
892 893
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
894
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
895

896 897
  if (MISCP (valcontents))
    {
898
      switch (XMISCTYPE (valcontents))
899 900 901 902
	{
	case Lisp_Misc_Intfwd:
	  XSETINT (val, *XINTFWD (valcontents)->intvar);
	  return val;
Jim Blandy's avatar
Jim Blandy committed
903

904 905
	case Lisp_Misc_Boolfwd:
	  return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
906

907 908
	case Lisp_Misc_Objfwd:
	  return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
909

910 911 912
	case Lisp_Misc_Buffer_Objfwd:
	  return *(Lisp_Object *)(XBUFFER_OBJFWD (valcontents)->offset
				  + (char *)current_buffer);
913

914 915 916
	case Lisp_Misc_Kboard_Objfwd:
	  return *(Lisp_Object *)(XKBOARD_OBJFWD (valcontents)->offset
				  + (char *)current_kboard);
917
	}
Jim Blandy's avatar
Jim Blandy committed
918 919 920 921 922
    }

  return valcontents;
}

Jim Blandy's avatar
Jim Blandy committed
923