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

This file is part of GNU Emacs.

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

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

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


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

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

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

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

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

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

Jim Blandy's avatar
Jim Blandy committed
79
Lisp_Object Qcdr;
80
Lisp_Object Qad_advice_info, Qad_activate_internal;
Jim Blandy's avatar
Jim Blandy committed
81

82 83 84
Lisp_Object Qrange_error, Qdomain_error, Qsingularity_error;
Lisp_Object Qoverflow_error, Qunderflow_error;

85
Lisp_Object Qfloatp;
Jim Blandy's avatar
Jim Blandy committed
86 87
Lisp_Object Qnumberp, Qnumber_or_marker_p;

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

Jim Blandy's avatar
Jim Blandy committed
95 96
static Lisp_Object swap_in_symval_forwarding ();

97 98
Lisp_Object set_internal ();

Jim Blandy's avatar
Jim Blandy committed
99 100 101 102 103 104 105 106 107
Lisp_Object
wrong_type_argument (predicate, value)
     register Lisp_Object predicate, value;
{
  register Lisp_Object tem;
  do
    {
      if (!EQ (Vmocklisp_arguments, Qt))
	{
108
	 if (STRINGP (value) &&
Jim Blandy's avatar
Jim Blandy committed
109
	     (EQ (predicate, Qintegerp) || EQ (predicate, Qinteger_or_marker_p)))
110
	   return Fstring_to_number (value, Qnil);
111
	 if (INTEGERP (value) && EQ (predicate, Qstringp))
112
	   return Fnumber_to_string (value);
Jim Blandy's avatar
Jim Blandy committed
113
	}
114 115 116

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

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

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

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

Richard M. Stallman's avatar
Richard M. Stallman committed
178
DEFUN ("null", Fnull, Snull, 1, 1, 0, "Return t if OBJECT is nil.")
179 180
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
181
{
182
  if (NILP (object))
Jim Blandy's avatar
Jim Blandy committed
183 184 185 186
    return Qt;
  return Qnil;
}

187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208
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:
209
      switch (XMISCTYPE (object))
210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232
	{
	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;
233 234 235 236
      if (GC_CHAR_TABLE_P (object))
	return Qchar_table;
      if (GC_BOOL_VECTOR_P (object))
	return Qbool_vector;
237 238
      if (GC_FRAMEP (object))
	return Qframe;
Gerd Moellmann's avatar
Gerd Moellmann committed
239 240
      if (GC_HASH_TABLE_P (object))
	return Qhash_table;
241 242 243 244 245 246 247 248 249 250
      return Qvector;

    case Lisp_Float:
      return Qfloat;

    default:
      abort ();
    }
}

Richard M. Stallman's avatar
Richard M. Stallman committed
251
DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0, "Return t if OBJECT is a cons cell.")
252 253
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
254
{
255
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
256 257 258 259
    return Qt;
  return Qnil;
}

260 261
DEFUN ("atom", Fatom, Satom, 1, 1, 0,
       "Return t if OBJECT is not a cons cell.  This includes nil.")
262 263
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
264
{
265
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
266 267 268 269
    return Qnil;
  return Qt;
}

270 271
DEFUN ("listp", Flistp, Slistp, 1, 1, 0,
       "Return t if OBJECT is a list.  This includes nil.")
272 273
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
274
{
275
  if (CONSP (object) || NILP (object))
Jim Blandy's avatar
Jim Blandy committed
276 277 278 279
    return Qt;
  return Qnil;
}

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

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

316 317
DEFUN ("vectorp", Fvectorp, Svectorp, 1, 1, 0,
       "Return t if OBJECT is a vector.")
318 319
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
320
{
321
  if (VECTORP (object))
Jim Blandy's avatar
Jim Blandy committed
322 323 324 325
    return Qt;
  return Qnil;
}

326 327
DEFUN ("stringp", Fstringp, Sstringp, 1, 1, 0,
       "Return t if OBJECT is a string.")
328 329
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
330
{
331
  if (STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
332 333 334 335
    return Qt;
  return Qnil;
}

336 337 338 339 340 341 342 343 344 345 346 347
DEFUN ("multibyte-string-p", Fmultibyte_string_p, Smultibyte_string_p,
       1, 1, 0, "Return t if OBJECT is a multibyte string.")
  (object)
     Lisp_Object object;
{
  if (STRINGP (object) && STRING_MULTIBYTE (object))
    return Qt;
  return Qnil;
}

DEFUN ("char-table-p", Fchar_table_p, Schar_table_p, 1, 1, 0,
       "Return t if OBJECT is a char-table.")
348 349 350 351 352 353 354 355
  (object)
     Lisp_Object object;
{
  if (CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

356 357
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
358
       "Return t if OBJECT is a char-table or vector.")
359 360 361 362 363 364 365 366
  (object)
     Lisp_Object object;
{
  if (VECTORP (object) || CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

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

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

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

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

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

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

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

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

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

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

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

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

DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
496
       "Return t if OBJECT is a floating point number.")
497 498
  (object)
     Lisp_Object object;
499
{
500
  if (FLOATP (object))
501 502 503
    return Qt;
  return Qnil;
}
504

Jim Blandy's avatar
Jim Blandy committed
505 506 507 508

/* Extract and set components of lists */

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

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

  (list)
     register Lisp_Object list;
{
  while (1)
    {
545
      if (CONSP (list))
546
	return XCDR (list);
Jim Blandy's avatar
Jim Blandy committed
547 548 549 550 551 552 553 554
      else if (EQ (list, Qnil))
	return Qnil;
      else
	list = wrong_type_argument (Qlistp, list);
    }
}

DEFUN ("cdr-safe", Fcdr_safe, Scdr_safe, 1, 1, 0,
555
  "Return the cdr of OBJECT if it is a cons cell, or else nil.")
Jim Blandy's avatar
Jim Blandy committed
556 557 558
  (object)
     Lisp_Object object;
{
559
  if (CONSP (object))
560
    return XCDR (object);
Jim Blandy's avatar
Jim Blandy committed
561 562 563 564 565
  else
    return Qnil;
}

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

  CHECK_IMPURE (cell);
574
  XCAR (cell) = newcar;
Jim Blandy's avatar
Jim Blandy committed
575 576 577 578
  return newcar;
}

DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
579
  "Set the cdr of CELL to be NEWCDR.  Returns NEWCDR.")
Jim Blandy's avatar
Jim Blandy committed
580 581 582
  (cell, newcdr)
     register Lisp_Object cell, newcdr;
{
583
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
584 585 586
    cell = wrong_type_argument (Qconsp, cell);

  CHECK_IMPURE (cell);
587
  XCDR (cell) = newcdr;
Jim Blandy's avatar
Jim Blandy committed
588 589 590 591 592
  return newcdr;
}

/* Extract and set components of symbols */

Richard M. Stallman's avatar
Richard M. Stallman committed
593
DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0, "Return t if SYMBOL's value is not void.")
594 595
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
596 597
{
  Lisp_Object valcontents;
598
  CHECK_SYMBOL (symbol, 0);
Jim Blandy's avatar
Jim Blandy committed
599

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

Karl Heuer's avatar
Karl Heuer committed
602 603
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
604
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
605

606
  return (EQ (valcontents, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
607 608
}

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

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

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

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

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

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

666 667
  CHECK_SYMBOL (symbol, 0);
  XSETSTRING (name, XSYMBOL (symbol)->name);
Jim Blandy's avatar
Jim Blandy committed
668 669 670 671
  return name;
}

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

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

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

713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734
DEFUN ("subr-arity", Fsubr_arity, Ssubr_arity, 1, 1, 0,
  "Return minimum and maximum number of args allowed for SUBR.\n\
SUBR must be a built-in function.\n\
The returned value is a pair (MIN . MAX).  MIN is the minimum number\n\
of args.  MAX is the maximum number or the symbol `many', for a\n\
function with `&rest' args, or `unevalled' for a special form.")
  (subr)
     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));
}

Jim Blandy's avatar
Jim Blandy committed
735 736 737 738 739 740 741 742 743 744 745 746 747

/* 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;
748 749
  int offset;
  if (MISCP (valcontents))
750
    switch (XMISCTYPE (valcontents))
751 752 753 754
      {
      case Lisp_Misc_Intfwd:
	XSETINT (val, *XINTFWD (valcontents)->intvar);
	return val;
Jim Blandy's avatar
Jim Blandy committed
755

756 757
      case Lisp_Misc_Boolfwd:
	return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
758

759 760
      case Lisp_Misc_Objfwd:
	return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
761

762 763
      case Lisp_Misc_Buffer_Objfwd:
	offset = XBUFFER_OBJFWD (valcontents)->offset;
Gerd Moellmann's avatar
Gerd Moellmann committed
764
	return PER_BUFFER_VALUE (current_buffer, offset);
765

766 767 768
      case Lisp_Misc_Kboard_Objfwd:
	offset = XKBOARD_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_kboard);
769
      }
Jim Blandy's avatar
Jim Blandy committed
770 771 772
  return valcontents;
}

773 774
/* 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
775 776 777 778
   buffer-independent contents of the value cell: forwarded just one
   step past the buffer-localness.  */

void
779 780
store_symval_forwarding (symbol, valcontents, newval)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
781 782
     register Lisp_Object valcontents, newval;
{
783
  switch (SWITCH_ENUM_CAST (XTYPE (valcontents)))
Jim Blandy's avatar
Jim Blandy committed
784
    {
785
    case Lisp_Misc:
786
      switch (XMISCTYPE (valcontents))
787 788 789 790
	{
	case Lisp_Misc_Intfwd:
	  CHECK_NUMBER (newval, 1);
	  *XINTFWD (valcontents)->intvar = XINT (newval);
791 792
	  if (*XINTFWD (valcontents)->intvar != XINT (newval))
	    error ("Value out of range for variable `%s'",
793
		   XSYMBOL (symbol)->name->data);
794 795 796 797 798 799 800 801 802 803 804 805 806 807 808
	  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
809
	    type = PER_BUFFER_TYPE (offset);
810 811 812
	    if (XINT (type) == -1)
	      error ("Variable %s is read-only", XSYMBOL (symbol)->name->data);

813 814 815 816
	    if (! NILP (type) && ! NILP (newval)
		&& XTYPE (newval) != XINT (type))
	      buffer_slot_type_mismatch (offset);

Gerd Moellmann's avatar
Gerd Moellmann committed
817
	    PER_BUFFER_VALUE (current_buffer, offset) = newval;
818
	  }
819 820
	  break;

821 822 823
	case Lisp_Misc_Kboard_Objfwd:
	  (*(Lisp_Object *)((char *)current_kboard
			    + XKBOARD_OBJFWD (valcontents)->offset))
824 825 826
	    = newval;
	  break;

827 828 829
	default:
	  goto def;
	}
Jim Blandy's avatar
Jim Blandy committed
830 831 832
      break;

    default:
833
    def:
834
      valcontents = XSYMBOL (symbol)->value;
835 836
      if (BUFFER_LOCAL_VALUEP (valcontents)
	  || SOME_BUFFER_LOCAL_VALUEP (valcontents))
837
	XBUFFER_LOCAL_VALUE (valcontents)->realvalue = newval;
Jim Blandy's avatar
Jim Blandy committed
838
      else
839
	XSYMBOL (symbol)->value = newval;
Jim Blandy's avatar
Jim Blandy committed
840 841 842
    }
}

843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872
/* Set up SYMBOL to refer to its global binding.
   This makes it safe to alter the status of other bindings.  */

void
swap_in_global_binding (symbol)
     Lisp_Object symbol;
{
  Lisp_Object valcontents, cdr;
  
  valcontents = XSYMBOL (symbol)->value;
  if (!BUFFER_LOCAL_VALUEP (valcontents)
      && !SOME_BUFFER_LOCAL_VALUEP (valcontents))
    abort ();
  cdr = XBUFFER_LOCAL_VALUE (valcontents)->cdr;

  /* Unload the previously loaded binding.  */
  Fsetcdr (XCAR (cdr),
	   do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
  
  /* Select the global binding in the symbol.  */
  XCAR (cdr) = cdr;
  store_symval_forwarding (symbol, valcontents, XCDR (cdr));

  /* Indicate that the global binding is set up now.  */
  XBUFFER_LOCAL_VALUE (valcontents)->frame = Qnil;
  XBUFFER_LOCAL_VALUE (valcontents)->buffer = Qnil;
  XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
  XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
}

873
/* Set up the buffer-local symbol SYMBOL for validity in the current buffer.
874 875 876 877 878
   VALCONTENTS is the contents of its value cell,
   which points to a struct Lisp_Buffer_Local_Value.

   Return the value forwarded one step past the buffer-local stage.
   This could be another forwarding pointer.  */
Jim Blandy's avatar
Jim Blandy committed
879 880

static Lisp_Object
881 882
swap_in_symval_forwarding (symbol, valcontents)
     Lisp_Object symbol, valcontents;
Jim Blandy's avatar
Jim Blandy committed
883 884
{
  register Lisp_Object tem1;
885
  tem1 = XBUFFER_LOCAL_VALUE (valcontents)->buffer;
Jim Blandy's avatar
Jim Blandy committed
886

887 888 889 890
  if (NILP (tem1)
      || current_buffer != XBUFFER (tem1)
      || (XBUFFER_LOCAL_VALUE (valcontents)->check_frame
	  && ! EQ (selected_frame, XBUFFER_LOCAL_VALUE (valcontents)->frame)))
Jim Blandy's avatar
Jim Blandy committed
891
    {
892
      /* Unload the previously loaded binding.  */
893
      tem1 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
894
      Fsetcdr (tem1,
895
	       do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
896
      /* Choose the new binding.  */
897
      tem1 = assq_no_quit (symbol, current_buffer->local_var_alist);
898 899
      XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
      XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
Jim Blandy's avatar
Jim Blandy committed
900
      if (NILP (tem1))
901 902
	{
	  if (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
903
	    tem1 = assq_no_quit (symbol, XFRAME (selected_frame)->param_alist);
904 905 906 907 908 909 910 911
	  if (! NILP (tem1))
	    XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 1;
	  else
	    tem1 = XBUFFER_LOCAL_VALUE (valcontents)->cdr;
	}
      else
	XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 1;

912
      /* Load the new binding.  */
913
      XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr) = tem1;
914
      XSETBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer, current_buffer);
915
      XBUFFER_LOCAL_VALUE (valcontents)->frame = selected_frame;
916 917
      store_symval_forwarding (symbol,
			       XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
918
			       Fcdr (tem1));
Jim Blandy's avatar
Jim Blandy committed
919
    }
920
  return XBUFFER_LOCAL_VALUE (valcontents)->realvalue;
Jim Blandy's avatar
Jim Blandy committed
921 922
}

Jim Blandy's avatar
Jim Blandy committed
923 924
/* 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
925
   if it has one, without signaling an error.
Jim Blandy's avatar
Jim Blandy committed
926 927
   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
928

Jim Blandy's avatar
Jim Blandy committed
929
Lisp_Object
930 931
find_symbol_value (symbol)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
932
{
933
  register Lisp_Object valcontents;
Jim Blandy's avatar
Jim Blandy committed
934
  register Lisp_Object val;
935