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

This file is part of GNU Emacs.

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

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

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


#include <signal.h>

24
#include <config.h>
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 40
#ifdef STDC_HEADERS
#include <stdlib.h>
41
#include <float.h>
42
#endif
43

44 45 46 47 48 49 50 51 52 53
/* 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

54 55 56 57 58 59 60 61 62 63
/* 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
64 65 66
#include <math.h>
#endif /* LISP_FLOAT_TYPE */

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

71 72 73 74
/* 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
75 76 77
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
78
Lisp_Object Qvoid_variable, Qvoid_function, Qcyclic_function_indirection;
Jim Blandy's avatar
Jim Blandy committed
79 80
Lisp_Object Qsetting_constant, Qinvalid_read_syntax;
Lisp_Object Qinvalid_function, Qwrong_number_of_arguments, Qno_catch;
Roland McGrath's avatar
Roland McGrath committed
81
Lisp_Object Qend_of_file, Qarith_error, Qmark_inactive;
Jim Blandy's avatar
Jim Blandy committed
82
Lisp_Object Qbeginning_of_buffer, Qend_of_buffer, Qbuffer_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;
Joseph Arceneaux's avatar
Joseph Arceneaux committed
86
Lisp_Object Qbuffer_or_string_p;
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;
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;
105
static Lisp_Object Qchar_table, Qbool_vector;
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 251 252 253 254 255 256 257 258 259 260 261 262
      if (GC_FRAMEP (object))
	return Qframe;
      return Qvector;

#ifdef LISP_FLOAT_TYPE
    case Lisp_Float:
      return Qfloat;
#endif

    default:
      abort ();
    }
}

Richard M. Stallman's avatar
Richard M. Stallman committed
263
DEFUN ("consp", Fconsp, Sconsp, 1, 1, 0, "Return t if OBJECT is a cons cell.")
264 265
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
266
{
267
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
268 269 270 271
    return Qt;
  return Qnil;
}

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

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

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

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

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

332 333 334 335 336 337 338 339 340 341 342 343
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.")
344 345 346 347 348 349 350 351
  (object)
     Lisp_Object object;
{
  if (CHAR_TABLE_P (object))
    return Qt;
  return Qnil;
}

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

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

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

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

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

Richard M. Stallman's avatar
Richard M. Stallman committed
402
DEFUN ("markerp", Fmarkerp, Smarkerp, 1, 1, 0, "Return t if OBJECT is a marker (editor pointer).")
403 404
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
405
{
406
  if (MARKERP (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 ("subrp", Fsubrp, Ssubrp, 1, 1, 0, "Return t if OBJECT is a built-in function.")
412 413
  (object)
     Lisp_Object object;
Jim Blandy's avatar
Jim Blandy committed
414
{
415
  if (SUBRP (object))
Jim Blandy's avatar
Jim Blandy committed
416 417 418 419
    return Qt;
  return Qnil;
}

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

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

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

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

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

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

#ifdef LISP_FLOAT_TYPE
DEFUN ("floatp", Ffloatp, Sfloatp, 1, 1, 0,
Richard M. Stallman's avatar
Richard M. Stallman committed
493
       "Return t if OBJECT is a floating point number.")
494 495
  (object)
     Lisp_Object object;
496
{
497
  if (FLOATP (object))
498 499 500
    return Qt;
  return Qnil;
}
Jim Blandy's avatar
Jim Blandy committed
501 502 503 504 505
#endif /* LISP_FLOAT_TYPE */

/* Extract and set components of lists */

DEFUN ("car", Fcar, Scar, 1, 1, 0,
506
  "Return the car of LIST.  If arg is nil, return nil.\n\
Jim Blandy's avatar
Jim Blandy committed
507 508 509 510 511 512
Error if arg is not nil and not a cons cell.  See also `car-safe'.")
  (list)
     register Lisp_Object list;
{
  while (1)
    {
513
      if (CONSP (list))
Jim Blandy's avatar
Jim Blandy committed
514 515 516 517 518 519 520 521 522 523 524 525 526
	return XCONS (list)->car;
      else if (EQ (list, Qnil))
	return Qnil;
      else
	list = wrong_type_argument (Qlistp, list);
    }
}

DEFUN ("car-safe", Fcar_safe, Scar_safe, 1, 1, 0,
  "Return the car of OBJECT if it is a cons cell, or else nil.")
  (object)
     Lisp_Object object;
{
527
  if (CONSP (object))
Jim Blandy's avatar
Jim Blandy committed
528 529 530 531 532 533
    return XCONS (object)->car;
  else
    return Qnil;
}

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

  (list)
     register Lisp_Object list;
{
  while (1)
    {
542
      if (CONSP (list))
Jim Blandy's avatar
Jim Blandy committed
543 544 545 546 547 548 549 550 551
	return XCONS (list)->cdr;
      else if (EQ (list, Qnil))
	return Qnil;
      else
	list = wrong_type_argument (Qlistp, list);
    }
}

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

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

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

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

  CHECK_IMPURE (cell);
  XCONS (cell)->cdr = newcdr;
  return newcdr;
}

/* Extract and set components of symbols */

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

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

Karl Heuer's avatar
Karl Heuer committed
599 600
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
601
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
602

603
  return (EQ (valcontents, Qunbound) ? Qnil : Qt);
Jim Blandy's avatar
Jim Blandy committed
604 605
}

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

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

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

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

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

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

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

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

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

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

Jim Blandy's avatar
Jim Blandy committed
711 712 713 714 715 716 717 718 719 720 721 722 723

/* 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;
724 725
  int offset;
  if (MISCP (valcontents))
726
    switch (XMISCTYPE (valcontents))
727 728 729 730
      {
      case Lisp_Misc_Intfwd:
	XSETINT (val, *XINTFWD (valcontents)->intvar);
	return val;
Jim Blandy's avatar
Jim Blandy committed
731

732 733
      case Lisp_Misc_Boolfwd:
	return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
734

735 736
      case Lisp_Misc_Objfwd:
	return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
737

738 739 740
      case Lisp_Misc_Buffer_Objfwd:
	offset = XBUFFER_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_buffer);
741

742 743 744
      case Lisp_Misc_Kboard_Objfwd:
	offset = XKBOARD_OBJFWD (valcontents)->offset;
	return *(Lisp_Object *)(offset + (char *)current_kboard);
745
      }
Jim Blandy's avatar
Jim Blandy committed
746 747 748
  return valcontents;
}

749 750
/* 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
751 752 753 754
   buffer-independent contents of the value cell: forwarded just one
   step past the buffer-localness.  */

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

789 790 791 792 793 794
	    if (! NILP (type) && ! NILP (newval)
		&& XTYPE (newval) != XINT (type))
	      buffer_slot_type_mismatch (offset);

	    *(Lisp_Object *)(offset + (char *)current_buffer) = newval;
	  }
795 796
	  break;

797 798 799
	case Lisp_Misc_Kboard_Objfwd:
	  (*(Lisp_Object *)((char *)current_kboard
			    + XKBOARD_OBJFWD (valcontents)->offset))
800 801 802
	    = newval;
	  break;

803 804 805
	default:
	  goto def;
	}
Jim Blandy's avatar
Jim Blandy committed
806 807 808
      break;

    default:
809
    def:
810
      valcontents = XSYMBOL (symbol)->value;
811 812
      if (BUFFER_LOCAL_VALUEP (valcontents)
	  || SOME_BUFFER_LOCAL_VALUEP (valcontents))
813
	XBUFFER_LOCAL_VALUE (valcontents)->realvalue = newval;
Jim Blandy's avatar
Jim Blandy committed
814
      else
815
	XSYMBOL (symbol)->value = newval;
Jim Blandy's avatar
Jim Blandy committed
816 817 818
    }
}

819
/* Set up the buffer-local symbol SYMBOL for validity in the current
Jim Blandy's avatar
Jim Blandy committed
820 821 822 823
   buffer.  VALCONTENTS is the contents of its value cell.
   Return the value forwarded one step past the buffer-local indicator.  */

static Lisp_Object
824 825
swap_in_symval_forwarding (symbol, valcontents)
     Lisp_Object symbol, valcontents;
Jim Blandy's avatar
Jim Blandy committed
826
{
827
  /* valcontents is a pointer to a struct resembling the cons
Jim Blandy's avatar
Jim Blandy committed
828
     (REALVALUE BUFFER CURRENT-ALIST-ELEMENT . DEFAULT-VALUE)).
829

Jim Blandy's avatar
Jim Blandy committed
830
     CURRENT-ALIST-ELEMENT is a pointer to an element of BUFFER's
831 832 833 834 835 836 837 838 839 840 841
     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
842 843 844
     Note that REALVALUE can be a forwarding pointer. */

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

847
  if (NILP (tem1) || current_buffer != XBUFFER (tem1)
848
      || !EQ (selected_frame, XBUFFER_LOCAL_VALUE (valcontents)->frame))
Jim Blandy's avatar
Jim Blandy committed
849
    {
850
      tem1 = XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->car;
851
      Fsetcdr (tem1,
852
	       do_symval_forwarding (XBUFFER_LOCAL_VALUE (valcontents)->realvalue));
853
      tem1 = assq_no_quit (symbol, current_buffer->local_var_alist);
854 855
      XBUFFER_LOCAL_VALUE (valcontents)->found_for_frame = 0;
      XBUFFER_LOCAL_VALUE (valcontents)->found_for_buffer = 0;
Jim Blandy's avatar
Jim Blandy committed
856
      if (NILP (tem1))
857 858
	{
	  if (XBUFFER_LOCAL_VALUE (valcontents)->check_frame)
859
	    tem1 = assq_no_quit (symbol, XFRAME (selected_frame)->param_alist);
860 861 862 863 864 865 866 867 868 869
	  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;

      XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->car = tem1;
      XSETBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer, current_buffer);
870
      XBUFFER_LOCAL_VALUE (valcontents)->frame = selected_frame;
871 872
      store_symval_forwarding (symbol,
			       XBUFFER_LOCAL_VALUE (valcontents)->realvalue,
873
			       Fcdr (tem1));
Jim Blandy's avatar
Jim Blandy committed
874
    }
875
  return XBUFFER_LOCAL_VALUE (valcontents)->realvalue;
Jim Blandy's avatar
Jim Blandy committed
876 877
}

Jim Blandy's avatar
Jim Blandy committed
878 879
/* 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
880
   if it has one, without signaling an error.
Jim Blandy's avatar
Jim Blandy committed
881 882
   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
883

Jim Blandy's avatar
Jim Blandy committed
884
Lisp_Object
885 886
find_symbol_value (symbol)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
887 888 889
{
  register Lisp_Object valcontents, tem1;
  register Lisp_Object val;
890 891
  CHECK_SYMBOL (symbol, 0);
  valcontents = XSYMBOL (symbol)->value;
Jim Blandy's avatar
Jim Blandy committed
892

Karl Heuer's avatar
Karl Heuer committed
893 894
  if (BUFFER_LOCAL_VALUEP (valcontents)
      || SOME_BUFFER_LOCAL_VALUEP (valcontents))
895
    valcontents = swap_in_symval_forwarding (symbol, valcontents);
Jim Blandy's avatar
Jim Blandy committed
896

897 898
  if (MISCP (valcontents))
    {
899
      switch (XMISCTYPE (valcontents))
900 901 902 903
	{
	case Lisp_Misc_Intfwd:
	  XSETINT (val, *XINTFWD (valcontents)->intvar);
	  return val;
Jim Blandy's avatar
Jim Blandy committed
904

905 906
	case Lisp_Misc_Boolfwd:
	  return (*XBOOLFWD (valcontents)->boolvar ? Qt : Qnil);
Jim Blandy's avatar
Jim Blandy committed
907

908 909
	case Lisp_Misc_Objfwd:
	  return *XOBJFWD (valcontents)->objvar;
Jim Blandy's avatar
Jim Blandy committed
910

911 912 913
	case Lisp_Misc_Buffer_Objfwd:
	  return *(Lisp_Object *)(XBUFFER_OBJFWD (valcontents)->offset
				  + (char *)current_buffer);
914

915 916 917
	case Lisp_Misc_Kboard_Objfwd:
	  return *(Lisp_Object *)(XKBOARD_OBJFWD (valcontents)->offset
				  + (char *)current_kboard);
918
	}
Jim Blandy's avatar
Jim Blandy committed
919 920 921 922 923
    }

  return valcontents;
}

Jim Blandy's avatar
Jim Blandy committed
924 925
DEFUN ("symbol-value", Fsymbol_value, Ssymbol_value, 1, 1, 0,
  "Return SYMBOL's value.  Error if that is void.")
926 927
  (symbol)
     Lisp_Object symbol;
Jim Blandy's avatar
Jim Blandy committed
928
{
929
  Lisp_Object val;
Jim Blandy's avatar
Jim Blandy committed
930

931
  val = find_symbol_value (symbol);
Jim Blandy's avatar
Jim Blandy committed
932
  if (EQ (val, Qunbound))
933
    return Fsignal (Qvoid_variable, Fcons (symbol, Qnil));
Jim Blandy's avatar
Jim Blandy committed
934 935 936 937
  else
    return val;
}

Jim Blandy's avatar
Jim Blandy committed
938 939
DEFUN ("set", Fset, Sset, 2, 2, 0,
  "Set SYMBOL's value to NEWVAL, and return NEWVAL.")
940 941
  (symbol, newval)
     register Lisp_Object symbol, newval;
942 943 944 945
{
  return set_internal (symbol, newval, 0);
}

946
/* Store the value NEWVAL into SYMBOL.
947 948 949 950 951 952 953 954
   If BINDFLAG is zero, then if this symbol is supposed to become
   local in every buffer where it is set, then we make it local.
   If BINDFLAG is nonzero, we don't do that.  */

Lisp_Object
set_internal (symbol, newval, bindflag)
     register Lisp_Object symbol, newval;
     int bindflag;
Jim Blandy's avatar
Jim Blandy committed
955
{
956
  int voide = EQ (newval, Qunbound);
Jim Blandy's avatar
Jim Blandy committed
957 958 959

  register Lisp_Object valcontents, tem1, current_alist_element;

960
  CHECK_SYMBOL (symbol, 0);
961 962
  if (NILP (symbol) || EQ (symbol, Qt)
      || (XSYMBOL (symbol)->name->data[0] == ':'
963
	  && EQ (XSYMBOL (symbol)->obarray, initial_obarray)
964
	  && keyword_symbols_constant_flag && ! EQ (newval, symbol)))
965 966
    return Fsignal (Qsetting_constant, Fcons (symbol, Qnil));
  valcontents = XSYMBOL (symbol)->value;
Jim Blandy's avatar
Jim Blandy committed
967

968
  if (BUFFER_OBJFWDP (valcontents))
Jim Blandy's avatar
Jim Blandy committed
969
    {
970
      register int idx = XBUFFER_OBJFWD (valcontents)->offset;
971 972
      register int mask = XINT (*((Lisp_Object *)
				  (idx + (char *)&buffer_local_flags)));
973
      if (mask > 0 && ! bindflag)
Jim Blandy's avatar
Jim Blandy committed
974 975 976
	current_buffer->local_var_flags |= mask;
    }

977 978
  else if (BUFFER_LOCAL_VALUEP (valcontents)
	   || SOME_BUFFER_LOCAL_VALUEP (valcontents))
Jim Blandy's avatar
Jim Blandy committed
979
    {
980 981
      /* valcontents is actually a pointer to a struct resembling a cons,
	 with contents something like:
Jim Blandy's avatar
Jim Blandy committed
982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008
	 (REALVALUE BUFFER CURRENT-ALIST-ELEMENT . DEFAULT-VALUE).

	 BUFFER is the last buffer for which this symbol's value was
	 made up to date.

	 CURRENT-ALIST-ELEMENT is a pointer to an element of BUFFER's
	 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 (that is, if
	 BUFFER sees the default value of this variable).

	 If we want to examine or set the value and BUFFER is current,
	 we just examine or set REALVALUE. If BUFFER is not current, 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.

	 If we are setting the variable and the current buffer does
	 not have an alist entry for this variable, an alist entry is
	 created.

	 Note that REALVALUE can be a forwarding pointer.  Each time
	 it is examined or set, forwarding must be done.  */

      /* What value are we caching right now?  */
1009 1010
      current_alist_element
	= XCONS (XBUFFER_LOCAL_VALUE (valcontents)->cdr)->car;
Jim Blandy's avatar
Jim Blandy committed
1011 1012 1013 1014 1015

      /* If the current buffer is not the buffer whose binding is
	 currently cached, or if it's a Lisp_Buffer_Local_Value and
	 we're looking at the default value, the cache is invalid; we
	 need to write it out, and find the new CURRENT-ALIST-ELEMENT.  */
1016
      if (current_buffer != XBUFFER (XBUFFER_LOCAL_VALUE (valcontents)->buffer)
1017
	  || !EQ (selected_frame, XBUFFER_LOCAL_VALUE (valcontents)->frame)
1018
	  || (BUFFER_LOCAL_VALUEP (valcontents)