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

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
9
the Free Software Foundation; either version 2, or (at your option)
Jim Blandy's avatar
Jim Blandy committed
10 11 12 13 14 15 16 17 18
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
19 20
the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.  */
Jim Blandy's avatar
Jim Blandy committed
21 22


23
#include <config.h>
24
#include <signal.h>
25
#include <stdio.h>
Jim Blandy's avatar
Jim Blandy committed
26
#include "lisp.h"
Jim Blandy's avatar
Jim Blandy committed
27
#include "puresize.h"
Karl Heuer's avatar
Karl Heuer committed
28
#include "charset.h"
Jim Blandy's avatar
Jim Blandy committed
29
#include "buffer.h"
Richard M. Stallman's avatar
Richard M. Stallman committed
30
#include "keyboard.h"
31
#include "frame.h"
Jim Blandy's avatar
Jim Blandy committed
32
#include "syssignal.h"
Jim Blandy's avatar
Jim Blandy committed
33

34
#ifdef STDC_HEADERS
35
#include <float.h>
36
#endif
37

38 39 40 41 42 43 44 45 46 47
/* 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

48 49 50 51 52 53 54 55 56 57
/* 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
58 59
#include <math.h>

60 61 62 63
#if !defined (atof)
extern double atof ();
#endif /* !atof */

Jim Blandy's avatar
Jim Blandy committed
64 65 66
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
67
Lisp_Object Qvoid_variable, Qvoid_function, Qcyclic_function_indirection;
68
Lisp_Object Qcyclic_variable_indirection, Qcircular_list;
Jim Blandy's avatar
Jim Blandy committed
69 70
Lisp_Object Qsetting_constant, Qinvalid_read_syntax;
Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch;
Roland McGrath's avatar
Roland McGrath committed
71
Lisp_Object Qend_of_file, Qarith_error, Qmark_inactive;
Jim Blandy's avatar
Jim Blandy committed
72
Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_read_only;
73
Lisp_Object Qtext_read_only;
74
Lisp_Object Qintegerp, Qnatnump, Qwholenump, Qsymbolp, Qlistp, Qconsp;
Jim Blandy's avatar
Jim Blandy committed
75 76
Lisp_Object Qstringp, Qarrayp, Qsequencep, Qbufferp;
Lisp_Object Qchar_or_string_p, Qmarkerp, Qinteger_or_marker_p, Qvectorp;
Dave Love's avatar
Dave Love committed
77
Lisp_Object Qbuffer_or_string_p, Qkeywordp;
Jim Blandy's avatar
Jim Blandy committed
78
Lisp_Object Qboundp, Qfboundp;
79
Lisp_Object Qchar_table_p, Qvector_or_char_table_p;
80

Jim Blandy's avatar
Jim Blandy committed
81
Lisp_Object Qcdr;
82
Lisp_Object Qad_advice_info, Qad_activate_internal;
Jim Blandy's avatar
Jim Blandy committed
83

84 85 86
Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
Lisp_Object Qoverflow_error, Qunderflow_error;

87
Lisp_Object Qfloatp;
Jim Blandy's avatar
Jim Blandy committed
88 89
Lisp_Object Qnumberp, Qnumber_or_marker_p;

90
static Lisp_Object Qinteger, Qsymbol, Qstring, Qcons, Qmarker, Qoverlay;
Karl Heuer's avatar
Karl Heuer committed
91 92
static Lisp_Object Qfloat, Qwindow_configuration, Qwindow;
Lisp_Object Qprocess;
93
static Lisp_Object Qcompiled_function, Qbuffer, Qframe, Qvector;
Gerd Moellmann's avatar
Gerd Moellmann committed
94
static Lisp_Object Qchar_table, Qbool_vector, Qhash_table;
95
static Lisp_Object Qsubrp, Qmany, Qunevalled;
96

97
static Lisp_Object swap_in_symval_forwarding P_ ((Lisp_Object, Lisp_Object));
98

99
Lisp_Object Vmost_positive_fixnum, Vmost_negative_fixnum;
100

101 102 103 104 105 106 107 108 109

void
circular_list_error (list)
     Lisp_Object list;
{
  Fsignal (Qcircular_list, list);
}


Jim Blandy's avatar
Jim Blandy committed
110 111 112 113 114 115 116
Lisp_Object
wrong_type_argument (predicate, value)
     register Lisp_Object predicate, value;
{
  register Lisp_Object tem;
  do
    {
117 118
      /* If VALUE is not even a valid Lisp object, abort here
	 where we can get a backtrace showing where it came from.  */
119
      if ((unsigned int) XGCTYPE (value) >= Lisp_Type_Limit)
120 121
	abort ();

Jim Blandy's avatar
Jim Blandy committed
122 123 124
      value = Fsignal (Qwrong_type_argument, Fcons (predicate, Fcons (value, Qnil)));
      tem = call1 (predicate, value);
    }
Jim Blandy's avatar
Jim Blandy committed
125
  while (NILP (tem));
Jim Blandy's avatar
Jim Blandy committed
126 127 128
  return value;
}

Andreas Schwab's avatar
Andreas Schwab committed
129
void
Jim Blandy's avatar
Jim Blandy committed
130 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
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)
160
     EMACS_INT num;
Jim Blandy's avatar
Jim Blandy committed
161
{
162 163
  if (num & (((EMACS_INT) 1) << (VALBITS - 1)))
    return num | (((EMACS_INT) (-1)) << VALBITS);
Jim Blandy's avatar
Jim Blandy committed
164
  else
165
    return num & ((((EMACS_INT) 1) << VALBITS) - 1);
Jim Blandy's avatar
Jim Blandy committed
166 167 168 169 170
}

/* Data type predicates */

DEFUN ("eq", Feq, Seq, 2, 2, 0,
171 172
       doc: /* Return t if the two args are the same Lisp object.  */)
     (obj1, obj2)
Jim Blandy's avatar
Jim Blandy committed
173 174 175 176 177 178 179
     Lisp_Object obj1, obj2;
{
  if (EQ (obj1, obj2))
    return Qt;
  return Qnil;
}

180 181 182
DEFUN ("null", Fnull, Snull, 1, 1, 0,
       doc: /* Return t if OBJECT is nil.  */)
     (object)
183
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
184
{
185
  if (NILP (object))
Jim Blandy's avatar
Jim Blandy committed
186 187 188 189
    return Qt;
  return Qnil;
}

190
DEFUN ("type-of", Ftype_of, Stype_of, 1, 1, 0,
191 192 193 194
       doc: /* Return a symbol representing the type of OBJECT.
The symbol returned names the object's basic type;
for example, (type-of 1) returns `integer'.  */)
     (object)
195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211
     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:
212
      switch (XMISCTYPE (object))
213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235
	{
	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;
236 237 238 239
      if (GC_CHAR_TABLE_P (object))
	return Qchar_table;
      if (GC_BOOL_VECTOR_P (object))
	return Qbool_vector;
240 241
      if (GC_FRAMEP (object))
	return Qframe;
Gerd Moellmann's avatar
Gerd Moellmann committed
242 243
      if (GC_HASH_TABLE_P (object))
	return Qhash_table;
244 245 246 247 248 249 250 251 252 253
      return Qvector;

    case Lisp_Float:
      return Qfloat;

    default:
      abort ();
    }
}

254 255 256
DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0,
       doc: /* Return t if OBJECT is a cons cell.  */)
     (object)
257
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
258
{
259
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
260 261 262 263
    return Qt;
  return Qnil;
}

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

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

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

Dave Love's avatar
Dave Love committed
304 305 306
/* Define this in C to avoid unnecessarily consing up the symbol
   name.  */
DEFUN ("keywordp", Fkeywordp, Skeywordp, 1, 1, 0,
307 308 309 310
       doc: /* Return t if OBJECT is a keyword.
This means that it is a symbol with a print name beginning with `:'
interned in the initial obarray.  */)
     (object)
Dave Love's avatar
Dave Love committed
311 312 313
     Lisp_Object object;
{
  if (SYMBOLP (object)
314
      && XSTRING (SYMBOL_NAME (object))->data[0] == ':'
315
      && SYMBOL_INTERNED_IN_INITIAL_OBARRAY_P (object))
Dave Love's avatar
Dave Love committed
316 317 318 319
    return Qt;
  return Qnil;
}

320
DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0,
321 322
       doc: /* Return t if OBJECT is a vector.  */)
     (object)
323
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
324
{
325
  if (VECTORP (object))
Jim Blandy's avatar
Jim Blandy committed
326 327 328 329
    return Qt;
  return Qnil;
}

330
DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0,
331 332
       doc: /* Return t if OBJECT is a string.  */)
     (object)
333
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
334
{
335
  if (STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
336 337 338 339
    return Qt;
  return Qnil;
}

340
DEFUN ("multibyte-string-p", Fmultibyte_string_p, Smultibyte_string_p,
341 342 343
       1, 1, 0,
       doc: /* Return t if OBJECT is a multibyte string.  */)
     (object)
344 345 346 347 348 349 350 351
     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,
352 353
       doc: /* Return t if OBJECT is a char-table.  */)
     (object)
354 355 356 357 358 359 360
     Lisp_Object object;
{
  if (CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

361 362
DEFUN ("vector-or-char-table-p", Fvector_or_char_table_p,
       Svector_or_char_table_p, 1, 1, 0,
363 364
       doc: /* Return t if OBJECT is a char-table or vector.  */)
     (object)
365 366 367 368 369 370 371
     Lisp_Object object;
{
  if (VECTORP (object) || CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

372 373 374
DEFUN ("bool-vector-p", Fbool_vector_p, Sbool_vector_p, 1, 1, 0,
       doc: /* Return t if OBJECT is a bool-vector.  */)
     (object)
375 376 377 378 379 380 381
     Lisp_Object object;
{
  if (BOOL_VECTOR_P (object))
    return Qt;
  return Qnil;
}

382 383 384
DEFUN ("arrayp", Farrayp, Sarrayp, 1, 1, 0,
       doc: /* Return t if OBJECT is an array (string or vector).  */)
     (object)
385
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
386
{
387 388
  if (VECTORP (object) || STRINGP (object)
      || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
Jim Blandy's avatar
Jim Blandy committed
389 390 391 392 393
    return Qt;
  return Qnil;
}

DEFUN ("sequencep", Fsequencep, Ssequencep, 1, 1, 0,
394 395
       doc: /* Return t if OBJECT is a sequence (list or array).  */)
     (object)
396
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
397
{
398 399
  if (CONSP (object) || NILP (object) || VECTORP (object) || STRINGP (object)
      || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
Jim Blandy's avatar
Jim Blandy committed
400 401 402 403
    return Qt;
  return Qnil;
}

404 405 406
DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0,
       doc: /* Return t if OBJECT is an editor buffer.  */)
     (object)
407
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
408
{
409
  if (BUFFERP (object))
Jim Blandy's avatar
Jim Blandy committed
410 411 412 413
    return Qt;
  return Qnil;
}

414 415 416
DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0,
       doc: /* Return t if OBJECT is a marker (editor pointer).  */)
     (object)
417
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
418
{
419
  if (MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
420 421 422 423
    return Qt;
  return Qnil;
}

424 425 426
DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0,
       doc: /* Return t if OBJECT is a built-in function.  */)
     (object)
427
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
428
{
429
  if (SUBRP (object))
Jim Blandy's avatar
Jim Blandy committed
430 431 432 433
    return Qt;
  return Qnil;
}

Jim Blandy's avatar
Jim Blandy committed
434
DEFUN ("byte-code-function-p", Fbyte_code_function_p, Sbyte_code_function_p,
435 436 437
       1, 1, 0,
       doc: /* Return t if OBJECT is a byte-compiled function object.  */)
     (object)
438
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
439
{
440
  if (COMPILEDP (object))
Jim Blandy's avatar
Jim Blandy committed
441 442 443 444
    return Qt;
  return Qnil;
}

445
DEFUN ("char-or-string-p", Fchar_or_string_p, Schar_or_string_p, 1, 1, 0,
446 447
       doc: /* Return t if OBJECT is a character (an integer) or a string.  */)
     (object)
448
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
449
{
450
  if (INTEGERP (object) || STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
451 452 453 454
    return Qt;
  return Qnil;
}

455 456 457
DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0,
       doc: /* Return t if OBJECT is an integer.  */)
     (object)
458
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
459
{
460
  if (INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
461 462 463 464
    return Qt;
  return Qnil;
}

465
DEFUN ("integer-or-marker-p", Finteger_or_marker_p, Sinteger_or_marker_p, 1, 1, 0,
466 467
       doc: /* Return t if OBJECT is an integer or a marker (editor pointer).  */)
     (object)
468
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
469
{
470
  if (MARKERP (object) || INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
471 472 473 474
    return Qt;
  return Qnil;
}

475
DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0,
476 477
       doc: /* Return t if OBJECT is a nonnegative integer.  */)
     (object)
478
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
479
{
480
  if (NATNUMP (object))
Jim Blandy's avatar
Jim Blandy committed
481 482 483 484 485
    return Qt;
  return Qnil;
}

DEFUN ("numberp", Fnumberp, Snumberp, 1, 1, 0,
486 487
       doc: /* Return t if OBJECT is a number (floating point or integer).  */)
     (object)
488
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
489
{
490
  if (NUMBERP (object))
Jim Blandy's avatar
Jim Blandy committed
491
    return Qt;
Jim Blandy's avatar
Jim Blandy committed
492 493
  else
    return Qnil;
Jim Blandy's avatar
Jim Blandy committed
494 495 496 497
}

DEFUN ("number-or-marker-p", Fnumber_or_marker_p,
       Snumber_or_marker_p, 1, 1, 0,
498 499
       doc: /* Return t if OBJECT is a number or a marker.  */)
     (object)
500
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
501
{
502
  if (NUMBERP (object) || MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
503 504 505
    return Qt;
  return Qnil;
}
506 507

DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
508 509
       doc: /* Return t if OBJECT is a floating point number.  */)
     (object)
510
     Lisp_Object object;
511
{
512
  if (FLOATP (object))
513 514 515
    return Qt;
  return Qnil;
}
516

Jim Blandy's avatar
Jim Blandy committed
517 518 519 520

/* Extract and set components of lists */

DEFUN ("car", Fcar, Scar, 1, 1, 0,
521 522 523
       doc: /* Return the car of LIST.  If arg is nil, return nil.
Error if arg is not nil and not a cons cell.  See also `car-safe'.  */)
     (list)
Jim Blandy's avatar
Jim Blandy committed
524 525 526 527
     register Lisp_Object list;
{
  while (1)
    {
528
      if (CONSP (list))
529
	return XCAR (list);
Jim Blandy's avatar
Jim Blandy committed
530 531 532 533 534 535 536 537
      else if (EQ (list, Qnil))
	return Qnil;
      else
	list = wrong_type_argument (Qlistp, list);
    }
}

DEFUN ("car-safe", Fcar_safe, Scar_safe, 1, 1, 0,
538 539
       doc: /* Return the car of OBJECT if it is a cons cell, or else nil.  */)
     (object)
Jim Blandy's avatar
Jim Blandy committed
540 541
     Lisp_Object object;
{
542
  if (CONSP (object))
543
    return XCAR (object);
Jim Blandy's avatar
Jim Blandy committed
544 545 546 547 548
  else
    return Qnil;
}

DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
549 550 551
       doc: /* Return the cdr of LIST.  If arg is nil, return nil.
Error if arg is not nil and not a cons cell.  See also `cdr-safe'.  */)
     (list)
Jim Blandy's avatar
Jim Blandy committed
552 553 554 555
     register Lisp_Object list;
{
  while (1)
    {
556
      if (CONSP (list))
557
	return XCDR (list);
Jim Blandy's avatar
Jim Blandy committed
558 559 560 561 562 563 564 565
      else if (EQ (list, Qnil))
	return Qnil;
      else
	list = wrong_type_argument (Qlistp, list);
    }
}

DEFUN ("cdr-safe", Fcdr_safe, Scdr_safe, 1, 1, 0,
566 567
       doc: /* Return the cdr of OBJECT if it is a cons cell, or else nil.  */)
     (object)
Jim Blandy's avatar
Jim Blandy committed
568 569
     Lisp_Object object;
{
570
  if (CONSP (object))
571
    return XCDR (object);
Jim Blandy's avatar
Jim Blandy committed
572 573 574 575 576
  else
    return Qnil;
}

DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0,
577 578
       doc: /* Set the car of CELL to be NEWCAR.  Returns NEWCAR.  */)
     (cell, newcar)
Jim Blandy's avatar
Jim Blandy committed
579 580
     register Lisp_Object cell, newcar;
{
581
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
582 583 584
    cell = wrong_type_argument (Qconsp, cell);

  CHECK_IMPURE (cell);
585
  XSETCAR (cell, newcar);
Jim Blandy's avatar
Jim Blandy committed
586 587 588 589
  return newcar;
}

DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
590 591
       doc: /* Set the cdr of CELL to be NEWCDR.  Returns NEWCDR.  */)
     (cell, newcdr)
Jim Blandy's avatar
Jim Blandy committed
592 593
     register Lisp_Object cell, newcdr;
{
594
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
595 596 597
    cell = wrong_type_argument (Qconsp, cell);

  CHECK_IMPURE (cell);
598
  XSETCDR (cell, newcdr);
Jim Blandy's avatar
Jim Blandy committed
599 600 601 602 603
  return newcdr;
}

/* Extract and set components of symbols */

604 605 606
DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0,
       doc: /* Return t if SYMBOL's value is not void.  */)
     (symbol)
607
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
608 609
{
  Lisp_Object valcontents;
610
  CHECK_SYMBOL (symbol);
Jim Blandy's avatar
Jim Blandy committed
611

612
  valcontents = SYMBOL_VALUE (symbol);
Jim Blandy's avatar
Jim Blandy committed
613

Karl Heuer's avatar
Karl Heuer committed
614 615
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
616
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
617

618
  return (EQ (valcontents, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
619 620
}

621 622 623
DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0,
       doc: /* Return t if SYMBOL's function definition is not void.  */)
     (symbol)
624
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
625
{
626
  CHECK_SYMBOL (symbol);
627
  return (EQ (XSYMBOL (symbol)->function, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
628 629
}

630 631 632
DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0,
       doc: /* Make SYMBOL's value be void.  */)
     (symbol)
633
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
634
{
635
  CHECK_SYMBOL (symbol);
636
  if (XSYMBOL (symbol)->constant)
637 638 639
    return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
  Fset (symbol, Qunbound);
  return symbol;
Jim Blandy's avatar
Jim Blandy committed
640 641
}

642 643 644
DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0,
       doc: /* Make SYMBOL's function definition be void.  */)
     (symbol)
645
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
646
{
647
  CHECK_SYMBOL (symbol);
648 649 650 651
  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
652 653 654
}

DEFUN ("symbol-function", Fsymbol_function, Ssymbol_function, 1, 1, 0,
655 656
       doc: /* Return SYMBOL's function definition.  Error if that is void.  */)
     (symbol)
Jim Blandy's avatar
Jim Blandy committed
657
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
658
{
659
  CHECK_SYMBOL (symbol);
Jim Blandy's avatar
Jim Blandy committed
660 661 662
  if (EQ (XSYMBOL (symbol)->function, Qunbound))
    return Fsignal (Qvoid_function, Fcons (symbol, Qnil));
  return XSYMBOL (symbol)->function;
Jim Blandy's avatar
Jim Blandy committed
663 664
}

665 666 667
DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0,
       doc: /* Return SYMBOL's property list.  */)
     (symbol)
668
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
669
{
670
  CHECK_SYMBOL (symbol);
671
  return XSYMBOL (symbol)->plist;
Jim Blandy's avatar
Jim Blandy committed
672 673
}

674 675 676
DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0,
       doc: /* Return SYMBOL's name, a string.  */)
     (symbol)
677
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
678 679 680
{
  register Lisp_Object name;

681
  CHECK_SYMBOL (symbol);
682
  name = SYMBOL_NAME (symbol);
Jim Blandy's avatar
Jim Blandy committed
683 684 685 686
  return name;
}

DEFUN ("fset", Ffset, Sfset, 2, 2, 0,
687 688
       doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION.  */)
     (symbol, definition)
689
     register Lisp_Object symbol, definition;
690
{
691
  CHECK_SYMBOL (symbol);
692 693 694 695
  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
696
			     Vautoload_queue);
697
  XSYMBOL (symbol)->function = definition;
698
  /* Handle automatic advice activation */
699
  if (CONSP (XSYMBOL (symbol)->plist) && !NILP (Fget (symbol, Qad_advice_info)))
700
    {
701
      call2 (Qad_activate_internal, symbol, Qnil);
702
      definition = XSYMBOL (symbol)->function;
703
    }
704
  return definition;
Jim Blandy's avatar
Jim Blandy committed
705 706
}

707
DEFUN ("defalias", Fdefalias, Sdefalias, 2, 2, 0,
708 709 710
       doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION.
Associates the function with the current load file, if any.  */)
     (symbol, definition)
711
     register Lisp_Object symbol, definition;
712
{
713
  definition = Ffset (symbol, definition);
714
  LOADHIST_ATTACH (symbol);
715
  return definition;
716 717
}

Jim Blandy's avatar
Jim Blandy committed
718
DEFUN ("setplist", Fsetplist, Ssetplist, 2, 2, 0,
719 720
       doc: /* Set SYMBOL's property list to NEWVAL, and return NEWVAL.  */)
     (symbol, newplist)
721
     register Lisp_Object symbol, newplist;
Jim Blandy's avatar
Jim Blandy committed
722
{
723
  CHECK_SYMBOL (symbol);
724
  XSYMBOL (symbol)->plist = newplist;
Jim Blandy's avatar
Jim Blandy committed
725 726
  return newplist;
}
Jim Blandy's avatar
Jim Blandy committed
727

728
DEFUN ("subr-arity", Fsubr_arity, Ssubr_arity, 1, 1, 0,
729 730 731 732 733 734
       doc: /* Return minimum and maximum number of args allowed for SUBR.
SUBR must be a built-in function.
The returned value is a pair (MIN . MAX).  MIN is the minimum number
of args.  MAX is the maximum number or the symbol `many', for a
function with `&rest' args, or `unevalled' for a special form.  */)
     (subr)
735 736 737 738 739 740 741 742 743 744 745 746 747 748 749
     Lisp_Object subr;
{
  short minargs, maxargs;
  if (!SUBRP (subr))
    wrong_type_argument (Qsubrp, subr);
  minargs = XSUBR (subr)->min_args;
  maxargs = XSUBR (subr)->max_args;
  if (maxargs == MANY)
    return Fcons (make_number (minargs), Qmany);
  else if (maxargs == UNEVALLED)
    return Fcons (make_number (minargs), Qunevalled);
  else
    return Fcons (make_number (minargs), make_number (maxargs));
}

750
DEFUN ("subr-interactive-form", Fsubr_interactive_form, Ssubr_interactive_form, 1, 1, 0,
751 752 753 754
       doc: /* Return the interactive form of SUBR or nil if none.
SUBR must be a built-in function.  Value, if non-nil, is a list
\(interactive SPEC).  */)
     (subr)
755 756 757 758 759 760 761 762 763
     Lisp_Object subr;
{
  if (!SUBRP (subr))
    wrong_type_argument (Qsubrp, subr);
  if (XSUBR (subr)->prompt)
    return list2 (Qinteractive, build_string (XSUBR (subr)->prompt));
  return Qnil;
}

Jim Blandy's avatar
Jim Blandy committed
764

765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798
/***********************************************************************
		Getting and Setting Values of Symbols
 ***********************************************************************/

/* Return the symbol holding SYMBOL's value.  Signal
   `cyclic-variable-indirection' if SYMBOL's chain of variable
   indirections contains a loop.  */

Lisp_Object
indirect_variable (symbol)
     Lisp_Object symbol;
{
  Lisp_Object tortoise, hare;

  hare = tortoise = symbol;

  while (XSYMBOL (hare)->indirect_variable)
    {
      hare = XSYMBOL (hare)->value;
      if (!XSYMBOL (hare)->indirect_variable)
	break;
      
      hare = XSYMBOL (hare)->value;
      tortoise = XSYMBOL (tortoise)->value;

      if (EQ (hare, tortoise))
	Fsignal (Qcyclic_variable_indirection, Fcons (symbol, Qnil));
    }

  return hare;
}


DEFUN ("indirect-variable", Findirect_variable, Sindirect_variable, 1, 1, 0,
799 800 801 802 803 804
       doc: /* Return the variable at the end of OBJECT's variable chain.
If OBJECT is a symbol, follow all variable indirections and return the final
variable.  If OBJECT is not a symbol, just return it.
Signal a cyclic-variable-indirection error if there is a loop in the
variable chain of symbols.  */)
     (object)
805 806 807 808 809 810 811
     Lisp_Object object;
{
  if (SYMBOLP (object))
    object = indirect_variable (object);
  return object;
}

Jim Blandy's avatar
Jim Blandy committed
812 813 814 815 816 817 818 819 820 821 822

/* 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;
823 824
  int offset;
  if (MISCP (valcontents))
825
    switch (XMISCTYPE (valcontents))
826 827 828 829
      {
      case Lisp_Misc_Intfwd:
	XSETINT (val, *XINTFWD (valcontents)->intvar);
	return val;
Jim Blandy's avatar
Jim Blandy committed
830

831 832
      case Lisp_Misc_Boolfwd:
	return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
833

834 835
      case Lisp_Misc_Objfwd:
	return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
836

837 838
      case Lisp_Misc_Buffer_Objfwd:
	offset = XBUFFER_OBJFWD (valcontents)->offset;
Gerd Moellmann's avatar
Gerd Moellmann committed
839
	return PER_BUFFER_VALUE (current_buffer, offset);
840

841 842 843
      case Lisp_Misc_Kboard_Objfwd:
	offset = XKBOARD_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_kboard);
844
      }
Jim Blandy's avatar
Jim Blandy committed
845 846 847
  return valcontents;
}

848 849
/* 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
850
   buffer-independent contents of the value cell: forwarded just one
851 852 853 854
   step past the buffer-localness.

   BUF non-zero means set the value in buffer BUF instead of the
   current buffer.  This only plays a role for per-buffer variables.  */
Jim Blandy's avatar
Jim Blandy committed
855 856

void
857
store_symval_forwarding (symbol, valcontents, newval, buf)
858
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
859
     register Lisp_Object valcontents, newval;
860
     struct buffer *buf;
Jim Blandy's avatar
Jim Blandy committed
861
{
862
  switch (SWITCH_ENUM_CAST (XTYPE (valcontents)))
Jim Blandy's avatar
Jim Blandy committed
863
    {
864
    case Lisp_Misc:
865
      switch (XMISCTYPE (valcontents))
866 867
	{
	case Lisp_Misc_Intfwd:
868
	  CHECK_NUMBER (newval);
869
	  *XINTFWD (valcontents)->intvar = XINT (newval);
870 871
	  if (*XINTFWD (valcontents)->intvar != XINT (newval))
	    error ("Value out of range for variable `%s'",
872
		   XSTRING (SYMBOL_NAME (symbol))->data);
873 874 875 876 877 878 879 880 881 882 883 884 885 886 887
	  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;

Gerd Moellmann's avatar
Gerd Moellmann committed
888
	    type = PER_BUFFER_TYPE (offset);
889
	    if (XINT (type) == -1)
890
	      error ("Variable %s is read-only", XSTRING (SYMBOL_NAME (symbol))->data);
891

892 893 894 895
	    if (! NILP (type) && ! NILP (newval)
		&& XTYPE (newval) != XINT (type))
	      buffer_slot_type_mismatch (offset);

896 897 898
	    if (buf == NULL)
	      buf = current_buffer;
	    PER_BUFFER_VALUE (buf, offset) = newval;
899
	  }
900 901
	  break;

902
	case Lisp_Misc_Kboard_Objfwd:
903 904 905 906 907
	  {
	    char *base = (char *) current_kboard;
	    char *p = base + XKBOARD_OBJFWD (valcontents)->offset;
	    *(Lisp_Object *) p = newval;
	  }
908 909
	  break;

910 911 912
	default:
	  goto def;
	}
Jim Blandy's avatar
Jim Blandy committed
913 914 915
      break;

    default:
916
    def:
917
      valcontents = SYMBOL_VALUE (symbol);
918 919
      if (BUFFER_LOCAL_VALUEP (valcontents)
	  || SOME_BUFFER_LOCAL_VALUEP (valcontents))