*** empty log message ***
[bpt/emacs.git] / src / textprop.c
1 /* Interface code for dealing with text properties.
2 Copyright (C) 1993, 1994, 1995, 1997 Free Software Foundation, Inc.
3
4 This file is part of GNU Emacs.
5
6 GNU Emacs is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
9 any later version.
10
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs; see the file COPYING. If not, write to
18 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 Boston, MA 02111-1307, USA. */
20
21 #include <config.h>
22 #include "lisp.h"
23 #include "intervals.h"
24 #include "buffer.h"
25 #include "window.h"
26
27 #ifndef NULL
28 #define NULL (void *)0
29 #endif
30
31 /* Test for membership, allowing for t (actually any non-cons) to mean the
32 universal set. */
33
34 #define TMEM(sym, set) (CONSP (set) ? ! NILP (Fmemq (sym, set)) : ! NILP (set))
35 \f
36
37 /* NOTES: previous- and next- property change will have to skip
38 zero-length intervals if they are implemented. This could be done
39 inside next_interval and previous_interval.
40
41 set_properties needs to deal with the interval property cache.
42
43 It is assumed that for any interval plist, a property appears
44 only once on the list. Although some code i.e., remove_properties,
45 handles the more general case, the uniqueness of properties is
46 necessary for the system to remain consistent. This requirement
47 is enforced by the subrs installing properties onto the intervals. */
48
49 \f
50 /* Types of hooks. */
51 Lisp_Object Qmouse_left;
52 Lisp_Object Qmouse_entered;
53 Lisp_Object Qpoint_left;
54 Lisp_Object Qpoint_entered;
55 Lisp_Object Qcategory;
56 Lisp_Object Qlocal_map;
57 Lisp_Object Qkeymap;
58
59 /* Visual properties text (including strings) may have. */
60 Lisp_Object Qforeground, Qbackground, Qfont, Qunderline, Qstipple;
61 Lisp_Object Qinvisible, Qread_only, Qintangible, Qmouse_face;
62
63 /* Sticky properties */
64 Lisp_Object Qfront_sticky, Qrear_nonsticky;
65
66 /* If o1 is a cons whose cdr is a cons, return non-zero and set o2 to
67 the o1's cdr. Otherwise, return zero. This is handy for
68 traversing plists. */
69 #define PLIST_ELT_P(o1, o2) (CONSP (o1) && ((o2)=XCDR (o1), CONSP (o2)))
70
71 Lisp_Object Vinhibit_point_motion_hooks;
72 Lisp_Object Vdefault_text_properties;
73 Lisp_Object Vtext_property_default_nonsticky;
74
75 /* verify_interval_modification saves insertion hooks here
76 to be run later by report_interval_modification. */
77 Lisp_Object interval_insert_behind_hooks;
78 Lisp_Object interval_insert_in_front_hooks;
79 \f
80 /* Extract the interval at the position pointed to by BEGIN from
81 OBJECT, a string or buffer. Additionally, check that the positions
82 pointed to by BEGIN and END are within the bounds of OBJECT, and
83 reverse them if *BEGIN is greater than *END. The objects pointed
84 to by BEGIN and END may be integers or markers; if the latter, they
85 are coerced to integers.
86
87 When OBJECT is a string, we increment *BEGIN and *END
88 to make them origin-one.
89
90 Note that buffer points don't correspond to interval indices.
91 For example, point-max is 1 greater than the index of the last
92 character. This difference is handled in the caller, which uses
93 the validated points to determine a length, and operates on that.
94 Exceptions are Ftext_properties_at, Fnext_property_change, and
95 Fprevious_property_change which call this function with BEGIN == END.
96 Handle this case specially.
97
98 If FORCE is soft (0), it's OK to return NULL_INTERVAL. Otherwise,
99 create an interval tree for OBJECT if one doesn't exist, provided
100 the object actually contains text. In the current design, if there
101 is no text, there can be no text properties. */
102
103 #define soft 0
104 #define hard 1
105
106 INTERVAL
107 validate_interval_range (object, begin, end, force)
108 Lisp_Object object, *begin, *end;
109 int force;
110 {
111 register INTERVAL i;
112 int searchpos;
113
114 CHECK_STRING_OR_BUFFER (object, 0);
115 CHECK_NUMBER_COERCE_MARKER (*begin, 0);
116 CHECK_NUMBER_COERCE_MARKER (*end, 0);
117
118 /* If we are asked for a point, but from a subr which operates
119 on a range, then return nothing. */
120 if (EQ (*begin, *end) && begin != end)
121 return NULL_INTERVAL;
122
123 if (XINT (*begin) > XINT (*end))
124 {
125 Lisp_Object n;
126 n = *begin;
127 *begin = *end;
128 *end = n;
129 }
130
131 if (BUFFERP (object))
132 {
133 register struct buffer *b = XBUFFER (object);
134
135 if (!(BUF_BEGV (b) <= XINT (*begin) && XINT (*begin) <= XINT (*end)
136 && XINT (*end) <= BUF_ZV (b)))
137 args_out_of_range (*begin, *end);
138 i = BUF_INTERVALS (b);
139
140 /* If there's no text, there are no properties. */
141 if (BUF_BEGV (b) == BUF_ZV (b))
142 return NULL_INTERVAL;
143
144 searchpos = XINT (*begin);
145 }
146 else
147 {
148 register struct Lisp_String *s = XSTRING (object);
149
150 if (! (0 <= XINT (*begin) && XINT (*begin) <= XINT (*end)
151 && XINT (*end) <= s->size))
152 args_out_of_range (*begin, *end);
153 XSETFASTINT (*begin, XFASTINT (*begin));
154 if (begin != end)
155 XSETFASTINT (*end, XFASTINT (*end));
156 i = s->intervals;
157
158 if (s->size == 0)
159 return NULL_INTERVAL;
160
161 searchpos = XINT (*begin);
162 }
163
164 if (NULL_INTERVAL_P (i))
165 return (force ? create_root_interval (object) : i);
166
167 return find_interval (i, searchpos);
168 }
169
170 /* Validate LIST as a property list. If LIST is not a list, then
171 make one consisting of (LIST nil). Otherwise, verify that LIST
172 is even numbered and thus suitable as a plist. */
173
174 static Lisp_Object
175 validate_plist (list)
176 Lisp_Object list;
177 {
178 if (NILP (list))
179 return Qnil;
180
181 if (CONSP (list))
182 {
183 register int i;
184 register Lisp_Object tail;
185 for (i = 0, tail = list; !NILP (tail); i++)
186 {
187 tail = Fcdr (tail);
188 QUIT;
189 }
190 if (i & 1)
191 error ("Odd length text property list");
192 return list;
193 }
194
195 return Fcons (list, Fcons (Qnil, Qnil));
196 }
197
198 /* Return nonzero if interval I has all the properties,
199 with the same values, of list PLIST. */
200
201 static int
202 interval_has_all_properties (plist, i)
203 Lisp_Object plist;
204 INTERVAL i;
205 {
206 register Lisp_Object tail1, tail2, sym1;
207 register int found;
208
209 /* Go through each element of PLIST. */
210 for (tail1 = plist; ! NILP (tail1); tail1 = Fcdr (Fcdr (tail1)))
211 {
212 sym1 = Fcar (tail1);
213 found = 0;
214
215 /* Go through I's plist, looking for sym1 */
216 for (tail2 = i->plist; ! NILP (tail2); tail2 = Fcdr (Fcdr (tail2)))
217 if (EQ (sym1, Fcar (tail2)))
218 {
219 /* Found the same property on both lists. If the
220 values are unequal, return zero. */
221 if (! EQ (Fcar (Fcdr (tail1)), Fcar (Fcdr (tail2))))
222 return 0;
223
224 /* Property has same value on both lists; go to next one. */
225 found = 1;
226 break;
227 }
228
229 if (! found)
230 return 0;
231 }
232
233 return 1;
234 }
235
236 /* Return nonzero if the plist of interval I has any of the
237 properties of PLIST, regardless of their values. */
238
239 static INLINE int
240 interval_has_some_properties (plist, i)
241 Lisp_Object plist;
242 INTERVAL i;
243 {
244 register Lisp_Object tail1, tail2, sym;
245
246 /* Go through each element of PLIST. */
247 for (tail1 = plist; ! NILP (tail1); tail1 = Fcdr (Fcdr (tail1)))
248 {
249 sym = Fcar (tail1);
250
251 /* Go through i's plist, looking for tail1 */
252 for (tail2 = i->plist; ! NILP (tail2); tail2 = Fcdr (Fcdr (tail2)))
253 if (EQ (sym, Fcar (tail2)))
254 return 1;
255 }
256
257 return 0;
258 }
259 \f
260 /* Changing the plists of individual intervals. */
261
262 /* Return the value of PROP in property-list PLIST, or Qunbound if it
263 has none. */
264 static Lisp_Object
265 property_value (plist, prop)
266 Lisp_Object plist, prop;
267 {
268 Lisp_Object value;
269
270 while (PLIST_ELT_P (plist, value))
271 if (EQ (XCAR (plist), prop))
272 return XCAR (value);
273 else
274 plist = XCDR (value);
275
276 return Qunbound;
277 }
278
279 /* Set the properties of INTERVAL to PROPERTIES,
280 and record undo info for the previous values.
281 OBJECT is the string or buffer that INTERVAL belongs to. */
282
283 static void
284 set_properties (properties, interval, object)
285 Lisp_Object properties, object;
286 INTERVAL interval;
287 {
288 Lisp_Object sym, value;
289
290 if (BUFFERP (object))
291 {
292 /* For each property in the old plist which is missing from PROPERTIES,
293 or has a different value in PROPERTIES, make an undo record. */
294 for (sym = interval->plist;
295 PLIST_ELT_P (sym, value);
296 sym = XCDR (value))
297 if (! EQ (property_value (properties, XCAR (sym)),
298 XCAR (value)))
299 {
300 record_property_change (interval->position, LENGTH (interval),
301 XCAR (sym), XCAR (value),
302 object);
303 }
304
305 /* For each new property that has no value at all in the old plist,
306 make an undo record binding it to nil, so it will be removed. */
307 for (sym = properties;
308 PLIST_ELT_P (sym, value);
309 sym = XCDR (value))
310 if (EQ (property_value (interval->plist, XCAR (sym)), Qunbound))
311 {
312 record_property_change (interval->position, LENGTH (interval),
313 XCAR (sym), Qnil,
314 object);
315 }
316 }
317
318 /* Store new properties. */
319 interval->plist = Fcopy_sequence (properties);
320 }
321
322 /* Add the properties of PLIST to the interval I, or set
323 the value of I's property to the value of the property on PLIST
324 if they are different.
325
326 OBJECT should be the string or buffer the interval is in.
327
328 Return nonzero if this changes I (i.e., if any members of PLIST
329 are actually added to I's plist) */
330
331 static int
332 add_properties (plist, i, object)
333 Lisp_Object plist;
334 INTERVAL i;
335 Lisp_Object object;
336 {
337 Lisp_Object tail1, tail2, sym1, val1;
338 register int changed = 0;
339 register int found;
340 struct gcpro gcpro1, gcpro2, gcpro3;
341
342 tail1 = plist;
343 sym1 = Qnil;
344 val1 = Qnil;
345 /* No need to protect OBJECT, because we can GC only in the case
346 where it is a buffer, and live buffers are always protected.
347 I and its plist are also protected, via OBJECT. */
348 GCPRO3 (tail1, sym1, val1);
349
350 /* Go through each element of PLIST. */
351 for (tail1 = plist; ! NILP (tail1); tail1 = Fcdr (Fcdr (tail1)))
352 {
353 sym1 = Fcar (tail1);
354 val1 = Fcar (Fcdr (tail1));
355 found = 0;
356
357 /* Go through I's plist, looking for sym1 */
358 for (tail2 = i->plist; ! NILP (tail2); tail2 = Fcdr (Fcdr (tail2)))
359 if (EQ (sym1, Fcar (tail2)))
360 {
361 /* No need to gcpro, because tail2 protects this
362 and it must be a cons cell (we get an error otherwise). */
363 register Lisp_Object this_cdr;
364
365 this_cdr = Fcdr (tail2);
366 /* Found the property. Now check its value. */
367 found = 1;
368
369 /* The properties have the same value on both lists.
370 Continue to the next property. */
371 if (EQ (val1, Fcar (this_cdr)))
372 break;
373
374 /* Record this change in the buffer, for undo purposes. */
375 if (BUFFERP (object))
376 {
377 record_property_change (i->position, LENGTH (i),
378 sym1, Fcar (this_cdr), object);
379 }
380
381 /* I's property has a different value -- change it */
382 Fsetcar (this_cdr, val1);
383 changed++;
384 break;
385 }
386
387 if (! found)
388 {
389 /* Record this change in the buffer, for undo purposes. */
390 if (BUFFERP (object))
391 {
392 record_property_change (i->position, LENGTH (i),
393 sym1, Qnil, object);
394 }
395 i->plist = Fcons (sym1, Fcons (val1, i->plist));
396 changed++;
397 }
398 }
399
400 UNGCPRO;
401
402 return changed;
403 }
404
405 /* For any members of PLIST which are properties of I, remove them
406 from I's plist.
407 OBJECT is the string or buffer containing I. */
408
409 static int
410 remove_properties (plist, i, object)
411 Lisp_Object plist;
412 INTERVAL i;
413 Lisp_Object object;
414 {
415 register Lisp_Object tail1, tail2, sym, current_plist;
416 register int changed = 0;
417
418 current_plist = i->plist;
419 /* Go through each element of plist. */
420 for (tail1 = plist; ! NILP (tail1); tail1 = Fcdr (Fcdr (tail1)))
421 {
422 sym = Fcar (tail1);
423
424 /* First, remove the symbol if its at the head of the list */
425 while (! NILP (current_plist) && EQ (sym, Fcar (current_plist)))
426 {
427 if (BUFFERP (object))
428 {
429 record_property_change (i->position, LENGTH (i),
430 sym, Fcar (Fcdr (current_plist)),
431 object);
432 }
433
434 current_plist = Fcdr (Fcdr (current_plist));
435 changed++;
436 }
437
438 /* Go through i's plist, looking for sym */
439 tail2 = current_plist;
440 while (! NILP (tail2))
441 {
442 register Lisp_Object this;
443 this = Fcdr (Fcdr (tail2));
444 if (EQ (sym, Fcar (this)))
445 {
446 if (BUFFERP (object))
447 {
448 record_property_change (i->position, LENGTH (i),
449 sym, Fcar (Fcdr (this)), object);
450 }
451
452 Fsetcdr (Fcdr (tail2), Fcdr (Fcdr (this)));
453 changed++;
454 }
455 tail2 = this;
456 }
457 }
458
459 if (changed)
460 i->plist = current_plist;
461 return changed;
462 }
463
464 #if 0
465 /* Remove all properties from interval I. Return non-zero
466 if this changes the interval. */
467
468 static INLINE int
469 erase_properties (i)
470 INTERVAL i;
471 {
472 if (NILP (i->plist))
473 return 0;
474
475 i->plist = Qnil;
476 return 1;
477 }
478 #endif
479 \f
480 /* Returns the interval of POSITION in OBJECT.
481 POSITION is BEG-based. */
482
483 INTERVAL
484 interval_of (position, object)
485 int position;
486 Lisp_Object object;
487 {
488 register INTERVAL i;
489 int beg, end;
490
491 if (NILP (object))
492 XSETBUFFER (object, current_buffer);
493 else if (EQ (object, Qt))
494 return NULL_INTERVAL;
495
496 CHECK_STRING_OR_BUFFER (object, 0);
497
498 if (BUFFERP (object))
499 {
500 register struct buffer *b = XBUFFER (object);
501
502 beg = BUF_BEGV (b);
503 end = BUF_ZV (b);
504 i = BUF_INTERVALS (b);
505 }
506 else
507 {
508 register struct Lisp_String *s = XSTRING (object);
509
510 beg = 0;
511 end = s->size;
512 i = s->intervals;
513 }
514
515 if (!(beg <= position && position <= end))
516 args_out_of_range (make_number (position), make_number (position));
517 if (beg == end || NULL_INTERVAL_P (i))
518 return NULL_INTERVAL;
519
520 return find_interval (i, position);
521 }
522 \f
523 DEFUN ("text-properties-at", Ftext_properties_at,
524 Stext_properties_at, 1, 2, 0,
525 "Return the list of properties of the character at POSITION in OBJECT.\n\
526 OBJECT is the string or buffer to look for the properties in;\n\
527 nil means the current buffer.\n\
528 If POSITION is at the end of OBJECT, the value is nil.")
529 (position, object)
530 Lisp_Object position, object;
531 {
532 register INTERVAL i;
533
534 if (NILP (object))
535 XSETBUFFER (object, current_buffer);
536
537 i = validate_interval_range (object, &position, &position, soft);
538 if (NULL_INTERVAL_P (i))
539 return Qnil;
540 /* If POSITION is at the end of the interval,
541 it means it's the end of OBJECT.
542 There are no properties at the very end,
543 since no character follows. */
544 if (XINT (position) == LENGTH (i) + i->position)
545 return Qnil;
546
547 return i->plist;
548 }
549
550 DEFUN ("get-text-property", Fget_text_property, Sget_text_property, 2, 3, 0,
551 "Return the value of POSITION's property PROP, in OBJECT.\n\
552 OBJECT is optional and defaults to the current buffer.\n\
553 If POSITION is at the end of OBJECT, the value is nil.")
554 (position, prop, object)
555 Lisp_Object position, object;
556 Lisp_Object prop;
557 {
558 return textget (Ftext_properties_at (position, object), prop);
559 }
560
561 DEFUN ("get-char-property", Fget_char_property, Sget_char_property, 2, 3, 0,
562 "Return the value of POSITION's property PROP, in OBJECT.\n\
563 OBJECT is optional and defaults to the current buffer.\n\
564 If POSITION is at the end of OBJECT, the value is nil.\n\
565 If OBJECT is a buffer, then overlay properties are considered as well as\n\
566 text properties.\n\
567 If OBJECT is a window, then that window's buffer is used, but window-specific\n\
568 overlays are considered only if they are associated with OBJECT.")
569 (position, prop, object)
570 Lisp_Object position, object;
571 register Lisp_Object prop;
572 {
573 struct window *w = 0;
574
575 CHECK_NUMBER_COERCE_MARKER (position, 0);
576
577 if (NILP (object))
578 XSETBUFFER (object, current_buffer);
579
580 if (WINDOWP (object))
581 {
582 w = XWINDOW (object);
583 object = w->buffer;
584 }
585 if (BUFFERP (object))
586 {
587 int posn = XINT (position);
588 int noverlays;
589 Lisp_Object *overlay_vec, tem;
590 int next_overlay;
591 int len;
592 struct buffer *obuf = current_buffer;
593
594 set_buffer_temp (XBUFFER (object));
595
596 /* First try with room for 40 overlays. */
597 len = 40;
598 overlay_vec = (Lisp_Object *) alloca (len * sizeof (Lisp_Object));
599
600 noverlays = overlays_at (posn, 0, &overlay_vec, &len,
601 &next_overlay, NULL);
602
603 /* If there are more than 40,
604 make enough space for all, and try again. */
605 if (noverlays > len)
606 {
607 len = noverlays;
608 overlay_vec = (Lisp_Object *) alloca (len * sizeof (Lisp_Object));
609 noverlays = overlays_at (posn, 0, &overlay_vec, &len,
610 &next_overlay, NULL);
611 }
612 noverlays = sort_overlays (overlay_vec, noverlays, w);
613
614 set_buffer_temp (obuf);
615
616 /* Now check the overlays in order of decreasing priority. */
617 while (--noverlays >= 0)
618 {
619 tem = Foverlay_get (overlay_vec[noverlays], prop);
620 if (!NILP (tem))
621 return (tem);
622 }
623 }
624 /* Not a buffer, or no appropriate overlay, so fall through to the
625 simpler case. */
626 return (Fget_text_property (position, prop, object));
627 }
628 \f
629 DEFUN ("next-char-property-change", Fnext_char_property_change,
630 Snext_char_property_change, 1, 2, 0,
631 "Return the position of next text property or overlay change.\n\
632 This scans characters forward from POSITION in OBJECT till it finds\n\
633 a change in some text property, or the beginning or end of an overlay,\n\
634 and returns the position of that.\n\
635 If none is found, the function returns (point-max).\n\
636 \n\
637 If the optional third argument LIMIT is non-nil, don't search\n\
638 past position LIMIT; return LIMIT if nothing is found before LIMIT.")
639 (position, limit)
640 Lisp_Object position, limit;
641 {
642 Lisp_Object temp;
643
644 temp = Fnext_overlay_change (position);
645 if (! NILP (limit))
646 {
647 CHECK_NUMBER (limit, 2);
648 if (XINT (limit) < XINT (temp))
649 temp = limit;
650 }
651 return Fnext_property_change (position, Qnil, temp);
652 }
653
654 DEFUN ("previous-char-property-change", Fprevious_char_property_change,
655 Sprevious_char_property_change, 1, 2, 0,
656 "Return the position of previous text property or overlay change.\n\
657 Scans characters backward from POSITION in OBJECT till it finds\n\
658 a change in some text property, or the beginning or end of an overlay,\n\
659 and returns the position of that.\n\
660 If none is found, the function returns (point-max).\n\
661 \n\
662 If the optional third argument LIMIT is non-nil, don't search\n\
663 past position LIMIT; return LIMIT if nothing is found before LIMIT.")
664 (position, limit)
665 Lisp_Object position, limit;
666 {
667 Lisp_Object temp;
668
669 temp = Fprevious_overlay_change (position);
670 if (! NILP (limit))
671 {
672 CHECK_NUMBER (limit, 2);
673 if (XINT (limit) > XINT (temp))
674 temp = limit;
675 }
676 return Fprevious_property_change (position, Qnil, temp);
677 }
678
679
680 /* Value is the position in OBJECT after POS where the value of
681 property PROP changes. OBJECT must be a string or buffer. If
682 OBJECT is nil, use the current buffer. LIMIT if not nil limits the
683 search. */
684
685 Lisp_Object
686 next_single_char_property_change (pos, prop, object, limit)
687 Lisp_Object prop, pos, object, limit;
688 {
689 if (STRINGP (object))
690 {
691 pos = Fnext_single_property_change (pos, prop, object, limit);
692 if (NILP (pos))
693 {
694 if (NILP (limit))
695 pos = make_number (XSTRING (object)->size);
696 else
697 pos = limit;
698 }
699 }
700 else
701 {
702 Lisp_Object initial_value, value;
703 int count = specpdl_ptr - specpdl;
704
705 if (!NILP (object))
706 CHECK_BUFFER (object, 0);
707
708 if (BUFFERP (object) && current_buffer != XBUFFER (object))
709 {
710 record_unwind_protect (Fset_buffer, Fcurrent_buffer ());
711 Fset_buffer (object);
712 }
713
714 initial_value = Fget_char_property (pos, prop, object);
715
716 while (XFASTINT (pos) < XFASTINT (limit))
717 {
718 pos = Fnext_char_property_change (pos, limit);
719 value = Fget_char_property (pos, prop, object);
720 if (!EQ (value, initial_value))
721 break;
722 }
723
724 unbind_to (count, Qnil);
725 }
726
727 return pos;
728 }
729
730
731 \f
732 DEFUN ("next-property-change", Fnext_property_change,
733 Snext_property_change, 1, 3, 0,
734 "Return the position of next property change.\n\
735 Scans characters forward from POSITION in OBJECT till it finds\n\
736 a change in some text property, then returns the position of the change.\n\
737 The optional second argument OBJECT is the string or buffer to scan.\n\
738 Return nil if the property is constant all the way to the end of OBJECT.\n\
739 If the value is non-nil, it is a position greater than POSITION, never equal.\n\n\
740 If the optional third argument LIMIT is non-nil, don't search\n\
741 past position LIMIT; return LIMIT if nothing is found before LIMIT.")
742 (position, object, limit)
743 Lisp_Object position, object, limit;
744 {
745 register INTERVAL i, next;
746
747 if (NILP (object))
748 XSETBUFFER (object, current_buffer);
749
750 if (! NILP (limit) && ! EQ (limit, Qt))
751 CHECK_NUMBER_COERCE_MARKER (limit, 0);
752
753 i = validate_interval_range (object, &position, &position, soft);
754
755 /* If LIMIT is t, return start of next interval--don't
756 bother checking further intervals. */
757 if (EQ (limit, Qt))
758 {
759 if (NULL_INTERVAL_P (i))
760 next = i;
761 else
762 next = next_interval (i);
763
764 if (NULL_INTERVAL_P (next))
765 XSETFASTINT (position, (STRINGP (object)
766 ? XSTRING (object)->size
767 : BUF_ZV (XBUFFER (object))));
768 else
769 XSETFASTINT (position, next->position);
770 return position;
771 }
772
773 if (NULL_INTERVAL_P (i))
774 return limit;
775
776 next = next_interval (i);
777
778 while (! NULL_INTERVAL_P (next) && intervals_equal (i, next)
779 && (NILP (limit) || next->position < XFASTINT (limit)))
780 next = next_interval (next);
781
782 if (NULL_INTERVAL_P (next))
783 return limit;
784 if (! NILP (limit) && !(next->position < XFASTINT (limit)))
785 return limit;
786
787 XSETFASTINT (position, next->position);
788 return position;
789 }
790
791 /* Return 1 if there's a change in some property between BEG and END. */
792
793 int
794 property_change_between_p (beg, end)
795 int beg, end;
796 {
797 register INTERVAL i, next;
798 Lisp_Object object, pos;
799
800 XSETBUFFER (object, current_buffer);
801 XSETFASTINT (pos, beg);
802
803 i = validate_interval_range (object, &pos, &pos, soft);
804 if (NULL_INTERVAL_P (i))
805 return 0;
806
807 next = next_interval (i);
808 while (! NULL_INTERVAL_P (next) && intervals_equal (i, next))
809 {
810 next = next_interval (next);
811 if (NULL_INTERVAL_P (next))
812 return 0;
813 if (next->position >= end)
814 return 0;
815 }
816
817 if (NULL_INTERVAL_P (next))
818 return 0;
819
820 return 1;
821 }
822
823 DEFUN ("next-single-property-change", Fnext_single_property_change,
824 Snext_single_property_change, 2, 4, 0,
825 "Return the position of next property change for a specific property.\n\
826 Scans characters forward from POSITION till it finds\n\
827 a change in the PROP property, then returns the position of the change.\n\
828 The optional third argument OBJECT is the string or buffer to scan.\n\
829 The property values are compared with `eq'.\n\
830 Return nil if the property is constant all the way to the end of OBJECT.\n\
831 If the value is non-nil, it is a position greater than POSITION, never equal.\n\n\
832 If the optional fourth argument LIMIT is non-nil, don't search\n\
833 past position LIMIT; return LIMIT if nothing is found before LIMIT.")
834 (position, prop, object, limit)
835 Lisp_Object position, prop, object, limit;
836 {
837 register INTERVAL i, next;
838 register Lisp_Object here_val;
839
840 if (NILP (object))
841 XSETBUFFER (object, current_buffer);
842
843 if (!NILP (limit))
844 CHECK_NUMBER_COERCE_MARKER (limit, 0);
845
846 i = validate_interval_range (object, &position, &position, soft);
847 if (NULL_INTERVAL_P (i))
848 return limit;
849
850 here_val = textget (i->plist, prop);
851 next = next_interval (i);
852 while (! NULL_INTERVAL_P (next)
853 && EQ (here_val, textget (next->plist, prop))
854 && (NILP (limit) || next->position < XFASTINT (limit)))
855 next = next_interval (next);
856
857 if (NULL_INTERVAL_P (next))
858 return limit;
859 if (! NILP (limit) && !(next->position < XFASTINT (limit)))
860 return limit;
861
862 return make_number (next->position);
863 }
864
865 DEFUN ("previous-property-change", Fprevious_property_change,
866 Sprevious_property_change, 1, 3, 0,
867 "Return the position of previous property change.\n\
868 Scans characters backwards from POSITION in OBJECT till it finds\n\
869 a change in some text property, then returns the position of the change.\n\
870 The optional second argument OBJECT is the string or buffer to scan.\n\
871 Return nil if the property is constant all the way to the start of OBJECT.\n\
872 If the value is non-nil, it is a position less than POSITION, never equal.\n\n\
873 If the optional third argument LIMIT is non-nil, don't search\n\
874 back past position LIMIT; return LIMIT if nothing is found until LIMIT.")
875 (position, object, limit)
876 Lisp_Object position, object, limit;
877 {
878 register INTERVAL i, previous;
879
880 if (NILP (object))
881 XSETBUFFER (object, current_buffer);
882
883 if (!NILP (limit))
884 CHECK_NUMBER_COERCE_MARKER (limit, 0);
885
886 i = validate_interval_range (object, &position, &position, soft);
887 if (NULL_INTERVAL_P (i))
888 return limit;
889
890 /* Start with the interval containing the char before point. */
891 if (i->position == XFASTINT (position))
892 i = previous_interval (i);
893
894 previous = previous_interval (i);
895 while (! NULL_INTERVAL_P (previous) && intervals_equal (previous, i)
896 && (NILP (limit)
897 || (previous->position + LENGTH (previous) > XFASTINT (limit))))
898 previous = previous_interval (previous);
899 if (NULL_INTERVAL_P (previous))
900 return limit;
901 if (!NILP (limit)
902 && !(previous->position + LENGTH (previous) > XFASTINT (limit)))
903 return limit;
904
905 return make_number (previous->position + LENGTH (previous));
906 }
907
908 DEFUN ("previous-single-property-change", Fprevious_single_property_change,
909 Sprevious_single_property_change, 2, 4, 0,
910 "Return the position of previous property change for a specific property.\n\
911 Scans characters backward from POSITION till it finds\n\
912 a change in the PROP property, then returns the position of the change.\n\
913 The optional third argument OBJECT is the string or buffer to scan.\n\
914 The property values are compared with `eq'.\n\
915 Return nil if the property is constant all the way to the start of OBJECT.\n\
916 If the value is non-nil, it is a position less than POSITION, never equal.\n\n\
917 If the optional fourth argument LIMIT is non-nil, don't search\n\
918 back past position LIMIT; return LIMIT if nothing is found until LIMIT.")
919 (position, prop, object, limit)
920 Lisp_Object position, prop, object, limit;
921 {
922 register INTERVAL i, previous;
923 register Lisp_Object here_val;
924
925 if (NILP (object))
926 XSETBUFFER (object, current_buffer);
927
928 if (!NILP (limit))
929 CHECK_NUMBER_COERCE_MARKER (limit, 0);
930
931 i = validate_interval_range (object, &position, &position, soft);
932
933 /* Start with the interval containing the char before point. */
934 if (! NULL_INTERVAL_P (i) && i->position == XFASTINT (position))
935 i = previous_interval (i);
936
937 if (NULL_INTERVAL_P (i))
938 return limit;
939
940 here_val = textget (i->plist, prop);
941 previous = previous_interval (i);
942 while (! NULL_INTERVAL_P (previous)
943 && EQ (here_val, textget (previous->plist, prop))
944 && (NILP (limit)
945 || (previous->position + LENGTH (previous) > XFASTINT (limit))))
946 previous = previous_interval (previous);
947 if (NULL_INTERVAL_P (previous))
948 return limit;
949 if (!NILP (limit)
950 && !(previous->position + LENGTH (previous) > XFASTINT (limit)))
951 return limit;
952
953 return make_number (previous->position + LENGTH (previous));
954 }
955 \f
956 /* Callers note, this can GC when OBJECT is a buffer (or nil). */
957
958 DEFUN ("add-text-properties", Fadd_text_properties,
959 Sadd_text_properties, 3, 4, 0,
960 "Add properties to the text from START to END.\n\
961 The third argument PROPERTIES is a property list\n\
962 specifying the property values to add.\n\
963 The optional fourth argument, OBJECT,\n\
964 is the string or buffer containing the text.\n\
965 Return t if any property value actually changed, nil otherwise.")
966 (start, end, properties, object)
967 Lisp_Object start, end, properties, object;
968 {
969 register INTERVAL i, unchanged;
970 register int s, len, modified = 0;
971 struct gcpro gcpro1;
972
973 properties = validate_plist (properties);
974 if (NILP (properties))
975 return Qnil;
976
977 if (NILP (object))
978 XSETBUFFER (object, current_buffer);
979
980 i = validate_interval_range (object, &start, &end, hard);
981 if (NULL_INTERVAL_P (i))
982 return Qnil;
983
984 s = XINT (start);
985 len = XINT (end) - s;
986
987 /* No need to protect OBJECT, because we GC only if it's a buffer,
988 and live buffers are always protected. */
989 GCPRO1 (properties);
990
991 /* If we're not starting on an interval boundary, we have to
992 split this interval. */
993 if (i->position != s)
994 {
995 /* If this interval already has the properties, we can
996 skip it. */
997 if (interval_has_all_properties (properties, i))
998 {
999 int got = (LENGTH (i) - (s - i->position));
1000 if (got >= len)
1001 RETURN_UNGCPRO (Qnil);
1002 len -= got;
1003 i = next_interval (i);
1004 }
1005 else
1006 {
1007 unchanged = i;
1008 i = split_interval_right (unchanged, s - unchanged->position);
1009 copy_properties (unchanged, i);
1010 }
1011 }
1012
1013 if (BUFFERP (object))
1014 modify_region (XBUFFER (object), XINT (start), XINT (end));
1015
1016 /* We are at the beginning of interval I, with LEN chars to scan. */
1017 for (;;)
1018 {
1019 if (i == 0)
1020 abort ();
1021
1022 if (LENGTH (i) >= len)
1023 {
1024 /* We can UNGCPRO safely here, because there will be just
1025 one more chance to gc, in the next call to add_properties,
1026 and after that we will not need PROPERTIES or OBJECT again. */
1027 UNGCPRO;
1028
1029 if (interval_has_all_properties (properties, i))
1030 {
1031 if (BUFFERP (object))
1032 signal_after_change (XINT (start), XINT (end) - XINT (start),
1033 XINT (end) - XINT (start));
1034
1035 return modified ? Qt : Qnil;
1036 }
1037
1038 if (LENGTH (i) == len)
1039 {
1040 add_properties (properties, i, object);
1041 if (BUFFERP (object))
1042 signal_after_change (XINT (start), XINT (end) - XINT (start),
1043 XINT (end) - XINT (start));
1044 return Qt;
1045 }
1046
1047 /* i doesn't have the properties, and goes past the change limit */
1048 unchanged = i;
1049 i = split_interval_left (unchanged, len);
1050 copy_properties (unchanged, i);
1051 add_properties (properties, i, object);
1052 if (BUFFERP (object))
1053 signal_after_change (XINT (start), XINT (end) - XINT (start),
1054 XINT (end) - XINT (start));
1055 return Qt;
1056 }
1057
1058 len -= LENGTH (i);
1059 modified += add_properties (properties, i, object);
1060 i = next_interval (i);
1061 }
1062 }
1063
1064 /* Callers note, this can GC when OBJECT is a buffer (or nil). */
1065
1066 DEFUN ("put-text-property", Fput_text_property,
1067 Sput_text_property, 4, 5, 0,
1068 "Set one property of the text from START to END.\n\
1069 The third and fourth arguments PROPERTY and VALUE\n\
1070 specify the property to add.\n\
1071 The optional fifth argument, OBJECT,\n\
1072 is the string or buffer containing the text.")
1073 (start, end, property, value, object)
1074 Lisp_Object start, end, property, value, object;
1075 {
1076 Fadd_text_properties (start, end,
1077 Fcons (property, Fcons (value, Qnil)),
1078 object);
1079 return Qnil;
1080 }
1081
1082 DEFUN ("set-text-properties", Fset_text_properties,
1083 Sset_text_properties, 3, 4, 0,
1084 "Completely replace properties of text from START to END.\n\
1085 The third argument PROPERTIES is the new property list.\n\
1086 The optional fourth argument, OBJECT,\n\
1087 is the string or buffer containing the text.")
1088 (start, end, properties, object)
1089 Lisp_Object start, end, properties, object;
1090 {
1091 return set_text_properties (start, end, properties, object, Qt);
1092 }
1093
1094
1095 /* Replace properties of text from START to END with new list of
1096 properties PROPERTIES. OBJECT is the buffer or string containing
1097 the text. OBJECT nil means use the current buffer.
1098 SIGNAL_AFTER_CHANGE_P nil means don't signal after changes. Value
1099 is non-nil if properties were replaced; it is nil if there weren't
1100 any properties to replace. */
1101
1102 Lisp_Object
1103 set_text_properties (start, end, properties, object, signal_after_change_p)
1104 Lisp_Object start, end, properties, object, signal_after_change_p;
1105 {
1106 register INTERVAL i, unchanged;
1107 register INTERVAL prev_changed = NULL_INTERVAL;
1108 register int s, len;
1109 Lisp_Object ostart, oend;
1110
1111 ostart = start;
1112 oend = end;
1113
1114 properties = validate_plist (properties);
1115
1116 if (NILP (object))
1117 XSETBUFFER (object, current_buffer);
1118
1119 /* If we want no properties for a whole string,
1120 get rid of its intervals. */
1121 if (NILP (properties) && STRINGP (object)
1122 && XFASTINT (start) == 0
1123 && XFASTINT (end) == XSTRING (object)->size)
1124 {
1125 if (! XSTRING (object)->intervals)
1126 return Qt;
1127
1128 XSTRING (object)->intervals = 0;
1129 return Qt;
1130 }
1131
1132 i = validate_interval_range (object, &start, &end, soft);
1133
1134 if (NULL_INTERVAL_P (i))
1135 {
1136 /* If buffer has no properties, and we want none, return now. */
1137 if (NILP (properties))
1138 return Qnil;
1139
1140 /* Restore the original START and END values
1141 because validate_interval_range increments them for strings. */
1142 start = ostart;
1143 end = oend;
1144
1145 i = validate_interval_range (object, &start, &end, hard);
1146 /* This can return if start == end. */
1147 if (NULL_INTERVAL_P (i))
1148 return Qnil;
1149 }
1150
1151 s = XINT (start);
1152 len = XINT (end) - s;
1153
1154 if (BUFFERP (object))
1155 modify_region (XBUFFER (object), XINT (start), XINT (end));
1156
1157 if (i->position != s)
1158 {
1159 unchanged = i;
1160 i = split_interval_right (unchanged, s - unchanged->position);
1161
1162 if (LENGTH (i) > len)
1163 {
1164 copy_properties (unchanged, i);
1165 i = split_interval_left (i, len);
1166 set_properties (properties, i, object);
1167 if (BUFFERP (object) && !NILP (signal_after_change_p))
1168 signal_after_change (XINT (start), XINT (end) - XINT (start),
1169 XINT (end) - XINT (start));
1170
1171 return Qt;
1172 }
1173
1174 set_properties (properties, i, object);
1175
1176 if (LENGTH (i) == len)
1177 {
1178 if (BUFFERP (object) && !NILP (signal_after_change_p))
1179 signal_after_change (XINT (start), XINT (end) - XINT (start),
1180 XINT (end) - XINT (start));
1181
1182 return Qt;
1183 }
1184
1185 prev_changed = i;
1186 len -= LENGTH (i);
1187 i = next_interval (i);
1188 }
1189
1190 /* We are starting at the beginning of an interval, I */
1191 while (len > 0)
1192 {
1193 if (i == 0)
1194 abort ();
1195
1196 if (LENGTH (i) >= len)
1197 {
1198 if (LENGTH (i) > len)
1199 i = split_interval_left (i, len);
1200
1201 /* We have to call set_properties even if we are going to
1202 merge the intervals, so as to make the undo records
1203 and cause redisplay to happen. */
1204 set_properties (properties, i, object);
1205 if (!NULL_INTERVAL_P (prev_changed))
1206 merge_interval_left (i);
1207 if (BUFFERP (object) && !NILP (signal_after_change_p))
1208 signal_after_change (XINT (start), XINT (end) - XINT (start),
1209 XINT (end) - XINT (start));
1210 return Qt;
1211 }
1212
1213 len -= LENGTH (i);
1214
1215 /* We have to call set_properties even if we are going to
1216 merge the intervals, so as to make the undo records
1217 and cause redisplay to happen. */
1218 set_properties (properties, i, object);
1219 if (NULL_INTERVAL_P (prev_changed))
1220 prev_changed = i;
1221 else
1222 prev_changed = i = merge_interval_left (i);
1223
1224 i = next_interval (i);
1225 }
1226
1227 if (BUFFERP (object) && !NILP (signal_after_change_p))
1228 signal_after_change (XINT (start), XINT (end) - XINT (start),
1229 XINT (end) - XINT (start));
1230 return Qt;
1231 }
1232
1233 DEFUN ("remove-text-properties", Fremove_text_properties,
1234 Sremove_text_properties, 3, 4, 0,
1235 "Remove some properties from text from START to END.\n\
1236 The third argument PROPERTIES is a property list\n\
1237 whose property names specify the properties to remove.\n\
1238 \(The values stored in PROPERTIES are ignored.)\n\
1239 The optional fourth argument, OBJECT,\n\
1240 is the string or buffer containing the text.\n\
1241 Return t if any property was actually removed, nil otherwise.")
1242 (start, end, properties, object)
1243 Lisp_Object start, end, properties, object;
1244 {
1245 register INTERVAL i, unchanged;
1246 register int s, len, modified = 0;
1247
1248 if (NILP (object))
1249 XSETBUFFER (object, current_buffer);
1250
1251 i = validate_interval_range (object, &start, &end, soft);
1252 if (NULL_INTERVAL_P (i))
1253 return Qnil;
1254
1255 s = XINT (start);
1256 len = XINT (end) - s;
1257
1258 if (i->position != s)
1259 {
1260 /* No properties on this first interval -- return if
1261 it covers the entire region. */
1262 if (! interval_has_some_properties (properties, i))
1263 {
1264 int got = (LENGTH (i) - (s - i->position));
1265 if (got >= len)
1266 return Qnil;
1267 len -= got;
1268 i = next_interval (i);
1269 }
1270 /* Split away the beginning of this interval; what we don't
1271 want to modify. */
1272 else
1273 {
1274 unchanged = i;
1275 i = split_interval_right (unchanged, s - unchanged->position);
1276 copy_properties (unchanged, i);
1277 }
1278 }
1279
1280 if (BUFFERP (object))
1281 modify_region (XBUFFER (object), XINT (start), XINT (end));
1282
1283 /* We are at the beginning of an interval, with len to scan */
1284 for (;;)
1285 {
1286 if (i == 0)
1287 abort ();
1288
1289 if (LENGTH (i) >= len)
1290 {
1291 if (! interval_has_some_properties (properties, i))
1292 return modified ? Qt : Qnil;
1293
1294 if (LENGTH (i) == len)
1295 {
1296 remove_properties (properties, i, object);
1297 if (BUFFERP (object))
1298 signal_after_change (XINT (start), XINT (end) - XINT (start),
1299 XINT (end) - XINT (start));
1300 return Qt;
1301 }
1302
1303 /* i has the properties, and goes past the change limit */
1304 unchanged = i;
1305 i = split_interval_left (i, len);
1306 copy_properties (unchanged, i);
1307 remove_properties (properties, i, object);
1308 if (BUFFERP (object))
1309 signal_after_change (XINT (start), XINT (end) - XINT (start),
1310 XINT (end) - XINT (start));
1311 return Qt;
1312 }
1313
1314 len -= LENGTH (i);
1315 modified += remove_properties (properties, i, object);
1316 i = next_interval (i);
1317 }
1318 }
1319 \f
1320 DEFUN ("text-property-any", Ftext_property_any,
1321 Stext_property_any, 4, 5, 0,
1322 "Check text from START to END for property PROPERTY equalling VALUE.\n\
1323 If so, return the position of the first character whose property PROPERTY\n\
1324 is `eq' to VALUE. Otherwise return nil.\n\
1325 The optional fifth argument, OBJECT, is the string or buffer\n\
1326 containing the text.")
1327 (start, end, property, value, object)
1328 Lisp_Object start, end, property, value, object;
1329 {
1330 register INTERVAL i;
1331 register int e, pos;
1332
1333 if (NILP (object))
1334 XSETBUFFER (object, current_buffer);
1335 i = validate_interval_range (object, &start, &end, soft);
1336 if (NULL_INTERVAL_P (i))
1337 return (!NILP (value) || EQ (start, end) ? Qnil : start);
1338 e = XINT (end);
1339
1340 while (! NULL_INTERVAL_P (i))
1341 {
1342 if (i->position >= e)
1343 break;
1344 if (EQ (textget (i->plist, property), value))
1345 {
1346 pos = i->position;
1347 if (pos < XINT (start))
1348 pos = XINT (start);
1349 return make_number (pos);
1350 }
1351 i = next_interval (i);
1352 }
1353 return Qnil;
1354 }
1355
1356 DEFUN ("text-property-not-all", Ftext_property_not_all,
1357 Stext_property_not_all, 4, 5, 0,
1358 "Check text from START to END for property PROPERTY not equalling VALUE.\n\
1359 If so, return the position of the first character whose property PROPERTY\n\
1360 is not `eq' to VALUE. Otherwise, return nil.\n\
1361 The optional fifth argument, OBJECT, is the string or buffer\n\
1362 containing the text.")
1363 (start, end, property, value, object)
1364 Lisp_Object start, end, property, value, object;
1365 {
1366 register INTERVAL i;
1367 register int s, e;
1368
1369 if (NILP (object))
1370 XSETBUFFER (object, current_buffer);
1371 i = validate_interval_range (object, &start, &end, soft);
1372 if (NULL_INTERVAL_P (i))
1373 return (NILP (value) || EQ (start, end)) ? Qnil : start;
1374 s = XINT (start);
1375 e = XINT (end);
1376
1377 while (! NULL_INTERVAL_P (i))
1378 {
1379 if (i->position >= e)
1380 break;
1381 if (! EQ (textget (i->plist, property), value))
1382 {
1383 if (i->position > s)
1384 s = i->position;
1385 return make_number (s);
1386 }
1387 i = next_interval (i);
1388 }
1389 return Qnil;
1390 }
1391 \f
1392 /* I don't think this is the right interface to export; how often do you
1393 want to do something like this, other than when you're copying objects
1394 around?
1395
1396 I think it would be better to have a pair of functions, one which
1397 returns the text properties of a region as a list of ranges and
1398 plists, and another which applies such a list to another object. */
1399
1400 /* Add properties from SRC to SRC of SRC, starting at POS in DEST.
1401 SRC and DEST may each refer to strings or buffers.
1402 Optional sixth argument PROP causes only that property to be copied.
1403 Properties are copied to DEST as if by `add-text-properties'.
1404 Return t if any property value actually changed, nil otherwise. */
1405
1406 /* Note this can GC when DEST is a buffer. */
1407
1408 Lisp_Object
1409 copy_text_properties (start, end, src, pos, dest, prop)
1410 Lisp_Object start, end, src, pos, dest, prop;
1411 {
1412 INTERVAL i;
1413 Lisp_Object res;
1414 Lisp_Object stuff;
1415 Lisp_Object plist;
1416 int s, e, e2, p, len, modified = 0;
1417 struct gcpro gcpro1, gcpro2;
1418
1419 i = validate_interval_range (src, &start, &end, soft);
1420 if (NULL_INTERVAL_P (i))
1421 return Qnil;
1422
1423 CHECK_NUMBER_COERCE_MARKER (pos, 0);
1424 {
1425 Lisp_Object dest_start, dest_end;
1426
1427 dest_start = pos;
1428 XSETFASTINT (dest_end, XINT (dest_start) + (XINT (end) - XINT (start)));
1429 /* Apply this to a copy of pos; it will try to increment its arguments,
1430 which we don't want. */
1431 validate_interval_range (dest, &dest_start, &dest_end, soft);
1432 }
1433
1434 s = XINT (start);
1435 e = XINT (end);
1436 p = XINT (pos);
1437
1438 stuff = Qnil;
1439
1440 while (s < e)
1441 {
1442 e2 = i->position + LENGTH (i);
1443 if (e2 > e)
1444 e2 = e;
1445 len = e2 - s;
1446
1447 plist = i->plist;
1448 if (! NILP (prop))
1449 while (! NILP (plist))
1450 {
1451 if (EQ (Fcar (plist), prop))
1452 {
1453 plist = Fcons (prop, Fcons (Fcar (Fcdr (plist)), Qnil));
1454 break;
1455 }
1456 plist = Fcdr (Fcdr (plist));
1457 }
1458 if (! NILP (plist))
1459 {
1460 /* Must defer modifications to the interval tree in case src
1461 and dest refer to the same string or buffer. */
1462 stuff = Fcons (Fcons (make_number (p),
1463 Fcons (make_number (p + len),
1464 Fcons (plist, Qnil))),
1465 stuff);
1466 }
1467
1468 i = next_interval (i);
1469 if (NULL_INTERVAL_P (i))
1470 break;
1471
1472 p += len;
1473 s = i->position;
1474 }
1475
1476 GCPRO2 (stuff, dest);
1477
1478 while (! NILP (stuff))
1479 {
1480 res = Fcar (stuff);
1481 res = Fadd_text_properties (Fcar (res), Fcar (Fcdr (res)),
1482 Fcar (Fcdr (Fcdr (res))), dest);
1483 if (! NILP (res))
1484 modified++;
1485 stuff = Fcdr (stuff);
1486 }
1487
1488 UNGCPRO;
1489
1490 return modified ? Qt : Qnil;
1491 }
1492
1493
1494 /* Return a list representing the text properties of OBJECT between
1495 START and END. if PROP is non-nil, report only on that property.
1496 Each result list element has the form (S E PLIST), where S and E
1497 are positions in OBJECT and PLIST is a property list containing the
1498 text properties of OBJECT between S and E. Value is nil if OBJECT
1499 doesn't contain text properties between START and END. */
1500
1501 Lisp_Object
1502 text_property_list (object, start, end, prop)
1503 Lisp_Object object, start, end, prop;
1504 {
1505 struct interval *i;
1506 Lisp_Object result;
1507
1508 result = Qnil;
1509
1510 i = validate_interval_range (object, &start, &end, soft);
1511 if (!NULL_INTERVAL_P (i))
1512 {
1513 int s = XINT (start);
1514 int e = XINT (end);
1515
1516 while (s < e)
1517 {
1518 int interval_end, len;
1519 Lisp_Object plist;
1520
1521 interval_end = i->position + LENGTH (i);
1522 if (interval_end > e)
1523 interval_end = e;
1524 len = interval_end - s;
1525
1526 plist = i->plist;
1527
1528 if (!NILP (prop))
1529 for (; !NILP (plist); plist = Fcdr (Fcdr (plist)))
1530 if (EQ (Fcar (plist), prop))
1531 {
1532 plist = Fcons (prop, Fcons (Fcar (Fcdr (plist)), Qnil));
1533 break;
1534 }
1535
1536 if (!NILP (plist))
1537 result = Fcons (Fcons (make_number (s),
1538 Fcons (make_number (s + len),
1539 Fcons (plist, Qnil))),
1540 result);
1541
1542 i = next_interval (i);
1543 if (NULL_INTERVAL_P (i))
1544 break;
1545 s = i->position;
1546 }
1547 }
1548
1549 return result;
1550 }
1551
1552
1553 /* Add text properties to OBJECT from LIST. LIST is a list of triples
1554 (START END PLIST), where START and END are positions and PLIST is a
1555 property list containing the text properties to add. Adjust START
1556 and END positions by DELTA before adding properties. Value is
1557 non-zero if OBJECT was modified. */
1558
1559 int
1560 add_text_properties_from_list (object, list, delta)
1561 Lisp_Object object, list, delta;
1562 {
1563 struct gcpro gcpro1, gcpro2;
1564 int modified_p = 0;
1565
1566 GCPRO2 (list, object);
1567
1568 for (; CONSP (list); list = XCDR (list))
1569 {
1570 Lisp_Object item, start, end, plist, tem;
1571
1572 item = XCAR (list);
1573 start = make_number (XINT (XCAR (item)) + XINT (delta));
1574 end = make_number (XINT (XCAR (XCDR (item))) + XINT (delta));
1575 plist = XCAR (XCDR (XCDR (item)));
1576
1577 tem = Fadd_text_properties (start, end, plist, object);
1578 if (!NILP (tem))
1579 modified_p = 1;
1580 }
1581
1582 UNGCPRO;
1583 return modified_p;
1584 }
1585
1586
1587
1588 /* Modify end-points of ranges in LIST destructively. LIST is a list
1589 as returned from text_property_list. Change end-points equal to
1590 OLD_END to NEW_END. */
1591
1592 void
1593 extend_property_ranges (list, old_end, new_end)
1594 Lisp_Object list, old_end, new_end;
1595 {
1596 for (; CONSP (list); list = XCDR (list))
1597 {
1598 Lisp_Object item, end;
1599
1600 item = XCAR (list);
1601 end = XCAR (XCDR (item));
1602
1603 if (EQ (end, old_end))
1604 XCAR (XCDR (item)) = new_end;
1605 }
1606 }
1607
1608
1609 \f
1610 /* Call the modification hook functions in LIST, each with START and END. */
1611
1612 static void
1613 call_mod_hooks (list, start, end)
1614 Lisp_Object list, start, end;
1615 {
1616 struct gcpro gcpro1;
1617 GCPRO1 (list);
1618 while (!NILP (list))
1619 {
1620 call2 (Fcar (list), start, end);
1621 list = Fcdr (list);
1622 }
1623 UNGCPRO;
1624 }
1625
1626 /* Check for read-only intervals between character positions START ... END,
1627 in BUF, and signal an error if we find one.
1628
1629 Then check for any modification hooks in the range.
1630 Create a list of all these hooks in lexicographic order,
1631 eliminating consecutive extra copies of the same hook. Then call
1632 those hooks in order, with START and END - 1 as arguments. */
1633
1634 void
1635 verify_interval_modification (buf, start, end)
1636 struct buffer *buf;
1637 int start, end;
1638 {
1639 register INTERVAL intervals = BUF_INTERVALS (buf);
1640 register INTERVAL i;
1641 Lisp_Object hooks;
1642 register Lisp_Object prev_mod_hooks;
1643 Lisp_Object mod_hooks;
1644 struct gcpro gcpro1;
1645
1646 hooks = Qnil;
1647 prev_mod_hooks = Qnil;
1648 mod_hooks = Qnil;
1649
1650 interval_insert_behind_hooks = Qnil;
1651 interval_insert_in_front_hooks = Qnil;
1652
1653 if (NULL_INTERVAL_P (intervals))
1654 return;
1655
1656 if (start > end)
1657 {
1658 int temp = start;
1659 start = end;
1660 end = temp;
1661 }
1662
1663 /* For an insert operation, check the two chars around the position. */
1664 if (start == end)
1665 {
1666 INTERVAL prev;
1667 Lisp_Object before, after;
1668
1669 /* Set I to the interval containing the char after START,
1670 and PREV to the interval containing the char before START.
1671 Either one may be null. They may be equal. */
1672 i = find_interval (intervals, start);
1673
1674 if (start == BUF_BEGV (buf))
1675 prev = 0;
1676 else if (i->position == start)
1677 prev = previous_interval (i);
1678 else if (i->position < start)
1679 prev = i;
1680 if (start == BUF_ZV (buf))
1681 i = 0;
1682
1683 /* If Vinhibit_read_only is set and is not a list, we can
1684 skip the read_only checks. */
1685 if (NILP (Vinhibit_read_only) || CONSP (Vinhibit_read_only))
1686 {
1687 /* If I and PREV differ we need to check for the read-only
1688 property together with its stickiness. If either I or
1689 PREV are 0, this check is all we need.
1690 We have to take special care, since read-only may be
1691 indirectly defined via the category property. */
1692 if (i != prev)
1693 {
1694 if (! NULL_INTERVAL_P (i))
1695 {
1696 after = textget (i->plist, Qread_only);
1697
1698 /* If interval I is read-only and read-only is
1699 front-sticky, inhibit insertion.
1700 Check for read-only as well as category. */
1701 if (! NILP (after)
1702 && NILP (Fmemq (after, Vinhibit_read_only)))
1703 {
1704 Lisp_Object tem;
1705
1706 tem = textget (i->plist, Qfront_sticky);
1707 if (TMEM (Qread_only, tem)
1708 || (NILP (Fplist_get (i->plist, Qread_only))
1709 && TMEM (Qcategory, tem)))
1710 Fsignal (Qtext_read_only, Qnil);
1711 }
1712 }
1713
1714 if (! NULL_INTERVAL_P (prev))
1715 {
1716 before = textget (prev->plist, Qread_only);
1717
1718 /* If interval PREV is read-only and read-only isn't
1719 rear-nonsticky, inhibit insertion.
1720 Check for read-only as well as category. */
1721 if (! NILP (before)
1722 && NILP (Fmemq (before, Vinhibit_read_only)))
1723 {
1724 Lisp_Object tem;
1725
1726 tem = textget (prev->plist, Qrear_nonsticky);
1727 if (! TMEM (Qread_only, tem)
1728 && (! NILP (Fplist_get (prev->plist,Qread_only))
1729 || ! TMEM (Qcategory, tem)))
1730 Fsignal (Qtext_read_only, Qnil);
1731 }
1732 }
1733 }
1734 else if (! NULL_INTERVAL_P (i))
1735 {
1736 after = textget (i->plist, Qread_only);
1737
1738 /* If interval I is read-only and read-only is
1739 front-sticky, inhibit insertion.
1740 Check for read-only as well as category. */
1741 if (! NILP (after) && NILP (Fmemq (after, Vinhibit_read_only)))
1742 {
1743 Lisp_Object tem;
1744
1745 tem = textget (i->plist, Qfront_sticky);
1746 if (TMEM (Qread_only, tem)
1747 || (NILP (Fplist_get (i->plist, Qread_only))
1748 && TMEM (Qcategory, tem)))
1749 Fsignal (Qtext_read_only, Qnil);
1750
1751 tem = textget (prev->plist, Qrear_nonsticky);
1752 if (! TMEM (Qread_only, tem)
1753 && (! NILP (Fplist_get (prev->plist, Qread_only))
1754 || ! TMEM (Qcategory, tem)))
1755 Fsignal (Qtext_read_only, Qnil);
1756 }
1757 }
1758 }
1759
1760 /* Run both insert hooks (just once if they're the same). */
1761 if (!NULL_INTERVAL_P (prev))
1762 interval_insert_behind_hooks
1763 = textget (prev->plist, Qinsert_behind_hooks);
1764 if (!NULL_INTERVAL_P (i))
1765 interval_insert_in_front_hooks
1766 = textget (i->plist, Qinsert_in_front_hooks);
1767 }
1768 else
1769 {
1770 /* Loop over intervals on or next to START...END,
1771 collecting their hooks. */
1772
1773 i = find_interval (intervals, start);
1774 do
1775 {
1776 if (! INTERVAL_WRITABLE_P (i))
1777 Fsignal (Qtext_read_only, Qnil);
1778
1779 mod_hooks = textget (i->plist, Qmodification_hooks);
1780 if (! NILP (mod_hooks) && ! EQ (mod_hooks, prev_mod_hooks))
1781 {
1782 hooks = Fcons (mod_hooks, hooks);
1783 prev_mod_hooks = mod_hooks;
1784 }
1785
1786 i = next_interval (i);
1787 }
1788 /* Keep going thru the interval containing the char before END. */
1789 while (! NULL_INTERVAL_P (i) && i->position < end);
1790
1791 GCPRO1 (hooks);
1792 hooks = Fnreverse (hooks);
1793 while (! EQ (hooks, Qnil))
1794 {
1795 call_mod_hooks (Fcar (hooks), make_number (start),
1796 make_number (end));
1797 hooks = Fcdr (hooks);
1798 }
1799 UNGCPRO;
1800 }
1801 }
1802
1803 /* Run the interval hooks for an insertion on character range START ... END.
1804 verify_interval_modification chose which hooks to run;
1805 this function is called after the insertion happens
1806 so it can indicate the range of inserted text. */
1807
1808 void
1809 report_interval_modification (start, end)
1810 Lisp_Object start, end;
1811 {
1812 if (! NILP (interval_insert_behind_hooks))
1813 call_mod_hooks (interval_insert_behind_hooks, start, end);
1814 if (! NILP (interval_insert_in_front_hooks)
1815 && ! EQ (interval_insert_in_front_hooks,
1816 interval_insert_behind_hooks))
1817 call_mod_hooks (interval_insert_in_front_hooks, start, end);
1818 }
1819 \f
1820 void
1821 syms_of_textprop ()
1822 {
1823 DEFVAR_LISP ("default-text-properties", &Vdefault_text_properties,
1824 "Property-list used as default values.\n\
1825 The value of a property in this list is seen as the value for every\n\
1826 character that does not have its own value for that property.");
1827 Vdefault_text_properties = Qnil;
1828
1829 DEFVAR_LISP ("inhibit-point-motion-hooks", &Vinhibit_point_motion_hooks,
1830 "If non-nil, don't run `point-left' and `point-entered' text properties.\n\
1831 This also inhibits the use of the `intangible' text property.");
1832 Vinhibit_point_motion_hooks = Qnil;
1833
1834 DEFVAR_LISP ("text-property-default-nonsticky",
1835 &Vtext_property_default_nonsticky,
1836 "Alist of properties vs the corresponding non-stickinesses.\n\
1837 Each element has the form (PROPERTY . NONSTICKINESS).\n\
1838 \n\
1839 If a character in a buffer has PROPERTY, new text inserted adjacent to\n\
1840 the character doesn't inherit PROPERTY if NONSTICKINESS is non-nil,\n\
1841 inherits it if NONSTICKINESS is nil. The front-sticky and\n\
1842 rear-nonsticky properties of the character overrides NONSTICKINESS.");
1843 Vtext_property_default_nonsticky = Qnil;
1844
1845 staticpro (&interval_insert_behind_hooks);
1846 staticpro (&interval_insert_in_front_hooks);
1847 interval_insert_behind_hooks = Qnil;
1848 interval_insert_in_front_hooks = Qnil;
1849
1850
1851 /* Common attributes one might give text */
1852
1853 staticpro (&Qforeground);
1854 Qforeground = intern ("foreground");
1855 staticpro (&Qbackground);
1856 Qbackground = intern ("background");
1857 staticpro (&Qfont);
1858 Qfont = intern ("font");
1859 staticpro (&Qstipple);
1860 Qstipple = intern ("stipple");
1861 staticpro (&Qunderline);
1862 Qunderline = intern ("underline");
1863 staticpro (&Qread_only);
1864 Qread_only = intern ("read-only");
1865 staticpro (&Qinvisible);
1866 Qinvisible = intern ("invisible");
1867 staticpro (&Qintangible);
1868 Qintangible = intern ("intangible");
1869 staticpro (&Qcategory);
1870 Qcategory = intern ("category");
1871 staticpro (&Qlocal_map);
1872 Qlocal_map = intern ("local-map");
1873 staticpro (&Qkeymap);
1874 Qkeymap = intern ("keymap");
1875 staticpro (&Qfront_sticky);
1876 Qfront_sticky = intern ("front-sticky");
1877 staticpro (&Qrear_nonsticky);
1878 Qrear_nonsticky = intern ("rear-nonsticky");
1879 staticpro (&Qmouse_face);
1880 Qmouse_face = intern ("mouse-face");
1881
1882 /* Properties that text might use to specify certain actions */
1883
1884 staticpro (&Qmouse_left);
1885 Qmouse_left = intern ("mouse-left");
1886 staticpro (&Qmouse_entered);
1887 Qmouse_entered = intern ("mouse-entered");
1888 staticpro (&Qpoint_left);
1889 Qpoint_left = intern ("point-left");
1890 staticpro (&Qpoint_entered);
1891 Qpoint_entered = intern ("point-entered");
1892
1893 defsubr (&Stext_properties_at);
1894 defsubr (&Sget_text_property);
1895 defsubr (&Sget_char_property);
1896 defsubr (&Snext_char_property_change);
1897 defsubr (&Sprevious_char_property_change);
1898 defsubr (&Snext_property_change);
1899 defsubr (&Snext_single_property_change);
1900 defsubr (&Sprevious_property_change);
1901 defsubr (&Sprevious_single_property_change);
1902 defsubr (&Sadd_text_properties);
1903 defsubr (&Sput_text_property);
1904 defsubr (&Sset_text_properties);
1905 defsubr (&Sremove_text_properties);
1906 defsubr (&Stext_property_any);
1907 defsubr (&Stext_property_not_all);
1908 /* defsubr (&Serase_text_properties); */
1909 /* defsubr (&Scopy_text_properties); */
1910 }
1911