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

This file is part of GNU Emacs.

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

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

You should have received a copy of the GNU General Public License
along with GNU Emacs; see the file COPYING.  If not, write to
18 19
the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.  */
Jim Blandy's avatar
Jim Blandy committed
20 21 22 23


#include <signal.h>

24
#include <config.h>
25 26 27 28 29 30 31 32

/* Put this before lisp.h so that lisp.h can define DBL_DIG if not defined.  */
#ifdef LISP_FLOAT_TYPE
#ifdef STDC_HEADERS
#include <float.h>
#endif
#endif

Jim Blandy's avatar
Jim Blandy committed
33
#include "lisp.h"
Jim Blandy's avatar
Jim Blandy committed
34
#include "puresize.h"
Karl Heuer's avatar
Karl Heuer committed
35
#include "charset.h"
Jim Blandy's avatar
Jim Blandy committed
36 37 38

#ifndef standalone
#include "buffer.h"
Richard M. Stallman's avatar
Richard M. Stallman committed
39
#include "keyboard.h"
Jim Blandy's avatar
Jim Blandy committed
40 41
#endif

Jim Blandy's avatar
Jim Blandy committed
42
#include "syssignal.h"
Jim Blandy's avatar
Jim Blandy committed
43

Jim Blandy's avatar
Jim Blandy committed
44
#ifdef LISP_FLOAT_TYPE
45

46 47 48
#ifdef STDC_HEADERS
#include <stdlib.h>
#endif
49

50 51 52 53 54 55 56 57 58 59
/* 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

60 61 62 63 64 65 66 67 68 69
/* 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
70 71 72
#include <math.h>
#endif /* LISP_FLOAT_TYPE */

73 74 75 76
#if !defined (atof)
extern double atof ();
#endif /* !atof */

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

Jim Blandy's avatar
Jim Blandy committed
92
Lisp_Object Qcdr;
93
Lisp_Object Qad_advice_info, Qad_activate;
Jim Blandy's avatar
Jim Blandy committed
94

95 96 97
Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
Lisp_Object Qoverflow_error, Qunderflow_error;

Jim Blandy's avatar
Jim Blandy committed
98
#ifdef LISP_FLOAT_TYPE
99
Lisp_Object Qfloatp;
Jim Blandy's avatar
Jim Blandy committed
100 101 102
Lisp_Object Qnumberp, Qnumber_or_marker_p;
#endif

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

Jim Blandy's avatar
Jim Blandy committed
109 110
static Lisp_Object swap_in_symval_forwarding ();

111 112
Lisp_Object set_internal ();

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

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

Jim Blandy's avatar
Jim Blandy committed
134 135 136
      value = Fsignal (Qwrong_type_argument, Fcons (predicate, Fcons (value, Qnil)));
      tem = call1 (predicate, value);
    }
Jim Blandy's avatar
Jim Blandy committed
137
  while (NILP (tem));
Jim Blandy's avatar
Jim Blandy committed
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 164 165 166 167 168 169 170
  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)
171
     EMACS_INT num;
Jim Blandy's avatar
Jim Blandy committed
172
{
173 174
  if (num & (((EMACS_INT) 1) << (VALBITS - 1)))
    return num | (((EMACS_INT) (-1)) << VALBITS);
Jim Blandy's avatar
Jim Blandy committed
175
  else
176
    return num & ((((EMACS_INT) 1) << VALBITS) - 1);
Jim Blandy's avatar
Jim Blandy committed
177 178 179 180 181
}

/* Data type predicates */

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

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

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

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

Richard M. Stallman's avatar
Richard M. Stallman committed
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;
}

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

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

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

Richard M. Stallman's avatar
Richard M. Stallman committed
327
DEFUN ("char-table-p", Fchar_table_p, Schar_table_p, 1, 1, 0, "Return t if OBJECT is a char-table.")
328 329 330 331 332 333 334 335
  (object)
     Lisp_Object object;
{
  if (CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

336 337
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
338
       "Return t if OBJECT is a char-table or vector.")
339 340 341 342 343 344 345 346
  (object)
     Lisp_Object object;
{
  if (VECTORP (object) || CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
347
DEFUN ("bool-vector-p", Fbool_vector_p, Sbool_vector_p, 1, 1, 0, "Return t if OBJECT is a bool-vector.")
348 349 350 351 352 353 354 355
  (object)
     Lisp_Object object;
{
  if (BOOL_VECTOR_P (object))
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
356
DEFUN ("arrayp", Farrayp, Sarrayp, 1, 1, 0, "Return t if OBJECT is an array (string or vector).")
357 358
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
359
{
360 361
  if (VECTORP (object) || STRINGP (object)
      || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
Jim Blandy's avatar
Jim Blandy committed
362 363 364 365 366
    return Qt;
  return Qnil;
}

DEFUN ("sequencep", Fsequencep, Ssequencep, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
367
  "Return t if OBJECT is a sequence (list or array).")
368 369
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
370
{
371 372
  if (CONSP (object) || NILP (object) || VECTORP (object) || STRINGP (object)
      || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
Jim Blandy's avatar
Jim Blandy committed
373 374 375 376
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
377
DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0, "Return t if OBJECT is an editor buffer.")
378 379
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
380
{
381
  if (BUFFERP (object))
Jim Blandy's avatar
Jim Blandy committed
382 383 384 385
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
386
DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0, "Return t if OBJECT is a marker (editor pointer).")
387 388
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
389
{
390
  if (MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
391 392 393 394
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
395
DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0, "Return t if OBJECT is a built-in function.")
396 397
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
398
{
399
  if (SUBRP (object))
Jim Blandy's avatar
Jim Blandy committed
400 401 402 403
    return Qt;
  return Qnil;
}

Jim Blandy's avatar
Jim Blandy committed
404
DEFUN ("byte-code-function-p", Fbyte_code_function_p, Sbyte_code_function_p,
Richard M. Stallman's avatar
Richard M. Stallman committed
405
       1, 1, 0, "Return t if OBJECT is a byte-compiled function object.")
406 407
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
408
{
409
  if (COMPILEDP (object))
Jim Blandy's avatar
Jim Blandy committed
410 411 412 413
    return Qt;
  return Qnil;
}

414
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
415
  "Return t if OBJECT is a character (an integer) or a string.")
416 417
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
418
{
419
  if (INTEGERP (object) || STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
420 421 422 423
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
424
DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0, "Return t if OBJECT is an integer.")
425 426
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
427
{
428
  if (INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
429 430 431 432
    return Qt;
  return Qnil;
}

433
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
434
  "Return t if OBJECT is an integer or a marker (editor pointer).")
435 436
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
437
{
438
  if (MARKERP (object) || INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
439 440 441 442
    return Qt;
  return Qnil;
}

443
DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
444
  "Return t if OBJECT is a nonnegative integer.")
445 446
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
447
{
448
  if (NATNUMP (object))
Jim Blandy's avatar
Jim Blandy committed
449 450 451 452 453
    return Qt;
  return Qnil;
}

DEFUN ("numberp", Fnumberp, Snumberp, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
454
       "Return t if OBJECT is a number (floating point or integer).")
455 456
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
457
{
458
  if (NUMBERP (object))
Jim Blandy's avatar
Jim Blandy committed
459
    return Qt;
Jim Blandy's avatar
Jim Blandy committed
460 461
  else
    return Qnil;
Jim Blandy's avatar
Jim Blandy committed
462 463 464 465
}

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
466
       "Return t if OBJECT is a number or a marker.")
467 468
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
469
{
470
  if (NUMBERP (object) || MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
471 472 473
    return Qt;
  return Qnil;
}
474 475 476

#ifdef LISP_FLOAT_TYPE
DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
477
       "Return t if OBJECT is a floating point number.")
478 479
  (object)
     Lisp_Object object;
480
{
481
  if (FLOATP (object))
482 483 484
    return Qt;
  return Qnil;
}
Jim Blandy's avatar
Jim Blandy committed
485 486 487 488 489
#endif /* LISP_FLOAT_TYPE */

/* Extract and set components of lists */

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

DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
518
  "Return the cdr of LIST.  If arg is nil, return nil.\n\
Jim Blandy's avatar
Jim Blandy committed
519 520 521 522 523 524 525
Error if arg is not nil and not a cons cell.  See also `cdr-safe'.")

  (list)
     register Lisp_Object list;
{
  while (1)
    {
526
      if (CONSP (list))
Jim Blandy's avatar
Jim Blandy committed
527 528 529 530 531 532 533 534 535
	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,
536
  "Return the cdr of OBJECT if it is a cons cell, or else nil.")
Jim Blandy's avatar
Jim Blandy committed
537 538 539
  (object)
     Lisp_Object object;
{
540
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
541 542 543 544 545 546
    return XCONS (object)->cdr;
  else
    return Qnil;
}

DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0,
547
  "Set the car of CELL to be NEWCAR.  Returns NEWCAR.")
Jim Blandy's avatar
Jim Blandy committed
548 549 550
  (cell, newcar)
     register Lisp_Object cell, newcar;
{
551
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
552 553 554 555 556 557 558 559
    cell = wrong_type_argument (Qconsp, cell);

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

DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
560
  "Set the cdr of CELL to be NEWCDR.  Returns NEWCDR.")
Jim Blandy's avatar
Jim Blandy committed
561 562 563
  (cell, newcdr)
     register Lisp_Object cell, newcdr;
{
564
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
565 566 567 568 569 570 571 572 573
    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
574
DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0, "Return t if SYMBOL's value is not void.")
575 576
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
577 578
{
  Lisp_Object valcontents;
579
  CHECK_SYMBOL (symbol, 0);
Jim Blandy's avatar
Jim Blandy committed
580

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

Karl Heuer's avatar
Karl Heuer committed
583 584
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
585
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
586

587
  return (EQ (valcontents, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
588 589
}

Richard M. Stallman's avatar
Richard M. Stallman committed
590
DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0, "Return t if SYMBOL's function definition is not void.")
591 592
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
593
{
594 595
  CHECK_SYMBOL (symbol, 0);
  return (EQ (XSYMBOL (symbol)->function, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
596 597 598
}

DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0, "Make SYMBOL's value be void.")
599 600
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
601
{
602 603 604 605 606
  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
607 608 609
}

DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0, "Make SYMBOL's function definition be void.")
610 611
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
612
{
613 614 615 616 617
  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
618 619 620 621
}

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
622 623
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
624
{
Jim Blandy's avatar
Jim Blandy committed
625 626 627 628
  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
629 630 631
}

DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0, "Return SYMBOL's property list.")
632 633
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
634
{
635 636
  CHECK_SYMBOL (symbol, 0);
  return XSYMBOL (symbol)->plist;
Jim Blandy's avatar
Jim Blandy committed
637 638 639
}

DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0, "Return SYMBOL's name, a string.")
640 641
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
642 643 644
{
  register Lisp_Object name;

645 646
  CHECK_SYMBOL (symbol, 0);
  XSETSTRING (name, XSYMBOL (symbol)->name);
Jim Blandy's avatar
Jim Blandy committed
647 648 649 650
  return name;
}

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

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

Jim Blandy's avatar
Jim Blandy committed
692 693
DEFUN ("setplist", Fsetplist, Ssetplist, 2, 2, 0,
  "Set SYMBOL's property list to NEWVAL, and return NEWVAL.")
694 695
  (symbol, newplist)
     register Lisp_Object symbol, newplist;
Jim Blandy's avatar
Jim Blandy committed
696
{
697 698
  CHECK_SYMBOL (symbol, 0);
  XSYMBOL (symbol)->plist = newplist;
Jim Blandy's avatar
Jim Blandy committed
699 700
  return newplist;
}
Jim Blandy's avatar
Jim Blandy committed
701

Jim Blandy's avatar
Jim Blandy committed
702 703 704 705 706 707 708 709 710 711 712 713 714

/* 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;
715 716
  int offset;
  if (MISCP (valcontents))
717
    switch (XMISCTYPE (valcontents))
718 719 720 721
      {
      case Lisp_Misc_Intfwd:
	XSETINT (val, *XINTFWD (valcontents)->intvar);
	return val;
Jim Blandy's avatar
Jim Blandy committed
722

723 724
      case Lisp_Misc_Boolfwd:
	return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
725

726 727
      case Lisp_Misc_Objfwd:
	return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
728

729 730 731
      case Lisp_Misc_Buffer_Objfwd:
	offset = XBUFFER_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_buffer);
732

733 734 735
      case Lisp_Misc_Kboard_Objfwd:
	offset = XKBOARD_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_kboard);
736
      }
Jim Blandy's avatar
Jim Blandy committed
737 738 739
  return valcontents;
}

740 741
/* 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
742 743 744 745
   buffer-independent contents of the value cell: forwarded just one
   step past the buffer-localness.  */

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

785 786 787
	case Lisp_Misc_Kboard_Objfwd:
	  (*(Lisp_Object *)((char *)current_kboard
			    + XKBOARD_OBJFWD (valcontents)->offset))
788 789 790
	    = newval;
	  break;

791 792 793
	default:
	  goto def;
	}
Jim Blandy's avatar
Jim Blandy committed
794 795 796
      break;

    default:
797
    def:
798
      valcontents = XSYMBOL (symbol)->value;
799 800
      if (BUFFER_LOCAL_VALUEP (valcontents)
	  || SOME_BUFFER_LOCAL_VALUEP (valcontents))
801
	XBUFFER_LOCAL_VALUE (valcontents)->car = newval;
Jim Blandy's avatar
Jim Blandy committed
802
      else
803
	XSYMBOL (symbol)->value = newval;
Jim Blandy's avatar
Jim Blandy committed
804 805 806
    }
}

807
/* Set up the buffer-local symbol SYMBOL for validity in the current
Jim Blandy's avatar
Jim Blandy committed
808 809 810 811
   buffer.  VALCONTENTS is the contents of its value cell.
   Return the value forwarded one step past the buffer-local indicator.  */

static Lisp_Object
812 813
swap_in_symval_forwarding (symbol, valcontents)
     Lisp_Object symbol, valcontents;
Jim Blandy's avatar
Jim Blandy committed
814
{
815
  /* valcontents is a pointer to a struct resembling the cons
Jim Blandy's avatar
Jim Blandy committed
816
     (REALVALUE BUFFER CURRENT-ALIST-ELEMENT . DEFAULT-VALUE)).
817

Jim Blandy's avatar
Jim Blandy committed
818
     CURRENT-ALIST-ELEMENT is a pointer to an element of BUFFER's
819 820 821 822 823 824 825 826 827 828 829
     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
830 831 832
     Note that REALVALUE can be a forwarding pointer. */

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

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

Jim Blandy's avatar
Jim Blandy committed
858
Lisp_Object
859 860
find_symbol_value (symbol)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
861 862 863
{
  register Lisp_Object valcontents, tem1;
  register Lisp_Object val;
864 865
  CHECK_SYMBOL (symbol, 0);
  valcontents = XSYMBOL (symbol)->value;
Jim Blandy's avatar
Jim Blandy committed
866

Karl Heuer's avatar
Karl Heuer committed
867 868
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
869
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
870

871 872
  if (MISCP (valcontents))
    {
873
      switch (XMISCTYPE (valcontents))
874 875 876 877
	{
	case Lisp_Misc_Intfwd:
	  XSETINT (val, *XINTFWD (valcontents)->intvar);
	  return val;
Jim Blandy's avatar
Jim Blandy committed
878

879 880
	case Lisp_Misc_Boolfwd:
	  return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
881

882 883
	case Lisp_Misc_Objfwd:
	  return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
884

885 886 887
	case Lisp_Misc_Buffer_Objfwd:
	  return *(Lisp_Object *)(XBUFFER_OBJFWD (valcontents)->offset
				  + (char *)current_buffer);
888

889 890 891
	case Lisp_Misc_Kboard_Objfwd:
	  return *(Lisp_Object *)(XKBOARD_OBJFWD (valcontents)->offset
				  + (char *)current_kboard);
892
	}
Jim Blandy's avatar
Jim Blandy committed
893 894 895 896 897
    }

  return valcontents;
}

Jim Blandy's avatar
Jim Blandy committed
898 899
DEFUN ("symbol-value", Fsymbol_value, Ssymbol_value, 1, 1, 0,
  "Return SYMBOL's value.  Error if that is void.")
900 901
  (symbol)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
902
{
903
  Lisp_Object val;
Jim Blandy's avatar
Jim Blandy committed
904

905
  val = find_symbol_value (symbol);
Jim Blandy's avatar
Jim Blandy committed
906
  if (EQ (val, Qunbound))
907
    return Fsignal (Qvoid_variable, Fcons (symbol, Qnil));
Jim Blandy's avatar
Jim Blandy committed
908 909 910 911
  else
    return val;
}

Jim Blandy's avatar
Jim Blandy committed
912 913
DEFUN ("set", Fset, Sset, 2, 2, 0,
  "Set SYMBOL's value to NEWVAL, and return NEWVAL.")
914 915
  (symbol, newval)
     register Lisp_Object symbol, newval;
916 917 918 919 920 921 922 923 924 925 926 927 928
{
  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
929
{