data.c 89.7 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 100
int most_positive_fixnum, most_negative_fixnum;

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 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,
180 181
       doc: /* Return t if the two args are the same Lisp object.  */)
     (obj1, obj2)
Jim Blandy's avatar
Jim Blandy committed
182 183 184 185 186 187 188
     Lisp_Object obj1, obj2;
{
  if (EQ (obj1, obj2))
    return Qt;
  return Qnil;
}

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

199
DEFUN ("type-of", Ftype_of, Stype_of, 1, 1, 0,
200 201 202 203
       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)
204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220
     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:
221
      switch (XMISCTYPE (object))
222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244
	{
	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;
245 246 247 248
      if (GC_CHAR_TABLE_P (object))
	return Qchar_table;
      if (GC_BOOL_VECTOR_P (object))
	return Qbool_vector;
249 250
      if (GC_FRAMEP (object))
	return Qframe;
Gerd Moellmann's avatar
Gerd Moellmann committed
251 252
      if (GC_HASH_TABLE_P (object))
	return Qhash_table;
253 254 255 256 257 258 259 260 261 262
      return Qvector;

    case Lisp_Float:
      return Qfloat;

    default:
      abort ();
    }
}

263 264 265
DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0,
       doc: /* Return t if OBJECT is a cons cell.  */)
     (object)
266
     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;
}

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

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

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

Dave Love's avatar
Dave Love committed
313 314 315
/* Define this in C to avoid unnecessarily consing up the symbol
   name.  */
DEFUN ("keywordp", Fkeywordp, Skeywordp, 1, 1, 0,
316 317 318 319
       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
320 321 322 323
     Lisp_Object object;
{
  if (SYMBOLP (object)
      && XSYMBOL (object)->name->data[0] == ':'
324
      && SYMBOL_INTERNED_IN_INITIAL_OBARRAY_P (object))
Dave Love's avatar
Dave Love committed
325 326 327 328
    return Qt;
  return Qnil;
}

329
DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0,
330 331
       doc: /* Return t if OBJECT is a vector.  */)
     (object)
332
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
333
{
334
  if (VECTORP (object))
Jim Blandy's avatar
Jim Blandy committed
335 336 337 338
    return Qt;
  return Qnil;
}

339
DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0,
340 341
       doc: /* Return t if OBJECT is a string.  */)
     (object)
342
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
343
{
344
  if (STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
345 346 347 348
    return Qt;
  return Qnil;
}

349
DEFUN ("multibyte-string-p", Fmultibyte_string_p, Smultibyte_string_p,
350 351 352
       1, 1, 0,
       doc: /* Return t if OBJECT is a multibyte string.  */)
     (object)
353 354 355 356 357 358 359 360
     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,
361 362
       doc: /* Return t if OBJECT is a char-table.  */)
     (object)
363 364 365 366 367 368 369
     Lisp_Object object;
{
  if (CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

370 371
DEFUN ("vector-or-char-table-p", Fvector_or_char_table_p,
       Svector_or_char_table_p, 1, 1, 0,
372 373
       doc: /* Return t if OBJECT is a char-table or vector.  */)
     (object)
374 375 376 377 378 379 380
     Lisp_Object object;
{
  if (VECTORP (object) || CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

381 382 383
DEFUN ("bool-vector-p", Fbool_vector_p, Sbool_vector_p, 1, 1, 0,
       doc: /* Return t if OBJECT is a bool-vector.  */)
     (object)
384 385 386 387 388 389 390
     Lisp_Object object;
{
  if (BOOL_VECTOR_P (object))
    return Qt;
  return Qnil;
}

391 392 393
DEFUN ("arrayp", Farrayp, Sarrayp, 1, 1, 0,
       doc: /* Return t if OBJECT is an array (string or vector).  */)
     (object)
394
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
395
{
396 397
  if (VECTORP (object) || STRINGP (object)
      || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
Jim Blandy's avatar
Jim Blandy committed
398 399 400 401 402
    return Qt;
  return Qnil;
}

DEFUN ("sequencep", Fsequencep, Ssequencep, 1, 1, 0,
403 404
       doc: /* Return t if OBJECT is a sequence (list or array).  */)
     (object)
405
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
406
{
407 408
  if (CONSP (object) || NILP (object) || VECTORP (object) || STRINGP (object)
      || CHAR_TABLE_P (object) || BOOL_VECTOR_P (object))
Jim Blandy's avatar
Jim Blandy committed
409 410 411 412
    return Qt;
  return Qnil;
}

413 414 415
DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0,
       doc: /* Return t if OBJECT is an editor buffer.  */)
     (object)
416
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
417
{
418
  if (BUFFERP (object))
Jim Blandy's avatar
Jim Blandy committed
419 420 421 422
    return Qt;
  return Qnil;
}

423 424 425
DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0,
       doc: /* Return t if OBJECT is a marker (editor pointer).  */)
     (object)
426
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
427
{
428
  if (MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
429 430 431 432
    return Qt;
  return Qnil;
}

433 434 435
DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0,
       doc: /* Return t if OBJECT is a built-in function.  */)
     (object)
436
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
437
{
438
  if (SUBRP (object))
Jim Blandy's avatar
Jim Blandy committed
439 440 441 442
    return Qt;
  return Qnil;
}

Jim Blandy's avatar
Jim Blandy committed
443
DEFUN ("byte-code-function-p", Fbyte_code_function_p, Sbyte_code_function_p,
444 445 446
       1, 1, 0,
       doc: /* Return t if OBJECT is a byte-compiled function object.  */)
     (object)
447
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
448
{
449
  if (COMPILEDP (object))
Jim Blandy's avatar
Jim Blandy committed
450 451 452 453
    return Qt;
  return Qnil;
}

454
DEFUN ("char-or-string-p", Fchar_or_string_p, Schar_or_string_p, 1, 1, 0,
455 456
       doc: /* Return t if OBJECT is a character (an integer) or a string.  */)
     (object)
457
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
458
{
459
  if (INTEGERP (object) || STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
460 461 462 463
    return Qt;
  return Qnil;
}

464 465 466
DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0,
       doc: /* Return t if OBJECT is an integer.  */)
     (object)
467
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
468
{
469
  if (INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
470 471 472 473
    return Qt;
  return Qnil;
}

474
DEFUN ("integer-or-marker-p", Finteger_or_marker_p, Sinteger_or_marker_p, 1, 1, 0,
475 476
       doc: /* Return t if OBJECT is an integer or a marker (editor pointer).  */)
     (object)
477
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
478
{
479
  if (MARKERP (object) || INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
480 481 482 483
    return Qt;
  return Qnil;
}

484
DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0,
485 486
       doc: /* Return t if OBJECT is a nonnegative integer.  */)
     (object)
487
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
488
{
489
  if (NATNUMP (object))
Jim Blandy's avatar
Jim Blandy committed
490 491 492 493 494
    return Qt;
  return Qnil;
}

DEFUN ("numberp", Fnumberp, Snumberp, 1, 1, 0,
495 496
       doc: /* Return t if OBJECT is a number (floating point or integer).  */)
     (object)
497
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
498
{
499
  if (NUMBERP (object))
Jim Blandy's avatar
Jim Blandy committed
500
    return Qt;
Jim Blandy's avatar
Jim Blandy committed
501 502
  else
    return Qnil;
Jim Blandy's avatar
Jim Blandy committed
503 504 505 506
}

DEFUN ("number-or-marker-p", Fnumber_or_marker_p,
       Snumber_or_marker_p, 1, 1, 0,
507 508
       doc: /* Return t if OBJECT is a number or a marker.  */)
     (object)
509
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
510
{
511
  if (NUMBERP (object) || MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
512 513 514
    return Qt;
  return Qnil;
}
515 516

DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
517 518
       doc: /* Return t if OBJECT is a floating point number.  */)
     (object)
519
     Lisp_Object object;
520
{
521
  if (FLOATP (object))
522 523 524
    return Qt;
  return Qnil;
}
525

Jim Blandy's avatar
Jim Blandy committed
526 527 528 529

/* Extract and set components of lists */

DEFUN ("car", Fcar, Scar, 1, 1, 0,
530 531 532
       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
533 534 535 536
     register Lisp_Object list;
{
  while (1)
    {
537
      if (CONSP (list))
538
	return XCAR (list);
Jim Blandy's avatar
Jim Blandy committed
539 540 541 542 543 544 545 546
      else if (EQ (list, Qnil))
	return Qnil;
      else
	list = wrong_type_argument (Qlistp, list);
    }
}

DEFUN ("car-safe", Fcar_safe, Scar_safe, 1, 1, 0,
547 548
       doc: /* Return the car of OBJECT if it is a cons cell, or else nil.  */)
     (object)
Jim Blandy's avatar
Jim Blandy committed
549 550
     Lisp_Object object;
{
551
  if (CONSP (object))
552
    return XCAR (object);
Jim Blandy's avatar
Jim Blandy committed
553 554 555 556 557
  else
    return Qnil;
}

DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
558 559 560
       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
561 562 563 564
     register Lisp_Object list;
{
  while (1)
    {
565
      if (CONSP (list))
566
	return XCDR (list);
Jim Blandy's avatar
Jim Blandy committed
567 568 569 570 571 572 573 574
      else if (EQ (list, Qnil))
	return Qnil;
      else
	list = wrong_type_argument (Qlistp, list);
    }
}

DEFUN ("cdr-safe", Fcdr_safe, Scdr_safe, 1, 1, 0,
575 576
       doc: /* Return the cdr of OBJECT if it is a cons cell, or else nil.  */)
     (object)
Jim Blandy's avatar
Jim Blandy committed
577 578
     Lisp_Object object;
{
579
  if (CONSP (object))
580
    return XCDR (object);
Jim Blandy's avatar
Jim Blandy committed
581 582 583 584 585
  else
    return Qnil;
}

DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0,
586 587
       doc: /* Set the car of CELL to be NEWCAR.  Returns NEWCAR.  */)
     (cell, newcar)
Jim Blandy's avatar
Jim Blandy committed
588 589
     register Lisp_Object cell, newcar;
{
590
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
591 592 593
    cell = wrong_type_argument (Qconsp, cell);

  CHECK_IMPURE (cell);
594
  XSETCAR (cell, newcar);
Jim Blandy's avatar
Jim Blandy committed
595 596 597 598
  return newcar;
}

DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
599 600
       doc: /* Set the cdr of CELL to be NEWCDR.  Returns NEWCDR.  */)
     (cell, newcdr)
Jim Blandy's avatar
Jim Blandy committed
601 602
     register Lisp_Object cell, newcdr;
{
603
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
604 605 606
    cell = wrong_type_argument (Qconsp, cell);

  CHECK_IMPURE (cell);
607
  XSETCDR (cell, newcdr);
Jim Blandy's avatar
Jim Blandy committed
608 609 610 611 612
  return newcdr;
}

/* Extract and set components of symbols */

613 614 615
DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0,
       doc: /* Return t if SYMBOL's value is not void.  */)
     (symbol)
616
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
617 618
{
  Lisp_Object valcontents;
619
  CHECK_SYMBOL (symbol);
Jim Blandy's avatar
Jim Blandy committed
620

621
  valcontents = SYMBOL_VALUE (symbol);
Jim Blandy's avatar
Jim Blandy committed
622

Karl Heuer's avatar
Karl Heuer committed
623 624
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
625
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
626

627
  return (EQ (valcontents, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
628 629
}

630 631 632
DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0,
       doc: /* Return t if SYMBOL's function definition is not void.  */)
     (symbol)
633
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
634
{
635
  CHECK_SYMBOL (symbol);
636
  return (EQ (XSYMBOL (symbol)->function, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
637 638
}

639 640 641
DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0,
       doc: /* Make SYMBOL's value be void.  */)
     (symbol)
642
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
643
{
644
  CHECK_SYMBOL (symbol);
645
  if (XSYMBOL (symbol)->constant)
646 647 648
    return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
  Fset (symbol, Qunbound);
  return symbol;
Jim Blandy's avatar
Jim Blandy committed
649 650
}

651 652 653
DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0,
       doc: /* Make SYMBOL's function definition be void.  */)
     (symbol)
654
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
655
{
656
  CHECK_SYMBOL (symbol);
657 658 659 660
  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
661 662 663
}

DEFUN ("symbol-function", Fsymbol_function, Ssymbol_function, 1, 1, 0,
664 665
       doc: /* Return SYMBOL's function definition.  Error if that is void.  */)
     (symbol)
Jim Blandy's avatar
Jim Blandy committed
666
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
667
{
668
  CHECK_SYMBOL (symbol);
Jim Blandy's avatar
Jim Blandy committed
669 670 671
  if (EQ (XSYMBOL (symbol)->function, Qunbound))
    return Fsignal (Qvoid_function, Fcons (symbol, Qnil));
  return XSYMBOL (symbol)->function;
Jim Blandy's avatar
Jim Blandy committed
672 673
}

674 675 676
DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0,
       doc: /* Return SYMBOL's property list.  */)
     (symbol)
677
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
678
{
679
  CHECK_SYMBOL (symbol);
680
  return XSYMBOL (symbol)->plist;
Jim Blandy's avatar
Jim Blandy committed
681 682
}

683 684 685
DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0,
       doc: /* Return SYMBOL's name, a string.  */)
     (symbol)
686
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
687 688 689
{
  register Lisp_Object name;

690
  CHECK_SYMBOL (symbol);
691
  XSETSTRING (name, XSYMBOL (symbol)->name);
Jim Blandy's avatar
Jim Blandy committed
692 693 694 695
  return name;
}

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

716
DEFUN ("defalias", Fdefalias, Sdefalias, 2, 2, 0,
717 718 719
       doc: /* Set SYMBOL's function definition to DEFINITION, and return DEFINITION.
Associates the function with the current load file, if any.  */)
     (symbol, definition)
720
     register Lisp_Object symbol, definition;
721
{
722
  definition = Ffset (symbol, definition);
723
  LOADHIST_ATTACH (symbol);
724
  return definition;
725 726
}

Jim Blandy's avatar
Jim Blandy committed
727
DEFUN ("setplist", Fsetplist, Ssetplist, 2, 2, 0,
728 729
       doc: /* Set SYMBOL's property list to NEWVAL, and return NEWVAL.  */)
     (symbol, newplist)
730
     register Lisp_Object symbol, newplist;
Jim Blandy's avatar
Jim Blandy committed
731
{
732
  CHECK_SYMBOL (symbol);
733
  XSYMBOL (symbol)->plist = newplist;
Jim Blandy's avatar
Jim Blandy committed
734 735
  return newplist;
}
Jim Blandy's avatar
Jim Blandy committed
736

737
DEFUN ("subr-arity", Fsubr_arity, Ssubr_arity, 1, 1, 0,
738 739 740 741 742 743
       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)
744 745 746 747 748 749 750 751 752 753 754 755 756 757 758
     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));
}

759
DEFUN ("subr-interactive-form", Fsubr_interactive_form, Ssubr_interactive_form, 1, 1, 0,
760 761 762 763
       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)
764 765 766 767 768 769 770 771 772
     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
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 799 800 801 802 803 804 805 806 807
/***********************************************************************
		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,
808 809 810 811 812 813
       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)
814 815 816 817 818 819 820
     Lisp_Object object;
{
  if (SYMBOLP (object))
    object = indirect_variable (object);
  return object;
}

Jim Blandy's avatar
Jim Blandy committed
821 822 823 824 825 826 827 828 829 830 831

/* 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;
832 833
  int offset;
  if (MISCP (valcontents))
834
    switch (XMISCTYPE (valcontents))
835 836 837 838
      {
      case Lisp_Misc_Intfwd:
	XSETINT (val, *XINTFWD (valcontents)->intvar);
	return val;
Jim Blandy's avatar
Jim Blandy committed
839

840 841
      case Lisp_Misc_Boolfwd:
	return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
842

843 844
      case Lisp_Misc_Objfwd:
	return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
845

846 847
      case Lisp_Misc_Buffer_Objfwd:
	offset = XBUFFER_OBJFWD (valcontents)->offset;
Gerd Moellmann's avatar
Gerd Moellmann committed
848
	return PER_BUFFER_VALUE (current_buffer, offset);
849

850 851 852
      case Lisp_Misc_Kboard_Objfwd:
	offset = XKBOARD_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_kboard);
853
      }
Jim Blandy's avatar
Jim Blandy committed
854 855 856
  return valcontents;
}

857 858
/* 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
859
   buffer-independent contents of the value cell: forwarded just one
860 861 862 863
   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
864 865

void
866
store_symval_forwarding (symbol, valcontents, newval, buf)
867
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
868
     register Lisp_Object valcontents, newval;
869
     struct buffer *buf;
Jim Blandy's avatar
Jim Blandy committed
870
{
871
  switch (SWITCH_ENUM_CAST (XTYPE (valcontents)))
Jim Blandy's avatar
Jim Blandy committed
872
    {
873
    case Lisp_Misc:
874
      switch (XMISCTYPE (valcontents))
875 876
	{
	case Lisp_Misc_Intfwd:
877
	  CHECK_NUMBER (newval);
878
	  *XINTFWD (valcontents)->intvar = XINT (newval);
879 880
	  if (*XINTFWD (valcontents)->intvar != XINT (newval))
	    error ("Value out of range for variable `%s'",
881
		   XSYMBOL (symbol)->name->data);
882 883 884 885 886 887 888 889 890 891 892 893 894 895 896
	  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
897
	    type = PER_BUFFER_TYPE (offset);
898 899 900
	    if (XINT (type) == -1)
	      error ("Variable %s is read-only", XSYMBOL (symbol)->name->data);

901 902 903 904
	    if (! NILP (type) && ! NILP (newval)
		&& XTYPE (newval) != XINT (type))
	      buffer_slot_type_mismatch (offset);

905 906 907
	    if (buf == NULL)
	      buf = current_buffer;
	    PER_BUFFER_VALUE (buf, offset) = newval;
908
	  }
909 910
	  break;

911
	case Lisp_Misc_Kboard_Objfwd:
912 913 914 915 916
	  {
	    char *base = (char *) current_kboard;
	    char *p = base + XKBOARD_OBJFWD (valcontents)->offset;
	    *(Lisp_Object *) p = newval;
	  }
917 918
	  break;

919 920 921
	default:
	  goto def;
	}
Jim Blandy's avatar
Jim Blandy committed
922 923 924
      break;

    default: