1 /* Random utility Lisp functions.
2 Copyright (C) 1985, 86, 87, 93, 94, 95, 97, 98, 99, 2000, 2001, 02, 2003
3 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
30 /* On Mac OS X, defining this conflicts with precompiled headers. */
32 /* Note on some machines this defines `vector' as a typedef,
33 so make sure we don't use that name in this file. */
37 #endif /* ! MAC_OSX */
46 #include "intervals.h"
49 #include "blockinput.h"
50 #if defined (HAVE_MENUS) && defined (HAVE_X_WINDOWS)
55 #define NULL ((POINTER_TYPE *)0)
58 /* Nonzero enables use of dialog boxes for questions
59 asked by mouse commands. */
62 /* Nonzero enables use of a file dialog for file name
63 questions asked by mouse commands. */
66 extern int minibuffer_auto_raise
;
67 extern Lisp_Object minibuf_window
;
68 extern Lisp_Object Vlocale_coding_system
;
70 Lisp_Object Qstring_lessp
, Qprovide
, Qrequire
;
71 Lisp_Object Qyes_or_no_p_history
;
72 Lisp_Object Qcursor_in_echo_area
;
73 Lisp_Object Qwidget_type
;
74 Lisp_Object Qcodeset
, Qdays
, Qmonths
, Qpaper
;
76 extern Lisp_Object Qinput_method_function
;
78 static int internal_equal ();
80 extern long get_random ();
81 extern void seed_random ();
87 DEFUN ("identity", Fidentity
, Sidentity
, 1, 1, 0,
88 doc
: /* Return the argument unchanged. */)
95 DEFUN ("random", Frandom
, Srandom
, 0, 1, 0,
96 doc
: /* Return a pseudo-random number.
97 All integers representable in Lisp are equally likely.
98 On most systems, this is 29 bits' worth.
99 With positive integer argument N, return random number in interval [0,N).
100 With argument t, set the random number seed from the current time and pid. */)
105 Lisp_Object lispy_val
;
106 unsigned long denominator
;
109 seed_random (getpid () + time (NULL
));
110 if (NATNUMP (n
) && XFASTINT (n
) != 0)
112 /* Try to take our random number from the higher bits of VAL,
113 not the lower, since (says Gentzel) the low bits of `random'
114 are less random than the higher ones. We do this by using the
115 quotient rather than the remainder. At the high end of the RNG
116 it's possible to get a quotient larger than n; discarding
117 these values eliminates the bias that would otherwise appear
118 when using a large n. */
119 denominator
= ((unsigned long)1 << VALBITS
) / XFASTINT (n
);
121 val
= get_random () / denominator
;
122 while (val
>= XFASTINT (n
));
126 XSETINT (lispy_val
, val
);
130 /* Random data-structure functions */
132 DEFUN ("length", Flength
, Slength
, 1, 1, 0,
133 doc
: /* Return the length of vector, list or string SEQUENCE.
134 A byte-code function object is also allowed.
135 If the string contains multibyte characters, this is not necessarily
136 the number of bytes in the string; it is the number of characters.
137 To get the number of bytes, use `string-bytes'. */)
139 register Lisp_Object sequence
;
141 register Lisp_Object val
;
145 if (STRINGP (sequence
))
146 XSETFASTINT (val
, SCHARS (sequence
));
147 else if (VECTORP (sequence
))
148 XSETFASTINT (val
, XVECTOR (sequence
)->size
);
149 else if (SUB_CHAR_TABLE_P (sequence
))
150 XSETFASTINT (val
, SUB_CHAR_TABLE_ORDINARY_SLOTS
);
151 else if (CHAR_TABLE_P (sequence
))
152 XSETFASTINT (val
, MAX_CHAR
);
153 else if (BOOL_VECTOR_P (sequence
))
154 XSETFASTINT (val
, XBOOL_VECTOR (sequence
)->size
);
155 else if (COMPILEDP (sequence
))
156 XSETFASTINT (val
, XVECTOR (sequence
)->size
& PSEUDOVECTOR_SIZE_MASK
);
157 else if (CONSP (sequence
))
160 while (CONSP (sequence
))
162 sequence
= XCDR (sequence
);
165 if (!CONSP (sequence
))
168 sequence
= XCDR (sequence
);
173 if (!NILP (sequence
))
174 wrong_type_argument (Qlistp
, sequence
);
176 val
= make_number (i
);
178 else if (NILP (sequence
))
179 XSETFASTINT (val
, 0);
182 sequence
= wrong_type_argument (Qsequencep
, sequence
);
188 /* This does not check for quits. That is safe
189 since it must terminate. */
191 DEFUN ("safe-length", Fsafe_length
, Ssafe_length
, 1, 1, 0,
192 doc
: /* Return the length of a list, but avoid error or infinite loop.
193 This function never gets an error. If LIST is not really a list,
194 it returns 0. If LIST is circular, it returns a finite value
195 which is at least the number of distinct elements. */)
199 Lisp_Object tail
, halftail
, length
;
202 /* halftail is used to detect circular lists. */
204 for (tail
= list
; CONSP (tail
); tail
= XCDR (tail
))
206 if (EQ (tail
, halftail
) && len
!= 0)
210 halftail
= XCDR (halftail
);
213 XSETINT (length
, len
);
217 DEFUN ("string-bytes", Fstring_bytes
, Sstring_bytes
, 1, 1, 0,
218 doc
: /* Return the number of bytes in STRING.
219 If STRING is a multibyte string, this is greater than the length of STRING. */)
223 CHECK_STRING (string
);
224 return make_number (SBYTES (string
));
227 DEFUN ("string-equal", Fstring_equal
, Sstring_equal
, 2, 2, 0,
228 doc
: /* Return t if two strings have identical contents.
229 Case is significant, but text properties are ignored.
230 Symbols are also allowed; their print names are used instead. */)
232 register Lisp_Object s1
, s2
;
235 s1
= SYMBOL_NAME (s1
);
237 s2
= SYMBOL_NAME (s2
);
241 if (SCHARS (s1
) != SCHARS (s2
)
242 || SBYTES (s1
) != SBYTES (s2
)
243 || bcmp (SDATA (s1
), SDATA (s2
), SBYTES (s1
)))
248 DEFUN ("compare-strings", Fcompare_strings
,
249 Scompare_strings
, 6, 7, 0,
250 doc
: /* Compare the contents of two strings, converting to multibyte if needed.
251 In string STR1, skip the first START1 characters and stop at END1.
252 In string STR2, skip the first START2 characters and stop at END2.
253 END1 and END2 default to the full lengths of the respective strings.
255 Case is significant in this comparison if IGNORE-CASE is nil.
256 Unibyte strings are converted to multibyte for comparison.
258 The value is t if the strings (or specified portions) match.
259 If string STR1 is less, the value is a negative number N;
260 - 1 - N is the number of characters that match at the beginning.
261 If string STR1 is greater, the value is a positive number N;
262 N - 1 is the number of characters that match at the beginning. */)
263 (str1
, start1
, end1
, str2
, start2
, end2
, ignore_case
)
264 Lisp_Object str1
, start1
, end1
, start2
, str2
, end2
, ignore_case
;
266 register int end1_char
, end2_char
;
267 register int i1
, i1_byte
, i2
, i2_byte
;
272 start1
= make_number (0);
274 start2
= make_number (0);
275 CHECK_NATNUM (start1
);
276 CHECK_NATNUM (start2
);
285 i1_byte
= string_char_to_byte (str1
, i1
);
286 i2_byte
= string_char_to_byte (str2
, i2
);
288 end1_char
= SCHARS (str1
);
289 if (! NILP (end1
) && end1_char
> XINT (end1
))
290 end1_char
= XINT (end1
);
292 end2_char
= SCHARS (str2
);
293 if (! NILP (end2
) && end2_char
> XINT (end2
))
294 end2_char
= XINT (end2
);
296 while (i1
< end1_char
&& i2
< end2_char
)
298 /* When we find a mismatch, we must compare the
299 characters, not just the bytes. */
302 if (STRING_MULTIBYTE (str1
))
303 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c1
, str1
, i1
, i1_byte
);
306 c1
= SREF (str1
, i1
++);
307 c1
= unibyte_char_to_multibyte (c1
);
310 if (STRING_MULTIBYTE (str2
))
311 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c2
, str2
, i2
, i2_byte
);
314 c2
= SREF (str2
, i2
++);
315 c2
= unibyte_char_to_multibyte (c2
);
321 if (! NILP (ignore_case
))
325 tem
= Fupcase (make_number (c1
));
327 tem
= Fupcase (make_number (c2
));
334 /* Note that I1 has already been incremented
335 past the character that we are comparing;
336 hence we don't add or subtract 1 here. */
338 return make_number (- i1
+ XINT (start1
));
340 return make_number (i1
- XINT (start1
));
344 return make_number (i1
- XINT (start1
) + 1);
346 return make_number (- i1
+ XINT (start1
) - 1);
351 DEFUN ("string-lessp", Fstring_lessp
, Sstring_lessp
, 2, 2, 0,
352 doc
: /* Return t if first arg string is less than second in lexicographic order.
354 Symbols are also allowed; their print names are used instead. */)
356 register Lisp_Object s1
, s2
;
359 register int i1
, i1_byte
, i2
, i2_byte
;
362 s1
= SYMBOL_NAME (s1
);
364 s2
= SYMBOL_NAME (s2
);
368 i1
= i1_byte
= i2
= i2_byte
= 0;
371 if (end
> SCHARS (s2
))
376 /* When we find a mismatch, we must compare the
377 characters, not just the bytes. */
380 FETCH_STRING_CHAR_ADVANCE (c1
, s1
, i1
, i1_byte
);
381 FETCH_STRING_CHAR_ADVANCE (c2
, s2
, i2
, i2_byte
);
384 return c1
< c2
? Qt
: Qnil
;
386 return i1
< SCHARS (s2
) ? Qt
: Qnil
;
389 static Lisp_Object
concat ();
400 return concat (2, args
, Lisp_String
, 0);
402 return concat (2, &s1
, Lisp_String
, 0);
403 #endif /* NO_ARG_ARRAY */
409 Lisp_Object s1
, s2
, s3
;
416 return concat (3, args
, Lisp_String
, 0);
418 return concat (3, &s1
, Lisp_String
, 0);
419 #endif /* NO_ARG_ARRAY */
422 DEFUN ("append", Fappend
, Sappend
, 0, MANY
, 0,
423 doc
: /* Concatenate all the arguments and make the result a list.
424 The result is a list whose elements are the elements of all the arguments.
425 Each argument may be a list, vector or string.
426 The last argument is not copied, just used as the tail of the new list.
427 usage: (append &rest SEQUENCES) */)
432 return concat (nargs
, args
, Lisp_Cons
, 1);
435 DEFUN ("concat", Fconcat
, Sconcat
, 0, MANY
, 0,
436 doc
: /* Concatenate all the arguments and make the result a string.
437 The result is a string whose elements are the elements of all the arguments.
438 Each argument may be a string or a list or vector of characters (integers).
439 usage: (concat &rest SEQUENCES) */)
444 return concat (nargs
, args
, Lisp_String
, 0);
447 DEFUN ("vconcat", Fvconcat
, Svconcat
, 0, MANY
, 0,
448 doc
: /* Concatenate all the arguments and make the result a vector.
449 The result is a vector whose elements are the elements of all the arguments.
450 Each argument may be a list, vector or string.
451 usage: (vconcat &rest SEQUENCES) */)
456 return concat (nargs
, args
, Lisp_Vectorlike
, 0);
459 /* Return a copy of a sub char table ARG. The elements except for a
460 nested sub char table are not copied. */
462 copy_sub_char_table (arg
)
465 Lisp_Object copy
= make_sub_char_table (XCHAR_TABLE (arg
)->defalt
);
468 /* Copy all the contents. */
469 bcopy (XCHAR_TABLE (arg
)->contents
, XCHAR_TABLE (copy
)->contents
,
470 SUB_CHAR_TABLE_ORDINARY_SLOTS
* sizeof (Lisp_Object
));
471 /* Recursively copy any sub char-tables in the ordinary slots. */
472 for (i
= 32; i
< SUB_CHAR_TABLE_ORDINARY_SLOTS
; i
++)
473 if (SUB_CHAR_TABLE_P (XCHAR_TABLE (arg
)->contents
[i
]))
474 XCHAR_TABLE (copy
)->contents
[i
]
475 = copy_sub_char_table (XCHAR_TABLE (copy
)->contents
[i
]);
481 DEFUN ("copy-sequence", Fcopy_sequence
, Scopy_sequence
, 1, 1, 0,
482 doc
: /* Return a copy of a list, vector, string or char-table.
483 The elements of a list or vector are not copied; they are shared
484 with the original. */)
488 if (NILP (arg
)) return arg
;
490 if (CHAR_TABLE_P (arg
))
495 copy
= Fmake_char_table (XCHAR_TABLE (arg
)->purpose
, Qnil
);
496 /* Copy all the slots, including the extra ones. */
497 bcopy (XVECTOR (arg
)->contents
, XVECTOR (copy
)->contents
,
498 ((XCHAR_TABLE (arg
)->size
& PSEUDOVECTOR_SIZE_MASK
)
499 * sizeof (Lisp_Object
)));
501 /* Recursively copy any sub char tables in the ordinary slots
502 for multibyte characters. */
503 for (i
= CHAR_TABLE_SINGLE_BYTE_SLOTS
;
504 i
< CHAR_TABLE_ORDINARY_SLOTS
; i
++)
505 if (SUB_CHAR_TABLE_P (XCHAR_TABLE (arg
)->contents
[i
]))
506 XCHAR_TABLE (copy
)->contents
[i
]
507 = copy_sub_char_table (XCHAR_TABLE (copy
)->contents
[i
]);
512 if (BOOL_VECTOR_P (arg
))
516 = (XBOOL_VECTOR (arg
)->size
+ BITS_PER_CHAR
- 1) / BITS_PER_CHAR
;
518 val
= Fmake_bool_vector (Flength (arg
), Qnil
);
519 bcopy (XBOOL_VECTOR (arg
)->data
, XBOOL_VECTOR (val
)->data
,
524 if (!CONSP (arg
) && !VECTORP (arg
) && !STRINGP (arg
))
525 arg
= wrong_type_argument (Qsequencep
, arg
);
526 return concat (1, &arg
, CONSP (arg
) ? Lisp_Cons
: XTYPE (arg
), 0);
529 /* In string STR of length LEN, see if bytes before STR[I] combine
530 with bytes after STR[I] to form a single character. If so, return
531 the number of bytes after STR[I] which combine in this way.
532 Otherwize, return 0. */
535 count_combining (str
, len
, i
)
539 int j
= i
- 1, bytes
;
541 if (i
== 0 || i
== len
|| CHAR_HEAD_P (str
[i
]))
543 while (j
>= 0 && !CHAR_HEAD_P (str
[j
])) j
--;
544 if (j
< 0 || ! BASE_LEADING_CODE_P (str
[j
]))
546 PARSE_MULTIBYTE_SEQ (str
+ j
, len
- j
, bytes
);
547 return (bytes
<= i
- j
? 0 : bytes
- (i
- j
));
550 /* This structure holds information of an argument of `concat' that is
551 a string and has text properties to be copied. */
554 int argnum
; /* refer to ARGS (arguments of `concat') */
555 int from
; /* refer to ARGS[argnum] (argument string) */
556 int to
; /* refer to VAL (the target string) */
560 concat (nargs
, args
, target_type
, last_special
)
563 enum Lisp_Type target_type
;
567 register Lisp_Object tail
;
568 register Lisp_Object
this;
570 int toindex_byte
= 0;
571 register int result_len
;
572 register int result_len_byte
;
574 Lisp_Object last_tail
;
577 /* When we make a multibyte string, we can't copy text properties
578 while concatinating each string because the length of resulting
579 string can't be decided until we finish the whole concatination.
580 So, we record strings that have text properties to be copied
581 here, and copy the text properties after the concatination. */
582 struct textprop_rec
*textprops
= NULL
;
583 /* Number of elments in textprops. */
584 int num_textprops
= 0;
588 /* In append, the last arg isn't treated like the others */
589 if (last_special
&& nargs
> 0)
592 last_tail
= args
[nargs
];
597 /* Canonicalize each argument. */
598 for (argnum
= 0; argnum
< nargs
; argnum
++)
601 if (!(CONSP (this) || NILP (this) || VECTORP (this) || STRINGP (this)
602 || COMPILEDP (this) || BOOL_VECTOR_P (this)))
604 args
[argnum
] = wrong_type_argument (Qsequencep
, this);
608 /* Compute total length in chars of arguments in RESULT_LEN.
609 If desired output is a string, also compute length in bytes
610 in RESULT_LEN_BYTE, and determine in SOME_MULTIBYTE
611 whether the result should be a multibyte string. */
615 for (argnum
= 0; argnum
< nargs
; argnum
++)
619 len
= XFASTINT (Flength (this));
620 if (target_type
== Lisp_String
)
622 /* We must count the number of bytes needed in the string
623 as well as the number of characters. */
629 for (i
= 0; i
< len
; i
++)
631 ch
= XVECTOR (this)->contents
[i
];
633 wrong_type_argument (Qintegerp
, ch
);
634 this_len_byte
= CHAR_BYTES (XINT (ch
));
635 result_len_byte
+= this_len_byte
;
636 if (!SINGLE_BYTE_CHAR_P (XINT (ch
)))
639 else if (BOOL_VECTOR_P (this) && XBOOL_VECTOR (this)->size
> 0)
640 wrong_type_argument (Qintegerp
, Faref (this, make_number (0)));
641 else if (CONSP (this))
642 for (; CONSP (this); this = XCDR (this))
646 wrong_type_argument (Qintegerp
, ch
);
647 this_len_byte
= CHAR_BYTES (XINT (ch
));
648 result_len_byte
+= this_len_byte
;
649 if (!SINGLE_BYTE_CHAR_P (XINT (ch
)))
652 else if (STRINGP (this))
654 if (STRING_MULTIBYTE (this))
657 result_len_byte
+= SBYTES (this);
660 result_len_byte
+= count_size_as_multibyte (SDATA (this),
668 if (! some_multibyte
)
669 result_len_byte
= result_len
;
671 /* Create the output object. */
672 if (target_type
== Lisp_Cons
)
673 val
= Fmake_list (make_number (result_len
), Qnil
);
674 else if (target_type
== Lisp_Vectorlike
)
675 val
= Fmake_vector (make_number (result_len
), Qnil
);
676 else if (some_multibyte
)
677 val
= make_uninit_multibyte_string (result_len
, result_len_byte
);
679 val
= make_uninit_string (result_len
);
681 /* In `append', if all but last arg are nil, return last arg. */
682 if (target_type
== Lisp_Cons
&& EQ (val
, Qnil
))
685 /* Copy the contents of the args into the result. */
687 tail
= val
, toindex
= -1; /* -1 in toindex is flag we are making a list */
689 toindex
= 0, toindex_byte
= 0;
694 = (struct textprop_rec
*) alloca (sizeof (struct textprop_rec
) * nargs
);
696 for (argnum
= 0; argnum
< nargs
; argnum
++)
700 register unsigned int thisindex
= 0;
701 register unsigned int thisindex_byte
= 0;
705 thislen
= Flength (this), thisleni
= XINT (thislen
);
707 /* Between strings of the same kind, copy fast. */
708 if (STRINGP (this) && STRINGP (val
)
709 && STRING_MULTIBYTE (this) == some_multibyte
)
711 int thislen_byte
= SBYTES (this);
714 bcopy (SDATA (this), SDATA (val
) + toindex_byte
,
716 combined
= (some_multibyte
&& toindex_byte
> 0
717 ? count_combining (SDATA (val
),
718 toindex_byte
+ thislen_byte
,
721 if (! NULL_INTERVAL_P (STRING_INTERVALS (this)))
723 textprops
[num_textprops
].argnum
= argnum
;
724 /* We ignore text properties on characters being combined. */
725 textprops
[num_textprops
].from
= combined
;
726 textprops
[num_textprops
++].to
= toindex
;
728 toindex_byte
+= thislen_byte
;
729 toindex
+= thisleni
- combined
;
730 STRING_SET_CHARS (val
, SCHARS (val
) - combined
);
732 /* Copy a single-byte string to a multibyte string. */
733 else if (STRINGP (this) && STRINGP (val
))
735 if (! NULL_INTERVAL_P (STRING_INTERVALS (this)))
737 textprops
[num_textprops
].argnum
= argnum
;
738 textprops
[num_textprops
].from
= 0;
739 textprops
[num_textprops
++].to
= toindex
;
741 toindex_byte
+= copy_text (SDATA (this),
742 SDATA (val
) + toindex_byte
,
743 SCHARS (this), 0, 1);
747 /* Copy element by element. */
750 register Lisp_Object elt
;
752 /* Fetch next element of `this' arg into `elt', or break if
753 `this' is exhausted. */
754 if (NILP (this)) break;
756 elt
= XCAR (this), this = XCDR (this);
757 else if (thisindex
>= thisleni
)
759 else if (STRINGP (this))
762 if (STRING_MULTIBYTE (this))
764 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c
, this,
767 XSETFASTINT (elt
, c
);
771 XSETFASTINT (elt
, SREF (this, thisindex
++));
773 && (XINT (elt
) >= 0240
774 || (XINT (elt
) >= 0200
775 && ! NILP (Vnonascii_translation_table
)))
776 && XINT (elt
) < 0400)
778 c
= unibyte_char_to_multibyte (XINT (elt
));
783 else if (BOOL_VECTOR_P (this))
786 byte
= XBOOL_VECTOR (this)->data
[thisindex
/ BITS_PER_CHAR
];
787 if (byte
& (1 << (thisindex
% BITS_PER_CHAR
)))
794 elt
= XVECTOR (this)->contents
[thisindex
++];
796 /* Store this element into the result. */
803 else if (VECTORP (val
))
804 XVECTOR (val
)->contents
[toindex
++] = elt
;
808 if (SINGLE_BYTE_CHAR_P (XINT (elt
)))
812 += CHAR_STRING (XINT (elt
),
813 SDATA (val
) + toindex_byte
);
815 SSET (val
, toindex_byte
++, XINT (elt
));
818 && count_combining (SDATA (val
),
819 toindex_byte
, toindex_byte
- 1))
820 STRING_SET_CHARS (val
, SCHARS (val
) - 1);
825 /* If we have any multibyte characters,
826 we already decided to make a multibyte string. */
829 /* P exists as a variable
830 to avoid a bug on the Masscomp C compiler. */
831 unsigned char *p
= SDATA (val
) + toindex_byte
;
833 toindex_byte
+= CHAR_STRING (c
, p
);
840 XSETCDR (prev
, last_tail
);
842 if (num_textprops
> 0)
845 int last_to_end
= -1;
847 for (argnum
= 0; argnum
< num_textprops
; argnum
++)
849 this = args
[textprops
[argnum
].argnum
];
850 props
= text_property_list (this,
852 make_number (SCHARS (this)),
854 /* If successive arguments have properites, be sure that the
855 value of `composition' property be the copy. */
856 if (last_to_end
== textprops
[argnum
].to
)
857 make_composition_value_copy (props
);
858 add_text_properties_from_list (val
, props
,
859 make_number (textprops
[argnum
].to
));
860 last_to_end
= textprops
[argnum
].to
+ SCHARS (this);
866 static Lisp_Object string_char_byte_cache_string
;
867 static int string_char_byte_cache_charpos
;
868 static int string_char_byte_cache_bytepos
;
871 clear_string_char_byte_cache ()
873 string_char_byte_cache_string
= Qnil
;
876 /* Return the character index corresponding to CHAR_INDEX in STRING. */
879 string_char_to_byte (string
, char_index
)
884 int best_below
, best_below_byte
;
885 int best_above
, best_above_byte
;
887 best_below
= best_below_byte
= 0;
888 best_above
= SCHARS (string
);
889 best_above_byte
= SBYTES (string
);
890 if (best_above
== best_above_byte
)
893 if (EQ (string
, string_char_byte_cache_string
))
895 if (string_char_byte_cache_charpos
< char_index
)
897 best_below
= string_char_byte_cache_charpos
;
898 best_below_byte
= string_char_byte_cache_bytepos
;
902 best_above
= string_char_byte_cache_charpos
;
903 best_above_byte
= string_char_byte_cache_bytepos
;
907 if (char_index
- best_below
< best_above
- char_index
)
909 while (best_below
< char_index
)
912 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c
, string
,
913 best_below
, best_below_byte
);
916 i_byte
= best_below_byte
;
920 while (best_above
> char_index
)
922 unsigned char *pend
= SDATA (string
) + best_above_byte
;
923 unsigned char *pbeg
= pend
- best_above_byte
;
924 unsigned char *p
= pend
- 1;
927 while (p
> pbeg
&& !CHAR_HEAD_P (*p
)) p
--;
928 PARSE_MULTIBYTE_SEQ (p
, pend
- p
, bytes
);
929 if (bytes
== pend
- p
)
930 best_above_byte
-= bytes
;
931 else if (bytes
> pend
- p
)
932 best_above_byte
-= (pend
- p
);
938 i_byte
= best_above_byte
;
941 string_char_byte_cache_bytepos
= i_byte
;
942 string_char_byte_cache_charpos
= i
;
943 string_char_byte_cache_string
= string
;
948 /* Return the character index corresponding to BYTE_INDEX in STRING. */
951 string_byte_to_char (string
, byte_index
)
956 int best_below
, best_below_byte
;
957 int best_above
, best_above_byte
;
959 best_below
= best_below_byte
= 0;
960 best_above
= SCHARS (string
);
961 best_above_byte
= SBYTES (string
);
962 if (best_above
== best_above_byte
)
965 if (EQ (string
, string_char_byte_cache_string
))
967 if (string_char_byte_cache_bytepos
< byte_index
)
969 best_below
= string_char_byte_cache_charpos
;
970 best_below_byte
= string_char_byte_cache_bytepos
;
974 best_above
= string_char_byte_cache_charpos
;
975 best_above_byte
= string_char_byte_cache_bytepos
;
979 if (byte_index
- best_below_byte
< best_above_byte
- byte_index
)
981 while (best_below_byte
< byte_index
)
984 FETCH_STRING_CHAR_ADVANCE_NO_CHECK (c
, string
,
985 best_below
, best_below_byte
);
988 i_byte
= best_below_byte
;
992 while (best_above_byte
> byte_index
)
994 unsigned char *pend
= SDATA (string
) + best_above_byte
;
995 unsigned char *pbeg
= pend
- best_above_byte
;
996 unsigned char *p
= pend
- 1;
999 while (p
> pbeg
&& !CHAR_HEAD_P (*p
)) p
--;
1000 PARSE_MULTIBYTE_SEQ (p
, pend
- p
, bytes
);
1001 if (bytes
== pend
- p
)
1002 best_above_byte
-= bytes
;
1003 else if (bytes
> pend
- p
)
1004 best_above_byte
-= (pend
- p
);
1010 i_byte
= best_above_byte
;
1013 string_char_byte_cache_bytepos
= i_byte
;
1014 string_char_byte_cache_charpos
= i
;
1015 string_char_byte_cache_string
= string
;
1020 /* Convert STRING to a multibyte string.
1021 Single-byte characters 0240 through 0377 are converted
1022 by adding nonascii_insert_offset to each. */
1025 string_make_multibyte (string
)
1031 if (STRING_MULTIBYTE (string
))
1034 nbytes
= count_size_as_multibyte (SDATA (string
),
1036 /* If all the chars are ASCII, they won't need any more bytes
1037 once converted. In that case, we can return STRING itself. */
1038 if (nbytes
== SBYTES (string
))
1041 buf
= (unsigned char *) alloca (nbytes
);
1042 copy_text (SDATA (string
), buf
, SBYTES (string
),
1045 return make_multibyte_string (buf
, SCHARS (string
), nbytes
);
1049 /* Convert STRING to a multibyte string without changing each
1050 character codes. Thus, characters 0200 trough 0237 are converted
1051 to eight-bit-control characters, and characters 0240 through 0377
1052 are converted eight-bit-graphic characters. */
1055 string_to_multibyte (string
)
1061 if (STRING_MULTIBYTE (string
))
1064 nbytes
= parse_str_to_multibyte (SDATA (string
), SBYTES (string
));
1065 /* If all the chars are ASCII or eight-bit-graphic, they won't need
1066 any more bytes once converted. */
1067 if (nbytes
== SBYTES (string
))
1068 return make_multibyte_string (SDATA (string
), nbytes
, nbytes
);
1070 buf
= (unsigned char *) alloca (nbytes
);
1071 bcopy (SDATA (string
), buf
, SBYTES (string
));
1072 str_to_multibyte (buf
, nbytes
, SBYTES (string
));
1074 return make_multibyte_string (buf
, SCHARS (string
), nbytes
);
1078 /* Convert STRING to a single-byte string. */
1081 string_make_unibyte (string
)
1086 if (! STRING_MULTIBYTE (string
))
1089 buf
= (unsigned char *) alloca (SCHARS (string
));
1091 copy_text (SDATA (string
), buf
, SBYTES (string
),
1094 return make_unibyte_string (buf
, SCHARS (string
));
1097 DEFUN ("string-make-multibyte", Fstring_make_multibyte
, Sstring_make_multibyte
,
1099 doc
: /* Return the multibyte equivalent of STRING.
1100 If STRING is unibyte and contains non-ASCII characters, the function
1101 `unibyte-char-to-multibyte' is used to convert each unibyte character
1102 to a multibyte character. In this case, the returned string is a
1103 newly created string with no text properties. If STRING is multibyte
1104 or entirely ASCII, it is returned unchanged. In particular, when
1105 STRING is unibyte and entirely ASCII, the returned string is unibyte.
1106 \(When the characters are all ASCII, Emacs primitives will treat the
1107 string the same way whether it is unibyte or multibyte.) */)
1111 CHECK_STRING (string
);
1113 return string_make_multibyte (string
);
1116 DEFUN ("string-make-unibyte", Fstring_make_unibyte
, Sstring_make_unibyte
,
1118 doc
: /* Return the unibyte equivalent of STRING.
1119 Multibyte character codes are converted to unibyte according to
1120 `nonascii-translation-table' or, if that is nil, `nonascii-insert-offset'.
1121 If the lookup in the translation table fails, this function takes just
1122 the low 8 bits of each character. */)
1126 CHECK_STRING (string
);
1128 return string_make_unibyte (string
);
1131 DEFUN ("string-as-unibyte", Fstring_as_unibyte
, Sstring_as_unibyte
,
1133 doc
: /* Return a unibyte string with the same individual bytes as STRING.
1134 If STRING is unibyte, the result is STRING itself.
1135 Otherwise it is a newly created string, with no text properties.
1136 If STRING is multibyte and contains a character of charset
1137 `eight-bit-control' or `eight-bit-graphic', it is converted to the
1138 corresponding single byte. */)
1142 CHECK_STRING (string
);
1144 if (STRING_MULTIBYTE (string
))
1146 int bytes
= SBYTES (string
);
1147 unsigned char *str
= (unsigned char *) xmalloc (bytes
);
1149 bcopy (SDATA (string
), str
, bytes
);
1150 bytes
= str_as_unibyte (str
, bytes
);
1151 string
= make_unibyte_string (str
, bytes
);
1157 DEFUN ("string-as-multibyte", Fstring_as_multibyte
, Sstring_as_multibyte
,
1159 doc
: /* Return a multibyte string with the same individual bytes as STRING.
1160 If STRING is multibyte, the result is STRING itself.
1161 Otherwise it is a newly created string, with no text properties.
1162 If STRING is unibyte and contains an individual 8-bit byte (i.e. not
1163 part of a multibyte form), it is converted to the corresponding
1164 multibyte character of charset `eight-bit-control' or `eight-bit-graphic'. */)
1168 CHECK_STRING (string
);
1170 if (! STRING_MULTIBYTE (string
))
1172 Lisp_Object new_string
;
1175 parse_str_as_multibyte (SDATA (string
),
1178 new_string
= make_uninit_multibyte_string (nchars
, nbytes
);
1179 bcopy (SDATA (string
), SDATA (new_string
),
1181 if (nbytes
!= SBYTES (string
))
1182 str_as_multibyte (SDATA (new_string
), nbytes
,
1183 SBYTES (string
), NULL
);
1184 string
= new_string
;
1185 STRING_SET_INTERVALS (string
, NULL_INTERVAL
);
1190 DEFUN ("string-to-multibyte", Fstring_to_multibyte
, Sstring_to_multibyte
,
1192 doc
: /* Return a multibyte string with the same individual chars as STRING.
1193 If STRING is multibyte, the result is STRING itself.
1194 Otherwise it is a newly created string, with no text properties.
1195 Characters 0200 through 0237 are converted to eight-bit-control
1196 characters of the same character code. Characters 0240 through 0377
1197 are converted to eight-bit-graphic characters of the same character
1202 CHECK_STRING (string
);
1204 return string_to_multibyte (string
);
1208 DEFUN ("copy-alist", Fcopy_alist
, Scopy_alist
, 1, 1, 0,
1209 doc
: /* Return a copy of ALIST.
1210 This is an alist which represents the same mapping from objects to objects,
1211 but does not share the alist structure with ALIST.
1212 The objects mapped (cars and cdrs of elements of the alist)
1213 are shared, however.
1214 Elements of ALIST that are not conses are also shared. */)
1218 register Lisp_Object tem
;
1223 alist
= concat (1, &alist
, Lisp_Cons
, 0);
1224 for (tem
= alist
; CONSP (tem
); tem
= XCDR (tem
))
1226 register Lisp_Object car
;
1230 XSETCAR (tem
, Fcons (XCAR (car
), XCDR (car
)));
1235 DEFUN ("substring", Fsubstring
, Ssubstring
, 2, 3, 0,
1236 doc
: /* Return a substring of STRING, starting at index FROM and ending before TO.
1237 TO may be nil or omitted; then the substring runs to the end of STRING.
1238 FROM and TO start at 0. If either is negative, it counts from the end.
1240 This function allows vectors as well as strings. */)
1243 register Lisp_Object from
, to
;
1248 int from_char
, to_char
;
1249 int from_byte
= 0, to_byte
= 0;
1251 if (! (STRINGP (string
) || VECTORP (string
)))
1252 wrong_type_argument (Qarrayp
, string
);
1254 CHECK_NUMBER (from
);
1256 if (STRINGP (string
))
1258 size
= SCHARS (string
);
1259 size_byte
= SBYTES (string
);
1262 size
= XVECTOR (string
)->size
;
1267 to_byte
= size_byte
;
1273 to_char
= XINT (to
);
1277 if (STRINGP (string
))
1278 to_byte
= string_char_to_byte (string
, to_char
);
1281 from_char
= XINT (from
);
1284 if (STRINGP (string
))
1285 from_byte
= string_char_to_byte (string
, from_char
);
1287 if (!(0 <= from_char
&& from_char
<= to_char
&& to_char
<= size
))
1288 args_out_of_range_3 (string
, make_number (from_char
),
1289 make_number (to_char
));
1291 if (STRINGP (string
))
1293 res
= make_specified_string (SDATA (string
) + from_byte
,
1294 to_char
- from_char
, to_byte
- from_byte
,
1295 STRING_MULTIBYTE (string
));
1296 copy_text_properties (make_number (from_char
), make_number (to_char
),
1297 string
, make_number (0), res
, Qnil
);
1300 res
= Fvector (to_char
- from_char
,
1301 XVECTOR (string
)->contents
+ from_char
);
1307 DEFUN ("substring-no-properties", Fsubstring_no_properties
, Ssubstring_no_properties
, 1, 3, 0,
1308 doc
: /* Return a substring of STRING, without text properties.
1309 It starts at index FROM and ending before TO.
1310 TO may be nil or omitted; then the substring runs to the end of STRING.
1311 If FROM is nil or omitted, the substring starts at the beginning of STRING.
1312 If FROM or TO is negative, it counts from the end.
1314 With one argument, just copy STRING without its properties. */)
1317 register Lisp_Object from
, to
;
1319 int size
, size_byte
;
1320 int from_char
, to_char
;
1321 int from_byte
, to_byte
;
1323 CHECK_STRING (string
);
1325 size
= SCHARS (string
);
1326 size_byte
= SBYTES (string
);
1329 from_char
= from_byte
= 0;
1332 CHECK_NUMBER (from
);
1333 from_char
= XINT (from
);
1337 from_byte
= string_char_to_byte (string
, from_char
);
1343 to_byte
= size_byte
;
1349 to_char
= XINT (to
);
1353 to_byte
= string_char_to_byte (string
, to_char
);
1356 if (!(0 <= from_char
&& from_char
<= to_char
&& to_char
<= size
))
1357 args_out_of_range_3 (string
, make_number (from_char
),
1358 make_number (to_char
));
1360 return make_specified_string (SDATA (string
) + from_byte
,
1361 to_char
- from_char
, to_byte
- from_byte
,
1362 STRING_MULTIBYTE (string
));
1365 /* Extract a substring of STRING, giving start and end positions
1366 both in characters and in bytes. */
1369 substring_both (string
, from
, from_byte
, to
, to_byte
)
1371 int from
, from_byte
, to
, to_byte
;
1377 if (! (STRINGP (string
) || VECTORP (string
)))
1378 wrong_type_argument (Qarrayp
, string
);
1380 if (STRINGP (string
))
1382 size
= SCHARS (string
);
1383 size_byte
= SBYTES (string
);
1386 size
= XVECTOR (string
)->size
;
1388 if (!(0 <= from
&& from
<= to
&& to
<= size
))
1389 args_out_of_range_3 (string
, make_number (from
), make_number (to
));
1391 if (STRINGP (string
))
1393 res
= make_specified_string (SDATA (string
) + from_byte
,
1394 to
- from
, to_byte
- from_byte
,
1395 STRING_MULTIBYTE (string
));
1396 copy_text_properties (make_number (from
), make_number (to
),
1397 string
, make_number (0), res
, Qnil
);
1400 res
= Fvector (to
- from
,
1401 XVECTOR (string
)->contents
+ from
);
1406 DEFUN ("nthcdr", Fnthcdr
, Snthcdr
, 2, 2, 0,
1407 doc
: /* Take cdr N times on LIST, returns the result. */)
1410 register Lisp_Object list
;
1412 register int i
, num
;
1415 for (i
= 0; i
< num
&& !NILP (list
); i
++)
1419 wrong_type_argument (Qlistp
, list
);
1425 DEFUN ("nth", Fnth
, Snth
, 2, 2, 0,
1426 doc
: /* Return the Nth element of LIST.
1427 N counts from zero. If LIST is not that long, nil is returned. */)
1429 Lisp_Object n
, list
;
1431 return Fcar (Fnthcdr (n
, list
));
1434 DEFUN ("elt", Felt
, Selt
, 2, 2, 0,
1435 doc
: /* Return element of SEQUENCE at index N. */)
1437 register Lisp_Object sequence
, n
;
1442 if (CONSP (sequence
) || NILP (sequence
))
1443 return Fcar (Fnthcdr (n
, sequence
));
1444 else if (STRINGP (sequence
) || VECTORP (sequence
)
1445 || BOOL_VECTOR_P (sequence
) || CHAR_TABLE_P (sequence
))
1446 return Faref (sequence
, n
);
1448 sequence
= wrong_type_argument (Qsequencep
, sequence
);
1452 DEFUN ("member", Fmember
, Smember
, 2, 2, 0,
1453 doc
: /* Return non-nil if ELT is an element of LIST. Comparison done with `equal'.
1454 The value is actually the tail of LIST whose car is ELT. */)
1456 register Lisp_Object elt
;
1459 register Lisp_Object tail
;
1460 for (tail
= list
; !NILP (tail
); tail
= XCDR (tail
))
1462 register Lisp_Object tem
;
1464 wrong_type_argument (Qlistp
, list
);
1466 if (! NILP (Fequal (elt
, tem
)))
1473 DEFUN ("memq", Fmemq
, Smemq
, 2, 2, 0,
1474 doc
: /* Return non-nil if ELT is an element of LIST.
1475 Comparison done with EQ. The value is actually the tail of LIST
1476 whose car is ELT. */)
1478 Lisp_Object elt
, list
;
1482 if (!CONSP (list
) || EQ (XCAR (list
), elt
))
1486 if (!CONSP (list
) || EQ (XCAR (list
), elt
))
1490 if (!CONSP (list
) || EQ (XCAR (list
), elt
))
1497 if (!CONSP (list
) && !NILP (list
))
1498 list
= wrong_type_argument (Qlistp
, list
);
1503 DEFUN ("assq", Fassq
, Sassq
, 2, 2, 0,
1504 doc
: /* Return non-nil if KEY is `eq' to the car of an element of LIST.
1505 The value is actually the first element of LIST whose car is KEY.
1506 Elements of LIST that are not conses are ignored. */)
1508 Lisp_Object key
, list
;
1515 || (CONSP (XCAR (list
))
1516 && EQ (XCAR (XCAR (list
)), key
)))
1521 || (CONSP (XCAR (list
))
1522 && EQ (XCAR (XCAR (list
)), key
)))
1527 || (CONSP (XCAR (list
))
1528 && EQ (XCAR (XCAR (list
)), key
)))
1536 result
= XCAR (list
);
1537 else if (NILP (list
))
1540 result
= wrong_type_argument (Qlistp
, list
);
1545 /* Like Fassq but never report an error and do not allow quits.
1546 Use only on lists known never to be circular. */
1549 assq_no_quit (key
, list
)
1550 Lisp_Object key
, list
;
1553 && (!CONSP (XCAR (list
))
1554 || !EQ (XCAR (XCAR (list
)), key
)))
1557 return CONSP (list
) ? XCAR (list
) : Qnil
;
1560 DEFUN ("assoc", Fassoc
, Sassoc
, 2, 2, 0,
1561 doc
: /* Return non-nil if KEY is `equal' to the car of an element of LIST.
1562 The value is actually the first element of LIST whose car equals KEY. */)
1564 Lisp_Object key
, list
;
1566 Lisp_Object result
, car
;
1571 || (CONSP (XCAR (list
))
1572 && (car
= XCAR (XCAR (list
)),
1573 EQ (car
, key
) || !NILP (Fequal (car
, key
)))))
1578 || (CONSP (XCAR (list
))
1579 && (car
= XCAR (XCAR (list
)),
1580 EQ (car
, key
) || !NILP (Fequal (car
, key
)))))
1585 || (CONSP (XCAR (list
))
1586 && (car
= XCAR (XCAR (list
)),
1587 EQ (car
, key
) || !NILP (Fequal (car
, key
)))))
1595 result
= XCAR (list
);
1596 else if (NILP (list
))
1599 result
= wrong_type_argument (Qlistp
, list
);
1604 DEFUN ("rassq", Frassq
, Srassq
, 2, 2, 0,
1605 doc
: /* Return non-nil if KEY is `eq' to the cdr of an element of LIST.
1606 The value is actually the first element of LIST whose cdr is KEY. */)
1608 register Lisp_Object key
;
1616 || (CONSP (XCAR (list
))
1617 && EQ (XCDR (XCAR (list
)), key
)))
1622 || (CONSP (XCAR (list
))
1623 && EQ (XCDR (XCAR (list
)), key
)))
1628 || (CONSP (XCAR (list
))
1629 && EQ (XCDR (XCAR (list
)), key
)))
1638 else if (CONSP (list
))
1639 result
= XCAR (list
);
1641 result
= wrong_type_argument (Qlistp
, list
);
1646 DEFUN ("rassoc", Frassoc
, Srassoc
, 2, 2, 0,
1647 doc
: /* Return non-nil if KEY is `equal' to the cdr of an element of LIST.
1648 The value is actually the first element of LIST whose cdr equals KEY. */)
1650 Lisp_Object key
, list
;
1652 Lisp_Object result
, cdr
;
1657 || (CONSP (XCAR (list
))
1658 && (cdr
= XCDR (XCAR (list
)),
1659 EQ (cdr
, key
) || !NILP (Fequal (cdr
, key
)))))
1664 || (CONSP (XCAR (list
))
1665 && (cdr
= XCDR (XCAR (list
)),
1666 EQ (cdr
, key
) || !NILP (Fequal (cdr
, key
)))))
1671 || (CONSP (XCAR (list
))
1672 && (cdr
= XCDR (XCAR (list
)),
1673 EQ (cdr
, key
) || !NILP (Fequal (cdr
, key
)))))
1681 result
= XCAR (list
);
1682 else if (NILP (list
))
1685 result
= wrong_type_argument (Qlistp
, list
);
1690 DEFUN ("delq", Fdelq
, Sdelq
, 2, 2, 0,
1691 doc
: /* Delete by side effect any occurrences of ELT as a member of LIST.
1692 The modified LIST is returned. Comparison is done with `eq'.
1693 If the first member of LIST is ELT, there is no way to remove it by side effect;
1694 therefore, write `(setq foo (delq element foo))'
1695 to be sure of changing the value of `foo'. */)
1697 register Lisp_Object elt
;
1700 register Lisp_Object tail
, prev
;
1701 register Lisp_Object tem
;
1705 while (!NILP (tail
))
1708 wrong_type_argument (Qlistp
, list
);
1715 Fsetcdr (prev
, XCDR (tail
));
1725 DEFUN ("delete", Fdelete
, Sdelete
, 2, 2, 0,
1726 doc
: /* Delete by side effect any occurrences of ELT as a member of SEQ.
1727 SEQ must be a list, a vector, or a string.
1728 The modified SEQ is returned. Comparison is done with `equal'.
1729 If SEQ is not a list, or the first member of SEQ is ELT, deleting it
1730 is not a side effect; it is simply using a different sequence.
1731 Therefore, write `(setq foo (delete element foo))'
1732 to be sure of changing the value of `foo'. */)
1734 Lisp_Object elt
, seq
;
1740 for (i
= n
= 0; i
< ASIZE (seq
); ++i
)
1741 if (NILP (Fequal (AREF (seq
, i
), elt
)))
1744 if (n
!= ASIZE (seq
))
1746 struct Lisp_Vector
*p
= allocate_vector (n
);
1748 for (i
= n
= 0; i
< ASIZE (seq
); ++i
)
1749 if (NILP (Fequal (AREF (seq
, i
), elt
)))
1750 p
->contents
[n
++] = AREF (seq
, i
);
1752 XSETVECTOR (seq
, p
);
1755 else if (STRINGP (seq
))
1757 EMACS_INT i
, ibyte
, nchars
, nbytes
, cbytes
;
1760 for (i
= nchars
= nbytes
= ibyte
= 0;
1762 ++i
, ibyte
+= cbytes
)
1764 if (STRING_MULTIBYTE (seq
))
1766 c
= STRING_CHAR (SDATA (seq
) + ibyte
,
1767 SBYTES (seq
) - ibyte
);
1768 cbytes
= CHAR_BYTES (c
);
1776 if (!INTEGERP (elt
) || c
!= XINT (elt
))
1783 if (nchars
!= SCHARS (seq
))
1787 tem
= make_uninit_multibyte_string (nchars
, nbytes
);
1788 if (!STRING_MULTIBYTE (seq
))
1789 STRING_SET_UNIBYTE (tem
);
1791 for (i
= nchars
= nbytes
= ibyte
= 0;
1793 ++i
, ibyte
+= cbytes
)
1795 if (STRING_MULTIBYTE (seq
))
1797 c
= STRING_CHAR (SDATA (seq
) + ibyte
,
1798 SBYTES (seq
) - ibyte
);
1799 cbytes
= CHAR_BYTES (c
);
1807 if (!INTEGERP (elt
) || c
!= XINT (elt
))
1809 unsigned char *from
= SDATA (seq
) + ibyte
;
1810 unsigned char *to
= SDATA (tem
) + nbytes
;
1816 for (n
= cbytes
; n
--; )
1826 Lisp_Object tail
, prev
;
1828 for (tail
= seq
, prev
= Qnil
; !NILP (tail
); tail
= XCDR (tail
))
1831 wrong_type_argument (Qlistp
, seq
);
1833 if (!NILP (Fequal (elt
, XCAR (tail
))))
1838 Fsetcdr (prev
, XCDR (tail
));
1849 DEFUN ("nreverse", Fnreverse
, Snreverse
, 1, 1, 0,
1850 doc
: /* Reverse LIST by modifying cdr pointers.
1851 Return the reversed list. */)
1855 register Lisp_Object prev
, tail
, next
;
1857 if (NILP (list
)) return list
;
1860 while (!NILP (tail
))
1864 wrong_type_argument (Qlistp
, list
);
1866 Fsetcdr (tail
, prev
);
1873 DEFUN ("reverse", Freverse
, Sreverse
, 1, 1, 0,
1874 doc
: /* Reverse LIST, copying. Return the reversed list.
1875 See also the function `nreverse', which is used more often. */)
1881 for (new = Qnil
; CONSP (list
); list
= XCDR (list
))
1884 new = Fcons (XCAR (list
), new);
1887 wrong_type_argument (Qconsp
, list
);
1891 Lisp_Object
merge ();
1893 DEFUN ("sort", Fsort
, Ssort
, 2, 2, 0,
1894 doc
: /* Sort LIST, stably, comparing elements using PREDICATE.
1895 Returns the sorted list. LIST is modified by side effects.
1896 PREDICATE is called with two elements of LIST, and should return t
1897 if the first element is "less" than the second. */)
1899 Lisp_Object list
, predicate
;
1901 Lisp_Object front
, back
;
1902 register Lisp_Object len
, tem
;
1903 struct gcpro gcpro1
, gcpro2
;
1904 register int length
;
1907 len
= Flength (list
);
1908 length
= XINT (len
);
1912 XSETINT (len
, (length
/ 2) - 1);
1913 tem
= Fnthcdr (len
, list
);
1915 Fsetcdr (tem
, Qnil
);
1917 GCPRO2 (front
, back
);
1918 front
= Fsort (front
, predicate
);
1919 back
= Fsort (back
, predicate
);
1921 return merge (front
, back
, predicate
);
1925 merge (org_l1
, org_l2
, pred
)
1926 Lisp_Object org_l1
, org_l2
;
1930 register Lisp_Object tail
;
1932 register Lisp_Object l1
, l2
;
1933 struct gcpro gcpro1
, gcpro2
, gcpro3
, gcpro4
;
1940 /* It is sufficient to protect org_l1 and org_l2.
1941 When l1 and l2 are updated, we copy the new values
1942 back into the org_ vars. */
1943 GCPRO4 (org_l1
, org_l2
, pred
, value
);
1963 tem
= call2 (pred
, Fcar (l2
), Fcar (l1
));
1979 Fsetcdr (tail
, tem
);
1985 DEFUN ("plist-get", Fplist_get
, Splist_get
, 2, 2, 0,
1986 doc
: /* Extract a value from a property list.
1987 PLIST is a property list, which is a list of the form
1988 \(PROP1 VALUE1 PROP2 VALUE2...). This function returns the value
1989 corresponding to the given PROP, or nil if PROP is not
1990 one of the properties on the list. */)
1998 CONSP (tail
) && CONSP (XCDR (tail
));
1999 tail
= XCDR (XCDR (tail
)))
2001 if (EQ (prop
, XCAR (tail
)))
2002 return XCAR (XCDR (tail
));
2004 /* This function can be called asynchronously
2005 (setup_coding_system). Don't QUIT in that case. */
2006 if (!interrupt_input_blocked
)
2011 wrong_type_argument (Qlistp
, prop
);
2016 DEFUN ("get", Fget
, Sget
, 2, 2, 0,
2017 doc
: /* Return the value of SYMBOL's PROPNAME property.
2018 This is the last value stored with `(put SYMBOL PROPNAME VALUE)'. */)
2020 Lisp_Object symbol
, propname
;
2022 CHECK_SYMBOL (symbol
);
2023 return Fplist_get (XSYMBOL (symbol
)->plist
, propname
);
2026 DEFUN ("plist-put", Fplist_put
, Splist_put
, 3, 3, 0,
2027 doc
: /* Change value in PLIST of PROP to VAL.
2028 PLIST is a property list, which is a list of the form
2029 \(PROP1 VALUE1 PROP2 VALUE2 ...). PROP is a symbol and VAL is any object.
2030 If PROP is already a property on the list, its value is set to VAL,
2031 otherwise the new PROP VAL pair is added. The new plist is returned;
2032 use `(setq x (plist-put x prop val))' to be sure to use the new value.
2033 The PLIST is modified by side effects. */)
2036 register Lisp_Object prop
;
2039 register Lisp_Object tail
, prev
;
2040 Lisp_Object newcell
;
2042 for (tail
= plist
; CONSP (tail
) && CONSP (XCDR (tail
));
2043 tail
= XCDR (XCDR (tail
)))
2045 if (EQ (prop
, XCAR (tail
)))
2047 Fsetcar (XCDR (tail
), val
);
2054 newcell
= Fcons (prop
, Fcons (val
, Qnil
));
2058 Fsetcdr (XCDR (prev
), newcell
);
2062 DEFUN ("put", Fput
, Sput
, 3, 3, 0,
2063 doc
: /* Store SYMBOL's PROPNAME property with value VALUE.
2064 It can be retrieved with `(get SYMBOL PROPNAME)'. */)
2065 (symbol
, propname
, value
)
2066 Lisp_Object symbol
, propname
, value
;
2068 CHECK_SYMBOL (symbol
);
2069 XSYMBOL (symbol
)->plist
2070 = Fplist_put (XSYMBOL (symbol
)->plist
, propname
, value
);
2074 DEFUN ("lax-plist-get", Flax_plist_get
, Slax_plist_get
, 2, 2, 0,
2075 doc
: /* Extract a value from a property list, comparing with `equal'.
2076 PLIST is a property list, which is a list of the form
2077 \(PROP1 VALUE1 PROP2 VALUE2...). This function returns the value
2078 corresponding to the given PROP, or nil if PROP is not
2079 one of the properties on the list. */)
2087 CONSP (tail
) && CONSP (XCDR (tail
));
2088 tail
= XCDR (XCDR (tail
)))
2090 if (! NILP (Fequal (prop
, XCAR (tail
))))
2091 return XCAR (XCDR (tail
));
2097 wrong_type_argument (Qlistp
, prop
);
2102 DEFUN ("lax-plist-put", Flax_plist_put
, Slax_plist_put
, 3, 3, 0,
2103 doc
: /* Change value in PLIST of PROP to VAL, comparing with `equal'.
2104 PLIST is a property list, which is a list of the form
2105 \(PROP1 VALUE1 PROP2 VALUE2 ...). PROP and VAL are any objects.
2106 If PROP is already a property on the list, its value is set to VAL,
2107 otherwise the new PROP VAL pair is added. The new plist is returned;
2108 use `(setq x (lax-plist-put x prop val))' to be sure to use the new value.
2109 The PLIST is modified by side effects. */)
2112 register Lisp_Object prop
;
2115 register Lisp_Object tail
, prev
;
2116 Lisp_Object newcell
;
2118 for (tail
= plist
; CONSP (tail
) && CONSP (XCDR (tail
));
2119 tail
= XCDR (XCDR (tail
)))
2121 if (! NILP (Fequal (prop
, XCAR (tail
))))
2123 Fsetcar (XCDR (tail
), val
);
2130 newcell
= Fcons (prop
, Fcons (val
, Qnil
));
2134 Fsetcdr (XCDR (prev
), newcell
);
2138 DEFUN ("eql", Feql
, Seql
, 2, 2, 0,
2139 doc
: /* Return t if the two args are the same Lisp object.
2140 Floating-point numbers of equal value are `eql', but they may not be `eq'. */)
2142 Lisp_Object obj1
, obj2
;
2145 return internal_equal (obj1
, obj2
, 0, 0) ? Qt
: Qnil
;
2147 return EQ (obj1
, obj2
) ? Qt
: Qnil
;
2150 DEFUN ("equal", Fequal
, Sequal
, 2, 2, 0,
2151 doc
: /* Return t if two Lisp objects have similar structure and contents.
2152 They must have the same data type.
2153 Conses are compared by comparing the cars and the cdrs.
2154 Vectors and strings are compared element by element.
2155 Numbers are compared by value, but integers cannot equal floats.
2156 (Use `=' if you want integers and floats to be able to be equal.)
2157 Symbols must match exactly. */)
2159 register Lisp_Object o1
, o2
;
2161 return internal_equal (o1
, o2
, 0, 0) ? Qt
: Qnil
;
2164 DEFUN ("equal-including-properties", Fequal_including_properties
, Sequal_including_properties
, 2, 2, 0,
2165 doc
: /* Return t if two Lisp objects have similar structure and contents.
2166 This is like `equal' except that it compares the text properties
2167 of strings. (`equal' ignores text properties.) */)
2169 register Lisp_Object o1
, o2
;
2171 return internal_equal (o1
, o2
, 0, 1) ? Qt
: Qnil
;
2174 /* DEPTH is current depth of recursion. Signal an error if it
2176 PROPS, if non-nil, means compare string text properties too. */
2179 internal_equal (o1
, o2
, depth
, props
)
2180 register Lisp_Object o1
, o2
;
2184 error ("Stack overflow in equal");
2190 if (XTYPE (o1
) != XTYPE (o2
))
2199 d1
= extract_float (o1
);
2200 d2
= extract_float (o2
);
2201 /* If d is a NaN, then d != d. Two NaNs should be `equal' even
2202 though they are not =. */
2203 return d1
== d2
|| (d1
!= d1
&& d2
!= d2
);
2207 if (!internal_equal (XCAR (o1
), XCAR (o2
), depth
+ 1, props
))
2214 if (XMISCTYPE (o1
) != XMISCTYPE (o2
))
2218 if (!internal_equal (OVERLAY_START (o1
), OVERLAY_START (o2
),
2220 || !internal_equal (OVERLAY_END (o1
), OVERLAY_END (o2
),
2223 o1
= XOVERLAY (o1
)->plist
;
2224 o2
= XOVERLAY (o2
)->plist
;
2229 return (XMARKER (o1
)->buffer
== XMARKER (o2
)->buffer
2230 && (XMARKER (o1
)->buffer
== 0
2231 || XMARKER (o1
)->bytepos
== XMARKER (o2
)->bytepos
));
2235 case Lisp_Vectorlike
:
2238 EMACS_INT size
= XVECTOR (o1
)->size
;
2239 /* Pseudovectors have the type encoded in the size field, so this test
2240 actually checks that the objects have the same type as well as the
2242 if (XVECTOR (o2
)->size
!= size
)
2244 /* Boolvectors are compared much like strings. */
2245 if (BOOL_VECTOR_P (o1
))
2248 = (XBOOL_VECTOR (o1
)->size
+ BITS_PER_CHAR
- 1) / BITS_PER_CHAR
;
2250 if (XBOOL_VECTOR (o1
)->size
!= XBOOL_VECTOR (o2
)->size
)
2252 if (bcmp (XBOOL_VECTOR (o1
)->data
, XBOOL_VECTOR (o2
)->data
,
2257 if (WINDOW_CONFIGURATIONP (o1
))
2258 return compare_window_configurations (o1
, o2
, 0);
2260 /* Aside from them, only true vectors, char-tables, and compiled
2261 functions are sensible to compare, so eliminate the others now. */
2262 if (size
& PSEUDOVECTOR_FLAG
)
2264 if (!(size
& (PVEC_COMPILED
| PVEC_CHAR_TABLE
)))
2266 size
&= PSEUDOVECTOR_SIZE_MASK
;
2268 for (i
= 0; i
< size
; i
++)
2271 v1
= XVECTOR (o1
)->contents
[i
];
2272 v2
= XVECTOR (o2
)->contents
[i
];
2273 if (!internal_equal (v1
, v2
, depth
+ 1, props
))
2281 if (SCHARS (o1
) != SCHARS (o2
))
2283 if (SBYTES (o1
) != SBYTES (o2
))
2285 if (bcmp (SDATA (o1
), SDATA (o2
),
2288 if (props
&& !compare_string_intervals (o1
, o2
))
2294 case Lisp_Type_Limit
:
2301 extern Lisp_Object
Fmake_char_internal ();
2303 DEFUN ("fillarray", Ffillarray
, Sfillarray
, 2, 2, 0,
2304 doc
: /* Store each element of ARRAY with ITEM.
2305 ARRAY is a vector, string, char-table, or bool-vector. */)
2307 Lisp_Object array
, item
;
2309 register int size
, index
, charval
;
2311 if (VECTORP (array
))
2313 register Lisp_Object
*p
= XVECTOR (array
)->contents
;
2314 size
= XVECTOR (array
)->size
;
2315 for (index
= 0; index
< size
; index
++)
2318 else if (CHAR_TABLE_P (array
))
2320 register Lisp_Object
*p
= XCHAR_TABLE (array
)->contents
;
2321 size
= CHAR_TABLE_ORDINARY_SLOTS
;
2322 for (index
= 0; index
< size
; index
++)
2324 XCHAR_TABLE (array
)->defalt
= Qnil
;
2326 else if (STRINGP (array
))
2328 register unsigned char *p
= SDATA (array
);
2329 CHECK_NUMBER (item
);
2330 charval
= XINT (item
);
2331 size
= SCHARS (array
);
2332 if (STRING_MULTIBYTE (array
))
2334 unsigned char str
[MAX_MULTIBYTE_LENGTH
];
2335 int len
= CHAR_STRING (charval
, str
);
2336 int size_byte
= SBYTES (array
);
2337 unsigned char *p1
= p
, *endp
= p
+ size_byte
;
2340 if (size
!= size_byte
)
2343 int this_len
= MULTIBYTE_FORM_LENGTH (p1
, endp
- p1
);
2344 if (len
!= this_len
)
2345 error ("Attempt to change byte length of a string");
2348 for (i
= 0; i
< size_byte
; i
++)
2349 *p
++ = str
[i
% len
];
2352 for (index
= 0; index
< size
; index
++)
2355 else if (BOOL_VECTOR_P (array
))
2357 register unsigned char *p
= XBOOL_VECTOR (array
)->data
;
2359 = (XBOOL_VECTOR (array
)->size
+ BITS_PER_CHAR
- 1) / BITS_PER_CHAR
;
2361 charval
= (! NILP (item
) ? -1 : 0);
2362 for (index
= 0; index
< size_in_chars
- 1; index
++)
2364 if (index
< size_in_chars
)
2366 /* Mask out bits beyond the vector size. */
2367 if (XBOOL_VECTOR (array
)->size
% BITS_PER_CHAR
)
2368 charval
&= (1 << (XBOOL_VECTOR (array
)->size
% BITS_PER_CHAR
)) - 1;
2374 array
= wrong_type_argument (Qarrayp
, array
);
2380 DEFUN ("clear-string", Fclear_string
, Sclear_string
,
2382 doc
: /* Clear the contents of STRING.
2383 This makes STRING unibyte and may change its length. */)
2387 int len
= SBYTES (string
);
2388 bzero (SDATA (string
), len
);
2389 STRING_SET_CHARS (string
, len
);
2390 STRING_SET_UNIBYTE (string
);
2394 DEFUN ("char-table-subtype", Fchar_table_subtype
, Schar_table_subtype
,
2396 doc
: /* Return the subtype of char-table CHAR-TABLE. The value is a symbol. */)
2398 Lisp_Object char_table
;
2400 CHECK_CHAR_TABLE (char_table
);
2402 return XCHAR_TABLE (char_table
)->purpose
;
2405 DEFUN ("char-table-parent", Fchar_table_parent
, Schar_table_parent
,
2407 doc
: /* Return the parent char-table of CHAR-TABLE.
2408 The value is either nil or another char-table.
2409 If CHAR-TABLE holds nil for a given character,
2410 then the actual applicable value is inherited from the parent char-table
2411 \(or from its parents, if necessary). */)
2413 Lisp_Object char_table
;
2415 CHECK_CHAR_TABLE (char_table
);
2417 return XCHAR_TABLE (char_table
)->parent
;
2420 DEFUN ("set-char-table-parent", Fset_char_table_parent
, Sset_char_table_parent
,
2422 doc
: /* Set the parent char-table of CHAR-TABLE to PARENT.
2423 Return PARENT. PARENT must be either nil or another char-table. */)
2424 (char_table
, parent
)
2425 Lisp_Object char_table
, parent
;
2429 CHECK_CHAR_TABLE (char_table
);
2433 CHECK_CHAR_TABLE (parent
);
2435 for (temp
= parent
; !NILP (temp
); temp
= XCHAR_TABLE (temp
)->parent
)
2436 if (EQ (temp
, char_table
))
2437 error ("Attempt to make a chartable be its own parent");
2440 XCHAR_TABLE (char_table
)->parent
= parent
;
2445 DEFUN ("char-table-extra-slot", Fchar_table_extra_slot
, Schar_table_extra_slot
,
2447 doc
: /* Return the value of CHAR-TABLE's extra-slot number N. */)
2449 Lisp_Object char_table
, n
;
2451 CHECK_CHAR_TABLE (char_table
);
2454 || XINT (n
) >= CHAR_TABLE_EXTRA_SLOTS (XCHAR_TABLE (char_table
)))
2455 args_out_of_range (char_table
, n
);
2457 return XCHAR_TABLE (char_table
)->extras
[XINT (n
)];
2460 DEFUN ("set-char-table-extra-slot", Fset_char_table_extra_slot
,
2461 Sset_char_table_extra_slot
,
2463 doc
: /* Set CHAR-TABLE's extra-slot number N to VALUE. */)
2464 (char_table
, n
, value
)
2465 Lisp_Object char_table
, n
, value
;
2467 CHECK_CHAR_TABLE (char_table
);
2470 || XINT (n
) >= CHAR_TABLE_EXTRA_SLOTS (XCHAR_TABLE (char_table
)))
2471 args_out_of_range (char_table
, n
);
2473 return XCHAR_TABLE (char_table
)->extras
[XINT (n
)] = value
;
2476 DEFUN ("char-table-range", Fchar_table_range
, Schar_table_range
,
2478 doc
: /* Return the value in CHAR-TABLE for a range of characters RANGE.
2479 RANGE should be nil (for the default value)
2480 a vector which identifies a character set or a row of a character set,
2481 a character set name, or a character code. */)
2483 Lisp_Object char_table
, range
;
2485 CHECK_CHAR_TABLE (char_table
);
2487 if (EQ (range
, Qnil
))
2488 return XCHAR_TABLE (char_table
)->defalt
;
2489 else if (INTEGERP (range
))
2490 return Faref (char_table
, range
);
2491 else if (SYMBOLP (range
))
2493 Lisp_Object charset_info
;
2495 charset_info
= Fget (range
, Qcharset
);
2496 CHECK_VECTOR (charset_info
);
2498 return Faref (char_table
,
2499 make_number (XINT (XVECTOR (charset_info
)->contents
[0])
2502 else if (VECTORP (range
))
2504 if (XVECTOR (range
)->size
== 1)
2505 return Faref (char_table
,
2506 make_number (XINT (XVECTOR (range
)->contents
[0]) + 128));
2509 int size
= XVECTOR (range
)->size
;
2510 Lisp_Object
*val
= XVECTOR (range
)->contents
;
2511 Lisp_Object ch
= Fmake_char_internal (size
<= 0 ? Qnil
: val
[0],
2512 size
<= 1 ? Qnil
: val
[1],
2513 size
<= 2 ? Qnil
: val
[2]);
2514 return Faref (char_table
, ch
);
2518 error ("Invalid RANGE argument to `char-table-range'");
2522 DEFUN ("set-char-table-range", Fset_char_table_range
, Sset_char_table_range
,
2524 doc
: /* Set the value in CHAR-TABLE for a range of characters RANGE to VALUE.
2525 RANGE should be t (for all characters), nil (for the default value),
2526 a character set, a vector which identifies a character set, a row of a
2527 character set, or a character code. Return VALUE. */)
2528 (char_table
, range
, value
)
2529 Lisp_Object char_table
, range
, value
;
2533 CHECK_CHAR_TABLE (char_table
);
2536 for (i
= 0; i
< CHAR_TABLE_ORDINARY_SLOTS
; i
++)
2537 XCHAR_TABLE (char_table
)->contents
[i
] = value
;
2538 else if (EQ (range
, Qnil
))
2539 XCHAR_TABLE (char_table
)->defalt
= value
;
2540 else if (SYMBOLP (range
))
2542 Lisp_Object charset_info
;
2545 charset_info
= Fget (range
, Qcharset
);
2546 if (! VECTORP (charset_info
)
2547 || ! NATNUMP (AREF (charset_info
, 0))
2548 || (charset_id
= XINT (AREF (charset_info
, 0)),
2549 ! CHARSET_DEFINED_P (charset_id
)))
2550 error ("Invalid charset: %s", SDATA (SYMBOL_NAME (range
)));
2552 if (charset_id
== CHARSET_ASCII
)
2553 for (i
= 0; i
< 128; i
++)
2554 XCHAR_TABLE (char_table
)->contents
[i
] = value
;
2555 else if (charset_id
== CHARSET_8_BIT_CONTROL
)
2556 for (i
= 128; i
< 160; i
++)
2557 XCHAR_TABLE (char_table
)->contents
[i
] = value
;
2558 else if (charset_id
== CHARSET_8_BIT_GRAPHIC
)
2559 for (i
= 160; i
< 256; i
++)
2560 XCHAR_TABLE (char_table
)->contents
[i
] = value
;
2562 XCHAR_TABLE (char_table
)->contents
[charset_id
+ 128] = value
;
2564 else if (INTEGERP (range
))
2565 Faset (char_table
, range
, value
);
2566 else if (VECTORP (range
))
2568 if (XVECTOR (range
)->size
== 1)
2569 return Faset (char_table
,
2570 make_number (XINT (XVECTOR (range
)->contents
[0]) + 128),
2574 int size
= XVECTOR (range
)->size
;
2575 Lisp_Object
*val
= XVECTOR (range
)->contents
;
2576 Lisp_Object ch
= Fmake_char_internal (size
<= 0 ? Qnil
: val
[0],
2577 size
<= 1 ? Qnil
: val
[1],
2578 size
<= 2 ? Qnil
: val
[2]);
2579 return Faset (char_table
, ch
, value
);
2583 error ("Invalid RANGE argument to `set-char-table-range'");
2588 DEFUN ("set-char-table-default", Fset_char_table_default
,
2589 Sset_char_table_default
, 3, 3, 0,
2590 doc
: /* Set the default value in CHAR-TABLE for generic character CH to VALUE.
2591 The generic character specifies the group of characters.
2592 See also the documentation of `make-char'. */)
2593 (char_table
, ch
, value
)
2594 Lisp_Object char_table
, ch
, value
;
2596 int c
, charset
, code1
, code2
;
2599 CHECK_CHAR_TABLE (char_table
);
2603 SPLIT_CHAR (c
, charset
, code1
, code2
);
2605 /* Since we may want to set the default value for a character set
2606 not yet defined, we check only if the character set is in the
2607 valid range or not, instead of it is already defined or not. */
2608 if (! CHARSET_VALID_P (charset
))
2609 invalid_character (c
);
2611 if (charset
== CHARSET_ASCII
)
2612 return (XCHAR_TABLE (char_table
)->defalt
= value
);
2614 /* Even if C is not a generic char, we had better behave as if a
2615 generic char is specified. */
2616 if (!CHARSET_DEFINED_P (charset
) || CHARSET_DIMENSION (charset
) == 1)
2618 temp
= XCHAR_TABLE (char_table
)->contents
[charset
+ 128];
2621 if (SUB_CHAR_TABLE_P (temp
))
2622 XCHAR_TABLE (temp
)->defalt
= value
;
2624 XCHAR_TABLE (char_table
)->contents
[charset
+ 128] = value
;
2627 if (SUB_CHAR_TABLE_P (temp
))
2630 char_table
= (XCHAR_TABLE (char_table
)->contents
[charset
+ 128]
2631 = make_sub_char_table (temp
));
2632 temp
= XCHAR_TABLE (char_table
)->contents
[code1
];
2633 if (SUB_CHAR_TABLE_P (temp
))
2634 XCHAR_TABLE (temp
)->defalt
= value
;
2636 XCHAR_TABLE (char_table
)->contents
[code1
] = value
;
2640 /* Look up the element in TABLE at index CH,
2641 and return it as an integer.
2642 If the element is nil, return CH itself.
2643 (Actually we do that for any non-integer.) */
2646 char_table_translate (table
, ch
)
2651 value
= Faref (table
, make_number (ch
));
2652 if (! INTEGERP (value
))
2654 return XINT (value
);
2658 optimize_sub_char_table (table
, chars
)
2666 from
= 33, to
= 127;
2668 from
= 32, to
= 128;
2670 if (!SUB_CHAR_TABLE_P (*table
))
2672 elt
= XCHAR_TABLE (*table
)->contents
[from
++];
2673 for (; from
< to
; from
++)
2674 if (NILP (Fequal (elt
, XCHAR_TABLE (*table
)->contents
[from
])))
2679 DEFUN ("optimize-char-table", Foptimize_char_table
, Soptimize_char_table
,
2680 1, 1, 0, doc
: /* Optimize char table TABLE. */)
2688 CHECK_CHAR_TABLE (table
);
2690 for (i
= CHAR_TABLE_SINGLE_BYTE_SLOTS
; i
< CHAR_TABLE_ORDINARY_SLOTS
; i
++)
2692 elt
= XCHAR_TABLE (table
)->contents
[i
];
2693 if (!SUB_CHAR_TABLE_P (elt
))
2695 dim
= CHARSET_DIMENSION (i
- 128);
2697 for (j
= 32; j
< SUB_CHAR_TABLE_ORDINARY_SLOTS
; j
++)
2698 optimize_sub_char_table (XCHAR_TABLE (elt
)->contents
+ j
, dim
);
2699 optimize_sub_char_table (XCHAR_TABLE (table
)->contents
+ i
, dim
);
2705 /* Map C_FUNCTION or FUNCTION over SUBTABLE, calling it for each
2706 character or group of characters that share a value.
2707 DEPTH is the current depth in the originally specified
2708 chartable, and INDICES contains the vector indices
2709 for the levels our callers have descended.
2711 ARG is passed to C_FUNCTION when that is called. */
2714 map_char_table (c_function
, function
, table
, subtable
, arg
, depth
, indices
)
2715 void (*c_function
) P_ ((Lisp_Object
, Lisp_Object
, Lisp_Object
));
2716 Lisp_Object function
, table
, subtable
, arg
, *indices
;
2723 /* At first, handle ASCII and 8-bit European characters. */
2724 for (i
= 0; i
< CHAR_TABLE_SINGLE_BYTE_SLOTS
; i
++)
2726 Lisp_Object elt
= XCHAR_TABLE (subtable
)->contents
[i
];
2728 elt
= XCHAR_TABLE (subtable
)->defalt
;
2730 elt
= Faref (subtable
, make_number (i
));
2732 (*c_function
) (arg
, make_number (i
), elt
);
2734 call2 (function
, make_number (i
), elt
);
2736 #if 0 /* If the char table has entries for higher characters,
2737 we should report them. */
2738 if (NILP (current_buffer
->enable_multibyte_characters
))
2741 to
= CHAR_TABLE_ORDINARY_SLOTS
;
2745 int charset
= XFASTINT (indices
[0]) - 128;
2748 to
= SUB_CHAR_TABLE_ORDINARY_SLOTS
;
2749 if (CHARSET_CHARS (charset
) == 94)
2758 elt
= XCHAR_TABLE (subtable
)->contents
[i
];
2759 XSETFASTINT (indices
[depth
], i
);
2760 charset
= XFASTINT (indices
[0]) - 128;
2762 && (!CHARSET_DEFINED_P (charset
)
2763 || charset
== CHARSET_8_BIT_CONTROL
2764 || charset
== CHARSET_8_BIT_GRAPHIC
))
2767 if (SUB_CHAR_TABLE_P (elt
))
2770 error ("Too deep char table");
2771 map_char_table (c_function
, function
, table
, elt
, arg
, depth
+ 1, indices
);
2777 c1
= depth
>= 1 ? XFASTINT (indices
[1]) : 0;
2778 c2
= depth
>= 2 ? XFASTINT (indices
[2]) : 0;
2779 c
= MAKE_CHAR (charset
, c1
, c2
);
2782 elt
= XCHAR_TABLE (subtable
)->defalt
;
2784 elt
= Faref (table
, make_number (c
));
2787 (*c_function
) (arg
, make_number (c
), elt
);
2789 call2 (function
, make_number (c
), elt
);
2794 static void void_call2
P_ ((Lisp_Object a
, Lisp_Object b
, Lisp_Object c
));
2796 void_call2 (a
, b
, c
)
2797 Lisp_Object a
, b
, c
;
2802 DEFUN ("map-char-table", Fmap_char_table
, Smap_char_table
,
2804 doc
: /* Call FUNCTION for each (normal and generic) characters in CHAR-TABLE.
2805 FUNCTION is called with two arguments--a key and a value.
2806 The key is always a possible IDX argument to `aref'. */)
2807 (function
, char_table
)
2808 Lisp_Object function
, char_table
;
2810 /* The depth of char table is at most 3. */
2811 Lisp_Object indices
[3];
2813 CHECK_CHAR_TABLE (char_table
);
2815 /* When Lisp_Object is represented as a union, `call2' cannot directly
2816 be passed to map_char_table because it returns a Lisp_Object rather
2817 than returning nothing.
2818 Casting leads to crashes on some architectures. -stef */
2819 map_char_table (void_call2
, Qnil
, char_table
, char_table
, function
, 0, indices
);
2823 /* Return a value for character C in char-table TABLE. Store the
2824 actual index for that value in *IDX. Ignore the default value of
2828 char_table_ref_and_index (table
, c
, idx
)
2832 int charset
, c1
, c2
;
2835 if (SINGLE_BYTE_CHAR_P (c
))
2838 return XCHAR_TABLE (table
)->contents
[c
];
2840 SPLIT_CHAR (c
, charset
, c1
, c2
);
2841 elt
= XCHAR_TABLE (table
)->contents
[charset
+ 128];
2842 *idx
= MAKE_CHAR (charset
, 0, 0);
2843 if (!SUB_CHAR_TABLE_P (elt
))
2845 if (c1
< 32 || NILP (XCHAR_TABLE (elt
)->contents
[c1
]))
2846 return XCHAR_TABLE (elt
)->defalt
;
2847 elt
= XCHAR_TABLE (elt
)->contents
[c1
];
2848 *idx
= MAKE_CHAR (charset
, c1
, 0);
2849 if (!SUB_CHAR_TABLE_P (elt
))
2851 if (c2
< 32 || NILP (XCHAR_TABLE (elt
)->contents
[c2
]))
2852 return XCHAR_TABLE (elt
)->defalt
;
2854 return XCHAR_TABLE (elt
)->contents
[c2
];
2864 Lisp_Object args
[2];
2867 return Fnconc (2, args
);
2869 return Fnconc (2, &s1
);
2870 #endif /* NO_ARG_ARRAY */
2873 DEFUN ("nconc", Fnconc
, Snconc
, 0, MANY
, 0,
2874 doc
: /* Concatenate any number of lists by altering them.
2875 Only the last argument is not altered, and need not be a list.
2876 usage: (nconc &rest LISTS) */)
2881 register int argnum
;
2882 register Lisp_Object tail
, tem
, val
;
2886 for (argnum
= 0; argnum
< nargs
; argnum
++)
2889 if (NILP (tem
)) continue;
2894 if (argnum
+ 1 == nargs
) break;
2897 tem
= wrong_type_argument (Qlistp
, tem
);
2906 tem
= args
[argnum
+ 1];
2907 Fsetcdr (tail
, tem
);
2909 args
[argnum
+ 1] = tail
;
2915 /* This is the guts of all mapping functions.
2916 Apply FN to each element of SEQ, one by one,
2917 storing the results into elements of VALS, a C vector of Lisp_Objects.
2918 LENI is the length of VALS, which should also be the length of SEQ. */
2921 mapcar1 (leni
, vals
, fn
, seq
)
2924 Lisp_Object fn
, seq
;
2926 register Lisp_Object tail
;
2929 struct gcpro gcpro1
, gcpro2
, gcpro3
;
2933 /* Don't let vals contain any garbage when GC happens. */
2934 for (i
= 0; i
< leni
; i
++)
2937 GCPRO3 (dummy
, fn
, seq
);
2939 gcpro1
.nvars
= leni
;
2943 /* We need not explicitly protect `tail' because it is used only on lists, and
2944 1) lists are not relocated and 2) the list is marked via `seq' so will not be freed */
2948 for (i
= 0; i
< leni
; i
++)
2950 dummy
= XVECTOR (seq
)->contents
[i
];
2951 dummy
= call1 (fn
, dummy
);
2956 else if (BOOL_VECTOR_P (seq
))
2958 for (i
= 0; i
< leni
; i
++)
2961 byte
= XBOOL_VECTOR (seq
)->data
[i
/ BITS_PER_CHAR
];
2962 if (byte
& (1 << (i
% BITS_PER_CHAR
)))
2967 dummy
= call1 (fn
, dummy
);
2972 else if (STRINGP (seq
))
2976 for (i
= 0, i_byte
= 0; i
< leni
;)
2981 FETCH_STRING_CHAR_ADVANCE (c
, seq
, i
, i_byte
);
2982 XSETFASTINT (dummy
, c
);
2983 dummy
= call1 (fn
, dummy
);
2985 vals
[i_before
] = dummy
;
2988 else /* Must be a list, since Flength did not get an error */
2991 for (i
= 0; i
< leni
; i
++)
2993 dummy
= call1 (fn
, Fcar (tail
));
3003 DEFUN ("mapconcat", Fmapconcat
, Smapconcat
, 3, 3, 0,
3004 doc
: /* Apply FUNCTION to each element of SEQUENCE, and concat the results as strings.
3005 In between each pair of results, stick in SEPARATOR. Thus, " " as
3006 SEPARATOR results in spaces between the values returned by FUNCTION.
3007 SEQUENCE may be a list, a vector, a bool-vector, or a string. */)
3008 (function
, sequence
, separator
)
3009 Lisp_Object function
, sequence
, separator
;
3014 register Lisp_Object
*args
;
3016 struct gcpro gcpro1
;
3018 len
= Flength (sequence
);
3020 nargs
= leni
+ leni
- 1;
3021 if (nargs
< 0) return build_string ("");
3023 args
= (Lisp_Object
*) alloca (nargs
* sizeof (Lisp_Object
));
3026 mapcar1 (leni
, args
, function
, sequence
);
3029 for (i
= leni
- 1; i
>= 0; i
--)
3030 args
[i
+ i
] = args
[i
];
3032 for (i
= 1; i
< nargs
; i
+= 2)
3033 args
[i
] = separator
;
3035 return Fconcat (nargs
, args
);
3038 DEFUN ("mapcar", Fmapcar
, Smapcar
, 2, 2, 0,
3039 doc
: /* Apply FUNCTION to each element of SEQUENCE, and make a list of the results.
3040 The result is a list just as long as SEQUENCE.
3041 SEQUENCE may be a list, a vector, a bool-vector, or a string. */)
3042 (function
, sequence
)
3043 Lisp_Object function
, sequence
;
3045 register Lisp_Object len
;
3047 register Lisp_Object
*args
;
3049 len
= Flength (sequence
);
3050 leni
= XFASTINT (len
);
3051 args
= (Lisp_Object
*) alloca (leni
* sizeof (Lisp_Object
));
3053 mapcar1 (leni
, args
, function
, sequence
);
3055 return Flist (leni
, args
);
3058 DEFUN ("mapc", Fmapc
, Smapc
, 2, 2, 0,
3059 doc
: /* Apply FUNCTION to each element of SEQUENCE for side effects only.
3060 Unlike `mapcar', don't accumulate the results. Return SEQUENCE.
3061 SEQUENCE may be a list, a vector, a bool-vector, or a string. */)
3062 (function
, sequence
)
3063 Lisp_Object function
, sequence
;
3067 leni
= XFASTINT (Flength (sequence
));
3068 mapcar1 (leni
, 0, function
, sequence
);
3073 /* Anything that calls this function must protect from GC! */
3075 DEFUN ("y-or-n-p", Fy_or_n_p
, Sy_or_n_p
, 1, 1, 0,
3076 doc
: /* Ask user a "y or n" question. Return t if answer is "y".
3077 Takes one argument, which is the string to display to ask the question.
3078 It should end in a space; `y-or-n-p' adds `(y or n) ' to it.
3079 No confirmation of the answer is requested; a single character is enough.
3080 Also accepts Space to mean yes, or Delete to mean no. \(Actually, it uses
3081 the bindings in `query-replace-map'; see the documentation of that variable
3082 for more information. In this case, the useful bindings are `act', `skip',
3083 `recenter', and `quit'.\)
3085 Under a windowing system a dialog box will be used if `last-nonmenu-event'
3086 is nil and `use-dialog-box' is non-nil. */)
3090 register Lisp_Object obj
, key
, def
, map
;
3091 register int answer
;
3092 Lisp_Object xprompt
;
3093 Lisp_Object args
[2];
3094 struct gcpro gcpro1
, gcpro2
;
3095 int count
= SPECPDL_INDEX ();
3097 specbind (Qcursor_in_echo_area
, Qt
);
3099 map
= Fsymbol_value (intern ("query-replace-map"));
3101 CHECK_STRING (prompt
);
3103 GCPRO2 (prompt
, xprompt
);
3105 #ifdef HAVE_X_WINDOWS
3106 if (display_hourglass_p
)
3107 cancel_hourglass ();
3114 if ((NILP (last_nonmenu_event
) || CONSP (last_nonmenu_event
))
3118 Lisp_Object pane
, menu
;
3119 redisplay_preserve_echo_area (3);
3120 pane
= Fcons (Fcons (build_string ("Yes"), Qt
),
3121 Fcons (Fcons (build_string ("No"), Qnil
),
3123 menu
= Fcons (prompt
, pane
);
3124 obj
= Fx_popup_dialog (Qt
, menu
);
3125 answer
= !NILP (obj
);
3128 #endif /* HAVE_MENUS */
3129 cursor_in_echo_area
= 1;
3130 choose_minibuf_frame ();
3133 Lisp_Object pargs
[3];
3135 /* Colorize prompt according to `minibuffer-prompt' face. */
3136 pargs
[0] = build_string ("%s(y or n) ");
3137 pargs
[1] = intern ("face");
3138 pargs
[2] = intern ("minibuffer-prompt");
3139 args
[0] = Fpropertize (3, pargs
);
3144 if (minibuffer_auto_raise
)
3146 Lisp_Object mini_frame
;
3148 mini_frame
= WINDOW_FRAME (XWINDOW (minibuf_window
));
3150 Fraise_frame (mini_frame
);
3153 obj
= read_filtered_event (1, 0, 0, 0);
3154 cursor_in_echo_area
= 0;
3155 /* If we need to quit, quit with cursor_in_echo_area = 0. */
3158 key
= Fmake_vector (make_number (1), obj
);
3159 def
= Flookup_key (map
, key
, Qt
);
3161 if (EQ (def
, intern ("skip")))
3166 else if (EQ (def
, intern ("act")))
3171 else if (EQ (def
, intern ("recenter")))
3177 else if (EQ (def
, intern ("quit")))
3179 /* We want to exit this command for exit-prefix,
3180 and this is the only way to do it. */
3181 else if (EQ (def
, intern ("exit-prefix")))
3186 /* If we don't clear this, then the next call to read_char will
3187 return quit_char again, and we'll enter an infinite loop. */
3192 if (EQ (xprompt
, prompt
))
3194 args
[0] = build_string ("Please answer y or n. ");
3196 xprompt
= Fconcat (2, args
);
3201 if (! noninteractive
)
3203 cursor_in_echo_area
= -1;
3204 message_with_string (answer
? "%s(y or n) y" : "%s(y or n) n",
3208 unbind_to (count
, Qnil
);
3209 return answer
? Qt
: Qnil
;
3212 /* This is how C code calls `yes-or-no-p' and allows the user
3215 Anything that calls this function must protect from GC! */
3218 do_yes_or_no_p (prompt
)
3221 return call1 (intern ("yes-or-no-p"), prompt
);
3224 /* Anything that calls this function must protect from GC! */
3226 DEFUN ("yes-or-no-p", Fyes_or_no_p
, Syes_or_no_p
, 1, 1, 0,
3227 doc
: /* Ask user a yes-or-no question. Return t if answer is yes.
3228 Takes one argument, which is the string to display to ask the question.
3229 It should end in a space; `yes-or-no-p' adds `(yes or no) ' to it.
3230 The user must confirm the answer with RET,
3231 and can edit it until it has been confirmed.
3233 Under a windowing system a dialog box will be used if `last-nonmenu-event'
3234 is nil, and `use-dialog-box' is non-nil. */)
3238 register Lisp_Object ans
;
3239 Lisp_Object args
[2];
3240 struct gcpro gcpro1
;
3242 CHECK_STRING (prompt
);
3245 if ((NILP (last_nonmenu_event
) || CONSP (last_nonmenu_event
))
3249 Lisp_Object pane
, menu
, obj
;
3250 redisplay_preserve_echo_area (4);
3251 pane
= Fcons (Fcons (build_string ("Yes"), Qt
),
3252 Fcons (Fcons (build_string ("No"), Qnil
),
3255 menu
= Fcons (prompt
, pane
);
3256 obj
= Fx_popup_dialog (Qt
, menu
);
3260 #endif /* HAVE_MENUS */
3263 args
[1] = build_string ("(yes or no) ");
3264 prompt
= Fconcat (2, args
);
3270 ans
= Fdowncase (Fread_from_minibuffer (prompt
, Qnil
, Qnil
, Qnil
,
3271 Qyes_or_no_p_history
, Qnil
,
3273 if (SCHARS (ans
) == 3 && !strcmp (SDATA (ans
), "yes"))
3278 if (SCHARS (ans
) == 2 && !strcmp (SDATA (ans
), "no"))
3286 message ("Please answer yes or no.");
3287 Fsleep_for (make_number (2), Qnil
);
3291 DEFUN ("load-average", Fload_average
, Sload_average
, 0, 1, 0,
3292 doc
: /* Return list of 1 minute, 5 minute and 15 minute load averages.
3294 Each of the three load averages is multiplied by 100, then converted
3297 When USE-FLOATS is non-nil, floats will be used instead of integers.
3298 These floats are not multiplied by 100.
3300 If the 5-minute or 15-minute load averages are not available, return a
3301 shortened list, containing only those averages which are available.
3303 An error is thrown if the load average can't be obtained. In some
3304 cases making it work would require Emacs being installed setuid or
3305 setgid so that it can read kernel information, and that usually isn't
3308 Lisp_Object use_floats
;
3311 int loads
= getloadavg (load_ave
, 3);
3312 Lisp_Object ret
= Qnil
;
3315 error ("load-average not implemented for this operating system");
3319 Lisp_Object load
= (NILP (use_floats
) ?
3320 make_number ((int) (100.0 * load_ave
[loads
]))
3321 : make_float (load_ave
[loads
]));
3322 ret
= Fcons (load
, ret
);
3328 Lisp_Object Vfeatures
, Qsubfeatures
;
3329 extern Lisp_Object Vafter_load_alist
;
3331 DEFUN ("featurep", Ffeaturep
, Sfeaturep
, 1, 2, 0,
3332 doc
: /* Returns t if FEATURE is present in this Emacs.
3334 Use this to conditionalize execution of lisp code based on the
3335 presence or absence of emacs or environment extensions.
3336 Use `provide' to declare that a feature is available. This function
3337 looks at the value of the variable `features'. The optional argument
3338 SUBFEATURE can be used to check a specific subfeature of FEATURE. */)
3339 (feature
, subfeature
)
3340 Lisp_Object feature
, subfeature
;
3342 register Lisp_Object tem
;
3343 CHECK_SYMBOL (feature
);
3344 tem
= Fmemq (feature
, Vfeatures
);
3345 if (!NILP (tem
) && !NILP (subfeature
))
3346 tem
= Fmember (subfeature
, Fget (feature
, Qsubfeatures
));
3347 return (NILP (tem
)) ? Qnil
: Qt
;
3350 DEFUN ("provide", Fprovide
, Sprovide
, 1, 2, 0,
3351 doc
: /* Announce that FEATURE is a feature of the current Emacs.
3352 The optional argument SUBFEATURES should be a list of symbols listing
3353 particular subfeatures supported in this version of FEATURE. */)
3354 (feature
, subfeatures
)
3355 Lisp_Object feature
, subfeatures
;
3357 register Lisp_Object tem
;
3358 CHECK_SYMBOL (feature
);
3359 CHECK_LIST (subfeatures
);
3360 if (!NILP (Vautoload_queue
))
3361 Vautoload_queue
= Fcons (Fcons (Vfeatures
, Qnil
), Vautoload_queue
);
3362 tem
= Fmemq (feature
, Vfeatures
);
3364 Vfeatures
= Fcons (feature
, Vfeatures
);
3365 if (!NILP (subfeatures
))
3366 Fput (feature
, Qsubfeatures
, subfeatures
);
3367 LOADHIST_ATTACH (Fcons (Qprovide
, feature
));
3369 /* Run any load-hooks for this file. */
3370 tem
= Fassq (feature
, Vafter_load_alist
);
3372 Fprogn (XCDR (tem
));
3377 /* `require' and its subroutines. */
3379 /* List of features currently being require'd, innermost first. */
3381 Lisp_Object require_nesting_list
;
3384 require_unwind (old_value
)
3385 Lisp_Object old_value
;
3387 return require_nesting_list
= old_value
;
3390 DEFUN ("require", Frequire
, Srequire
, 1, 3, 0,
3391 doc
: /* If feature FEATURE is not loaded, load it from FILENAME.
3392 If FEATURE is not a member of the list `features', then the feature
3393 is not loaded; so load the file FILENAME.
3394 If FILENAME is omitted, the printname of FEATURE is used as the file name,
3395 and `load' will try to load this name appended with the suffix `.elc' or
3396 `.el', in that order. The name without appended suffix will not be used.
3397 If the optional third argument NOERROR is non-nil,
3398 then return nil if the file is not found instead of signaling an error.
3399 Normally the return value is FEATURE.
3400 The normal messages at start and end of loading FILENAME are suppressed. */)
3401 (feature
, filename
, noerror
)
3402 Lisp_Object feature
, filename
, noerror
;
3404 register Lisp_Object tem
;
3405 struct gcpro gcpro1
, gcpro2
;
3407 CHECK_SYMBOL (feature
);
3409 tem
= Fmemq (feature
, Vfeatures
);
3413 int count
= SPECPDL_INDEX ();
3416 LOADHIST_ATTACH (Fcons (Qrequire
, feature
));
3418 /* This is to make sure that loadup.el gives a clear picture
3419 of what files are preloaded and when. */
3420 if (! NILP (Vpurify_flag
))
3421 error ("(require %s) while preparing to dump",
3422 SDATA (SYMBOL_NAME (feature
)));
3424 /* A certain amount of recursive `require' is legitimate,
3425 but if we require the same feature recursively 3 times,
3427 tem
= require_nesting_list
;
3428 while (! NILP (tem
))
3430 if (! NILP (Fequal (feature
, XCAR (tem
))))
3435 error ("Recursive `require' for feature `%s'",
3436 SDATA (SYMBOL_NAME (feature
)));
3438 /* Update the list for any nested `require's that occur. */
3439 record_unwind_protect (require_unwind
, require_nesting_list
);
3440 require_nesting_list
= Fcons (feature
, require_nesting_list
);
3442 /* Value saved here is to be restored into Vautoload_queue */
3443 record_unwind_protect (un_autoload
, Vautoload_queue
);
3444 Vautoload_queue
= Qt
;
3446 /* Load the file. */
3447 GCPRO2 (feature
, filename
);
3448 tem
= Fload (NILP (filename
) ? Fsymbol_name (feature
) : filename
,
3449 noerror
, Qt
, Qnil
, (NILP (filename
) ? Qt
: Qnil
));
3452 /* If load failed entirely, return nil. */
3454 return unbind_to (count
, Qnil
);
3456 tem
= Fmemq (feature
, Vfeatures
);
3458 error ("Required feature `%s' was not provided",
3459 SDATA (SYMBOL_NAME (feature
)));
3461 /* Once loading finishes, don't undo it. */
3462 Vautoload_queue
= Qt
;
3463 feature
= unbind_to (count
, feature
);
3469 /* Primitives for work of the "widget" library.
3470 In an ideal world, this section would not have been necessary.
3471 However, lisp function calls being as slow as they are, it turns
3472 out that some functions in the widget library (wid-edit.el) are the
3473 bottleneck of Widget operation. Here is their translation to C,
3474 for the sole reason of efficiency. */
3476 DEFUN ("plist-member", Fplist_member
, Splist_member
, 2, 2, 0,
3477 doc
: /* Return non-nil if PLIST has the property PROP.
3478 PLIST is a property list, which is a list of the form
3479 \(PROP1 VALUE1 PROP2 VALUE2 ...\). PROP is a symbol.
3480 Unlike `plist-get', this allows you to distinguish between a missing
3481 property and a property with the value nil.
3482 The value is actually the tail of PLIST whose car is PROP. */)
3484 Lisp_Object plist
, prop
;
3486 while (CONSP (plist
) && !EQ (XCAR (plist
), prop
))
3489 plist
= XCDR (plist
);
3490 plist
= CDR (plist
);
3495 DEFUN ("widget-put", Fwidget_put
, Swidget_put
, 3, 3, 0,
3496 doc
: /* In WIDGET, set PROPERTY to VALUE.
3497 The value can later be retrieved with `widget-get'. */)
3498 (widget
, property
, value
)
3499 Lisp_Object widget
, property
, value
;
3501 CHECK_CONS (widget
);
3502 XSETCDR (widget
, Fplist_put (XCDR (widget
), property
, value
));
3506 DEFUN ("widget-get", Fwidget_get
, Swidget_get
, 2, 2, 0,
3507 doc
: /* In WIDGET, get the value of PROPERTY.
3508 The value could either be specified when the widget was created, or
3509 later with `widget-put'. */)
3511 Lisp_Object widget
, property
;
3519 CHECK_CONS (widget
);
3520 tmp
= Fplist_member (XCDR (widget
), property
);
3526 tmp
= XCAR (widget
);
3529 widget
= Fget (tmp
, Qwidget_type
);
3533 DEFUN ("widget-apply", Fwidget_apply
, Swidget_apply
, 2, MANY
, 0,
3534 doc
: /* Apply the value of WIDGET's PROPERTY to the widget itself.
3535 ARGS are passed as extra arguments to the function.
3536 usage: (widget-apply WIDGET PROPERTY &rest ARGS) */)
3541 /* This function can GC. */
3542 Lisp_Object newargs
[3];
3543 struct gcpro gcpro1
, gcpro2
;
3546 newargs
[0] = Fwidget_get (args
[0], args
[1]);
3547 newargs
[1] = args
[0];
3548 newargs
[2] = Flist (nargs
- 2, args
+ 2);
3549 GCPRO2 (newargs
[0], newargs
[2]);
3550 result
= Fapply (3, newargs
);
3555 #ifdef HAVE_LANGINFO_CODESET
3556 #include <langinfo.h>
3559 DEFUN ("locale-info", Flocale_info
, Slocale_info
, 1, 1, 0,
3560 doc
: /* Access locale data ITEM for the current C locale, if available.
3561 ITEM should be one of the following:
3563 `codeset', returning the character set as a string (locale item CODESET);
3565 `days', returning a 7-element vector of day names (locale items DAY_n);
3567 `months', returning a 12-element vector of month names (locale items MON_n);
3569 `paper', returning a list (WIDTH HEIGHT) for the default paper size,
3570 both measured in milimeters (locale items PAPER_WIDTH, PAPER_HEIGHT).
3572 If the system can't provide such information through a call to
3573 `nl_langinfo', or if ITEM isn't from the list above, return nil.
3575 See also Info node `(libc)Locales'.
3577 The data read from the system are decoded using `locale-coding-system'. */)
3582 #ifdef HAVE_LANGINFO_CODESET
3584 if (EQ (item
, Qcodeset
))
3586 str
= nl_langinfo (CODESET
);
3587 return build_string (str
);
3590 else if (EQ (item
, Qdays
)) /* e.g. for calendar-day-name-array */
3592 Lisp_Object v
= Fmake_vector (make_number (7), Qnil
);
3593 int days
[7] = {DAY_1
, DAY_2
, DAY_3
, DAY_4
, DAY_5
, DAY_6
, DAY_7
};
3595 synchronize_system_time_locale ();
3596 for (i
= 0; i
< 7; i
++)
3598 str
= nl_langinfo (days
[i
]);
3599 val
= make_unibyte_string (str
, strlen (str
));
3600 /* Fixme: Is this coding system necessarily right, even if
3601 it is consistent with CODESET? If not, what to do? */
3602 Faset (v
, make_number (i
),
3603 code_convert_string_norecord (val
, Vlocale_coding_system
,
3610 else if (EQ (item
, Qmonths
)) /* e.g. for calendar-month-name-array */
3612 struct Lisp_Vector
*p
= allocate_vector (12);
3613 int months
[12] = {MON_1
, MON_2
, MON_3
, MON_4
, MON_5
, MON_6
, MON_7
,
3614 MON_8
, MON_9
, MON_10
, MON_11
, MON_12
};
3616 synchronize_system_time_locale ();
3617 for (i
= 0; i
< 12; i
++)
3619 str
= nl_langinfo (months
[i
]);
3620 val
= make_unibyte_string (str
, strlen (str
));
3622 code_convert_string_norecord (val
, Vlocale_coding_system
, 0);
3624 XSETVECTOR (val
, p
);
3628 /* LC_PAPER stuff isn't defined as accessible in glibc as of 2.3.1,
3629 but is in the locale files. This could be used by ps-print. */
3631 else if (EQ (item
, Qpaper
))
3633 return list2 (make_number (nl_langinfo (PAPER_WIDTH
)),
3634 make_number (nl_langinfo (PAPER_HEIGHT
)));
3636 #endif /* PAPER_WIDTH */
3637 #endif /* HAVE_LANGINFO_CODESET*/
3641 /* base64 encode/decode functions (RFC 2045).
3642 Based on code from GNU recode. */
3644 #define MIME_LINE_LENGTH 76
3646 #define IS_ASCII(Character) \
3648 #define IS_BASE64(Character) \
3649 (IS_ASCII (Character) && base64_char_to_value[Character] >= 0)
3650 #define IS_BASE64_IGNORABLE(Character) \
3651 ((Character) == ' ' || (Character) == '\t' || (Character) == '\n' \
3652 || (Character) == '\f' || (Character) == '\r')
3654 /* Used by base64_decode_1 to retrieve a non-base64-ignorable
3655 character or return retval if there are no characters left to
3657 #define READ_QUADRUPLET_BYTE(retval) \
3662 if (nchars_return) \
3663 *nchars_return = nchars; \
3668 while (IS_BASE64_IGNORABLE (c))
3670 /* Don't use alloca for regions larger than this, lest we overflow
3672 #define MAX_ALLOCA 16*1024
3674 /* Table of characters coding the 64 values. */
3675 static char base64_value_to_char
[64] =
3677 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', /* 0- 9 */
3678 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', /* 10-19 */
3679 'U', 'V', 'W', 'X', 'Y', 'Z', 'a', 'b', 'c', 'd', /* 20-29 */
3680 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', /* 30-39 */
3681 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', /* 40-49 */
3682 'y', 'z', '0', '1', '2', '3', '4', '5', '6', '7', /* 50-59 */
3683 '8', '9', '+', '/' /* 60-63 */
3686 /* Table of base64 values for first 128 characters. */
3687 static short base64_char_to_value
[128] =
3689 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, /* 0- 9 */
3690 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, /* 10- 19 */
3691 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, /* 20- 29 */
3692 -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, /* 30- 39 */
3693 -1, -1, -1, 62, -1, -1, -1, 63, 52, 53, /* 40- 49 */
3694 54, 55, 56, 57, 58, 59, 60, 61, -1, -1, /* 50- 59 */
3695 -1, -1, -1, -1, -1, 0, 1, 2, 3, 4, /* 60- 69 */
3696 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, /* 70- 79 */
3697 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, /* 80- 89 */
3698 25, -1, -1, -1, -1, -1, -1, 26, 27, 28, /* 90- 99 */
3699 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, /* 100-109 */
3700 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, /* 110-119 */
3701 49, 50, 51, -1, -1, -1, -1, -1 /* 120-127 */
3704 /* The following diagram shows the logical steps by which three octets
3705 get transformed into four base64 characters.
3707 .--------. .--------. .--------.
3708 |aaaaaabb| |bbbbcccc| |ccdddddd|
3709 `--------' `--------' `--------'
3711 .--------+--------+--------+--------.
3712 |00aaaaaa|00bbbbbb|00cccccc|00dddddd|
3713 `--------+--------+--------+--------'
3715 .--------+--------+--------+--------.
3716 |AAAAAAAA|BBBBBBBB|CCCCCCCC|DDDDDDDD|
3717 `--------+--------+--------+--------'
3719 The octets are divided into 6 bit chunks, which are then encoded into
3720 base64 characters. */
3723 static int base64_encode_1
P_ ((const char *, char *, int, int, int));
3724 static int base64_decode_1
P_ ((const char *, char *, int, int, int *));
3726 DEFUN ("base64-encode-region", Fbase64_encode_region
, Sbase64_encode_region
,
3728 doc
: /* Base64-encode the region between BEG and END.
3729 Return the length of the encoded text.
3730 Optional third argument NO-LINE-BREAK means do not break long lines
3731 into shorter lines. */)
3732 (beg
, end
, no_line_break
)
3733 Lisp_Object beg
, end
, no_line_break
;
3736 int allength
, length
;
3737 int ibeg
, iend
, encoded_length
;
3740 validate_region (&beg
, &end
);
3742 ibeg
= CHAR_TO_BYTE (XFASTINT (beg
));
3743 iend
= CHAR_TO_BYTE (XFASTINT (end
));
3744 move_gap_both (XFASTINT (beg
), ibeg
);
3746 /* We need to allocate enough room for encoding the text.
3747 We need 33 1/3% more space, plus a newline every 76
3748 characters, and then we round up. */
3749 length
= iend
- ibeg
;
3750 allength
= length
+ length
/3 + 1;
3751 allength
+= allength
/ MIME_LINE_LENGTH
+ 1 + 6;
3753 if (allength
<= MAX_ALLOCA
)
3754 encoded
= (char *) alloca (allength
);
3756 encoded
= (char *) xmalloc (allength
);
3757 encoded_length
= base64_encode_1 (BYTE_POS_ADDR (ibeg
), encoded
, length
,
3758 NILP (no_line_break
),
3759 !NILP (current_buffer
->enable_multibyte_characters
));
3760 if (encoded_length
> allength
)
3763 if (encoded_length
< 0)
3765 /* The encoding wasn't possible. */
3766 if (length
> MAX_ALLOCA
)
3768 error ("Multibyte character in data for base64 encoding");
3771 /* Now we have encoded the region, so we insert the new contents
3772 and delete the old. (Insert first in order to preserve markers.) */
3773 SET_PT_BOTH (XFASTINT (beg
), ibeg
);
3774 insert (encoded
, encoded_length
);
3775 if (allength
> MAX_ALLOCA
)
3777 del_range_byte (ibeg
+ encoded_length
, iend
+ encoded_length
, 1);
3779 /* If point was outside of the region, restore it exactly; else just
3780 move to the beginning of the region. */
3781 if (old_pos
>= XFASTINT (end
))
3782 old_pos
+= encoded_length
- (XFASTINT (end
) - XFASTINT (beg
));
3783 else if (old_pos
> XFASTINT (beg
))
3784 old_pos
= XFASTINT (beg
);
3787 /* We return the length of the encoded text. */
3788 return make_number (encoded_length
);
3791 DEFUN ("base64-encode-string", Fbase64_encode_string
, Sbase64_encode_string
,
3793 doc
: /* Base64-encode STRING and return the result.
3794 Optional second argument NO-LINE-BREAK means do not break long lines
3795 into shorter lines. */)
3796 (string
, no_line_break
)
3797 Lisp_Object string
, no_line_break
;
3799 int allength
, length
, encoded_length
;
3801 Lisp_Object encoded_string
;
3803 CHECK_STRING (string
);
3805 /* We need to allocate enough room for encoding the text.
3806 We need 33 1/3% more space, plus a newline every 76
3807 characters, and then we round up. */
3808 length
= SBYTES (string
);
3809 allength
= length
+ length
/3 + 1;
3810 allength
+= allength
/ MIME_LINE_LENGTH
+ 1 + 6;
3812 /* We need to allocate enough room for decoding the text. */
3813 if (allength
<= MAX_ALLOCA
)
3814 encoded
= (char *) alloca (allength
);
3816 encoded
= (char *) xmalloc (allength
);
3818 encoded_length
= base64_encode_1 (SDATA (string
),
3819 encoded
, length
, NILP (no_line_break
),
3820 STRING_MULTIBYTE (string
));
3821 if (encoded_length
> allength
)
3824 if (encoded_length
< 0)
3826 /* The encoding wasn't possible. */
3827 if (length
> MAX_ALLOCA
)
3829 error ("Multibyte character in data for base64 encoding");
3832 encoded_string
= make_unibyte_string (encoded
, encoded_length
);
3833 if (allength
> MAX_ALLOCA
)
3836 return encoded_string
;
3840 base64_encode_1 (from
, to
, length
, line_break
, multibyte
)
3847 int counter
= 0, i
= 0;
3857 c
= STRING_CHAR_AND_LENGTH (from
+ i
, length
- i
, bytes
);
3865 /* Wrap line every 76 characters. */
3869 if (counter
< MIME_LINE_LENGTH
/ 4)
3878 /* Process first byte of a triplet. */
3880 *e
++ = base64_value_to_char
[0x3f & c
>> 2];
3881 value
= (0x03 & c
) << 4;
3883 /* Process second byte of a triplet. */
3887 *e
++ = base64_value_to_char
[value
];
3895 c
= STRING_CHAR_AND_LENGTH (from
+ i
, length
- i
, bytes
);
3903 *e
++ = base64_value_to_char
[value
| (0x0f & c
>> 4)];
3904 value
= (0x0f & c
) << 2;
3906 /* Process third byte of a triplet. */
3910 *e
++ = base64_value_to_char
[value
];
3917 c
= STRING_CHAR_AND_LENGTH (from
+ i
, length
- i
, bytes
);
3925 *e
++ = base64_value_to_char
[value
| (0x03 & c
>> 6)];
3926 *e
++ = base64_value_to_char
[0x3f & c
];
3933 DEFUN ("base64-decode-region", Fbase64_decode_region
, Sbase64_decode_region
,
3935 doc
: /* Base64-decode the region between BEG and END.
3936 Return the length of the decoded text.
3937 If the region can't be decoded, signal an error and don't modify the buffer. */)
3939 Lisp_Object beg
, end
;
3941 int ibeg
, iend
, length
, allength
;
3946 int multibyte
= !NILP (current_buffer
->enable_multibyte_characters
);
3948 validate_region (&beg
, &end
);
3950 ibeg
= CHAR_TO_BYTE (XFASTINT (beg
));
3951 iend
= CHAR_TO_BYTE (XFASTINT (end
));
3953 length
= iend
- ibeg
;
3955 /* We need to allocate enough room for decoding the text. If we are
3956 working on a multibyte buffer, each decoded code may occupy at
3958 allength
= multibyte
? length
* 2 : length
;
3959 if (allength
<= MAX_ALLOCA
)
3960 decoded
= (char *) alloca (allength
);
3962 decoded
= (char *) xmalloc (allength
);
3964 move_gap_both (XFASTINT (beg
), ibeg
);
3965 decoded_length
= base64_decode_1 (BYTE_POS_ADDR (ibeg
), decoded
, length
,
3966 multibyte
, &inserted_chars
);
3967 if (decoded_length
> allength
)
3970 if (decoded_length
< 0)
3972 /* The decoding wasn't possible. */
3973 if (allength
> MAX_ALLOCA
)
3975 error ("Invalid base64 data");
3978 /* Now we have decoded the region, so we insert the new contents
3979 and delete the old. (Insert first in order to preserve markers.) */
3980 TEMP_SET_PT_BOTH (XFASTINT (beg
), ibeg
);
3981 insert_1_both (decoded
, inserted_chars
, decoded_length
, 0, 1, 0);
3982 if (allength
> MAX_ALLOCA
)
3984 /* Delete the original text. */
3985 del_range_both (PT
, PT_BYTE
, XFASTINT (end
) + inserted_chars
,
3986 iend
+ decoded_length
, 1);
3988 /* If point was outside of the region, restore it exactly; else just
3989 move to the beginning of the region. */
3990 if (old_pos
>= XFASTINT (end
))
3991 old_pos
+= inserted_chars
- (XFASTINT (end
) - XFASTINT (beg
));
3992 else if (old_pos
> XFASTINT (beg
))
3993 old_pos
= XFASTINT (beg
);
3994 SET_PT (old_pos
> ZV
? ZV
: old_pos
);
3996 return make_number (inserted_chars
);
3999 DEFUN ("base64-decode-string", Fbase64_decode_string
, Sbase64_decode_string
,
4001 doc
: /* Base64-decode STRING and return the result. */)
4006 int length
, decoded_length
;
4007 Lisp_Object decoded_string
;
4009 CHECK_STRING (string
);
4011 length
= SBYTES (string
);
4012 /* We need to allocate enough room for decoding the text. */
4013 if (length
<= MAX_ALLOCA
)
4014 decoded
= (char *) alloca (length
);
4016 decoded
= (char *) xmalloc (length
);
4018 /* The decoded result should be unibyte. */
4019 decoded_length
= base64_decode_1 (SDATA (string
), decoded
, length
,
4021 if (decoded_length
> length
)
4023 else if (decoded_length
>= 0)
4024 decoded_string
= make_unibyte_string (decoded
, decoded_length
);
4026 decoded_string
= Qnil
;
4028 if (length
> MAX_ALLOCA
)
4030 if (!STRINGP (decoded_string
))
4031 error ("Invalid base64 data");
4033 return decoded_string
;
4036 /* Base64-decode the data at FROM of LENGHT bytes into TO. If
4037 MULTIBYTE is nonzero, the decoded result should be in multibyte
4038 form. If NCHARS_RETRUN is not NULL, store the number of produced
4039 characters in *NCHARS_RETURN. */
4042 base64_decode_1 (from
, to
, length
, multibyte
, nchars_return
)
4052 unsigned long value
;
4057 /* Process first byte of a quadruplet. */
4059 READ_QUADRUPLET_BYTE (e
-to
);
4063 value
= base64_char_to_value
[c
] << 18;
4065 /* Process second byte of a quadruplet. */
4067 READ_QUADRUPLET_BYTE (-1);
4071 value
|= base64_char_to_value
[c
] << 12;
4073 c
= (unsigned char) (value
>> 16);
4075 e
+= CHAR_STRING (c
, e
);
4080 /* Process third byte of a quadruplet. */
4082 READ_QUADRUPLET_BYTE (-1);
4086 READ_QUADRUPLET_BYTE (-1);
4095 value
|= base64_char_to_value
[c
] << 6;
4097 c
= (unsigned char) (0xff & value
>> 8);
4099 e
+= CHAR_STRING (c
, e
);
4104 /* Process fourth byte of a quadruplet. */
4106 READ_QUADRUPLET_BYTE (-1);
4113 value
|= base64_char_to_value
[c
];
4115 c
= (unsigned char) (0xff & value
);
4117 e
+= CHAR_STRING (c
, e
);
4126 /***********************************************************************
4128 ***** Hash Tables *****
4130 ***********************************************************************/
4132 /* Implemented by gerd@gnu.org. This hash table implementation was
4133 inspired by CMUCL hash tables. */
4137 1. For small tables, association lists are probably faster than
4138 hash tables because they have lower overhead.
4140 For uses of hash tables where the O(1) behavior of table
4141 operations is not a requirement, it might therefore be a good idea
4142 not to hash. Instead, we could just do a linear search in the
4143 key_and_value vector of the hash table. This could be done
4144 if a `:linear-search t' argument is given to make-hash-table. */
4147 /* The list of all weak hash tables. Don't staticpro this one. */
4149 Lisp_Object Vweak_hash_tables
;
4151 /* Various symbols. */
4153 Lisp_Object Qhash_table_p
, Qeq
, Qeql
, Qequal
, Qkey
, Qvalue
;
4154 Lisp_Object QCtest
, QCsize
, QCrehash_size
, QCrehash_threshold
, QCweakness
;
4155 Lisp_Object Qhash_table_test
, Qkey_or_value
, Qkey_and_value
;
4157 /* Function prototypes. */
4159 static struct Lisp_Hash_Table
*check_hash_table
P_ ((Lisp_Object
));
4160 static int get_key_arg
P_ ((Lisp_Object
, int, Lisp_Object
*, char *));
4161 static void maybe_resize_hash_table
P_ ((struct Lisp_Hash_Table
*));
4162 static int cmpfn_eql
P_ ((struct Lisp_Hash_Table
*, Lisp_Object
, unsigned,
4163 Lisp_Object
, unsigned));
4164 static int cmpfn_equal
P_ ((struct Lisp_Hash_Table
*, Lisp_Object
, unsigned,
4165 Lisp_Object
, unsigned));
4166 static int cmpfn_user_defined
P_ ((struct Lisp_Hash_Table
*, Lisp_Object
,
4167 unsigned, Lisp_Object
, unsigned));
4168 static unsigned hashfn_eq
P_ ((struct Lisp_Hash_Table
*, Lisp_Object
));
4169 static unsigned hashfn_eql
P_ ((struct Lisp_Hash_Table
*, Lisp_Object
));
4170 static unsigned hashfn_equal
P_ ((struct Lisp_Hash_Table
*, Lisp_Object
));
4171 static unsigned hashfn_user_defined
P_ ((struct Lisp_Hash_Table
*,
4173 static unsigned sxhash_string
P_ ((unsigned char *, int));
4174 static unsigned sxhash_list
P_ ((Lisp_Object
, int));
4175 static unsigned sxhash_vector
P_ ((Lisp_Object
, int));
4176 static unsigned sxhash_bool_vector
P_ ((Lisp_Object
));
4177 static int sweep_weak_table
P_ ((struct Lisp_Hash_Table
*, int));
4181 /***********************************************************************
4183 ***********************************************************************/
4185 /* If OBJ is a Lisp hash table, return a pointer to its struct
4186 Lisp_Hash_Table. Otherwise, signal an error. */
4188 static struct Lisp_Hash_Table
*
4189 check_hash_table (obj
)
4192 CHECK_HASH_TABLE (obj
);
4193 return XHASH_TABLE (obj
);
4197 /* Value is the next integer I >= N, N >= 0 which is "almost" a prime
4201 next_almost_prime (n
)
4214 /* Find KEY in ARGS which has size NARGS. Don't consider indices for
4215 which USED[I] is non-zero. If found at index I in ARGS, set
4216 USED[I] and USED[I + 1] to 1, and return I + 1. Otherwise return
4217 -1. This function is used to extract a keyword/argument pair from
4218 a DEFUN parameter list. */
4221 get_key_arg (key
, nargs
, args
, used
)
4229 for (i
= 0; i
< nargs
- 1; ++i
)
4230 if (!used
[i
] && EQ (args
[i
], key
))
4245 /* Return a Lisp vector which has the same contents as VEC but has
4246 size NEW_SIZE, NEW_SIZE >= VEC->size. Entries in the resulting
4247 vector that are not copied from VEC are set to INIT. */
4250 larger_vector (vec
, new_size
, init
)
4255 struct Lisp_Vector
*v
;
4258 xassert (VECTORP (vec
));
4259 old_size
= XVECTOR (vec
)->size
;
4260 xassert (new_size
>= old_size
);
4262 v
= allocate_vector (new_size
);
4263 bcopy (XVECTOR (vec
)->contents
, v
->contents
,
4264 old_size
* sizeof *v
->contents
);
4265 for (i
= old_size
; i
< new_size
; ++i
)
4266 v
->contents
[i
] = init
;
4267 XSETVECTOR (vec
, v
);
4272 /***********************************************************************
4274 ***********************************************************************/
4276 /* Compare KEY1 which has hash code HASH1 and KEY2 with hash code
4277 HASH2 in hash table H using `eql'. Value is non-zero if KEY1 and
4278 KEY2 are the same. */
4281 cmpfn_eql (h
, key1
, hash1
, key2
, hash2
)
4282 struct Lisp_Hash_Table
*h
;
4283 Lisp_Object key1
, key2
;
4284 unsigned hash1
, hash2
;
4286 return (FLOATP (key1
)
4288 && XFLOAT_DATA (key1
) == XFLOAT_DATA (key2
));
4292 /* Compare KEY1 which has hash code HASH1 and KEY2 with hash code
4293 HASH2 in hash table H using `equal'. Value is non-zero if KEY1 and
4294 KEY2 are the same. */
4297 cmpfn_equal (h
, key1
, hash1
, key2
, hash2
)
4298 struct Lisp_Hash_Table
*h
;
4299 Lisp_Object key1
, key2
;
4300 unsigned hash1
, hash2
;
4302 return hash1
== hash2
&& !NILP (Fequal (key1
, key2
));
4306 /* Compare KEY1 which has hash code HASH1, and KEY2 with hash code
4307 HASH2 in hash table H using H->user_cmp_function. Value is non-zero
4308 if KEY1 and KEY2 are the same. */
4311 cmpfn_user_defined (h
, key1
, hash1
, key2
, hash2
)
4312 struct Lisp_Hash_Table
*h
;
4313 Lisp_Object key1
, key2
;
4314 unsigned hash1
, hash2
;
4318 Lisp_Object args
[3];
4320 args
[0] = h
->user_cmp_function
;
4323 return !NILP (Ffuncall (3, args
));
4330 /* Value is a hash code for KEY for use in hash table H which uses
4331 `eq' to compare keys. The hash code returned is guaranteed to fit
4332 in a Lisp integer. */
4336 struct Lisp_Hash_Table
*h
;
4339 unsigned hash
= XUINT (key
) ^ XGCTYPE (key
);
4340 xassert ((hash
& ~INTMASK
) == 0);
4345 /* Value is a hash code for KEY for use in hash table H which uses
4346 `eql' to compare keys. The hash code returned is guaranteed to fit
4347 in a Lisp integer. */
4351 struct Lisp_Hash_Table
*h
;
4356 hash
= sxhash (key
, 0);
4358 hash
= XUINT (key
) ^ XGCTYPE (key
);
4359 xassert ((hash
& ~INTMASK
) == 0);
4364 /* Value is a hash code for KEY for use in hash table H which uses
4365 `equal' to compare keys. The hash code returned is guaranteed to fit
4366 in a Lisp integer. */
4369 hashfn_equal (h
, key
)
4370 struct Lisp_Hash_Table
*h
;
4373 unsigned hash
= sxhash (key
, 0);
4374 xassert ((hash
& ~INTMASK
) == 0);
4379 /* Value is a hash code for KEY for use in hash table H which uses as
4380 user-defined function to compare keys. The hash code returned is
4381 guaranteed to fit in a Lisp integer. */
4384 hashfn_user_defined (h
, key
)
4385 struct Lisp_Hash_Table
*h
;
4388 Lisp_Object args
[2], hash
;
4390 args
[0] = h
->user_hash_function
;
4392 hash
= Ffuncall (2, args
);
4393 if (!INTEGERP (hash
))
4395 list2 (build_string ("Invalid hash code returned from \
4396 user-supplied hash function"),
4398 return XUINT (hash
);
4402 /* Create and initialize a new hash table.
4404 TEST specifies the test the hash table will use to compare keys.
4405 It must be either one of the predefined tests `eq', `eql' or
4406 `equal' or a symbol denoting a user-defined test named TEST with
4407 test and hash functions USER_TEST and USER_HASH.
4409 Give the table initial capacity SIZE, SIZE >= 0, an integer.
4411 If REHASH_SIZE is an integer, it must be > 0, and this hash table's
4412 new size when it becomes full is computed by adding REHASH_SIZE to
4413 its old size. If REHASH_SIZE is a float, it must be > 1.0, and the
4414 table's new size is computed by multiplying its old size with
4417 REHASH_THRESHOLD must be a float <= 1.0, and > 0. The table will
4418 be resized when the ratio of (number of entries in the table) /
4419 (table size) is >= REHASH_THRESHOLD.
4421 WEAK specifies the weakness of the table. If non-nil, it must be
4422 one of the symbols `key', `value', `key-or-value', or `key-and-value'. */
4425 make_hash_table (test
, size
, rehash_size
, rehash_threshold
, weak
,
4426 user_test
, user_hash
)
4427 Lisp_Object test
, size
, rehash_size
, rehash_threshold
, weak
;
4428 Lisp_Object user_test
, user_hash
;
4430 struct Lisp_Hash_Table
*h
;
4432 int index_size
, i
, sz
;
4434 /* Preconditions. */
4435 xassert (SYMBOLP (test
));
4436 xassert (INTEGERP (size
) && XINT (size
) >= 0);
4437 xassert ((INTEGERP (rehash_size
) && XINT (rehash_size
) > 0)
4438 || (FLOATP (rehash_size
) && XFLOATINT (rehash_size
) > 1.0));
4439 xassert (FLOATP (rehash_threshold
)
4440 && XFLOATINT (rehash_threshold
) > 0
4441 && XFLOATINT (rehash_threshold
) <= 1.0);
4443 if (XFASTINT (size
) == 0)
4444 size
= make_number (1);
4446 /* Allocate a table and initialize it. */
4447 h
= allocate_hash_table ();
4449 /* Initialize hash table slots. */
4450 sz
= XFASTINT (size
);
4453 if (EQ (test
, Qeql
))
4455 h
->cmpfn
= cmpfn_eql
;
4456 h
->hashfn
= hashfn_eql
;
4458 else if (EQ (test
, Qeq
))
4461 h
->hashfn
= hashfn_eq
;
4463 else if (EQ (test
, Qequal
))
4465 h
->cmpfn
= cmpfn_equal
;
4466 h
->hashfn
= hashfn_equal
;
4470 h
->user_cmp_function
= user_test
;
4471 h
->user_hash_function
= user_hash
;
4472 h
->cmpfn
= cmpfn_user_defined
;
4473 h
->hashfn
= hashfn_user_defined
;
4477 h
->rehash_threshold
= rehash_threshold
;
4478 h
->rehash_size
= rehash_size
;
4479 h
->count
= make_number (0);
4480 h
->key_and_value
= Fmake_vector (make_number (2 * sz
), Qnil
);
4481 h
->hash
= Fmake_vector (size
, Qnil
);
4482 h
->next
= Fmake_vector (size
, Qnil
);
4483 /* Cast to int here avoids losing with gcc 2.95 on Tru64/Alpha... */
4484 index_size
= next_almost_prime ((int) (sz
/ XFLOATINT (rehash_threshold
)));
4485 h
->index
= Fmake_vector (make_number (index_size
), Qnil
);
4487 /* Set up the free list. */
4488 for (i
= 0; i
< sz
- 1; ++i
)
4489 HASH_NEXT (h
, i
) = make_number (i
+ 1);
4490 h
->next_free
= make_number (0);
4492 XSET_HASH_TABLE (table
, h
);
4493 xassert (HASH_TABLE_P (table
));
4494 xassert (XHASH_TABLE (table
) == h
);
4496 /* Maybe add this hash table to the list of all weak hash tables. */
4498 h
->next_weak
= Qnil
;
4501 h
->next_weak
= Vweak_hash_tables
;
4502 Vweak_hash_tables
= table
;
4509 /* Return a copy of hash table H1. Keys and values are not copied,
4510 only the table itself is. */
4513 copy_hash_table (h1
)
4514 struct Lisp_Hash_Table
*h1
;
4517 struct Lisp_Hash_Table
*h2
;
4518 struct Lisp_Vector
*next
;
4520 h2
= allocate_hash_table ();
4521 next
= h2
->vec_next
;
4522 bcopy (h1
, h2
, sizeof *h2
);
4523 h2
->vec_next
= next
;
4524 h2
->key_and_value
= Fcopy_sequence (h1
->key_and_value
);
4525 h2
->hash
= Fcopy_sequence (h1
->hash
);
4526 h2
->next
= Fcopy_sequence (h1
->next
);
4527 h2
->index
= Fcopy_sequence (h1
->index
);
4528 XSET_HASH_TABLE (table
, h2
);
4530 /* Maybe add this hash table to the list of all weak hash tables. */
4531 if (!NILP (h2
->weak
))
4533 h2
->next_weak
= Vweak_hash_tables
;
4534 Vweak_hash_tables
= table
;
4541 /* Resize hash table H if it's too full. If H cannot be resized
4542 because it's already too large, throw an error. */
4545 maybe_resize_hash_table (h
)
4546 struct Lisp_Hash_Table
*h
;
4548 if (NILP (h
->next_free
))
4550 int old_size
= HASH_TABLE_SIZE (h
);
4551 int i
, new_size
, index_size
;
4553 if (INTEGERP (h
->rehash_size
))
4554 new_size
= old_size
+ XFASTINT (h
->rehash_size
);
4556 new_size
= old_size
* XFLOATINT (h
->rehash_size
);
4557 new_size
= max (old_size
+ 1, new_size
);
4558 index_size
= next_almost_prime ((int)
4560 / XFLOATINT (h
->rehash_threshold
)));
4561 if (max (index_size
, 2 * new_size
) > MOST_POSITIVE_FIXNUM
)
4562 error ("Hash table too large to resize");
4564 h
->key_and_value
= larger_vector (h
->key_and_value
, 2 * new_size
, Qnil
);
4565 h
->next
= larger_vector (h
->next
, new_size
, Qnil
);
4566 h
->hash
= larger_vector (h
->hash
, new_size
, Qnil
);
4567 h
->index
= Fmake_vector (make_number (index_size
), Qnil
);
4569 /* Update the free list. Do it so that new entries are added at
4570 the end of the free list. This makes some operations like
4572 for (i
= old_size
; i
< new_size
- 1; ++i
)
4573 HASH_NEXT (h
, i
) = make_number (i
+ 1);
4575 if (!NILP (h
->next_free
))
4577 Lisp_Object last
, next
;
4579 last
= h
->next_free
;
4580 while (next
= HASH_NEXT (h
, XFASTINT (last
)),
4584 HASH_NEXT (h
, XFASTINT (last
)) = make_number (old_size
);
4587 XSETFASTINT (h
->next_free
, old_size
);
4590 for (i
= 0; i
< old_size
; ++i
)
4591 if (!NILP (HASH_HASH (h
, i
)))
4593 unsigned hash_code
= XUINT (HASH_HASH (h
, i
));
4594 int start_of_bucket
= hash_code
% XVECTOR (h
->index
)->size
;
4595 HASH_NEXT (h
, i
) = HASH_INDEX (h
, start_of_bucket
);
4596 HASH_INDEX (h
, start_of_bucket
) = make_number (i
);
4602 /* Lookup KEY in hash table H. If HASH is non-null, return in *HASH
4603 the hash code of KEY. Value is the index of the entry in H
4604 matching KEY, or -1 if not found. */
4607 hash_lookup (h
, key
, hash
)
4608 struct Lisp_Hash_Table
*h
;
4613 int start_of_bucket
;
4616 hash_code
= h
->hashfn (h
, key
);
4620 start_of_bucket
= hash_code
% XVECTOR (h
->index
)->size
;
4621 idx
= HASH_INDEX (h
, start_of_bucket
);
4623 /* We need not gcpro idx since it's either an integer or nil. */
4626 int i
= XFASTINT (idx
);
4627 if (EQ (key
, HASH_KEY (h
, i
))
4629 && h
->cmpfn (h
, key
, hash_code
,
4630 HASH_KEY (h
, i
), XUINT (HASH_HASH (h
, i
)))))
4632 idx
= HASH_NEXT (h
, i
);
4635 return NILP (idx
) ? -1 : XFASTINT (idx
);
4639 /* Put an entry into hash table H that associates KEY with VALUE.
4640 HASH is a previously computed hash code of KEY.
4641 Value is the index of the entry in H matching KEY. */
4644 hash_put (h
, key
, value
, hash
)
4645 struct Lisp_Hash_Table
*h
;
4646 Lisp_Object key
, value
;
4649 int start_of_bucket
, i
;
4651 xassert ((hash
& ~INTMASK
) == 0);
4653 /* Increment count after resizing because resizing may fail. */
4654 maybe_resize_hash_table (h
);
4655 h
->count
= make_number (XFASTINT (h
->count
) + 1);
4657 /* Store key/value in the key_and_value vector. */
4658 i
= XFASTINT (h
->next_free
);
4659 h
->next_free
= HASH_NEXT (h
, i
);
4660 HASH_KEY (h
, i
) = key
;
4661 HASH_VALUE (h
, i
) = value
;
4663 /* Remember its hash code. */
4664 HASH_HASH (h
, i
) = make_number (hash
);
4666 /* Add new entry to its collision chain. */
4667 start_of_bucket
= hash
% XVECTOR (h
->index
)->size
;
4668 HASH_NEXT (h
, i
) = HASH_INDEX (h
, start_of_bucket
);
4669 HASH_INDEX (h
, start_of_bucket
) = make_number (i
);
4674 /* Remove the entry matching KEY from hash table H, if there is one. */
4677 hash_remove (h
, key
)
4678 struct Lisp_Hash_Table
*h
;
4682 int start_of_bucket
;
4683 Lisp_Object idx
, prev
;
4685 hash_code
= h
->hashfn (h
, key
);
4686 start_of_bucket
= hash_code
% XVECTOR (h
->index
)->size
;
4687 idx
= HASH_INDEX (h
, start_of_bucket
);
4690 /* We need not gcpro idx, prev since they're either integers or nil. */
4693 int i
= XFASTINT (idx
);
4695 if (EQ (key
, HASH_KEY (h
, i
))
4697 && h
->cmpfn (h
, key
, hash_code
,
4698 HASH_KEY (h
, i
), XUINT (HASH_HASH (h
, i
)))))
4700 /* Take entry out of collision chain. */
4702 HASH_INDEX (h
, start_of_bucket
) = HASH_NEXT (h
, i
);
4704 HASH_NEXT (h
, XFASTINT (prev
)) = HASH_NEXT (h
, i
);
4706 /* Clear slots in key_and_value and add the slots to
4708 HASH_KEY (h
, i
) = HASH_VALUE (h
, i
) = HASH_HASH (h
, i
) = Qnil
;
4709 HASH_NEXT (h
, i
) = h
->next_free
;
4710 h
->next_free
= make_number (i
);
4711 h
->count
= make_number (XFASTINT (h
->count
) - 1);
4712 xassert (XINT (h
->count
) >= 0);
4718 idx
= HASH_NEXT (h
, i
);
4724 /* Clear hash table H. */
4728 struct Lisp_Hash_Table
*h
;
4730 if (XFASTINT (h
->count
) > 0)
4732 int i
, size
= HASH_TABLE_SIZE (h
);
4734 for (i
= 0; i
< size
; ++i
)
4736 HASH_NEXT (h
, i
) = i
< size
- 1 ? make_number (i
+ 1) : Qnil
;
4737 HASH_KEY (h
, i
) = Qnil
;
4738 HASH_VALUE (h
, i
) = Qnil
;
4739 HASH_HASH (h
, i
) = Qnil
;
4742 for (i
= 0; i
< XVECTOR (h
->index
)->size
; ++i
)
4743 XVECTOR (h
->index
)->contents
[i
] = Qnil
;
4745 h
->next_free
= make_number (0);
4746 h
->count
= make_number (0);
4752 /************************************************************************
4754 ************************************************************************/
4756 /* Sweep weak hash table H. REMOVE_ENTRIES_P non-zero means remove
4757 entries from the table that don't survive the current GC.
4758 REMOVE_ENTRIES_P zero means mark entries that are in use. Value is
4759 non-zero if anything was marked. */
4762 sweep_weak_table (h
, remove_entries_p
)
4763 struct Lisp_Hash_Table
*h
;
4764 int remove_entries_p
;
4766 int bucket
, n
, marked
;
4768 n
= XVECTOR (h
->index
)->size
& ~ARRAY_MARK_FLAG
;
4771 for (bucket
= 0; bucket
< n
; ++bucket
)
4773 Lisp_Object idx
, next
, prev
;
4775 /* Follow collision chain, removing entries that
4776 don't survive this garbage collection. */
4778 for (idx
= HASH_INDEX (h
, bucket
); !GC_NILP (idx
); idx
= next
)
4780 int i
= XFASTINT (idx
);
4781 int key_known_to_survive_p
= survives_gc_p (HASH_KEY (h
, i
));
4782 int value_known_to_survive_p
= survives_gc_p (HASH_VALUE (h
, i
));
4785 if (EQ (h
->weak
, Qkey
))
4786 remove_p
= !key_known_to_survive_p
;
4787 else if (EQ (h
->weak
, Qvalue
))
4788 remove_p
= !value_known_to_survive_p
;
4789 else if (EQ (h
->weak
, Qkey_or_value
))
4790 remove_p
= !(key_known_to_survive_p
|| value_known_to_survive_p
);
4791 else if (EQ (h
->weak
, Qkey_and_value
))
4792 remove_p
= !(key_known_to_survive_p
&& value_known_to_survive_p
);
4796 next
= HASH_NEXT (h
, i
);
4798 if (remove_entries_p
)
4802 /* Take out of collision chain. */
4804 HASH_INDEX (h
, bucket
) = next
;
4806 HASH_NEXT (h
, XFASTINT (prev
)) = next
;
4808 /* Add to free list. */
4809 HASH_NEXT (h
, i
) = h
->next_free
;
4812 /* Clear key, value, and hash. */
4813 HASH_KEY (h
, i
) = HASH_VALUE (h
, i
) = Qnil
;
4814 HASH_HASH (h
, i
) = Qnil
;
4816 h
->count
= make_number (XFASTINT (h
->count
) - 1);
4823 /* Make sure key and value survive. */
4824 if (!key_known_to_survive_p
)
4826 mark_object (HASH_KEY (h
, i
));
4830 if (!value_known_to_survive_p
)
4832 mark_object (HASH_VALUE (h
, i
));
4843 /* Remove elements from weak hash tables that don't survive the
4844 current garbage collection. Remove weak tables that don't survive
4845 from Vweak_hash_tables. Called from gc_sweep. */
4848 sweep_weak_hash_tables ()
4850 Lisp_Object table
, used
, next
;
4851 struct Lisp_Hash_Table
*h
;
4854 /* Mark all keys and values that are in use. Keep on marking until
4855 there is no more change. This is necessary for cases like
4856 value-weak table A containing an entry X -> Y, where Y is used in a
4857 key-weak table B, Z -> Y. If B comes after A in the list of weak
4858 tables, X -> Y might be removed from A, although when looking at B
4859 one finds that it shouldn't. */
4863 for (table
= Vweak_hash_tables
; !GC_NILP (table
); table
= h
->next_weak
)
4865 h
= XHASH_TABLE (table
);
4866 if (h
->size
& ARRAY_MARK_FLAG
)
4867 marked
|= sweep_weak_table (h
, 0);
4872 /* Remove tables and entries that aren't used. */
4873 for (table
= Vweak_hash_tables
, used
= Qnil
; !GC_NILP (table
); table
= next
)
4875 h
= XHASH_TABLE (table
);
4876 next
= h
->next_weak
;
4878 if (h
->size
& ARRAY_MARK_FLAG
)
4880 /* TABLE is marked as used. Sweep its contents. */
4881 if (XFASTINT (h
->count
) > 0)
4882 sweep_weak_table (h
, 1);
4884 /* Add table to the list of used weak hash tables. */
4885 h
->next_weak
= used
;
4890 Vweak_hash_tables
= used
;
4895 /***********************************************************************
4896 Hash Code Computation
4897 ***********************************************************************/
4899 /* Maximum depth up to which to dive into Lisp structures. */
4901 #define SXHASH_MAX_DEPTH 3
4903 /* Maximum length up to which to take list and vector elements into
4906 #define SXHASH_MAX_LEN 7
4908 /* Combine two integers X and Y for hashing. */
4910 #define SXHASH_COMBINE(X, Y) \
4911 ((((unsigned)(X) << 4) + (((unsigned)(X) >> 24) & 0x0fffffff)) \
4915 /* Return a hash for string PTR which has length LEN. The hash
4916 code returned is guaranteed to fit in a Lisp integer. */
4919 sxhash_string (ptr
, len
)
4923 unsigned char *p
= ptr
;
4924 unsigned char *end
= p
+ len
;
4933 hash
= ((hash
<< 3) + (hash
>> 28) + c
);
4936 return hash
& INTMASK
;
4940 /* Return a hash for list LIST. DEPTH is the current depth in the
4941 list. We don't recurse deeper than SXHASH_MAX_DEPTH in it. */
4944 sxhash_list (list
, depth
)
4951 if (depth
< SXHASH_MAX_DEPTH
)
4953 CONSP (list
) && i
< SXHASH_MAX_LEN
;
4954 list
= XCDR (list
), ++i
)
4956 unsigned hash2
= sxhash (XCAR (list
), depth
+ 1);
4957 hash
= SXHASH_COMBINE (hash
, hash2
);
4964 /* Return a hash for vector VECTOR. DEPTH is the current depth in
4965 the Lisp structure. */
4968 sxhash_vector (vec
, depth
)
4972 unsigned hash
= XVECTOR (vec
)->size
;
4975 n
= min (SXHASH_MAX_LEN
, XVECTOR (vec
)->size
);
4976 for (i
= 0; i
< n
; ++i
)
4978 unsigned hash2
= sxhash (XVECTOR (vec
)->contents
[i
], depth
+ 1);
4979 hash
= SXHASH_COMBINE (hash
, hash2
);
4986 /* Return a hash for bool-vector VECTOR. */
4989 sxhash_bool_vector (vec
)
4992 unsigned hash
= XBOOL_VECTOR (vec
)->size
;
4995 n
= min (SXHASH_MAX_LEN
, XBOOL_VECTOR (vec
)->vector_size
);
4996 for (i
= 0; i
< n
; ++i
)
4997 hash
= SXHASH_COMBINE (hash
, XBOOL_VECTOR (vec
)->data
[i
]);
5003 /* Return a hash code for OBJ. DEPTH is the current depth in the Lisp
5004 structure. Value is an unsigned integer clipped to INTMASK. */
5013 if (depth
> SXHASH_MAX_DEPTH
)
5016 switch (XTYPE (obj
))
5023 hash
= sxhash_string (SDATA (SYMBOL_NAME (obj
)),
5024 SCHARS (SYMBOL_NAME (obj
)));
5032 hash
= sxhash_string (SDATA (obj
), SCHARS (obj
));
5035 /* This can be everything from a vector to an overlay. */
5036 case Lisp_Vectorlike
:
5038 /* According to the CL HyperSpec, two arrays are equal only if
5039 they are `eq', except for strings and bit-vectors. In
5040 Emacs, this works differently. We have to compare element
5042 hash
= sxhash_vector (obj
, depth
);
5043 else if (BOOL_VECTOR_P (obj
))
5044 hash
= sxhash_bool_vector (obj
);
5046 /* Others are `equal' if they are `eq', so let's take their
5052 hash
= sxhash_list (obj
, depth
);
5057 unsigned char *p
= (unsigned char *) &XFLOAT_DATA (obj
);
5058 unsigned char *e
= p
+ sizeof XFLOAT_DATA (obj
);
5059 for (hash
= 0; p
< e
; ++p
)
5060 hash
= SXHASH_COMBINE (hash
, *p
);
5068 return hash
& INTMASK
;
5073 /***********************************************************************
5075 ***********************************************************************/
5078 DEFUN ("sxhash", Fsxhash
, Ssxhash
, 1, 1, 0,
5079 doc
: /* Compute a hash code for OBJ and return it as integer. */)
5083 unsigned hash
= sxhash (obj
, 0);;
5084 return make_number (hash
);
5088 DEFUN ("make-hash-table", Fmake_hash_table
, Smake_hash_table
, 0, MANY
, 0,
5089 doc
: /* Create and return a new hash table.
5091 Arguments are specified as keyword/argument pairs. The following
5092 arguments are defined:
5094 :test TEST -- TEST must be a symbol that specifies how to compare
5095 keys. Default is `eql'. Predefined are the tests `eq', `eql', and
5096 `equal'. User-supplied test and hash functions can be specified via
5097 `define-hash-table-test'.
5099 :size SIZE -- A hint as to how many elements will be put in the table.
5102 :rehash-size REHASH-SIZE - Indicates how to expand the table when it
5103 fills up. If REHASH-SIZE is an integer, add that many space. If it
5104 is a float, it must be > 1.0, and the new size is computed by
5105 multiplying the old size with that factor. Default is 1.5.
5107 :rehash-threshold THRESHOLD -- THRESHOLD must a float > 0, and <= 1.0.
5108 Resize the hash table when ratio of the number of entries in the
5109 table. Default is 0.8.
5111 :weakness WEAK -- WEAK must be one of nil, t, `key', `value',
5112 `key-or-value', or `key-and-value'. If WEAK is not nil, the table
5113 returned is a weak table. Key/value pairs are removed from a weak
5114 hash table when there are no non-weak references pointing to their
5115 key, value, one of key or value, or both key and value, depending on
5116 WEAK. WEAK t is equivalent to `key-and-value'. Default value of WEAK
5119 usage: (make-hash-table &rest KEYWORD-ARGS) */)
5124 Lisp_Object test
, size
, rehash_size
, rehash_threshold
, weak
;
5125 Lisp_Object user_test
, user_hash
;
5129 /* The vector `used' is used to keep track of arguments that
5130 have been consumed. */
5131 used
= (char *) alloca (nargs
* sizeof *used
);
5132 bzero (used
, nargs
* sizeof *used
);
5134 /* See if there's a `:test TEST' among the arguments. */
5135 i
= get_key_arg (QCtest
, nargs
, args
, used
);
5136 test
= i
< 0 ? Qeql
: args
[i
];
5137 if (!EQ (test
, Qeq
) && !EQ (test
, Qeql
) && !EQ (test
, Qequal
))
5139 /* See if it is a user-defined test. */
5142 prop
= Fget (test
, Qhash_table_test
);
5143 if (!CONSP (prop
) || !CONSP (XCDR (prop
)))
5144 Fsignal (Qerror
, list2 (build_string ("Invalid hash table test"),
5146 user_test
= XCAR (prop
);
5147 user_hash
= XCAR (XCDR (prop
));
5150 user_test
= user_hash
= Qnil
;
5152 /* See if there's a `:size SIZE' argument. */
5153 i
= get_key_arg (QCsize
, nargs
, args
, used
);
5154 size
= i
< 0 ? Qnil
: args
[i
];
5156 size
= make_number (DEFAULT_HASH_SIZE
);
5157 else if (!INTEGERP (size
) || XINT (size
) < 0)
5159 list2 (build_string ("Invalid hash table size"),
5162 /* Look for `:rehash-size SIZE'. */
5163 i
= get_key_arg (QCrehash_size
, nargs
, args
, used
);
5164 rehash_size
= i
< 0 ? make_float (DEFAULT_REHASH_SIZE
) : args
[i
];
5165 if (!NUMBERP (rehash_size
)
5166 || (INTEGERP (rehash_size
) && XINT (rehash_size
) <= 0)
5167 || XFLOATINT (rehash_size
) <= 1.0)
5169 list2 (build_string ("Invalid hash table rehash size"),
5172 /* Look for `:rehash-threshold THRESHOLD'. */
5173 i
= get_key_arg (QCrehash_threshold
, nargs
, args
, used
);
5174 rehash_threshold
= i
< 0 ? make_float (DEFAULT_REHASH_THRESHOLD
) : args
[i
];
5175 if (!FLOATP (rehash_threshold
)
5176 || XFLOATINT (rehash_threshold
) <= 0.0
5177 || XFLOATINT (rehash_threshold
) > 1.0)
5179 list2 (build_string ("Invalid hash table rehash threshold"),
5182 /* Look for `:weakness WEAK'. */
5183 i
= get_key_arg (QCweakness
, nargs
, args
, used
);
5184 weak
= i
< 0 ? Qnil
: args
[i
];
5186 weak
= Qkey_and_value
;
5189 && !EQ (weak
, Qvalue
)
5190 && !EQ (weak
, Qkey_or_value
)
5191 && !EQ (weak
, Qkey_and_value
))
5192 Fsignal (Qerror
, list2 (build_string ("Invalid hash table weakness"),
5195 /* Now, all args should have been used up, or there's a problem. */
5196 for (i
= 0; i
< nargs
; ++i
)
5199 list2 (build_string ("Invalid argument list"), args
[i
]));
5201 return make_hash_table (test
, size
, rehash_size
, rehash_threshold
, weak
,
5202 user_test
, user_hash
);
5206 DEFUN ("copy-hash-table", Fcopy_hash_table
, Scopy_hash_table
, 1, 1, 0,
5207 doc
: /* Return a copy of hash table TABLE. */)
5211 return copy_hash_table (check_hash_table (table
));
5215 DEFUN ("hash-table-count", Fhash_table_count
, Shash_table_count
, 1, 1, 0,
5216 doc
: /* Return the number of elements in TABLE. */)
5220 return check_hash_table (table
)->count
;
5224 DEFUN ("hash-table-rehash-size", Fhash_table_rehash_size
,
5225 Shash_table_rehash_size
, 1, 1, 0,
5226 doc
: /* Return the current rehash size of TABLE. */)
5230 return check_hash_table (table
)->rehash_size
;
5234 DEFUN ("hash-table-rehash-threshold", Fhash_table_rehash_threshold
,
5235 Shash_table_rehash_threshold
, 1, 1, 0,
5236 doc
: /* Return the current rehash threshold of TABLE. */)
5240 return check_hash_table (table
)->rehash_threshold
;
5244 DEFUN ("hash-table-size", Fhash_table_size
, Shash_table_size
, 1, 1, 0,
5245 doc
: /* Return the size of TABLE.
5246 The size can be used as an argument to `make-hash-table' to create
5247 a hash table than can hold as many elements of TABLE holds
5248 without need for resizing. */)
5252 struct Lisp_Hash_Table
*h
= check_hash_table (table
);
5253 return make_number (HASH_TABLE_SIZE (h
));
5257 DEFUN ("hash-table-test", Fhash_table_test
, Shash_table_test
, 1, 1, 0,
5258 doc
: /* Return the test TABLE uses. */)
5262 return check_hash_table (table
)->test
;
5266 DEFUN ("hash-table-weakness", Fhash_table_weakness
, Shash_table_weakness
,
5268 doc
: /* Return the weakness of TABLE. */)
5272 return check_hash_table (table
)->weak
;
5276 DEFUN ("hash-table-p", Fhash_table_p
, Shash_table_p
, 1, 1, 0,
5277 doc
: /* Return t if OBJ is a Lisp hash table object. */)
5281 return HASH_TABLE_P (obj
) ? Qt
: Qnil
;
5285 DEFUN ("clrhash", Fclrhash
, Sclrhash
, 1, 1, 0,
5286 doc
: /* Clear hash table TABLE. */)
5290 hash_clear (check_hash_table (table
));
5295 DEFUN ("gethash", Fgethash
, Sgethash
, 2, 3, 0,
5296 doc
: /* Look up KEY in TABLE and return its associated value.
5297 If KEY is not found, return DFLT which defaults to nil. */)
5299 Lisp_Object key
, table
, dflt
;
5301 struct Lisp_Hash_Table
*h
= check_hash_table (table
);
5302 int i
= hash_lookup (h
, key
, NULL
);
5303 return i
>= 0 ? HASH_VALUE (h
, i
) : dflt
;
5307 DEFUN ("puthash", Fputhash
, Sputhash
, 3, 3, 0,
5308 doc
: /* Associate KEY with VALUE in hash table TABLE.
5309 If KEY is already present in table, replace its current value with
5312 Lisp_Object key
, value
, table
;
5314 struct Lisp_Hash_Table
*h
= check_hash_table (table
);
5318 i
= hash_lookup (h
, key
, &hash
);
5320 HASH_VALUE (h
, i
) = value
;
5322 hash_put (h
, key
, value
, hash
);
5328 DEFUN ("remhash", Fremhash
, Sremhash
, 2, 2, 0,
5329 doc
: /* Remove KEY from TABLE. */)
5331 Lisp_Object key
, table
;
5333 struct Lisp_Hash_Table
*h
= check_hash_table (table
);
5334 hash_remove (h
, key
);
5339 DEFUN ("maphash", Fmaphash
, Smaphash
, 2, 2, 0,
5340 doc
: /* Call FUNCTION for all entries in hash table TABLE.
5341 FUNCTION is called with 2 arguments KEY and VALUE. */)
5343 Lisp_Object function
, table
;
5345 struct Lisp_Hash_Table
*h
= check_hash_table (table
);
5346 Lisp_Object args
[3];
5349 for (i
= 0; i
< HASH_TABLE_SIZE (h
); ++i
)
5350 if (!NILP (HASH_HASH (h
, i
)))
5353 args
[1] = HASH_KEY (h
, i
);
5354 args
[2] = HASH_VALUE (h
, i
);
5362 DEFUN ("define-hash-table-test", Fdefine_hash_table_test
,
5363 Sdefine_hash_table_test
, 3, 3, 0,
5364 doc
: /* Define a new hash table test with name NAME, a symbol.
5366 In hash tables created with NAME specified as test, use TEST to
5367 compare keys, and HASH for computing hash codes of keys.
5369 TEST must be a function taking two arguments and returning non-nil if
5370 both arguments are the same. HASH must be a function taking one
5371 argument and return an integer that is the hash code of the argument.
5372 Hash code computation should use the whole value range of integers,
5373 including negative integers. */)
5375 Lisp_Object name
, test
, hash
;
5377 return Fput (name
, Qhash_table_test
, list2 (test
, hash
));
5382 /************************************************************************
5384 ************************************************************************/
5389 DEFUN ("md5", Fmd5
, Smd5
, 1, 5, 0,
5390 doc
: /* Return MD5 message digest of OBJECT, a buffer or string.
5392 A message digest is a cryptographic checksum of a document, and the
5393 algorithm to calculate it is defined in RFC 1321.
5395 The two optional arguments START and END are character positions
5396 specifying for which part of OBJECT the message digest should be
5397 computed. If nil or omitted, the digest is computed for the whole
5400 The MD5 message digest is computed from the result of encoding the
5401 text in a coding system, not directly from the internal Emacs form of
5402 the text. The optional fourth argument CODING-SYSTEM specifies which
5403 coding system to encode the text with. It should be the same coding
5404 system that you used or will use when actually writing the text into a
5407 If CODING-SYSTEM is nil or omitted, the default depends on OBJECT. If
5408 OBJECT is a buffer, the default for CODING-SYSTEM is whatever coding
5409 system would be chosen by default for writing this text into a file.
5411 If OBJECT is a string, the most preferred coding system (see the
5412 command `prefer-coding-system') is used.
5414 If NOERROR is non-nil, silently assume the `raw-text' coding if the
5415 guesswork fails. Normally, an error is signaled in such case. */)
5416 (object
, start
, end
, coding_system
, noerror
)
5417 Lisp_Object object
, start
, end
, coding_system
, noerror
;
5419 unsigned char digest
[16];
5420 unsigned char value
[33];
5424 int start_char
= 0, end_char
= 0;
5425 int start_byte
= 0, end_byte
= 0;
5427 register struct buffer
*bp
;
5430 if (STRINGP (object
))
5432 if (NILP (coding_system
))
5434 /* Decide the coding-system to encode the data with. */
5436 if (STRING_MULTIBYTE (object
))
5437 /* use default, we can't guess correct value */
5438 coding_system
= SYMBOL_VALUE (XCAR (Vcoding_category_list
));
5440 coding_system
= Qraw_text
;
5443 if (NILP (Fcoding_system_p (coding_system
)))
5445 /* Invalid coding system. */
5447 if (!NILP (noerror
))
5448 coding_system
= Qraw_text
;
5451 Fsignal (Qcoding_system_error
, Fcons (coding_system
, Qnil
));
5454 if (STRING_MULTIBYTE (object
))
5455 object
= code_convert_string1 (object
, coding_system
, Qnil
, 1);
5457 size
= SCHARS (object
);
5458 size_byte
= SBYTES (object
);
5462 CHECK_NUMBER (start
);
5464 start_char
= XINT (start
);
5469 start_byte
= string_char_to_byte (object
, start_char
);
5475 end_byte
= size_byte
;
5481 end_char
= XINT (end
);
5486 end_byte
= string_char_to_byte (object
, end_char
);
5489 if (!(0 <= start_char
&& start_char
<= end_char
&& end_char
<= size
))
5490 args_out_of_range_3 (object
, make_number (start_char
),
5491 make_number (end_char
));
5495 struct buffer
*prev
= current_buffer
;
5497 record_unwind_protect (Fset_buffer
, Fcurrent_buffer ());
5499 CHECK_BUFFER (object
);
5501 bp
= XBUFFER (object
);
5502 if (bp
!= current_buffer
)
5503 set_buffer_internal (bp
);
5509 CHECK_NUMBER_COERCE_MARKER (start
);
5517 CHECK_NUMBER_COERCE_MARKER (end
);
5522 temp
= b
, b
= e
, e
= temp
;
5524 if (!(BEGV
<= b
&& e
<= ZV
))
5525 args_out_of_range (start
, end
);
5527 if (NILP (coding_system
))
5529 /* Decide the coding-system to encode the data with.
5530 See fileio.c:Fwrite-region */
5532 if (!NILP (Vcoding_system_for_write
))
5533 coding_system
= Vcoding_system_for_write
;
5536 int force_raw_text
= 0;
5538 coding_system
= XBUFFER (object
)->buffer_file_coding_system
;
5539 if (NILP (coding_system
)
5540 || NILP (Flocal_variable_p (Qbuffer_file_coding_system
, Qnil
)))
5542 coding_system
= Qnil
;
5543 if (NILP (current_buffer
->enable_multibyte_characters
))
5547 if (NILP (coding_system
) && !NILP (Fbuffer_file_name(object
)))
5549 /* Check file-coding-system-alist. */
5550 Lisp_Object args
[4], val
;
5552 args
[0] = Qwrite_region
; args
[1] = start
; args
[2] = end
;
5553 args
[3] = Fbuffer_file_name(object
);
5554 val
= Ffind_operation_coding_system (4, args
);
5555 if (CONSP (val
) && !NILP (XCDR (val
)))
5556 coding_system
= XCDR (val
);
5559 if (NILP (coding_system
)
5560 && !NILP (XBUFFER (object
)->buffer_file_coding_system
))
5562 /* If we still have not decided a coding system, use the
5563 default value of buffer-file-coding-system. */
5564 coding_system
= XBUFFER (object
)->buffer_file_coding_system
;
5568 && !NILP (Ffboundp (Vselect_safe_coding_system_function
)))
5569 /* Confirm that VAL can surely encode the current region. */
5570 coding_system
= call4 (Vselect_safe_coding_system_function
,
5571 make_number (b
), make_number (e
),
5572 coding_system
, Qnil
);
5575 coding_system
= Qraw_text
;
5578 if (NILP (Fcoding_system_p (coding_system
)))
5580 /* Invalid coding system. */
5582 if (!NILP (noerror
))
5583 coding_system
= Qraw_text
;
5586 Fsignal (Qcoding_system_error
, Fcons (coding_system
, Qnil
));
5590 object
= make_buffer_string (b
, e
, 0);
5591 if (prev
!= current_buffer
)
5592 set_buffer_internal (prev
);
5593 /* Discard the unwind protect for recovering the current
5597 if (STRING_MULTIBYTE (object
))
5598 object
= code_convert_string1 (object
, coding_system
, Qnil
, 1);
5601 md5_buffer (SDATA (object
) + start_byte
,
5602 SBYTES (object
) - (size_byte
- end_byte
),
5605 for (i
= 0; i
< 16; i
++)
5606 sprintf (&value
[2 * i
], "%02x", digest
[i
]);
5609 return make_string (value
, 32);
5616 /* Hash table stuff. */
5617 Qhash_table_p
= intern ("hash-table-p");
5618 staticpro (&Qhash_table_p
);
5619 Qeq
= intern ("eq");
5621 Qeql
= intern ("eql");
5623 Qequal
= intern ("equal");
5624 staticpro (&Qequal
);
5625 QCtest
= intern (":test");
5626 staticpro (&QCtest
);
5627 QCsize
= intern (":size");
5628 staticpro (&QCsize
);
5629 QCrehash_size
= intern (":rehash-size");
5630 staticpro (&QCrehash_size
);
5631 QCrehash_threshold
= intern (":rehash-threshold");
5632 staticpro (&QCrehash_threshold
);
5633 QCweakness
= intern (":weakness");
5634 staticpro (&QCweakness
);
5635 Qkey
= intern ("key");
5637 Qvalue
= intern ("value");
5638 staticpro (&Qvalue
);
5639 Qhash_table_test
= intern ("hash-table-test");
5640 staticpro (&Qhash_table_test
);
5641 Qkey_or_value
= intern ("key-or-value");
5642 staticpro (&Qkey_or_value
);
5643 Qkey_and_value
= intern ("key-and-value");
5644 staticpro (&Qkey_and_value
);
5647 defsubr (&Smake_hash_table
);
5648 defsubr (&Scopy_hash_table
);
5649 defsubr (&Shash_table_count
);
5650 defsubr (&Shash_table_rehash_size
);
5651 defsubr (&Shash_table_rehash_threshold
);
5652 defsubr (&Shash_table_size
);
5653 defsubr (&Shash_table_test
);
5654 defsubr (&Shash_table_weakness
);
5655 defsubr (&Shash_table_p
);
5656 defsubr (&Sclrhash
);
5657 defsubr (&Sgethash
);
5658 defsubr (&Sputhash
);
5659 defsubr (&Sremhash
);
5660 defsubr (&Smaphash
);
5661 defsubr (&Sdefine_hash_table_test
);
5663 Qstring_lessp
= intern ("string-lessp");
5664 staticpro (&Qstring_lessp
);
5665 Qprovide
= intern ("provide");
5666 staticpro (&Qprovide
);
5667 Qrequire
= intern ("require");
5668 staticpro (&Qrequire
);
5669 Qyes_or_no_p_history
= intern ("yes-or-no-p-history");
5670 staticpro (&Qyes_or_no_p_history
);
5671 Qcursor_in_echo_area
= intern ("cursor-in-echo-area");
5672 staticpro (&Qcursor_in_echo_area
);
5673 Qwidget_type
= intern ("widget-type");
5674 staticpro (&Qwidget_type
);
5676 staticpro (&string_char_byte_cache_string
);
5677 string_char_byte_cache_string
= Qnil
;
5679 require_nesting_list
= Qnil
;
5680 staticpro (&require_nesting_list
);
5682 Fset (Qyes_or_no_p_history
, Qnil
);
5684 DEFVAR_LISP ("features", &Vfeatures
,
5685 doc
: /* A list of symbols which are the features of the executing emacs.
5686 Used by `featurep' and `require', and altered by `provide'. */);
5688 Qsubfeatures
= intern ("subfeatures");
5689 staticpro (&Qsubfeatures
);
5691 #ifdef HAVE_LANGINFO_CODESET
5692 Qcodeset
= intern ("codeset");
5693 staticpro (&Qcodeset
);
5694 Qdays
= intern ("days");
5696 Qmonths
= intern ("months");
5697 staticpro (&Qmonths
);
5698 Qpaper
= intern ("paper");
5699 staticpro (&Qpaper
);
5700 #endif /* HAVE_LANGINFO_CODESET */
5702 DEFVAR_BOOL ("use-dialog-box", &use_dialog_box
,
5703 doc
: /* *Non-nil means mouse commands use dialog boxes to ask questions.
5704 This applies to `y-or-n-p' and `yes-or-no-p' questions asked by commands
5705 invoked by mouse clicks and mouse menu items. */);
5708 DEFVAR_BOOL ("use-file-dialog", &use_file_dialog
,
5709 doc
: /* *Non-nil means mouse commands use a file dialog to ask for files.
5710 This applies to commands from menus and tool bar buttons. The value of
5711 `use-dialog-box' takes precedence over this variable, so a file dialog is only
5712 used if both `use-dialog-box' and this variable are non-nil. */);
5713 use_file_dialog
= 1;
5715 defsubr (&Sidentity
);
5718 defsubr (&Ssafe_length
);
5719 defsubr (&Sstring_bytes
);
5720 defsubr (&Sstring_equal
);
5721 defsubr (&Scompare_strings
);
5722 defsubr (&Sstring_lessp
);
5725 defsubr (&Svconcat
);
5726 defsubr (&Scopy_sequence
);
5727 defsubr (&Sstring_make_multibyte
);
5728 defsubr (&Sstring_make_unibyte
);
5729 defsubr (&Sstring_as_multibyte
);
5730 defsubr (&Sstring_as_unibyte
);
5731 defsubr (&Sstring_to_multibyte
);
5732 defsubr (&Scopy_alist
);
5733 defsubr (&Ssubstring
);
5734 defsubr (&Ssubstring_no_properties
);
5746 defsubr (&Snreverse
);
5747 defsubr (&Sreverse
);
5749 defsubr (&Splist_get
);
5751 defsubr (&Splist_put
);
5753 defsubr (&Slax_plist_get
);
5754 defsubr (&Slax_plist_put
);
5757 defsubr (&Sequal_including_properties
);
5758 defsubr (&Sfillarray
);
5759 defsubr (&Sclear_string
);
5760 defsubr (&Schar_table_subtype
);
5761 defsubr (&Schar_table_parent
);
5762 defsubr (&Sset_char_table_parent
);
5763 defsubr (&Schar_table_extra_slot
);
5764 defsubr (&Sset_char_table_extra_slot
);
5765 defsubr (&Schar_table_range
);
5766 defsubr (&Sset_char_table_range
);
5767 defsubr (&Sset_char_table_default
);
5768 defsubr (&Soptimize_char_table
);
5769 defsubr (&Smap_char_table
);
5773 defsubr (&Smapconcat
);
5774 defsubr (&Sy_or_n_p
);
5775 defsubr (&Syes_or_no_p
);
5776 defsubr (&Sload_average
);
5777 defsubr (&Sfeaturep
);
5778 defsubr (&Srequire
);
5779 defsubr (&Sprovide
);
5780 defsubr (&Splist_member
);
5781 defsubr (&Swidget_put
);
5782 defsubr (&Swidget_get
);
5783 defsubr (&Swidget_apply
);
5784 defsubr (&Sbase64_encode_region
);
5785 defsubr (&Sbase64_decode_region
);
5786 defsubr (&Sbase64_encode_string
);
5787 defsubr (&Sbase64_decode_string
);
5789 defsubr (&Slocale_info
);
5796 Vweak_hash_tables
= Qnil
;
5799 /* arch-tag: 787f8219-5b74-46bd-8469-7e1cc475fa31
5800 (do not change this comment) */