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

This file is part of GNU Emacs.

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

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

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


22
#include <config.h>
23
#include <signal.h>
24
#include <stdio.h>
Jim Blandy's avatar
Jim Blandy committed
25
#include "lisp.h"
Jim Blandy's avatar
Jim Blandy committed
26
#include "puresize.h"
Karl Heuer's avatar
Karl Heuer committed
27
#include "charset.h"
Jim Blandy's avatar
Jim Blandy committed
28 29 30

#ifndef standalone
#include "buffer.h"
Richard M. Stallman's avatar
Richard M. Stallman committed
31
#include "keyboard.h"
32
#include "frame.h"
Jim Blandy's avatar
Jim Blandy committed
33 34
#endif

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

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

39
#ifdef STDC_HEADERS
40
#include <float.h>
41
#endif
42

43 44 45 46 47 48 49 50 51 52
/* If IEEE_FLOATING_POINT isn't defined, default it from FLT_*. */
#ifndef IEEE_FLOATING_POINT
#if (FLT_RADIX == 2 && FLT_MANT_DIG == 24 \
     && FLT_MIN_EXP == -125 && FLT_MAX_EXP == 128)
#define IEEE_FLOATING_POINT 1
#else
#define IEEE_FLOATING_POINT 0
#endif
#endif

53 54 55 56 57 58 59 60 61 62
/* Work around a problem that happens because math.h on hpux 7
   defines two static variables--which, in Emacs, are not really static,
   because `static' is defined as nothing.  The problem is that they are
   here, in floatfns.c, and in lread.c.
   These macros prevent the name conflict.  */
#if defined (HPUX) && !defined (HPUX8)
#define _MAXLDBL data_c_maxldbl
#define _NMAXLDBL data_c_nmaxldbl
#endif

Jim Blandy's avatar
Jim Blandy committed
63 64 65
#include <math.h>
#endif /* LISP_FLOAT_TYPE */

66 67 68 69
#if !defined (atof)
extern double atof ();
#endif /* !atof */

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

Jim Blandy's avatar
Jim Blandy committed
74 75 76
Lisp_Object Qnil, Qt, Qquote, Qlambda, Qsubr, Qunbound;
Lisp_Object Qerror_conditions, Qerror_message, Qtop_level;
Lisp_Object Qerror, Qquit, Qwrong_type_argument, Qargs_out_of_range;
Jim Blandy's avatar
Jim Blandy committed
77
Lisp_Object Qvoid_variable, Qvoid_function, Qcyclic_function_indirection;
Jim Blandy's avatar
Jim Blandy committed
78 79
Lisp_Object Qsetting_constant, Qinvalid_read_syntax;
Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch;
Roland McGrath's avatar
Roland McGrath committed
80
Lisp_Object Qend_of_file, Qarith_error, Qmark_inactive;
Jim Blandy's avatar
Jim Blandy committed
81
Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_read_only;
82
Lisp_Object Qtext_read_only;
83
Lisp_Object Qintegerp, Qnatnump, Qwholenump, Qsymbolp, Qlistp, Qconsp;
Jim Blandy's avatar
Jim Blandy committed
84 85
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
86
Lisp_Object Qbuffer_or_string_p, Qkeywordp;
Jim Blandy's avatar
Jim Blandy committed
87
Lisp_Object Qboundp, Qfboundp;
88
Lisp_Object Qchar_table_p, Qvector_or_char_table_p;
89

Jim Blandy's avatar
Jim Blandy committed
90
Lisp_Object Qcdr;
91
Lisp_Object Qad_advice_info, Qad_activate_internal;
Jim Blandy's avatar
Jim Blandy committed
92

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

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

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

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

109 110
Lisp_Object set_internal ();

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

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

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

Andreas Schwab's avatar
Andreas Schwab committed
139
void
Jim Blandy's avatar
Jim Blandy committed
140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169
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)
170
     EMACS_INT num;
Jim Blandy's avatar
Jim Blandy committed
171
{
172 173
  if (num & (((EMACS_INT) 1) << (VALBITS - 1)))
    return num | (((EMACS_INT) (-1)) << VALBITS);
Jim Blandy's avatar
Jim Blandy committed
174
  else
175
    return num & ((((EMACS_INT) 1) << VALBITS) - 1);
Jim Blandy's avatar
Jim Blandy committed
176 177 178 179 180
}

/* Data type predicates */

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

Richard M. Stallman's avatar
Richard M. Stallman committed
190
DEFUN ("null", Fnull, Snull, 1, 1, 0, "Return t if OBJECT is nil.")
191 192
  (object)
     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 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220
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:
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 263 264
      return Qvector;

#ifdef LISP_FLOAT_TYPE
    case Lisp_Float:
      return Qfloat;
#endif

    default:
      abort ();
    }
}

Richard M. Stallman's avatar
Richard M. Stallman committed
265
DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0, "Return t if OBJECT is a cons cell.")
266 267
  (object)
     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 Qt;
  return Qnil;
}

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

284 285
DEFUN ("listp", Flistp, Slistp, 1, 1, 0,
       "Return t if OBJECT is a list.  This includes nil.")
286 287
  (object)
     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 Qt;
  return Qnil;
}

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

Dave Love's avatar
Dave Love committed
314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329
/* 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;
}

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

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

350 351 352 353 354 355 356 357 358 359 360 361
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.")
362 363 364 365 366 367 368 369
  (object)
     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,
Richard M. Stallman's avatar
Richard M. Stallman committed
372
       "Return t if OBJECT is a char-table or vector.")
373 374 375 376 377 378 379 380
  (object)
     Lisp_Object object;
{
  if (VECTORP (object) || CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
381
DEFUN ("bool-vector-p", Fbool_vector_p, Sbool_vector_p, 1, 1, 0, "Return t if OBJECT is a bool-vector.")
382 383 384 385 386 387 388 389
  (object)
     Lisp_Object object;
{
  if (BOOL_VECTOR_P (object))
    return Qt;
  return Qnil;
}

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

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

Richard M. Stallman's avatar
Richard M. Stallman committed
411
DEFUN ("bufferp", Fbufferp, Sbufferp, 1, 1, 0, "Return t if OBJECT is an editor buffer.")
412 413
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
414
{
415
  if (BUFFERP (object))
Jim Blandy's avatar
Jim Blandy committed
416 417 418 419
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
420
DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0, "Return t if OBJECT is a marker (editor pointer).")
421 422
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
423
{
424
  if (MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
425 426 427 428
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
429
DEFUN ("subrp", Fsubrp, Ssubrp, 1, 1, 0, "Return t if OBJECT is a built-in function.")
430 431
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
432
{
433
  if (SUBRP (object))
Jim Blandy's avatar
Jim Blandy committed
434 435 436 437
    return Qt;
  return Qnil;
}

Jim Blandy's avatar
Jim Blandy committed
438
DEFUN ("byte-code-function-p", Fbyte_code_function_p, Sbyte_code_function_p,
Richard M. Stallman's avatar
Richard M. Stallman committed
439
       1, 1, 0, "Return t if OBJECT is a byte-compiled function object.")
440 441
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
442
{
443
  if (COMPILEDP (object))
Jim Blandy's avatar
Jim Blandy committed
444 445 446 447
    return Qt;
  return Qnil;
}

448
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
449
  "Return t if OBJECT is a character (an integer) or a string.")
450 451
  (object)
     register Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
452
{
453
  if (INTEGERP (object) || STRINGP (object))
Jim Blandy's avatar
Jim Blandy committed
454 455 456 457
    return Qt;
  return Qnil;
}

Richard M. Stallman's avatar
Richard M. Stallman committed
458
DEFUN ("integerp", Fintegerp, Sintegerp, 1, 1, 0, "Return t if OBJECT is an integer.")
459 460
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
461
{
462
  if (INTEGERP (object))
Jim Blandy's avatar
Jim Blandy committed
463 464 465 466
    return Qt;
  return Qnil;
}

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

477
DEFUN ("natnump", Fnatnump, Snatnump, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
478
  "Return t if OBJECT is a nonnegative integer.")
479 480
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
481
{
482
  if (NATNUMP (object))
Jim Blandy's avatar
Jim Blandy committed
483 484 485 486 487
    return Qt;
  return Qnil;
}

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

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
500
       "Return t if OBJECT is a number or a marker.")
501 502
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
503
{
504
  if (NUMBERP (object) || MARKERP (object))
Jim Blandy's avatar
Jim Blandy committed
505 506 507
    return Qt;
  return Qnil;
}
508 509 510

#ifdef LISP_FLOAT_TYPE
DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
511
       "Return t if OBJECT is a floating point number.")
512 513
  (object)
     Lisp_Object object;
514
{
515
  if (FLOATP (object))
516 517 518
    return Qt;
  return Qnil;
}
Jim Blandy's avatar
Jim Blandy committed
519 520 521 522 523
#endif /* LISP_FLOAT_TYPE */

/* Extract and set components of lists */

DEFUN ("car", Fcar, Scar, 1, 1, 0,
524
  "Return the car of LIST.  If arg is nil, return nil.\n\
Jim Blandy's avatar
Jim Blandy committed
525 526 527 528 529 530
Error if arg is not nil and not a cons cell.  See also `car-safe'.")
  (list)
     register Lisp_Object list;
{
  while (1)
    {
531
      if (CONSP (list))
532
	return XCAR (list);
Jim Blandy's avatar
Jim Blandy committed
533 534 535 536 537 538 539 540 541 542 543 544
      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;
{
545
  if (CONSP (object))
546
    return XCAR (object);
Jim Blandy's avatar
Jim Blandy committed
547 548 549 550 551
  else
    return Qnil;
}

DEFUN ("cdr", Fcdr, Scdr, 1, 1, 0,
552
  "Return the cdr of LIST.  If arg is nil, return nil.\n\
Jim Blandy's avatar
Jim Blandy committed
553 554 555 556 557 558 559
Error if arg is not nil and not a cons cell.  See also `cdr-safe'.")

  (list)
     register Lisp_Object list;
{
  while (1)
    {
560
      if (CONSP (list))
561
	return XCDR (list);
Jim Blandy's avatar
Jim Blandy committed
562 563 564 565 566 567 568 569
      else if (EQ (list, Qnil))
	return Qnil;
      else
	list = wrong_type_argument (Qlistp, list);
    }
}

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

DEFUN ("setcar", Fsetcar, Ssetcar, 2, 2, 0,
581
  "Set the car of CELL to be NEWCAR.  Returns NEWCAR.")
Jim Blandy's avatar
Jim Blandy committed
582 583 584
  (cell, newcar)
     register Lisp_Object cell, newcar;
{
585
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
586 587 588
    cell = wrong_type_argument (Qconsp, cell);

  CHECK_IMPURE (cell);
589
  XCAR (cell) = newcar;
Jim Blandy's avatar
Jim Blandy committed
590 591 592 593
  return newcar;
}

DEFUN ("setcdr", Fsetcdr, Ssetcdr, 2, 2, 0,
594
  "Set the cdr of CELL to be NEWCDR.  Returns NEWCDR.")
Jim Blandy's avatar
Jim Blandy committed
595 596 597
  (cell, newcdr)
     register Lisp_Object cell, newcdr;
{
598
  if (!CONSP (cell))
Jim Blandy's avatar
Jim Blandy committed
599 600 601
    cell = wrong_type_argument (Qconsp, cell);

  CHECK_IMPURE (cell);
602
  XCDR (cell) = newcdr;
Jim Blandy's avatar
Jim Blandy committed
603 604 605 606 607
  return newcdr;
}

/* Extract and set components of symbols */

Richard M. Stallman's avatar
Richard M. Stallman committed
608
DEFUN ("boundp", Fboundp, Sboundp, 1, 1, 0, "Return t if SYMBOL's value is not void.")
609 610
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
611 612
{
  Lisp_Object valcontents;
613
  CHECK_SYMBOL (symbol, 0);
Jim Blandy's avatar
Jim Blandy committed
614

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

Karl Heuer's avatar
Karl Heuer committed
617 618
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
619
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
620

621
  return (EQ (valcontents, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
622 623
}

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

DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0, "Make SYMBOL's value be void.")
633 634
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
635
{
636
  CHECK_SYMBOL (symbol, 0);
637 638
  if (NILP (symbol) || EQ (symbol, Qt)
      || (XSYMBOL (symbol)->name->data[0] == ':'
639
	  && EQ (XSYMBOL (symbol)->obarray, initial_obarray)
640
	  && keyword_symbols_constant_flag))
641 642 643
    return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
  Fset (symbol, Qunbound);
  return symbol;
Jim Blandy's avatar
Jim Blandy committed
644 645 646
}

DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0, "Make SYMBOL's function definition be void.")
647 648
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
649
{
650 651 652 653 654
  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
655 656 657 658
}

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
659 660
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
661
{
Jim Blandy's avatar
Jim Blandy committed
662 663 664 665
  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
666 667 668
}

DEFUN ("symbol-plist", Fsymbol_plist, Ssymbol_plist, 1, 1, 0, "Return SYMBOL's property list.")
669 670
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
671
{
672 673
  CHECK_SYMBOL (symbol, 0);
  return XSYMBOL (symbol)->plist;
Jim Blandy's avatar
Jim Blandy committed
674 675 676
}

DEFUN ("symbol-name", Fsymbol_name, Ssymbol_name, 1, 1, 0, "Return SYMBOL's name, a string.")
677 678
  (symbol)
     register Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
679 680 681
{
  register Lisp_Object name;

682 683
  CHECK_SYMBOL (symbol, 0);
  XSETSTRING (name, XSYMBOL (symbol)->name);
Jim Blandy's avatar
Jim Blandy committed
684 685 686 687
  return name;
}

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

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

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

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

750 751
      case Lisp_Misc_Boolfwd:
	return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
752

753 754
      case Lisp_Misc_Objfwd:
	return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
755

756 757 758
      case Lisp_Misc_Buffer_Objfwd:
	offset = XBUFFER_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_buffer);
759

760 761 762
      case Lisp_Misc_Kboard_Objfwd:
	offset = XKBOARD_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_kboard);
763
      }
Jim Blandy's avatar
Jim Blandy committed
764 765 766
  return valcontents;
}

767 768
/* 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
769 770 771 772
   buffer-independent contents of the value cell: forwarded just one
   step past the buffer-localness.  */

void
773 774
store_symval_forwarding (symbol, valcontents, newval)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
775 776
     register Lisp_Object valcontents, newval;
{
777
  switch (SWITCH_ENUM_CAST (XTYPE (valcontents)))
Jim Blandy's avatar
Jim Blandy committed
778
    {
779
    case Lisp_Misc:
780
      switch (XMISCTYPE (valcontents))
781 782 783 784
	{
	case Lisp_Misc_Intfwd:
	  CHECK_NUMBER (newval, 1);
	  *XINTFWD (valcontents)->intvar = XINT (newval);
785 786
	  if (*XINTFWD (valcontents)->intvar != XINT (newval))
	    error ("Value out of range for variable `%s'",
787
		   XSYMBOL (symbol)->name->data);
788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803
	  break;

	case Lisp_Misc_Boolfwd:
	  *XBOOLFWD (valcontents)->boolvar = NILP (newval) ? 0 : 1;
	  break;

	case Lisp_Misc_Objfwd:
	  *XOBJFWD (valcontents)->objvar = newval;
	  break;

	case Lisp_Misc_Buffer_Objfwd:
	  {
	    int offset = XBUFFER_OBJFWD (valcontents)->offset;
	    Lisp_Object type;

	    type = *(Lisp_Object *)(offset + (char *)&buffer_local_types);
804 805 806
	    if (XINT (type) == -1)
	      error ("Variable %s is read-only", XSYMBOL (symbol)->name->data);

807 808 809 810 811 812
	    if (! NILP (type) && ! NILP (newval)
		&& XTYPE (newval) != XINT (type))
	      buffer_slot_type_mismatch (offset);

	    *(Lisp_Object *)(offset + (char *)current_buffer) = newval;
	  }
813 814
	  break;

815 816 817
	case Lisp_Misc_Kboard_Objfwd:
	  (*(Lisp_Object *)((char *)current_kboard
			    + XKBOARD_OBJFWD (valcontents)->offset))
818 819 820
	    = newval;
	  break;

821 822 823
	default:
	  goto def;
	}
Jim Blandy's avatar
Jim Blandy committed
824 825 826
      break;

    default:
827
    def:
828
      valcontents = XSYMBOL (symbol)->value;
829 830
      if (BUFFER_LOCAL_VALUEP (valcontents)
	  || SOME_BUFFER_LOCAL_VALUEP (valcontents))
831
	XBUFFER_LOCAL_VALUE (valcontents)->realvalue = newval;
Jim Blandy's avatar
Jim Blandy committed
832
      else
833
	XSYMBOL (symbol)->value = newval;
Jim Blandy's avatar
Jim Blandy committed
834 835 836
    }
}

837 838
/* Set up the buffer-local symbol SYMBOL for validity in the current buffer.
   VALCONTENTS is the contents of its value cell.
Jim Blandy's avatar
Jim Blandy committed
839 840 841
   Return the value forwarded one step past the buffer-local indicator.  */

static Lisp_Object
842 843
swap_in_symval_forwarding (symbol, valcontents)
     Lisp_Object symbol, valcontents;
Jim Blandy's avatar
Jim Blandy committed
844
{
845
  /* valcontents is a pointer to a struct resembling the cons
Jim Blandy's avatar
Jim Blandy committed
846
     (REALVALUE BUFFER CURRENT-ALIST-ELEMENT . DEFAULT-VALUE)).
847

Jim Blandy's avatar
Jim Blandy committed
848
     CURRENT-ALIST-ELEMENT is a pointer to an element of BUFFER's
849 850 851 852 853 854 855 856 857 858 859
     local_var_alist, that being the element whose car is this
     variable.  Or it can be a pointer to the
     (CURRENT-ALIST-ELEMENT . DEFAULT-VALUE), if BUFFER does not have
     an element in its alist for this variable.

     If the current buffer is not BUFFER, we store the current
     REALVALUE value into CURRENT-ALIST-ELEMENT, then find the
     appropriate alist element for the buffer now current and set up
     CURRENT-ALIST-ELEMENT.  Then we set REALVALUE out of that
     element, and store into BUFFER.

Jim Blandy's avatar
Jim Blandy committed
860 861 862
     Note that REALVALUE can be a forwarding pointer. */

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

865
  if (NILP (tem1) || current_buffer != XBUFFER (tem1)
866
      || !EQ (selected_frame, XBUFFER_LOCAL_VALUE (valcontents)->frame))
Jim Blandy's avatar
Jim Blandy committed
867
    {
868
      tem1 = XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr);
869
      Fsetcdr (tem1,
870
	       do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
871
      tem1 = assq_no_quit (symbol, current_buffer->local_var_alist);
872 873
      XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
      XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
Jim Blandy's avatar
Jim Blandy committed
874
      if (NILP (tem1))
875 876
	{
	  if (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
877
	    tem1 = assq_no_quit (symbol, XFRAME (selected_frame)->param_alist);
878 879 880 881 882 883 884 885
	  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;

886
      XCAR (XBUFFER_LOCAL_VALUE (valcontents)->cdr) = tem1;
887
      XSETBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer, current_buffer);
888
      XBUFFER_LOCAL_VALUE (valcontents)->frame = selected_frame;
889 890
      store_symval_forwarding (symbol,
			       XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
891
			       Fcdr (tem1));
Jim Blandy's avatar
Jim Blandy committed
892
    }
893
  return XBUFFER_LOCAL_VALUE (valcontents)->realvalue;
Jim Blandy's avatar
Jim Blandy committed
894 895
}

Jim Blandy's avatar
Jim Blandy committed
896 897
/* 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
898
   if it has one, without signaling an error.
Jim Blandy's avatar
Jim Blandy committed
899 900
   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
901

Jim Blandy's avatar
Jim Blandy committed
902
Lisp_Object
903 904
find_symbol_value (symbol)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
905
{
906
  register Lisp_Object valcontents;
Jim Blandy's avatar
Jim Blandy committed
907
  register Lisp_Object val;
908 909
  CHECK_SYMBOL (symbol, 0);
  valcontents = XSYMBOL (symbol)->value;
Jim Blandy's avatar
Jim Blandy committed
910

Karl Heuer's avatar
Karl Heuer committed
911 912
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
913 914
    valcontents = swap_in_symval_forwarding (symbol, valcontents,
					     current_buffer);
Jim Blandy's avatar
Jim Blandy committed
915

916 917
  if (MISCP (valcontents))
    {