1 /* Lisp functions pertaining to editing.
2 Copyright (C) 1985,86,87,89,93,94,95,96,97,98, 1999 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
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)
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.
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. */
23 #include <sys/types.h>
36 #include "intervals.h"
44 #define min(a, b) ((a) < (b) ? (a) : (b))
45 #define max(a, b) ((a) > (b) ? (a) : (b))
51 extern char **environ
;
52 extern Lisp_Object
make_time ();
53 extern void insert_from_buffer ();
54 static int tm_diff ();
55 static void update_buffer_properties ();
56 size_t emacs_strftimeu ();
57 void set_time_zone_rule ();
59 Lisp_Object Vbuffer_access_fontify_functions
;
60 Lisp_Object Qbuffer_access_fontify_functions
;
61 Lisp_Object Vbuffer_access_fontified_property
;
63 Lisp_Object
Fuser_full_name ();
65 /* Some static data, and a function to initialize it for each run */
67 Lisp_Object Vsystem_name
;
68 Lisp_Object Vuser_real_login_name
; /* login name of current user ID */
69 Lisp_Object Vuser_full_name
; /* full name of current user */
70 Lisp_Object Vuser_login_name
; /* user name from LOGNAME or USER */
76 register unsigned char *p
;
77 struct passwd
*pw
; /* password entry for the current user */
80 /* Set up system_name even when dumping. */
84 /* Don't bother with this on initial start when just dumping out */
87 #endif /* not CANNOT_DUMP */
89 pw
= (struct passwd
*) getpwuid (getuid ());
91 /* We let the real user name default to "root" because that's quite
92 accurate on MSDOG and because it lets Emacs find the init file.
93 (The DVX libraries override the Djgpp libraries here.) */
94 Vuser_real_login_name
= build_string (pw
? pw
->pw_name
: "root");
96 Vuser_real_login_name
= build_string (pw
? pw
->pw_name
: "unknown");
99 /* Get the effective user name, by consulting environment variables,
100 or the effective uid if those are unset. */
101 user_name
= (char *) getenv ("LOGNAME");
104 user_name
= (char *) getenv ("USERNAME"); /* it's USERNAME on NT */
105 #else /* WINDOWSNT */
106 user_name
= (char *) getenv ("USER");
107 #endif /* WINDOWSNT */
110 pw
= (struct passwd
*) getpwuid (geteuid ());
111 user_name
= (char *) (pw
? pw
->pw_name
: "unknown");
113 Vuser_login_name
= build_string (user_name
);
115 /* If the user name claimed in the environment vars differs from
116 the real uid, use the claimed name to find the full name. */
117 tem
= Fstring_equal (Vuser_login_name
, Vuser_real_login_name
);
118 Vuser_full_name
= Fuser_full_name (NILP (tem
)? make_number (geteuid())
121 p
= (unsigned char *) getenv ("NAME");
123 Vuser_full_name
= build_string (p
);
124 else if (NILP (Vuser_full_name
))
125 Vuser_full_name
= build_string ("unknown");
128 DEFUN ("char-to-string", Fchar_to_string
, Schar_to_string
, 1, 1, 0,
129 "Convert arg CHAR to a string containing that character.")
131 Lisp_Object character
;
134 unsigned char workbuf
[4], *str
;
136 CHECK_NUMBER (character
, 0);
138 len
= CHAR_STRING (XFASTINT (character
), workbuf
, str
);
139 return make_string_from_bytes (str
, 1, len
);
142 DEFUN ("string-to-char", Fstring_to_char
, Sstring_to_char
, 1, 1, 0,
143 "Convert arg STRING to a character, the first character of that string.\n\
144 A multibyte character is handled correctly.")
146 register Lisp_Object string
;
148 register Lisp_Object val
;
149 register struct Lisp_String
*p
;
150 CHECK_STRING (string
, 0);
151 p
= XSTRING (string
);
154 if (STRING_MULTIBYTE (string
))
155 XSETFASTINT (val
, STRING_CHAR (p
->data
, STRING_BYTES (p
)));
157 XSETFASTINT (val
, p
->data
[0]);
160 XSETFASTINT (val
, 0);
165 buildmark (charpos
, bytepos
)
166 int charpos
, bytepos
;
168 register Lisp_Object mark
;
169 mark
= Fmake_marker ();
170 set_marker_both (mark
, Qnil
, charpos
, bytepos
);
174 DEFUN ("point", Fpoint
, Spoint
, 0, 0, 0,
175 "Return value of point, as an integer.\n\
176 Beginning of buffer is position (point-min)")
180 XSETFASTINT (temp
, PT
);
184 DEFUN ("point-marker", Fpoint_marker
, Spoint_marker
, 0, 0, 0,
185 "Return value of point, as a marker object.")
188 return buildmark (PT
, PT_BYTE
);
192 clip_to_bounds (lower
, num
, upper
)
193 int lower
, num
, upper
;
197 else if (num
> upper
)
203 DEFUN ("goto-char", Fgoto_char
, Sgoto_char
, 1, 1, "NGoto char: ",
204 "Set point to POSITION, a number or marker.\n\
205 Beginning of buffer is position (point-min), end is (point-max).\n\
206 If the position is in the middle of a multibyte form,\n\
207 the actual point is set at the head of the multibyte form\n\
208 except in the case that `enable-multibyte-characters' is nil.")
210 register Lisp_Object position
;
214 if (MARKERP (position
)
215 && current_buffer
== XMARKER (position
)->buffer
)
217 pos
= marker_position (position
);
219 SET_PT_BOTH (BEGV
, BEGV_BYTE
);
221 SET_PT_BOTH (ZV
, ZV_BYTE
);
223 SET_PT_BOTH (pos
, marker_byte_position (position
));
228 CHECK_NUMBER_COERCE_MARKER (position
, 0);
230 pos
= clip_to_bounds (BEGV
, XINT (position
), ZV
);
236 region_limit (beginningp
)
239 extern Lisp_Object Vmark_even_if_inactive
; /* Defined in callint.c. */
240 register Lisp_Object m
;
241 if (!NILP (Vtransient_mark_mode
) && NILP (Vmark_even_if_inactive
)
242 && NILP (current_buffer
->mark_active
))
243 Fsignal (Qmark_inactive
, Qnil
);
244 m
= Fmarker_position (current_buffer
->mark
);
245 if (NILP (m
)) error ("There is no region now");
246 if ((PT
< XFASTINT (m
)) == beginningp
)
247 return (make_number (PT
));
252 DEFUN ("region-beginning", Fregion_beginning
, Sregion_beginning
, 0, 0, 0,
253 "Return position of beginning of region, as an integer.")
256 return (region_limit (1));
259 DEFUN ("region-end", Fregion_end
, Sregion_end
, 0, 0, 0,
260 "Return position of end of region, as an integer.")
263 return (region_limit (0));
266 DEFUN ("mark-marker", Fmark_marker
, Smark_marker
, 0, 0, 0,
267 "Return this buffer's mark, as a marker object.\n\
268 Watch out! Moving this marker changes the mark position.\n\
269 If you set the marker not to point anywhere, the buffer will have no mark.")
272 return current_buffer
->mark
;
275 /* Returns the position before POS in the current buffer. POS must not
276 be at the beginning of the buffer. */
278 preceding_pos (int pos
)
280 int pos_byte
= CHAR_TO_BYTE (pos
);
282 /* Decrement POS_BYTE (is all this cruft really necessary?). */
283 if (NILP (current_buffer
->enable_multibyte_characters
))
288 return make_number (BYTE_TO_CHAR (pos_byte
));
291 /* Returns true if POS1 and POS2 have the same value for text property PROP. */
293 text_property_eq (prop
, pos1
, pos2
)
295 Lisp_Object pos1
, pos2
;
297 Lisp_Object pval1
, pval2
;
299 pval1
= Fget_text_property (pos1
, prop
, Qnil
);
300 pval2
= Fget_text_property (pos2
, prop
, Qnil
);
302 return EQ (pval1
, pval2
);
305 /* Returns the direction that the text-property PROP would be inherited
306 by any new text inserted at POS: 1 if it would be inherited from POS,
307 -1 if it would be inherited from POS-1, and 0 if from neither. */
309 text_property_stickiness (prop
, pos
)
313 Lisp_Object front_sticky
;
316 /* Consider previous position. */
318 Lisp_Object prev_pos
, rear_non_sticky
;
320 prev_pos
= preceding_pos (pos
);
321 rear_non_sticky
= Fget_text_property (prev_pos
, Qrear_nonsticky
, Qnil
);
323 if (EQ (rear_non_sticky
, Qnil
)
324 || (CONSP (rear_non_sticky
)
325 && !Fmemq (prop
, rear_non_sticky
)))
326 /* PROP is not rear-non-sticky, and since this takes precedence over
327 any front-stickiness, that must be the answer. */
331 /* Consider current position. */
332 front_sticky
= Fget_text_property (pos
, Qfront_sticky
, Qnil
);
334 if (EQ (front_sticky
, Qt
)
335 || (CONSP (front_sticky
)
336 && Fmemq (prop
, front_sticky
)))
337 /* PROP is front-sticky. */
340 /* PROP is not sticky at all. */
344 /* Name for the text property we use to distinguish fields. */
347 /* Returns the field surrounding POS in *BEG and *END; an
348 `field' is a region of text with the same `field' property.
349 If POS is nil, the position of the current buffer's point is used.
350 If MERGE_AT_BOUNDARY is true, then if POS is at the very first
351 position of a field, then the beginning of the previous field
352 is returned instead of the beginning of POS's field (since the end of
353 a field is actually also the beginning of the next input
354 field, this behavior is sometimes useful). BEG or END may be 0, in
355 which case the corresponding value is not returned. */
357 find_field (pos
, merge_at_boundary
, beg
, end
)
359 Lisp_Object merge_at_boundary
;
362 /* If POS is at the edge of a field, then -1 or 1 depending on
363 whether it should be considered as the beginning of the following
364 field, or the end of the previous field, respectively. If POS is
365 not at a field-boundary, then STICKINESS is 0. */
369 XSETFASTINT (pos
, PT
);
371 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
373 if (NILP (merge_at_boundary
) && XFASTINT (pos
) > BEGV
)
374 /* See if we need to handle the case where POS is at beginning of a
375 field, which can also be interpreted as the end of the previous
376 field. We decide which one by seeing which field the `field'
377 property sticks to. The case where if MERGE_AT_BOUNDARY is
378 non-nil (see function comment) is actually the more natural one;
379 then we avoid treating the beginning of a field specially. */
381 /* First see if POS is actually *at* a boundary. */
382 Lisp_Object after_field
, before_field
;
384 after_field
= Fget_text_property (pos
, Qfield
, Qnil
);
385 before_field
= Fget_text_property (preceding_pos (pos
), Qfield
, Qnil
);
387 if (! EQ (after_field
, before_field
))
388 /* We are at a boundary, see which direction is inclusive. */
390 stickiness
= text_property_stickiness (Qfield
, pos
);
393 /* STICKINESS == 0 means that any inserted text will get a
394 `field' text-property of nil, so check to see if that
395 matches either of the adjacent characters (this being a
396 kind of `stickiness by default'). */
398 if (NILP (before_field
))
399 stickiness
= -1; /* Sticks to the left. */
400 else if (NILP (after_field
))
401 stickiness
= 1; /* Sticks to the right. */
409 /* POS is at the edge of a field, and we should consider it as
410 the beginning of the following field. */
411 *beg
= XFASTINT (pos
);
413 /* Find the previous field boundary. */
416 prev
= Fprevious_single_property_change (pos
, Qfield
, Qnil
, Qnil
);
417 *beg
= NILP(prev
) ? BEGV
: XFASTINT (prev
);
424 /* POS is at the edge of a field, and we should consider it as
425 the end of the previous field. */
426 *end
= XFASTINT (pos
);
428 /* Find the next field boundary. */
431 next
= Fnext_single_property_change (pos
, Qfield
, Qnil
, Qnil
);
432 *end
= NILP(next
) ? ZV
: XFASTINT (next
);
437 DEFUN ("erase-field", Ferase_field
, Serase_field
, 0, 1, "d",
438 "Erases the field surrounding POS.\n\
439 A field is a region of text with the same `field' property.\n\
440 If POS is nil, the position of the current buffer's point is used.")
445 find_field (pos
, Qnil
, &beg
, &end
);
447 del_range (beg
, end
);
450 DEFUN ("field-string", Ffield_string
, Sfield_string
, 0, 1, 0,
451 "Return the contents of the field surrounding POS as a string.\n\
452 A field is a region of text with the same `field' property.\n\
453 If POS is nil, the position of the current buffer's point is used.")
458 find_field (pos
, Qnil
, &beg
, &end
);
459 return make_buffer_string (beg
, end
, 1);
462 DEFUN ("field-string-no-properties", Ffield_string_no_properties
, Sfield_string_no_properties
, 0, 1, 0,
463 "Return the contents of the field around POS, without text-properties.\n\
464 A field is a region of text with the same `field' property.\n\
465 If POS is nil, the position of the current buffer's point is used.")
470 find_field (pos
, Qnil
, &beg
, &end
);
471 return make_buffer_string (beg
, end
, 0);
474 DEFUN ("field-beginning", Ffield_beginning
, Sfield_beginning
, 0, 2, 0,
475 "Return the beginning of the field surrounding POS.\n\
476 A field is a region of text with the same `field' property.\n\
477 If POS is nil, the position of the current buffer's point is used.\n\
478 If ESCAPE-FROM-EDGE is non-nil and POS is already at beginning of an\n\
479 field, then the beginning of the *previous* field is returned.")
480 (pos
, escape_from_edge
)
481 Lisp_Object pos
, escape_from_edge
;
484 find_field (pos
, escape_from_edge
, &beg
, 0);
485 return make_number (beg
);
488 DEFUN ("field-end", Ffield_end
, Sfield_end
, 0, 2, 0,
489 "Return the end of the field surrounding POS.\n\
490 A field is a region of text with the same `field' property.\n\
491 If POS is nil, the position of the current buffer's point is used.\n\
492 If ESCAPE-FROM-EDGE is non-nil and POS is already at end of a field,\n\
493 then the end of the *following* field is returned.")
494 (pos
, escape_from_edge
)
495 Lisp_Object pos
, escape_from_edge
;
498 find_field (pos
, escape_from_edge
, 0, &end
);
499 return make_number (end
);
502 DEFUN ("constrain-to-field", Fconstrain_to_field
, Sconstrain_to_field
, 2, 4, 0,
503 "Return the position closest to NEW-POS that is in the same field as OLD-POS.\n\
504 A field is a region of text with the same `field' property.\n\
505 If NEW-POS is nil, then the current point is used instead, and set to the\n\
506 constrained position if that is is different.\n\
508 If OLD-POS is at the boundary of two fields, then the allowable\n\
509 positions for NEW-POS depends on the value of the optional argument\n\
510 ESCAPE-FROM-EDGE: If ESCAPE-FROM-EDGE is nil, then NEW-POS is\n\
511 constrained to the field that has the same `field' text-property\n\
512 as any new characters inserted at OLD-POS, whereas if ESCAPE-FROM-EDGE\n\
513 is non-nil, NEW-POS is constrained to the union of the two adjacent\n\
516 If the optional argument ONLY-IN-LINE is non-nil and constraining\n\
517 NEW-POS would move it to a different line, NEW-POS is returned\n\
518 unconstrained. This useful for commands that move by line, like\n\
519 \\[next-line] or \\[beginning-of-line], which should generally respect field boundaries\n\
520 only in the case where they can still move to the right line.")
521 (new_pos
, old_pos
, escape_from_edge
, only_in_line
)
522 Lisp_Object new_pos
, old_pos
, escape_from_edge
, only_in_line
;
524 /* If non-zero, then the original point, before re-positioning. */
528 /* Use the current point, and afterwards, set it. */
531 XSETFASTINT (new_pos
, PT
);
534 if (!EQ (new_pos
, old_pos
) && !text_property_eq (Qfield
, new_pos
, old_pos
))
535 /* NEW_POS is not within the same field as OLD_POS; try to
536 move NEW_POS so that it is. */
539 Lisp_Object field_bound
;
541 CHECK_NUMBER_COERCE_MARKER (new_pos
, 0);
542 CHECK_NUMBER_COERCE_MARKER (old_pos
, 0);
544 fwd
= (XFASTINT (new_pos
) > XFASTINT (old_pos
));
547 field_bound
= Ffield_end (old_pos
, escape_from_edge
);
549 field_bound
= Ffield_beginning (old_pos
, escape_from_edge
);
551 if (/* If ONLY_IN_LINE is non-nil, we only constrain NEW_POS if doing
552 so would remain within the same line. */
554 /* In that case, see if ESCAPE_FROM_EDGE caused FIELD_BOUND
555 to jump to the other side of NEW_POS, which would mean
556 that NEW_POS is already acceptable, and that we don't
557 have to do the line-check. */
558 || ((XFASTINT (field_bound
) < XFASTINT (new_pos
)) ? !fwd
: fwd
)
559 /* If not, see if there's no newline intervening between
560 NEW_POS and FIELD_BOUND. */
561 || (find_before_next_newline (XFASTINT (new_pos
),
562 XFASTINT (field_bound
),
564 == XFASTINT (field_bound
)))
565 /* Constrain NEW_POS to FIELD_BOUND. */
566 new_pos
= field_bound
;
568 if (orig_point
&& XFASTINT (new_pos
) != orig_point
)
569 /* The NEW_POS argument was originally nil, so automatically set PT. */
570 SET_PT (XFASTINT (new_pos
));
576 DEFUN ("line-beginning-position", Fline_beginning_position
, Sline_beginning_position
,
578 "Return the character position of the first character on the current line.\n\
579 With argument N not nil or 1, move forward N - 1 lines first.\n\
580 If scan reaches end of buffer, return that position.\n\
581 This function does not move point.\n\n\
582 In the minibuffer, if point is not within the prompt,\n\
583 the return value is never within the prompt either.")
588 register int orig
, orig_byte
, end
;
597 Fforward_line (make_number (XINT (n
) - 1));
600 SET_PT_BOTH (orig
, orig_byte
);
602 /* Return END constrained to the current input field. */
603 return Fconstrain_to_field (make_number (end
), make_number (orig
), Qnil
, Qt
);
606 DEFUN ("line-end-position", Fline_end_position
, Sline_end_position
,
608 "Return the character position of the last character on the current line.\n\
609 With argument N not nil or 1, move forward N - 1 lines first.\n\
610 If scan reaches end of buffer, return that position.\n\
611 This function does not move point.")
616 register int orig
= PT
;
623 end_pos
= find_before_next_newline (orig
, 0, XINT (n
) - (XINT (n
) <= 0));
625 /* Return END_POS constrained to the current input field. */
627 Fconstrain_to_field (make_number (end_pos
), make_number (orig
), Qnil
, Qt
);
631 save_excursion_save ()
633 register int visible
= (XBUFFER (XWINDOW (selected_window
)->buffer
)
636 return Fcons (Fpoint_marker (),
637 Fcons (Fcopy_marker (current_buffer
->mark
, Qnil
),
638 Fcons (visible
? Qt
: Qnil
,
639 current_buffer
->mark_active
)));
643 save_excursion_restore (info
)
646 Lisp_Object tem
, tem1
, omark
, nmark
;
647 struct gcpro gcpro1
, gcpro2
, gcpro3
;
649 tem
= Fmarker_buffer (Fcar (info
));
650 /* If buffer being returned to is now deleted, avoid error */
651 /* Otherwise could get error here while unwinding to top level
653 /* In that case, Fmarker_buffer returns nil now. */
657 omark
= nmark
= Qnil
;
658 GCPRO3 (info
, omark
, nmark
);
663 unchain_marker (tem
);
664 tem
= Fcar (Fcdr (info
));
665 omark
= Fmarker_position (current_buffer
->mark
);
666 Fset_marker (current_buffer
->mark
, tem
, Fcurrent_buffer ());
667 nmark
= Fmarker_position (tem
);
668 unchain_marker (tem
);
669 tem
= Fcdr (Fcdr (info
));
670 #if 0 /* We used to make the current buffer visible in the selected window
671 if that was true previously. That avoids some anomalies.
672 But it creates others, and it wasn't documented, and it is simpler
673 and cleaner never to alter the window/buffer connections. */
676 && current_buffer
!= XBUFFER (XWINDOW (selected_window
)->buffer
))
677 Fswitch_to_buffer (Fcurrent_buffer (), Qnil
);
680 tem1
= current_buffer
->mark_active
;
681 current_buffer
->mark_active
= Fcdr (tem
);
682 if (!NILP (Vrun_hooks
))
684 /* If mark is active now, and either was not active
685 or was at a different place, run the activate hook. */
686 if (! NILP (current_buffer
->mark_active
))
688 if (! EQ (omark
, nmark
))
689 call1 (Vrun_hooks
, intern ("activate-mark-hook"));
691 /* If mark has ceased to be active, run deactivate hook. */
692 else if (! NILP (tem1
))
693 call1 (Vrun_hooks
, intern ("deactivate-mark-hook"));
699 DEFUN ("save-excursion", Fsave_excursion
, Ssave_excursion
, 0, UNEVALLED
, 0,
700 "Save point, mark, and current buffer; execute BODY; restore those things.\n\
701 Executes BODY just like `progn'.\n\
702 The values of point, mark and the current buffer are restored\n\
703 even in case of abnormal exit (throw or error).\n\
704 The state of activation of the mark is also restored.\n\
706 This construct does not save `deactivate-mark', and therefore\n\
707 functions that change the buffer will still cause deactivation\n\
708 of the mark at the end of the command. To prevent that, bind\n\
709 `deactivate-mark' with `let'.")
713 register Lisp_Object val
;
714 int count
= specpdl_ptr
- specpdl
;
716 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
719 return unbind_to (count
, val
);
722 DEFUN ("save-current-buffer", Fsave_current_buffer
, Ssave_current_buffer
, 0, UNEVALLED
, 0,
723 "Save the current buffer; execute BODY; restore the current buffer.\n\
724 Executes BODY just like `progn'.")
728 register Lisp_Object val
;
729 int count
= specpdl_ptr
- specpdl
;
731 record_unwind_protect (set_buffer_if_live
, Fcurrent_buffer ());
734 return unbind_to (count
, val
);
737 DEFUN ("buffer-size", Fbufsize
, Sbufsize
, 0, 1, 0,
738 "Return the number of characters in the current buffer.\n\
739 If BUFFER, return the number of characters in that buffer instead.")
744 return make_number (Z
- BEG
);
747 CHECK_BUFFER (buffer
, 1);
748 return make_number (BUF_Z (XBUFFER (buffer
))
749 - BUF_BEG (XBUFFER (buffer
)));
753 DEFUN ("point-min", Fpoint_min
, Spoint_min
, 0, 0, 0,
754 "Return the minimum permissible value of point in the current buffer.\n\
755 This is 1, unless narrowing (a buffer restriction) is in effect.")
759 XSETFASTINT (temp
, BEGV
);
763 DEFUN ("point-min-marker", Fpoint_min_marker
, Spoint_min_marker
, 0, 0, 0,
764 "Return a marker to the minimum permissible value of point in this buffer.\n\
765 This is the beginning, unless narrowing (a buffer restriction) is in effect.")
768 return buildmark (BEGV
, BEGV_BYTE
);
771 DEFUN ("point-max", Fpoint_max
, Spoint_max
, 0, 0, 0,
772 "Return the maximum permissible value of point in the current buffer.\n\
773 This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
774 is in effect, in which case it is less.")
778 XSETFASTINT (temp
, ZV
);
782 DEFUN ("point-max-marker", Fpoint_max_marker
, Spoint_max_marker
, 0, 0, 0,
783 "Return a marker to the maximum permissible value of point in this buffer.\n\
784 This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
785 is in effect, in which case it is less.")
788 return buildmark (ZV
, ZV_BYTE
);
791 DEFUN ("gap-position", Fgap_position
, Sgap_position
, 0, 0, 0,
792 "Return the position of the gap, in the current buffer.\n\
793 See also `gap-size'.")
797 XSETFASTINT (temp
, GPT
);
801 DEFUN ("gap-size", Fgap_size
, Sgap_size
, 0, 0, 0,
802 "Return the size of the current buffer's gap.\n\
803 See also `gap-position'.")
807 XSETFASTINT (temp
, GAP_SIZE
);
811 DEFUN ("position-bytes", Fposition_bytes
, Sposition_bytes
, 1, 1, 0,
812 "Return the byte position for character position POSITION.\n\
813 If POSITION is out of range, the value is nil.")
815 Lisp_Object position
;
817 CHECK_NUMBER_COERCE_MARKER (position
, 1);
818 if (XINT (position
) < BEG
|| XINT (position
) > Z
)
820 return make_number (CHAR_TO_BYTE (XINT (position
)));
823 DEFUN ("byte-to-position", Fbyte_to_position
, Sbyte_to_position
, 1, 1, 0,
824 "Return the character position for byte position BYTEPOS.\n\
825 If BYTEPOS is out of range, the value is nil.")
829 CHECK_NUMBER (bytepos
, 1);
830 if (XINT (bytepos
) < BEG_BYTE
|| XINT (bytepos
) > Z_BYTE
)
832 return make_number (BYTE_TO_CHAR (XINT (bytepos
)));
835 DEFUN ("following-char", Ffollowing_char
, Sfollowing_char
, 0, 0, 0,
836 "Return the character following point, as a number.\n\
837 At the end of the buffer or accessible region, return 0.\n\
838 If `enable-multibyte-characters' is nil or point is not\n\
839 at character boundary, multibyte form is ignored,\n\
840 and only one byte following point is returned as a character.")
845 XSETFASTINT (temp
, 0);
847 XSETFASTINT (temp
, FETCH_CHAR (PT_BYTE
));
851 DEFUN ("preceding-char", Fprevious_char
, Sprevious_char
, 0, 0, 0,
852 "Return the character preceding point, as a number.\n\
853 At the beginning of the buffer or accessible region, return 0.\n\
854 If `enable-multibyte-characters' is nil or point is not\n\
855 at character boundary, multi-byte form is ignored,\n\
856 and only one byte preceding point is returned as a character.")
861 XSETFASTINT (temp
, 0);
862 else if (!NILP (current_buffer
->enable_multibyte_characters
))
866 XSETFASTINT (temp
, FETCH_CHAR (pos
));
869 XSETFASTINT (temp
, FETCH_BYTE (PT_BYTE
- 1));
873 DEFUN ("bobp", Fbobp
, Sbobp
, 0, 0, 0,
874 "Return t if point is at the beginning of the buffer.\n\
875 If the buffer is narrowed, this means the beginning of the narrowed part.")
883 DEFUN ("eobp", Feobp
, Seobp
, 0, 0, 0,
884 "Return t if point is at the end of the buffer.\n\
885 If the buffer is narrowed, this means the end of the narrowed part.")
893 DEFUN ("bolp", Fbolp
, Sbolp
, 0, 0, 0,
894 "Return t if point is at the beginning of a line.")
897 if (PT
== BEGV
|| FETCH_BYTE (PT_BYTE
- 1) == '\n')
902 DEFUN ("eolp", Feolp
, Seolp
, 0, 0, 0,
903 "Return t if point is at the end of a line.\n\
904 `End of a line' includes point being at the end of the buffer.")
907 if (PT
== ZV
|| FETCH_BYTE (PT_BYTE
) == '\n')
912 DEFUN ("char-after", Fchar_after
, Schar_after
, 0, 1, 0,
913 "Return character in current buffer at position POS.\n\
914 POS is an integer or a buffer pointer.\n\
915 If POS is out of range, the value is nil.")
919 register int pos_byte
;
924 XSETFASTINT (pos
, PT
);
929 pos_byte
= marker_byte_position (pos
);
930 if (pos_byte
< BEGV_BYTE
|| pos_byte
>= ZV_BYTE
)
935 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
936 if (XINT (pos
) < BEGV
|| XINT (pos
) >= ZV
)
939 pos_byte
= CHAR_TO_BYTE (XINT (pos
));
942 return make_number (FETCH_CHAR (pos_byte
));
945 DEFUN ("char-before", Fchar_before
, Schar_before
, 0, 1, 0,
946 "Return character in current buffer preceding position POS.\n\
947 POS is an integer or a buffer pointer.\n\
948 If POS is out of range, the value is nil.")
952 register Lisp_Object val
;
953 register int pos_byte
;
958 XSETFASTINT (pos
, PT
);
963 pos_byte
= marker_byte_position (pos
);
965 if (pos_byte
<= BEGV_BYTE
|| pos_byte
> ZV_BYTE
)
970 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
972 if (XINT (pos
) <= BEGV
|| XINT (pos
) > ZV
)
975 pos_byte
= CHAR_TO_BYTE (XINT (pos
));
978 if (!NILP (current_buffer
->enable_multibyte_characters
))
981 XSETFASTINT (val
, FETCH_CHAR (pos_byte
));
986 XSETFASTINT (val
, FETCH_BYTE (pos_byte
));
991 DEFUN ("user-login-name", Fuser_login_name
, Suser_login_name
, 0, 1, 0,
992 "Return the name under which the user logged in, as a string.\n\
993 This is based on the effective uid, not the real uid.\n\
994 Also, if the environment variable LOGNAME or USER is set,\n\
995 that determines the value of this function.\n\n\
996 If optional argument UID is an integer, return the login name of the user\n\
997 with that uid, or nil if there is no such user.")
1003 /* Set up the user name info if we didn't do it before.
1004 (That can happen if Emacs is dumpable
1005 but you decide to run `temacs -l loadup' and not dump. */
1006 if (INTEGERP (Vuser_login_name
))
1010 return Vuser_login_name
;
1012 CHECK_NUMBER (uid
, 0);
1013 pw
= (struct passwd
*) getpwuid (XINT (uid
));
1014 return (pw
? build_string (pw
->pw_name
) : Qnil
);
1017 DEFUN ("user-real-login-name", Fuser_real_login_name
, Suser_real_login_name
,
1019 "Return the name of the user's real uid, as a string.\n\
1020 This ignores the environment variables LOGNAME and USER, so it differs from\n\
1021 `user-login-name' when running under `su'.")
1024 /* Set up the user name info if we didn't do it before.
1025 (That can happen if Emacs is dumpable
1026 but you decide to run `temacs -l loadup' and not dump. */
1027 if (INTEGERP (Vuser_login_name
))
1029 return Vuser_real_login_name
;
1032 DEFUN ("user-uid", Fuser_uid
, Suser_uid
, 0, 0, 0,
1033 "Return the effective uid of Emacs, as an integer.")
1036 return make_number (geteuid ());
1039 DEFUN ("user-real-uid", Fuser_real_uid
, Suser_real_uid
, 0, 0, 0,
1040 "Return the real uid of Emacs, as an integer.")
1043 return make_number (getuid ());
1046 DEFUN ("user-full-name", Fuser_full_name
, Suser_full_name
, 0, 1, 0,
1047 "Return the full name of the user logged in, as a string.\n\
1048 If the full name corresponding to Emacs's userid is not known,\n\
1049 return \"unknown\".\n\
1051 If optional argument UID is an integer, return the full name of the user\n\
1052 with that uid, or nil if there is no such user.\n\
1053 If UID is a string, return the full name of the user with that login\n\
1054 name, or nil if there is no such user.")
1059 register unsigned char *p
, *q
;
1060 extern char *index ();
1064 return Vuser_full_name
;
1065 else if (NUMBERP (uid
))
1066 pw
= (struct passwd
*) getpwuid (XINT (uid
));
1067 else if (STRINGP (uid
))
1068 pw
= (struct passwd
*) getpwnam (XSTRING (uid
)->data
);
1070 error ("Invalid UID specification");
1075 p
= (unsigned char *) USER_FULL_NAME
;
1076 /* Chop off everything after the first comma. */
1077 q
= (unsigned char *) index (p
, ',');
1078 full
= make_string (p
, q
? q
- p
: strlen (p
));
1080 #ifdef AMPERSAND_FULL_NAME
1081 p
= XSTRING (full
)->data
;
1082 q
= (unsigned char *) index (p
, '&');
1083 /* Substitute the login name for the &, upcasing the first character. */
1086 register unsigned char *r
;
1089 login
= Fuser_login_name (make_number (pw
->pw_uid
));
1090 r
= (unsigned char *) alloca (strlen (p
) + XSTRING (login
)->size
+ 1);
1091 bcopy (p
, r
, q
- p
);
1093 strcat (r
, XSTRING (login
)->data
);
1094 r
[q
- p
] = UPCASE (r
[q
- p
]);
1096 full
= build_string (r
);
1098 #endif /* AMPERSAND_FULL_NAME */
1103 DEFUN ("system-name", Fsystem_name
, Ssystem_name
, 0, 0, 0,
1104 "Return the name of the machine you are running on, as a string.")
1107 return Vsystem_name
;
1110 /* For the benefit of callers who don't want to include lisp.h */
1114 if (STRINGP (Vsystem_name
))
1115 return (char *) XSTRING (Vsystem_name
)->data
;
1120 DEFUN ("emacs-pid", Femacs_pid
, Semacs_pid
, 0, 0, 0,
1121 "Return the process ID of Emacs, as an integer.")
1124 return make_number (getpid ());
1127 DEFUN ("current-time", Fcurrent_time
, Scurrent_time
, 0, 0, 0,
1128 "Return the current time, as the number of seconds since 1970-01-01 00:00:00.\n\
1129 The time is returned as a list of three integers. The first has the\n\
1130 most significant 16 bits of the seconds, while the second has the\n\
1131 least significant 16 bits. The third integer gives the microsecond\n\
1134 The microsecond count is zero on systems that do not provide\n\
1135 resolution finer than a second.")
1139 Lisp_Object result
[3];
1142 XSETINT (result
[0], (EMACS_SECS (t
) >> 16) & 0xffff);
1143 XSETINT (result
[1], (EMACS_SECS (t
) >> 0) & 0xffff);
1144 XSETINT (result
[2], EMACS_USECS (t
));
1146 return Flist (3, result
);
1151 lisp_time_argument (specified_time
, result
)
1152 Lisp_Object specified_time
;
1155 if (NILP (specified_time
))
1156 return time (result
) != -1;
1159 Lisp_Object high
, low
;
1160 high
= Fcar (specified_time
);
1161 CHECK_NUMBER (high
, 0);
1162 low
= Fcdr (specified_time
);
1165 CHECK_NUMBER (low
, 0);
1166 *result
= (XINT (high
) << 16) + (XINT (low
) & 0xffff);
1167 return *result
>> 16 == XINT (high
);
1171 /* Write information into buffer S of size MAXSIZE, according to the
1172 FORMAT of length FORMAT_LEN, using time information taken from *TP.
1173 Default to Universal Time if UT is nonzero, local time otherwise.
1174 Return the number of bytes written, not including the terminating
1175 '\0'. If S is NULL, nothing will be written anywhere; so to
1176 determine how many bytes would be written, use NULL for S and
1177 ((size_t) -1) for MAXSIZE.
1179 This function behaves like emacs_strftimeu, except it allows null
1182 emacs_memftimeu (s
, maxsize
, format
, format_len
, tp
, ut
)
1187 const struct tm
*tp
;
1192 /* Loop through all the null-terminated strings in the format
1193 argument. Normally there's just one null-terminated string, but
1194 there can be arbitrarily many, concatenated together, if the
1195 format contains '\0' bytes. emacs_strftimeu stops at the first
1196 '\0' byte so we must invoke it separately for each such string. */
1205 result
= emacs_strftimeu (s
, maxsize
, format
, tp
, ut
);
1209 if (result
== 0 && s
[0] != '\0')
1214 maxsize
-= result
+ 1;
1216 len
= strlen (format
);
1217 if (len
== format_len
)
1221 format_len
-= len
+ 1;
1226 DEFUN ("format-time-string", Fformat_time_string, Sformat_time_string, 1, 3, 0,
1227 "Use FORMAT-STRING to format the time TIME, or now if omitted.\n\
1228 TIME is specified as (HIGH LOW . IGNORED) or (HIGH . LOW), as returned by\n\
1229 `current-time' or `file-attributes'.\n\
1230 The third, optional, argument UNIVERSAL, if non-nil, means describe TIME\n\
1231 as Universal Time; nil means describe TIME in the local time zone.\n\
1232 The value is a copy of FORMAT-STRING, but with certain constructs replaced\n\
1233 by text that describes the specified date and time in TIME:\n\
1235 %Y is the year, %y within the century, %C the century.\n\
1236 %G is the year corresponding to the ISO week, %g within the century.\n\
1237 %m is the numeric month.\n\
1238 %b and %h are the locale's abbreviated month name, %B the full name.\n\
1239 %d is the day of the month, zero-padded, %e is blank-padded.\n\
1240 %u is the numeric day of week from 1 (Monday) to 7, %w from 0 (Sunday) to 6.\n\
1241 %a is the locale's abbreviated name of the day of week, %A the full name.\n\
1242 %U is the week number starting on Sunday, %W starting on Monday,\n\
1243 %V according to ISO 8601.\n\
1244 %j is the day of the year.\n\
1246 %H is the hour on a 24-hour clock, %I is on a 12-hour clock, %k is like %H\n\
1247 only blank-padded, %l is like %I blank-padded.\n\
1248 %p is the locale's equivalent of either AM or PM.\n\
1249 %M is the minute.\n\
1250 %S is the second.\n\
1251 %Z is the time zone name, %z is the numeric form.\n\
1252 %s is the number of seconds since 1970-01-01 00:00:00 +0000.\n\
1254 %c is the locale's date and time format.\n\
1255 %x is the locale's \"preferred\" date format.\n\
1256 %D is like \"%m/%d/%y\".\n\
1258 %R is like \"%H:%M\", %T is like \"%H:%M:%S\", %r is like \"%I:%M:%S %p\".\n\
1259 %X is the locale's \"preferred\" time format.\n\
1261 Finally, %n is a newline, %t is a tab, %% is a literal %.\n\
1263 Certain flags and modifiers are available with some format controls.\n\
1264 The flags are `_' and `-'. For certain characters X, %_X is like %X,\n\
1265 but padded with blanks; %-X is like %X, but without padding.\n\
1266 %NX (where N stands for an integer) is like %X,\n\
1267 but takes up at least N (a number) positions.\n\
1268 The modifiers are `E' and `O'. For certain characters X,\n\
1269 %EX is a locale's alternative version of %X;\n\
1270 %OX is like %X, but uses the locale's number symbols.\n\
1272 For example, to produce full ISO 8601 format, use \"%Y-%m-%dT%T%z\".")
1273 (format_string, time, universal)
1276 DEFUN ("format-time-string", Fformat_time_string
, Sformat_time_string
, 1, 3, 0,
1277 0 /* See immediately above */)
1278 (format_string
, time
, universal
)
1279 Lisp_Object format_string
, time
, universal
;
1284 int ut
= ! NILP (universal
);
1286 CHECK_STRING (format_string
, 1);
1288 if (! lisp_time_argument (time
, &value
))
1289 error ("Invalid time specification");
1291 format_string
= code_convert_string_norecord (format_string
,
1292 Vlocale_coding_system
, 1);
1294 /* This is probably enough. */
1295 size
= STRING_BYTES (XSTRING (format_string
)) * 6 + 50;
1297 tm
= ut
? gmtime (&value
) : localtime (&value
);
1299 error ("Specified time is not representable");
1301 synchronize_time_locale ();
1305 char *buf
= (char *) alloca (size
+ 1);
1309 result
= emacs_memftimeu (buf
, size
, XSTRING (format_string
)->data
,
1310 STRING_BYTES (XSTRING (format_string
)),
1312 if ((result
> 0 && result
< size
) || (result
== 0 && buf
[0] == '\0'))
1313 return code_convert_string_norecord (make_string (buf
, result
),
1314 Vlocale_coding_system
, 0);
1316 /* If buffer was too small, make it bigger and try again. */
1317 result
= emacs_memftimeu (NULL
, (size_t) -1,
1318 XSTRING (format_string
)->data
,
1319 STRING_BYTES (XSTRING (format_string
)),
1325 DEFUN ("decode-time", Fdecode_time
, Sdecode_time
, 0, 1, 0,
1326 "Decode a time value as (SEC MINUTE HOUR DAY MONTH YEAR DOW DST ZONE).\n\
1327 The optional SPECIFIED-TIME should be a list of (HIGH LOW . IGNORED)\n\
1328 or (HIGH . LOW), as from `current-time' and `file-attributes', or `nil'\n\
1329 to use the current time. The list has the following nine members:\n\
1330 SEC is an integer between 0 and 60; SEC is 60 for a leap second, which\n\
1331 only some operating systems support. MINUTE is an integer between 0 and 59.\n\
1332 HOUR is an integer between 0 and 23. DAY is an integer between 1 and 31.\n\
1333 MONTH is an integer between 1 and 12. YEAR is an integer indicating the\n\
1334 four-digit year. DOW is the day of week, an integer between 0 and 6, where\n\
1335 0 is Sunday. DST is t if daylight savings time is effect, otherwise nil.\n\
1336 ZONE is an integer indicating the number of seconds east of Greenwich.\n\
1337 \(Note that Common Lisp has different meanings for DOW and ZONE.)")
1339 Lisp_Object specified_time
;
1343 struct tm
*decoded_time
;
1344 Lisp_Object list_args
[9];
1346 if (! lisp_time_argument (specified_time
, &time_spec
))
1347 error ("Invalid time specification");
1349 decoded_time
= localtime (&time_spec
);
1351 error ("Specified time is not representable");
1352 XSETFASTINT (list_args
[0], decoded_time
->tm_sec
);
1353 XSETFASTINT (list_args
[1], decoded_time
->tm_min
);
1354 XSETFASTINT (list_args
[2], decoded_time
->tm_hour
);
1355 XSETFASTINT (list_args
[3], decoded_time
->tm_mday
);
1356 XSETFASTINT (list_args
[4], decoded_time
->tm_mon
+ 1);
1357 XSETINT (list_args
[5], decoded_time
->tm_year
+ 1900);
1358 XSETFASTINT (list_args
[6], decoded_time
->tm_wday
);
1359 list_args
[7] = (decoded_time
->tm_isdst
)? Qt
: Qnil
;
1361 /* Make a copy, in case gmtime modifies the struct. */
1362 save_tm
= *decoded_time
;
1363 decoded_time
= gmtime (&time_spec
);
1364 if (decoded_time
== 0)
1365 list_args
[8] = Qnil
;
1367 XSETINT (list_args
[8], tm_diff (&save_tm
, decoded_time
));
1368 return Flist (9, list_args
);
1371 DEFUN ("encode-time", Fencode_time
, Sencode_time
, 6, MANY
, 0,
1372 "Convert SECOND, MINUTE, HOUR, DAY, MONTH, YEAR and ZONE to internal time.\n\
1373 This is the reverse operation of `decode-time', which see.\n\
1374 ZONE defaults to the current time zone rule. This can\n\
1375 be a string or t (as from `set-time-zone-rule'), or it can be a list\n\
1376 \(as from `current-time-zone') or an integer (as from `decode-time')\n\
1377 applied without consideration for daylight savings time.\n\
1379 You can pass more than 7 arguments; then the first six arguments\n\
1380 are used as SECOND through YEAR, and the *last* argument is used as ZONE.\n\
1381 The intervening arguments are ignored.\n\
1382 This feature lets (apply 'encode-time (decode-time ...)) work.\n\
1384 Out-of-range values for SEC, MINUTE, HOUR, DAY, or MONTH are allowed;\n\
1385 for example, a DAY of 0 means the day preceding the given month.\n\
1386 Year numbers less than 100 are treated just like other year numbers.\n\
1387 If you want them to stand for years in this century, you must do that yourself.")
1390 register Lisp_Object
*args
;
1394 Lisp_Object zone
= (nargs
> 6 ? args
[nargs
- 1] : Qnil
);
1396 CHECK_NUMBER (args
[0], 0); /* second */
1397 CHECK_NUMBER (args
[1], 1); /* minute */
1398 CHECK_NUMBER (args
[2], 2); /* hour */
1399 CHECK_NUMBER (args
[3], 3); /* day */
1400 CHECK_NUMBER (args
[4], 4); /* month */
1401 CHECK_NUMBER (args
[5], 5); /* year */
1403 tm
.tm_sec
= XINT (args
[0]);
1404 tm
.tm_min
= XINT (args
[1]);
1405 tm
.tm_hour
= XINT (args
[2]);
1406 tm
.tm_mday
= XINT (args
[3]);
1407 tm
.tm_mon
= XINT (args
[4]) - 1;
1408 tm
.tm_year
= XINT (args
[5]) - 1900;
1414 time
= mktime (&tm
);
1419 char **oldenv
= environ
, **newenv
;
1423 else if (STRINGP (zone
))
1424 tzstring
= (char *) XSTRING (zone
)->data
;
1425 else if (INTEGERP (zone
))
1427 int abszone
= abs (XINT (zone
));
1428 sprintf (tzbuf
, "XXX%s%d:%02d:%02d", "-" + (XINT (zone
) < 0),
1429 abszone
/ (60*60), (abszone
/60) % 60, abszone
% 60);
1433 error ("Invalid time zone specification");
1435 /* Set TZ before calling mktime; merely adjusting mktime's returned
1436 value doesn't suffice, since that would mishandle leap seconds. */
1437 set_time_zone_rule (tzstring
);
1439 time
= mktime (&tm
);
1441 /* Restore TZ to previous value. */
1445 #ifdef LOCALTIME_CACHE
1450 if (time
== (time_t) -1)
1451 error ("Specified time is not representable");
1453 return make_time (time
);
1456 DEFUN ("current-time-string", Fcurrent_time_string
, Scurrent_time_string
, 0, 1, 0,
1457 "Return the current time, as a human-readable string.\n\
1458 Programs can use this function to decode a time,\n\
1459 since the number of columns in each field is fixed.\n\
1460 The format is `Sun Sep 16 01:03:52 1973'.\n\
1461 However, see also the functions `decode-time' and `format-time-string'\n\
1462 which provide a much more powerful and general facility.\n\
1464 If an argument is given, it specifies a time to format\n\
1465 instead of the current time. The argument should have the form:\n\
1468 (HIGH LOW . IGNORED).\n\
1469 Thus, you can use times obtained from `current-time'\n\
1470 and from `file-attributes'.")
1472 Lisp_Object specified_time
;
1478 if (! lisp_time_argument (specified_time
, &value
))
1480 tem
= (char *) ctime (&value
);
1482 strncpy (buf
, tem
, 24);
1485 return build_string (buf
);
1488 #define TM_YEAR_BASE 1900
1490 /* Yield A - B, measured in seconds.
1491 This function is copied from the GNU C Library. */
1496 /* Compute intervening leap days correctly even if year is negative.
1497 Take care to avoid int overflow in leap day calculations,
1498 but it's OK to assume that A and B are close to each other. */
1499 int a4
= (a
->tm_year
>> 2) + (TM_YEAR_BASE
>> 2) - ! (a
->tm_year
& 3);
1500 int b4
= (b
->tm_year
>> 2) + (TM_YEAR_BASE
>> 2) - ! (b
->tm_year
& 3);
1501 int a100
= a4
/ 25 - (a4
% 25 < 0);
1502 int b100
= b4
/ 25 - (b4
% 25 < 0);
1503 int a400
= a100
>> 2;
1504 int b400
= b100
>> 2;
1505 int intervening_leap_days
= (a4
- b4
) - (a100
- b100
) + (a400
- b400
);
1506 int years
= a
->tm_year
- b
->tm_year
;
1507 int days
= (365 * years
+ intervening_leap_days
1508 + (a
->tm_yday
- b
->tm_yday
));
1509 return (60 * (60 * (24 * days
+ (a
->tm_hour
- b
->tm_hour
))
1510 + (a
->tm_min
- b
->tm_min
))
1511 + (a
->tm_sec
- b
->tm_sec
));
1514 DEFUN ("current-time-zone", Fcurrent_time_zone
, Scurrent_time_zone
, 0, 1, 0,
1515 "Return the offset and name for the local time zone.\n\
1516 This returns a list of the form (OFFSET NAME).\n\
1517 OFFSET is an integer number of seconds ahead of UTC (east of Greenwich).\n\
1518 A negative value means west of Greenwich.\n\
1519 NAME is a string giving the name of the time zone.\n\
1520 If an argument is given, it specifies when the time zone offset is determined\n\
1521 instead of using the current time. The argument should have the form:\n\
1524 (HIGH LOW . IGNORED).\n\
1525 Thus, you can use times obtained from `current-time'\n\
1526 and from `file-attributes'.\n\
1528 Some operating systems cannot provide all this information to Emacs;\n\
1529 in this case, `current-time-zone' returns a list containing nil for\n\
1530 the data it can't find.")
1532 Lisp_Object specified_time
;
1538 if (lisp_time_argument (specified_time
, &value
)
1539 && (t
= gmtime (&value
)) != 0
1540 && (gmt
= *t
, t
= localtime (&value
)) != 0)
1542 int offset
= tm_diff (t
, &gmt
);
1547 s
= (char *)t
->tm_zone
;
1548 #else /* not HAVE_TM_ZONE */
1550 if (t
->tm_isdst
== 0 || t
->tm_isdst
== 1)
1551 s
= tzname
[t
->tm_isdst
];
1553 #endif /* not HAVE_TM_ZONE */
1556 /* No local time zone name is available; use "+-NNNN" instead. */
1557 int am
= (offset
< 0 ? -offset
: offset
) / 60;
1558 sprintf (buf
, "%c%02d%02d", (offset
< 0 ? '-' : '+'), am
/60, am
%60);
1561 return Fcons (make_number (offset
), Fcons (build_string (s
), Qnil
));
1564 return Fmake_list (make_number (2), Qnil
);
1567 /* This holds the value of `environ' produced by the previous
1568 call to Fset_time_zone_rule, or 0 if Fset_time_zone_rule
1569 has never been called. */
1570 static char **environbuf
;
1572 DEFUN ("set-time-zone-rule", Fset_time_zone_rule
, Sset_time_zone_rule
, 1, 1, 0,
1573 "Set the local time zone using TZ, a string specifying a time zone rule.\n\
1574 If TZ is nil, use implementation-defined default time zone information.\n\
1575 If TZ is t, use Universal Time.")
1583 else if (EQ (tz
, Qt
))
1587 CHECK_STRING (tz
, 0);
1588 tzstring
= (char *) XSTRING (tz
)->data
;
1591 set_time_zone_rule (tzstring
);
1594 environbuf
= environ
;
1599 #ifdef LOCALTIME_CACHE
1601 /* These two values are known to load tz files in buggy implementations,
1602 i.e. Solaris 1 executables running under either Solaris 1 or Solaris 2.
1603 Their values shouldn't matter in non-buggy implementations.
1604 We don't use string literals for these strings,
1605 since if a string in the environment is in readonly
1606 storage, it runs afoul of bugs in SVR4 and Solaris 2.3.
1607 See Sun bugs 1113095 and 1114114, ``Timezone routines
1608 improperly modify environment''. */
1610 static char set_time_zone_rule_tz1
[] = "TZ=GMT+0";
1611 static char set_time_zone_rule_tz2
[] = "TZ=GMT+1";
1615 /* Set the local time zone rule to TZSTRING.
1616 This allocates memory into `environ', which it is the caller's
1617 responsibility to free. */
1619 set_time_zone_rule (tzstring
)
1623 char **from
, **to
, **newenv
;
1625 /* Make the ENVIRON vector longer with room for TZSTRING. */
1626 for (from
= environ
; *from
; from
++)
1628 envptrs
= from
- environ
+ 2;
1629 newenv
= to
= (char **) xmalloc (envptrs
* sizeof (char *)
1630 + (tzstring
? strlen (tzstring
) + 4 : 0));
1632 /* Add TZSTRING to the end of environ, as a value for TZ. */
1635 char *t
= (char *) (to
+ envptrs
);
1637 strcat (t
, tzstring
);
1641 /* Copy the old environ vector elements into NEWENV,
1642 but don't copy the TZ variable.
1643 So we have only one definition of TZ, which came from TZSTRING. */
1644 for (from
= environ
; *from
; from
++)
1645 if (strncmp (*from
, "TZ=", 3) != 0)
1651 /* If we do have a TZSTRING, NEWENV points to the vector slot where
1652 the TZ variable is stored. If we do not have a TZSTRING,
1653 TO points to the vector slot which has the terminating null. */
1655 #ifdef LOCALTIME_CACHE
1657 /* In SunOS 4.1.3_U1 and 4.1.4, if TZ has a value like
1658 "US/Pacific" that loads a tz file, then changes to a value like
1659 "XXX0" that does not load a tz file, and then changes back to
1660 its original value, the last change is (incorrectly) ignored.
1661 Also, if TZ changes twice in succession to values that do
1662 not load a tz file, tzset can dump core (see Sun bug#1225179).
1663 The following code works around these bugs. */
1667 /* Temporarily set TZ to a value that loads a tz file
1668 and that differs from tzstring. */
1670 *newenv
= (strcmp (tzstring
, set_time_zone_rule_tz1
+ 3) == 0
1671 ? set_time_zone_rule_tz2
: set_time_zone_rule_tz1
);
1677 /* The implied tzstring is unknown, so temporarily set TZ to
1678 two different values that each load a tz file. */
1679 *to
= set_time_zone_rule_tz1
;
1682 *to
= set_time_zone_rule_tz2
;
1687 /* Now TZ has the desired value, and tzset can be invoked safely. */
1694 /* Insert NARGS Lisp objects in the array ARGS by calling INSERT_FUNC
1695 (if a type of object is Lisp_Int) or INSERT_FROM_STRING_FUNC (if a
1696 type of object is Lisp_String). INHERIT is passed to
1697 INSERT_FROM_STRING_FUNC as the last argument. */
1700 general_insert_function (insert_func
, insert_from_string_func
,
1701 inherit
, nargs
, args
)
1702 void (*insert_func
) P_ ((unsigned char *, int));
1703 void (*insert_from_string_func
) P_ ((Lisp_Object
, int, int, int, int, int));
1705 register Lisp_Object
*args
;
1707 register int argnum
;
1708 register Lisp_Object val
;
1710 for (argnum
= 0; argnum
< nargs
; argnum
++)
1716 unsigned char workbuf
[4], *str
;
1719 if (!NILP (current_buffer
->enable_multibyte_characters
))
1720 len
= CHAR_STRING (XFASTINT (val
), workbuf
, str
);
1723 workbuf
[0] = (SINGLE_BYTE_CHAR_P (XINT (val
))
1725 : multibyte_char_to_unibyte (XINT (val
), Qnil
));
1729 (*insert_func
) (str
, len
);
1731 else if (STRINGP (val
))
1733 (*insert_from_string_func
) (val
, 0, 0,
1734 XSTRING (val
)->size
,
1735 STRING_BYTES (XSTRING (val
)),
1740 val
= wrong_type_argument (Qchar_or_string_p
, val
);
1754 /* Callers passing one argument to Finsert need not gcpro the
1755 argument "array", since the only element of the array will
1756 not be used after calling insert or insert_from_string, so
1757 we don't care if it gets trashed. */
1759 DEFUN ("insert", Finsert
, Sinsert
, 0, MANY
, 0,
1760 "Insert the arguments, either strings or characters, at point.\n\
1761 Point and before-insertion markers move forward to end up\n\
1762 after the inserted text.\n\
1763 Any other markers at the point of insertion remain before the text.\n\
1765 If the current buffer is multibyte, unibyte strings are converted\n\
1766 to multibyte for insertion (see `unibyte-char-to-multibyte').\n\
1767 If the current buffer is unibyte, multibyte strings are converted\n\
1768 to unibyte for insertion.")
1771 register Lisp_Object
*args
;
1773 general_insert_function (insert
, insert_from_string
, 0, nargs
, args
);
1777 DEFUN ("insert-and-inherit", Finsert_and_inherit
, Sinsert_and_inherit
,
1779 "Insert the arguments at point, inheriting properties from adjoining text.\n\
1780 Point and before-insertion markers move forward to end up\n\
1781 after the inserted text.\n\
1782 Any other markers at the point of insertion remain before the text.\n\
1784 If the current buffer is multibyte, unibyte strings are converted\n\
1785 to multibyte for insertion (see `unibyte-char-to-multibyte').\n\
1786 If the current buffer is unibyte, multibyte strings are converted\n\
1787 to unibyte for insertion.")
1790 register Lisp_Object
*args
;
1792 general_insert_function (insert_and_inherit
, insert_from_string
, 1,
1797 DEFUN ("insert-before-markers", Finsert_before_markers
, Sinsert_before_markers
, 0, MANY
, 0,
1798 "Insert strings or characters at point, relocating markers after the text.\n\
1799 Point and markers move forward to end up after the inserted text.\n\
1801 If the current buffer is multibyte, unibyte strings are converted\n\
1802 to multibyte for insertion (see `unibyte-char-to-multibyte').\n\
1803 If the current buffer is unibyte, multibyte strings are converted\n\
1804 to unibyte for insertion.")
1807 register Lisp_Object
*args
;
1809 general_insert_function (insert_before_markers
,
1810 insert_from_string_before_markers
, 0,
1815 DEFUN ("insert-before-markers-and-inherit", Finsert_and_inherit_before_markers
,
1816 Sinsert_and_inherit_before_markers
, 0, MANY
, 0,
1817 "Insert text at point, relocating markers and inheriting properties.\n\
1818 Point and markers move forward to end up after the inserted text.\n\
1820 If the current buffer is multibyte, unibyte strings are converted\n\
1821 to multibyte for insertion (see `unibyte-char-to-multibyte').\n\
1822 If the current buffer is unibyte, multibyte strings are converted\n\
1823 to unibyte for insertion.")
1826 register Lisp_Object
*args
;
1828 general_insert_function (insert_before_markers_and_inherit
,
1829 insert_from_string_before_markers
, 1,
1834 DEFUN ("insert-char", Finsert_char
, Sinsert_char
, 2, 3, 0,
1835 "Insert COUNT (second arg) copies of CHARACTER (first arg).\n\
1836 Both arguments are required.\n\
1837 Point, and before-insertion markers, are relocated as in the function `insert'.\n\
1838 The optional third arg INHERIT, if non-nil, says to inherit text properties\n\
1839 from adjoining text, if those properties are sticky.")
1840 (character
, count
, inherit
)
1841 Lisp_Object character
, count
, inherit
;
1843 register unsigned char *string
;
1844 register int strlen
;
1847 unsigned char workbuf
[4], *str
;
1849 CHECK_NUMBER (character
, 0);
1850 CHECK_NUMBER (count
, 1);
1852 if (!NILP (current_buffer
->enable_multibyte_characters
))
1853 len
= CHAR_STRING (XFASTINT (character
), workbuf
, str
);
1855 workbuf
[0] = XFASTINT (character
), str
= workbuf
, len
= 1;
1856 n
= XINT (count
) * len
;
1859 strlen
= min (n
, 256 * len
);
1860 string
= (unsigned char *) alloca (strlen
);
1861 for (i
= 0; i
< strlen
; i
++)
1862 string
[i
] = str
[i
% len
];
1866 if (!NILP (inherit
))
1867 insert_and_inherit (string
, strlen
);
1869 insert (string
, strlen
);
1874 if (!NILP (inherit
))
1875 insert_and_inherit (string
, n
);
1883 /* Making strings from buffer contents. */
1885 /* Return a Lisp_String containing the text of the current buffer from
1886 START to END. If text properties are in use and the current buffer
1887 has properties in the range specified, the resulting string will also
1888 have them, if PROPS is nonzero.
1890 We don't want to use plain old make_string here, because it calls
1891 make_uninit_string, which can cause the buffer arena to be
1892 compacted. make_string has no way of knowing that the data has
1893 been moved, and thus copies the wrong data into the string. This
1894 doesn't effect most of the other users of make_string, so it should
1895 be left as is. But we should use this function when conjuring
1896 buffer substrings. */
1899 make_buffer_string (start
, end
, props
)
1903 int start_byte
= CHAR_TO_BYTE (start
);
1904 int end_byte
= CHAR_TO_BYTE (end
);
1906 return make_buffer_string_both (start
, start_byte
, end
, end_byte
, props
);
1909 /* Return a Lisp_String containing the text of the current buffer from
1910 START / START_BYTE to END / END_BYTE.
1912 If text properties are in use and the current buffer
1913 has properties in the range specified, the resulting string will also
1914 have them, if PROPS is nonzero.
1916 We don't want to use plain old make_string here, because it calls
1917 make_uninit_string, which can cause the buffer arena to be
1918 compacted. make_string has no way of knowing that the data has
1919 been moved, and thus copies the wrong data into the string. This
1920 doesn't effect most of the other users of make_string, so it should
1921 be left as is. But we should use this function when conjuring
1922 buffer substrings. */
1925 make_buffer_string_both (start
, start_byte
, end
, end_byte
, props
)
1926 int start
, start_byte
, end
, end_byte
;
1929 Lisp_Object result
, tem
, tem1
;
1931 if (start
< GPT
&& GPT
< end
)
1934 if (! NILP (current_buffer
->enable_multibyte_characters
))
1935 result
= make_uninit_multibyte_string (end
- start
, end_byte
- start_byte
);
1937 result
= make_uninit_string (end
- start
);
1938 bcopy (BYTE_POS_ADDR (start_byte
), XSTRING (result
)->data
,
1939 end_byte
- start_byte
);
1941 /* If desired, update and copy the text properties. */
1942 #ifdef USE_TEXT_PROPERTIES
1945 update_buffer_properties (start
, end
);
1947 tem
= Fnext_property_change (make_number (start
), Qnil
, make_number (end
));
1948 tem1
= Ftext_properties_at (make_number (start
), Qnil
);
1950 if (XINT (tem
) != end
|| !NILP (tem1
))
1951 copy_intervals_to_string (result
, current_buffer
, start
,
1959 /* Call Vbuffer_access_fontify_functions for the range START ... END
1960 in the current buffer, if necessary. */
1963 update_buffer_properties (start
, end
)
1966 #ifdef USE_TEXT_PROPERTIES
1967 /* If this buffer has some access functions,
1968 call them, specifying the range of the buffer being accessed. */
1969 if (!NILP (Vbuffer_access_fontify_functions
))
1971 Lisp_Object args
[3];
1974 args
[0] = Qbuffer_access_fontify_functions
;
1975 XSETINT (args
[1], start
);
1976 XSETINT (args
[2], end
);
1978 /* But don't call them if we can tell that the work
1979 has already been done. */
1980 if (!NILP (Vbuffer_access_fontified_property
))
1982 tem
= Ftext_property_any (args
[1], args
[2],
1983 Vbuffer_access_fontified_property
,
1986 Frun_hook_with_args (3, args
);
1989 Frun_hook_with_args (3, args
);
1994 DEFUN ("buffer-substring", Fbuffer_substring
, Sbuffer_substring
, 2, 2, 0,
1995 "Return the contents of part of the current buffer as a string.\n\
1996 The two arguments START and END are character positions;\n\
1997 they can be in either order.\n\
1998 The string returned is multibyte if the buffer is multibyte.")
2000 Lisp_Object start
, end
;
2004 validate_region (&start
, &end
);
2008 return make_buffer_string (b
, e
, 1);
2011 DEFUN ("buffer-substring-no-properties", Fbuffer_substring_no_properties
,
2012 Sbuffer_substring_no_properties
, 2, 2, 0,
2013 "Return the characters of part of the buffer, without the text properties.\n\
2014 The two arguments START and END are character positions;\n\
2015 they can be in either order.")
2017 Lisp_Object start
, end
;
2021 validate_region (&start
, &end
);
2025 return make_buffer_string (b
, e
, 0);
2028 DEFUN ("buffer-string", Fbuffer_string
, Sbuffer_string
, 0, 0, 0,
2029 "Return the contents of the current buffer as a string.\n\
2030 If narrowing is in effect, this function returns only the visible part\n\
2031 of the buffer. If in a mini-buffer, don't include the prompt in the\n\
2035 return make_buffer_string (BEGV
, ZV
, 1);
2038 DEFUN ("insert-buffer-substring", Finsert_buffer_substring
, Sinsert_buffer_substring
,
2040 "Insert before point a substring of the contents of buffer BUFFER.\n\
2041 BUFFER may be a buffer or a buffer name.\n\
2042 Arguments START and END are character numbers specifying the substring.\n\
2043 They default to the beginning and the end of BUFFER.")
2045 Lisp_Object buf
, start
, end
;
2047 register int b
, e
, temp
;
2048 register struct buffer
*bp
, *obuf
;
2051 buffer
= Fget_buffer (buf
);
2054 bp
= XBUFFER (buffer
);
2055 if (NILP (bp
->name
))
2056 error ("Selecting deleted buffer");
2062 CHECK_NUMBER_COERCE_MARKER (start
, 0);
2069 CHECK_NUMBER_COERCE_MARKER (end
, 1);
2074 temp
= b
, b
= e
, e
= temp
;
2076 if (!(BUF_BEGV (bp
) <= b
&& e
<= BUF_ZV (bp
)))
2077 args_out_of_range (start
, end
);
2079 obuf
= current_buffer
;
2080 set_buffer_internal_1 (bp
);
2081 update_buffer_properties (b
, e
);
2082 set_buffer_internal_1 (obuf
);
2084 insert_from_buffer (bp
, b
, e
- b
, 0);
2088 DEFUN ("compare-buffer-substrings", Fcompare_buffer_substrings
, Scompare_buffer_substrings
,
2090 "Compare two substrings of two buffers; return result as number.\n\
2091 the value is -N if first string is less after N-1 chars,\n\
2092 +N if first string is greater after N-1 chars, or 0 if strings match.\n\
2093 Each substring is represented as three arguments: BUFFER, START and END.\n\
2094 That makes six args in all, three for each substring.\n\n\
2095 The value of `case-fold-search' in the current buffer\n\
2096 determines whether case is significant or ignored.")
2097 (buffer1
, start1
, end1
, buffer2
, start2
, end2
)
2098 Lisp_Object buffer1
, start1
, end1
, buffer2
, start2
, end2
;
2100 register int begp1
, endp1
, begp2
, endp2
, temp
;
2101 register struct buffer
*bp1
, *bp2
;
2102 register Lisp_Object
*trt
2103 = (!NILP (current_buffer
->case_fold_search
)
2104 ? XCHAR_TABLE (current_buffer
->case_canon_table
)->contents
: 0);
2106 int i1
, i2
, i1_byte
, i2_byte
;
2108 /* Find the first buffer and its substring. */
2111 bp1
= current_buffer
;
2115 buf1
= Fget_buffer (buffer1
);
2118 bp1
= XBUFFER (buf1
);
2119 if (NILP (bp1
->name
))
2120 error ("Selecting deleted buffer");
2124 begp1
= BUF_BEGV (bp1
);
2127 CHECK_NUMBER_COERCE_MARKER (start1
, 1);
2128 begp1
= XINT (start1
);
2131 endp1
= BUF_ZV (bp1
);
2134 CHECK_NUMBER_COERCE_MARKER (end1
, 2);
2135 endp1
= XINT (end1
);
2139 temp
= begp1
, begp1
= endp1
, endp1
= temp
;
2141 if (!(BUF_BEGV (bp1
) <= begp1
2143 && endp1
<= BUF_ZV (bp1
)))
2144 args_out_of_range (start1
, end1
);
2146 /* Likewise for second substring. */
2149 bp2
= current_buffer
;
2153 buf2
= Fget_buffer (buffer2
);
2156 bp2
= XBUFFER (buf2
);
2157 if (NILP (bp2
->name
))
2158 error ("Selecting deleted buffer");
2162 begp2
= BUF_BEGV (bp2
);
2165 CHECK_NUMBER_COERCE_MARKER (start2
, 4);
2166 begp2
= XINT (start2
);
2169 endp2
= BUF_ZV (bp2
);
2172 CHECK_NUMBER_COERCE_MARKER (end2
, 5);
2173 endp2
= XINT (end2
);
2177 temp
= begp2
, begp2
= endp2
, endp2
= temp
;
2179 if (!(BUF_BEGV (bp2
) <= begp2
2181 && endp2
<= BUF_ZV (bp2
)))
2182 args_out_of_range (start2
, end2
);
2186 i1_byte
= buf_charpos_to_bytepos (bp1
, i1
);
2187 i2_byte
= buf_charpos_to_bytepos (bp2
, i2
);
2189 while (i1
< endp1
&& i2
< endp2
)
2191 /* When we find a mismatch, we must compare the
2192 characters, not just the bytes. */
2195 if (! NILP (bp1
->enable_multibyte_characters
))
2197 c1
= BUF_FETCH_MULTIBYTE_CHAR (bp1
, i1_byte
);
2198 BUF_INC_POS (bp1
, i1_byte
);
2203 c1
= BUF_FETCH_BYTE (bp1
, i1
);
2204 c1
= unibyte_char_to_multibyte (c1
);
2208 if (! NILP (bp2
->enable_multibyte_characters
))
2210 c2
= BUF_FETCH_MULTIBYTE_CHAR (bp2
, i2_byte
);
2211 BUF_INC_POS (bp2
, i2_byte
);
2216 c2
= BUF_FETCH_BYTE (bp2
, i2
);
2217 c2
= unibyte_char_to_multibyte (c2
);
2223 c1
= XINT (trt
[c1
]);
2224 c2
= XINT (trt
[c2
]);
2227 return make_number (- 1 - chars
);
2229 return make_number (chars
+ 1);
2234 /* The strings match as far as they go.
2235 If one is shorter, that one is less. */
2236 if (chars
< endp1
- begp1
)
2237 return make_number (chars
+ 1);
2238 else if (chars
< endp2
- begp2
)
2239 return make_number (- chars
- 1);
2241 /* Same length too => they are equal. */
2242 return make_number (0);
2246 subst_char_in_region_unwind (arg
)
2249 return current_buffer
->undo_list
= arg
;
2253 subst_char_in_region_unwind_1 (arg
)
2256 return current_buffer
->filename
= arg
;
2259 DEFUN ("subst-char-in-region", Fsubst_char_in_region
,
2260 Ssubst_char_in_region
, 4, 5, 0,
2261 "From START to END, replace FROMCHAR with TOCHAR each time it occurs.\n\
2262 If optional arg NOUNDO is non-nil, don't record this change for undo\n\
2263 and don't mark the buffer as really changed.\n\
2264 Both characters must have the same length of multi-byte form.")
2265 (start
, end
, fromchar
, tochar
, noundo
)
2266 Lisp_Object start
, end
, fromchar
, tochar
, noundo
;
2268 register int pos
, pos_byte
, stop
, i
, len
, end_byte
;
2270 unsigned char fromwork
[4], *fromstr
, towork
[4], *tostr
, *p
;
2271 int count
= specpdl_ptr
- specpdl
;
2272 #define COMBINING_NO 0
2273 #define COMBINING_BEFORE 1
2274 #define COMBINING_AFTER 2
2275 #define COMBINING_BOTH (COMBINING_BEFORE | COMBINING_AFTER)
2276 int maybe_byte_combining
= COMBINING_NO
;
2278 validate_region (&start
, &end
);
2279 CHECK_NUMBER (fromchar
, 2);
2280 CHECK_NUMBER (tochar
, 3);
2282 if (! NILP (current_buffer
->enable_multibyte_characters
))
2284 len
= CHAR_STRING (XFASTINT (fromchar
), fromwork
, fromstr
);
2285 if (CHAR_STRING (XFASTINT (tochar
), towork
, tostr
) != len
)
2286 error ("Characters in subst-char-in-region have different byte-lengths");
2287 if (!ASCII_BYTE_P (*tostr
))
2289 /* If *TOSTR is in the range 0x80..0x9F and TOCHAR is not a
2290 complete multibyte character, it may be combined with the
2291 after bytes. If it is in the range 0xA0..0xFF, it may be
2292 combined with the before and after bytes. */
2293 if (!CHAR_HEAD_P (*tostr
))
2294 maybe_byte_combining
= COMBINING_BOTH
;
2295 else if (BYTES_BY_CHAR_HEAD (*tostr
) > len
)
2296 maybe_byte_combining
= COMBINING_AFTER
;
2302 fromwork
[0] = XFASTINT (fromchar
), fromstr
= fromwork
;
2303 towork
[0] = XFASTINT (tochar
), tostr
= towork
;
2307 pos_byte
= CHAR_TO_BYTE (pos
);
2308 stop
= CHAR_TO_BYTE (XINT (end
));
2311 /* If we don't want undo, turn off putting stuff on the list.
2312 That's faster than getting rid of things,
2313 and it prevents even the entry for a first change.
2314 Also inhibit locking the file. */
2317 record_unwind_protect (subst_char_in_region_unwind
,
2318 current_buffer
->undo_list
);
2319 current_buffer
->undo_list
= Qt
;
2320 /* Don't do file-locking. */
2321 record_unwind_protect (subst_char_in_region_unwind_1
,
2322 current_buffer
->filename
);
2323 current_buffer
->filename
= Qnil
;
2326 if (pos_byte
< GPT_BYTE
)
2327 stop
= min (stop
, GPT_BYTE
);
2330 int pos_byte_next
= pos_byte
;
2332 if (pos_byte
>= stop
)
2334 if (pos_byte
>= end_byte
) break;
2337 p
= BYTE_POS_ADDR (pos_byte
);
2338 INC_POS (pos_byte_next
);
2339 if (pos_byte_next
- pos_byte
== len
2340 && p
[0] == fromstr
[0]
2342 || (p
[1] == fromstr
[1]
2343 && (len
== 2 || (p
[2] == fromstr
[2]
2344 && (len
== 3 || p
[3] == fromstr
[3]))))))
2348 modify_region (current_buffer
, XINT (start
), XINT (end
));
2350 if (! NILP (noundo
))
2352 if (MODIFF
- 1 == SAVE_MODIFF
)
2354 if (MODIFF
- 1 == current_buffer
->auto_save_modified
)
2355 current_buffer
->auto_save_modified
++;
2361 /* Take care of the case where the new character
2362 combines with neighboring bytes. */
2363 if (maybe_byte_combining
2364 && (maybe_byte_combining
== COMBINING_AFTER
2365 ? (pos_byte_next
< Z_BYTE
2366 && ! CHAR_HEAD_P (FETCH_BYTE (pos_byte_next
)))
2367 : ((pos_byte_next
< Z_BYTE
2368 && ! CHAR_HEAD_P (FETCH_BYTE (pos_byte_next
)))
2369 || (pos_byte
> BEG_BYTE
2370 && ! ASCII_BYTE_P (FETCH_BYTE (pos_byte
- 1))))))
2372 Lisp_Object tem
, string
;
2374 struct gcpro gcpro1
;
2376 tem
= current_buffer
->undo_list
;
2379 /* Make a multibyte string containing this single character. */
2380 string
= make_multibyte_string (tostr
, 1, len
);
2381 /* replace_range is less efficient, because it moves the gap,
2382 but it handles combining correctly. */
2383 replace_range (pos
, pos
+ 1, string
,
2385 pos_byte_next
= CHAR_TO_BYTE (pos
);
2386 if (pos_byte_next
> pos_byte
)
2387 /* Before combining happened. We should not increment
2388 POS. So, to cancel the later increment of POS,
2392 INC_POS (pos_byte_next
);
2394 if (! NILP (noundo
))
2395 current_buffer
->undo_list
= tem
;
2402 record_change (pos
, 1);
2403 for (i
= 0; i
< len
; i
++) *p
++ = tostr
[i
];
2406 pos_byte
= pos_byte_next
;
2411 signal_after_change (XINT (start
),
2412 XINT (end
) - XINT (start
), XINT (end
) - XINT (start
));
2414 unbind_to (count
, Qnil
);
2418 DEFUN ("translate-region", Ftranslate_region
, Stranslate_region
, 3, 3, 0,
2419 "From START to END, translate characters according to TABLE.\n\
2420 TABLE is a string; the Nth character in it is the mapping\n\
2421 for the character with code N.\n\
2422 This function does not alter multibyte characters.\n\
2423 It returns the number of characters changed.")
2427 register Lisp_Object table
;
2429 register int pos_byte
, stop
; /* Limits of the region. */
2430 register unsigned char *tt
; /* Trans table. */
2431 register int nc
; /* New character. */
2432 int cnt
; /* Number of changes made. */
2433 int size
; /* Size of translate table. */
2436 validate_region (&start
, &end
);
2437 CHECK_STRING (table
, 2);
2439 size
= STRING_BYTES (XSTRING (table
));
2440 tt
= XSTRING (table
)->data
;
2442 pos_byte
= CHAR_TO_BYTE (XINT (start
));
2443 stop
= CHAR_TO_BYTE (XINT (end
));
2444 modify_region (current_buffer
, XINT (start
), XINT (end
));
2448 for (; pos_byte
< stop
; )
2450 register unsigned char *p
= BYTE_POS_ADDR (pos_byte
);
2455 oc
= STRING_CHAR_AND_LENGTH (p
, stop
- pos_byte
, len
);
2456 pos_byte_next
= pos_byte
+ len
;
2457 if (oc
< size
&& len
== 1)
2462 /* Take care of the case where the new character
2463 combines with neighboring bytes. */
2464 if (!ASCII_BYTE_P (nc
)
2465 && (CHAR_HEAD_P (nc
)
2466 ? ! CHAR_HEAD_P (FETCH_BYTE (pos_byte
+ 1))
2467 : (pos_byte
> BEG_BYTE
2468 && ! ASCII_BYTE_P (FETCH_BYTE (pos_byte
- 1)))))
2472 string
= make_multibyte_string (tt
+ oc
, 1, 1);
2473 /* This is less efficient, because it moves the gap,
2474 but it handles combining correctly. */
2475 replace_range (pos
, pos
+ 1, string
,
2477 pos_byte_next
= CHAR_TO_BYTE (pos
);
2478 if (pos_byte_next
> pos_byte
)
2479 /* Before combining happened. We should not
2480 increment POS. So, to cancel the later
2481 increment of POS, we decrease it now. */
2484 INC_POS (pos_byte_next
);
2488 record_change (pos
, 1);
2490 signal_after_change (pos
, 1, 1);
2495 pos_byte
= pos_byte_next
;
2499 return make_number (cnt
);
2502 DEFUN ("delete-region", Fdelete_region
, Sdelete_region
, 2, 2, "r",
2503 "Delete the text between point and mark.\n\
2504 When called from a program, expects two arguments,\n\
2505 positions (integers or markers) specifying the stretch to be deleted.")
2507 Lisp_Object start
, end
;
2509 validate_region (&start
, &end
);
2510 del_range (XINT (start
), XINT (end
));
2514 DEFUN ("widen", Fwiden
, Swiden
, 0, 0, "",
2515 "Remove restrictions (narrowing) from current buffer.\n\
2516 This allows the buffer's full text to be seen and edited.")
2519 if (BEG
!= BEGV
|| Z
!= ZV
)
2520 current_buffer
->clip_changed
= 1;
2522 BEGV_BYTE
= BEG_BYTE
;
2523 SET_BUF_ZV_BOTH (current_buffer
, Z
, Z_BYTE
);
2524 /* Changing the buffer bounds invalidates any recorded current column. */
2525 invalidate_current_column ();
2529 DEFUN ("narrow-to-region", Fnarrow_to_region
, Snarrow_to_region
, 2, 2, "r",
2530 "Restrict editing in this buffer to the current region.\n\
2531 The rest of the text becomes temporarily invisible and untouchable\n\
2532 but is not deleted; if you save the buffer in a file, the invisible\n\
2533 text is included in the file. \\[widen] makes all visible again.\n\
2534 See also `save-restriction'.\n\
2536 When calling from a program, pass two arguments; positions (integers\n\
2537 or markers) bounding the text that should remain visible.")
2539 register Lisp_Object start
, end
;
2541 CHECK_NUMBER_COERCE_MARKER (start
, 0);
2542 CHECK_NUMBER_COERCE_MARKER (end
, 1);
2544 if (XINT (start
) > XINT (end
))
2547 tem
= start
; start
= end
; end
= tem
;
2550 if (!(BEG
<= XINT (start
) && XINT (start
) <= XINT (end
) && XINT (end
) <= Z
))
2551 args_out_of_range (start
, end
);
2553 if (BEGV
!= XFASTINT (start
) || ZV
!= XFASTINT (end
))
2554 current_buffer
->clip_changed
= 1;
2556 SET_BUF_BEGV (current_buffer
, XFASTINT (start
));
2557 SET_BUF_ZV (current_buffer
, XFASTINT (end
));
2558 if (PT
< XFASTINT (start
))
2559 SET_PT (XFASTINT (start
));
2560 if (PT
> XFASTINT (end
))
2561 SET_PT (XFASTINT (end
));
2562 /* Changing the buffer bounds invalidates any recorded current column. */
2563 invalidate_current_column ();
2568 save_restriction_save ()
2570 register Lisp_Object bottom
, top
;
2571 /* Note: I tried using markers here, but it does not win
2572 because insertion at the end of the saved region
2573 does not advance mh and is considered "outside" the saved region. */
2574 XSETFASTINT (bottom
, BEGV
- BEG
);
2575 XSETFASTINT (top
, Z
- ZV
);
2577 return Fcons (Fcurrent_buffer (), Fcons (bottom
, top
));
2581 save_restriction_restore (data
)
2584 register struct buffer
*buf
;
2585 register int newhead
, newtail
;
2586 register Lisp_Object tem
;
2589 buf
= XBUFFER (XCAR (data
));
2594 newhead
= XINT (tem
);
2596 newtail
= XINT (tem
);
2597 if (newhead
+ newtail
> BUF_Z (buf
) - BUF_BEG (buf
))
2603 obegv
= BUF_BEGV (buf
);
2606 SET_BUF_BEGV (buf
, BUF_BEG (buf
) + newhead
);
2607 SET_BUF_ZV (buf
, BUF_Z (buf
) - newtail
);
2609 if (obegv
!= BUF_BEGV (buf
) || ozv
!= BUF_ZV (buf
))
2610 current_buffer
->clip_changed
= 1;
2612 /* If point is outside the new visible range, move it inside. */
2613 SET_BUF_PT_BOTH (buf
,
2614 clip_to_bounds (BUF_BEGV (buf
), BUF_PT (buf
), BUF_ZV (buf
)),
2615 clip_to_bounds (BUF_BEGV_BYTE (buf
), BUF_PT_BYTE (buf
),
2616 BUF_ZV_BYTE (buf
)));
2621 DEFUN ("save-restriction", Fsave_restriction
, Ssave_restriction
, 0, UNEVALLED
, 0,
2622 "Execute BODY, saving and restoring current buffer's restrictions.\n\
2623 The buffer's restrictions make parts of the beginning and end invisible.\n\
2624 \(They are set up with `narrow-to-region' and eliminated with `widen'.)\n\
2625 This special form, `save-restriction', saves the current buffer's restrictions\n\
2626 when it is entered, and restores them when it is exited.\n\
2627 So any `narrow-to-region' within BODY lasts only until the end of the form.\n\
2628 The old restrictions settings are restored\n\
2629 even in case of abnormal exit (throw or error).\n\
2631 The value returned is the value of the last form in BODY.\n\
2633 `save-restriction' can get confused if, within the BODY, you widen\n\
2634 and then make changes outside the area within the saved restrictions.\n\
2635 See Info node `(elisp)Narrowing' for details and an appropriate technique.\n\
2637 Note: if you are using both `save-excursion' and `save-restriction',\n\
2638 use `save-excursion' outermost:\n\
2639 (save-excursion (save-restriction ...))")
2643 register Lisp_Object val
;
2644 int count
= specpdl_ptr
- specpdl
;
2646 record_unwind_protect (save_restriction_restore
, save_restriction_save ());
2647 val
= Fprogn (body
);
2648 return unbind_to (count
, val
);
2653 /* Buffer for the most recent text displayed by Fmessage. */
2654 static char *message_text
;
2656 /* Allocated length of that buffer. */
2657 static int message_length
;
2659 #endif /* not HAVE_MENUS */
2661 DEFUN ("message", Fmessage
, Smessage
, 1, MANY
, 0,
2662 "Print a one-line message at the bottom of the screen.\n\
2663 The first argument is a format control string, and the rest are data\n\
2664 to be formatted under control of the string. See `format' for details.\n\
2666 If the first argument is nil, clear any existing message; let the\n\
2667 minibuffer contents show.")
2679 register Lisp_Object val
;
2680 val
= Fformat (nargs
, args
);
2681 message3 (val
, STRING_BYTES (XSTRING (val
)), STRING_MULTIBYTE (val
));
2686 DEFUN ("message-box", Fmessage_box
, Smessage_box
, 1, MANY
, 0,
2687 "Display a message, in a dialog box if possible.\n\
2688 If a dialog box is not available, use the echo area.\n\
2689 The first argument is a format control string, and the rest are data\n\
2690 to be formatted under control of the string. See `format' for details.\n\
2692 If the first argument is nil, clear any existing message; let the\n\
2693 minibuffer contents show.")
2705 register Lisp_Object val
;
2706 val
= Fformat (nargs
, args
);
2709 Lisp_Object pane
, menu
, obj
;
2710 struct gcpro gcpro1
;
2711 pane
= Fcons (Fcons (build_string ("OK"), Qt
), Qnil
);
2713 menu
= Fcons (val
, pane
);
2714 obj
= Fx_popup_dialog (Qt
, menu
);
2718 #else /* not HAVE_MENUS */
2719 /* Copy the data so that it won't move when we GC. */
2722 message_text
= (char *)xmalloc (80);
2723 message_length
= 80;
2725 if (STRING_BYTES (XSTRING (val
)) > message_length
)
2727 message_length
= STRING_BYTES (XSTRING (val
));
2728 message_text
= (char *)xrealloc (message_text
, message_length
);
2730 bcopy (XSTRING (val
)->data
, message_text
, STRING_BYTES (XSTRING (val
)));
2731 message2 (message_text
, STRING_BYTES (XSTRING (val
)),
2732 STRING_MULTIBYTE (val
));
2734 #endif /* not HAVE_MENUS */
2738 extern Lisp_Object last_nonmenu_event
;
2741 DEFUN ("message-or-box", Fmessage_or_box
, Smessage_or_box
, 1, MANY
, 0,
2742 "Display a message in a dialog box or in the echo area.\n\
2743 If this command was invoked with the mouse, use a dialog box.\n\
2744 Otherwise, use the echo area.\n\
2745 The first argument is a format control string, and the rest are data\n\
2746 to be formatted under control of the string. See `format' for details.\n\
2748 If the first argument is nil, clear any existing message; let the\n\
2749 minibuffer contents show.")
2755 if (NILP (last_nonmenu_event
) || CONSP (last_nonmenu_event
))
2756 return Fmessage_box (nargs
, args
);
2758 return Fmessage (nargs
, args
);
2761 DEFUN ("current-message", Fcurrent_message
, Scurrent_message
, 0, 0, 0,
2762 "Return the string currently displayed in the echo area, or nil if none.")
2765 return current_message ();
2769 DEFUN ("propertize", Fpropertize
, Spropertize
, 3, MANY
, 0,
2770 "Return a copy of STRING with text properties added.\n\
2771 First argument is the string to copy.\n\
2772 Remaining arguments are sequences of PROPERTY VALUE pairs for text\n\
2773 properties to add to the result ")
2778 Lisp_Object properties
, string
;
2779 struct gcpro gcpro1
, gcpro2
;
2782 /* Number of args must be odd. */
2783 if ((nargs
& 1) == 0 || nargs
< 3)
2784 error ("Wrong number of arguments");
2786 properties
= string
= Qnil
;
2787 GCPRO2 (properties
, string
);
2789 /* First argument must be a string. */
2790 CHECK_STRING (args
[0], 0);
2791 string
= Fcopy_sequence (args
[0]);
2793 for (i
= 1; i
< nargs
; i
+= 2)
2795 CHECK_SYMBOL (args
[i
], i
);
2796 properties
= Fcons (args
[i
], Fcons (args
[i
+ 1], properties
));
2799 Fadd_text_properties (make_number (0),
2800 make_number (XSTRING (string
)->size
),
2801 properties
, string
);
2802 RETURN_UNGCPRO (string
);
2806 /* Number of bytes that STRING will occupy when put into the result.
2807 MULTIBYTE is nonzero if the result should be multibyte. */
2809 #define CONVERTED_BYTE_SIZE(MULTIBYTE, STRING) \
2810 (((MULTIBYTE) && ! STRING_MULTIBYTE (STRING)) \
2811 ? count_size_as_multibyte (XSTRING (STRING)->data, \
2812 STRING_BYTES (XSTRING (STRING))) \
2813 : STRING_BYTES (XSTRING (STRING)))
2815 DEFUN ("format", Fformat
, Sformat
, 1, MANY
, 0,
2816 "Format a string out of a control-string and arguments.\n\
2817 The first argument is a control string.\n\
2818 The other arguments are substituted into it to make the result, a string.\n\
2819 It may contain %-sequences meaning to substitute the next argument.\n\
2820 %s means print a string argument. Actually, prints any object, with `princ'.\n\
2821 %d means print as number in decimal (%o octal, %x hex).\n\
2822 %e means print a number in exponential notation.\n\
2823 %f means print a number in decimal-point notation.\n\
2824 %g means print a number in exponential notation\n\
2825 or decimal-point notation, whichever uses fewer characters.\n\
2826 %c means print a number as a single character.\n\
2827 %S means print any object as an s-expression (using `prin1').\n\
2828 The argument used for %d, %o, %x, %e, %f, %g or %c must be a number.\n\
2829 Use %% to put a single % into the output.")
2832 register Lisp_Object
*args
;
2834 register int n
; /* The number of the next arg to substitute */
2835 register int total
; /* An estimate of the final length */
2837 register unsigned char *format
, *end
;
2839 /* Nonzero if the output should be a multibyte string,
2840 which is true if any of the inputs is one. */
2842 /* When we make a multibyte string, we must pay attention to the
2843 byte combining problem, i.e., a byte may be combined with a
2844 multibyte charcter of the previous string. This flag tells if we
2845 must consider such a situation or not. */
2846 int maybe_combine_byte
;
2847 unsigned char *this_format
;
2855 extern char *index ();
2857 /* It should not be necessary to GCPRO ARGS, because
2858 the caller in the interpreter should take care of that. */
2860 /* Try to determine whether the result should be multibyte.
2861 This is not always right; sometimes the result needs to be multibyte
2862 because of an object that we will pass through prin1,
2863 and in that case, we won't know it here. */
2864 for (n
= 0; n
< nargs
; n
++)
2865 if (STRINGP (args
[n
]) && STRING_MULTIBYTE (args
[n
]))
2868 CHECK_STRING (args
[0], 0);
2870 /* If we start out planning a unibyte result,
2871 and later find it has to be multibyte, we jump back to retry. */
2874 format
= XSTRING (args
[0])->data
;
2875 end
= format
+ STRING_BYTES (XSTRING (args
[0]));
2878 /* Make room in result for all the non-%-codes in the control string. */
2879 total
= 5 + CONVERTED_BYTE_SIZE (multibyte
, args
[0]);
2881 /* Add to TOTAL enough space to hold the converted arguments. */
2884 while (format
!= end
)
2885 if (*format
++ == '%')
2887 int minlen
, thissize
= 0;
2888 unsigned char *this_format_start
= format
- 1;
2890 /* Process a numeric arg and skip it. */
2891 minlen
= atoi (format
);
2895 while ((*format
>= '0' && *format
<= '9')
2896 || *format
== '-' || *format
== ' ' || *format
== '.')
2899 if (format
- this_format_start
+ 1 > longest_format
)
2900 longest_format
= format
- this_format_start
+ 1;
2903 error ("Format string ends in middle of format specifier");
2906 else if (++n
>= nargs
)
2907 error ("Not enough arguments for format string");
2908 else if (*format
== 'S')
2910 /* For `S', prin1 the argument and then treat like a string. */
2911 register Lisp_Object tem
;
2912 tem
= Fprin1_to_string (args
[n
], Qnil
);
2913 if (STRING_MULTIBYTE (tem
) && ! multibyte
)
2921 else if (SYMBOLP (args
[n
]))
2923 XSETSTRING (args
[n
], XSYMBOL (args
[n
])->name
);
2924 if (STRING_MULTIBYTE (args
[n
]) && ! multibyte
)
2931 else if (STRINGP (args
[n
]))
2934 if (*format
!= 's' && *format
!= 'S')
2935 error ("Format specifier doesn't match argument type");
2936 thissize
= CONVERTED_BYTE_SIZE (multibyte
, args
[n
]);
2938 /* Would get MPV otherwise, since Lisp_Int's `point' to low memory. */
2939 else if (INTEGERP (args
[n
]) && *format
!= 's')
2941 #ifdef LISP_FLOAT_TYPE
2942 /* The following loop assumes the Lisp type indicates
2943 the proper way to pass the argument.
2944 So make sure we have a flonum if the argument should
2946 if (*format
== 'e' || *format
== 'f' || *format
== 'g')
2947 args
[n
] = Ffloat (args
[n
]);
2950 if (*format
!= 'd' && *format
!= 'o' && *format
!= 'x'
2951 && *format
!= 'i' && *format
!= 'X' && *format
!= 'c')
2952 error ("Invalid format operation %%%c", *format
);
2956 && (! SINGLE_BYTE_CHAR_P (XINT (args
[n
]))
2957 || XINT (args
[n
]) == 0))
2964 args
[n
] = Fchar_to_string (args
[n
]);
2965 thissize
= STRING_BYTES (XSTRING (args
[n
]));
2968 #ifdef LISP_FLOAT_TYPE
2969 else if (FLOATP (args
[n
]) && *format
!= 's')
2971 if (! (*format
== 'e' || *format
== 'f' || *format
== 'g'))
2972 args
[n
] = Ftruncate (args
[n
], Qnil
);
2978 /* Anything but a string, convert to a string using princ. */
2979 register Lisp_Object tem
;
2980 tem
= Fprin1_to_string (args
[n
], Qt
);
2981 if (STRING_MULTIBYTE (tem
) & ! multibyte
)
2990 if (thissize
< minlen
)
2993 total
+= thissize
+ 4;
2996 /* Now we can no longer jump to retry.
2997 TOTAL and LONGEST_FORMAT are known for certain. */
2999 this_format
= (unsigned char *) alloca (longest_format
+ 1);
3001 /* Allocate the space for the result.
3002 Note that TOTAL is an overestimate. */
3004 buf
= (char *) alloca (total
+ 1);
3006 buf
= (char *) xmalloc (total
+ 1);
3012 /* Scan the format and store result in BUF. */
3013 format
= XSTRING (args
[0])->data
;
3014 maybe_combine_byte
= 0;
3015 while (format
!= end
)
3021 unsigned char *this_format_start
= format
;
3025 /* Process a numeric arg and skip it. */
3026 minlen
= atoi (format
);
3028 minlen
= - minlen
, negative
= 1;
3030 while ((*format
>= '0' && *format
<= '9')
3031 || *format
== '-' || *format
== ' ' || *format
== '.')
3034 if (*format
++ == '%')
3043 if (STRINGP (args
[n
]))
3045 int padding
, nbytes
;
3046 int width
= strwidth (XSTRING (args
[n
])->data
,
3047 STRING_BYTES (XSTRING (args
[n
])));
3050 /* If spec requires it, pad on right with spaces. */
3051 padding
= minlen
- width
;
3053 while (padding
-- > 0)
3061 && !ASCII_BYTE_P (*((unsigned char *) p
- 1))
3062 && STRING_MULTIBYTE (args
[n
])
3063 && !CHAR_HEAD_P (XSTRING (args
[n
])->data
[0]))
3064 maybe_combine_byte
= 1;
3065 nbytes
= copy_text (XSTRING (args
[n
])->data
, p
,
3066 STRING_BYTES (XSTRING (args
[n
])),
3067 STRING_MULTIBYTE (args
[n
]), multibyte
);
3069 nchars
+= XSTRING (args
[n
])->size
;
3072 while (padding
-- > 0)
3078 /* If this argument has text properties, record where
3079 in the result string it appears. */
3080 if (XSTRING (args
[n
])->intervals
)
3084 int nbytes
= nargs
* sizeof *info
;
3085 info
= (struct info
*) alloca (nbytes
);
3086 bzero (info
, nbytes
);
3089 info
[n
].start
= start
;
3090 info
[n
].end
= nchars
;
3093 else if (INTEGERP (args
[n
]) || FLOATP (args
[n
]))
3097 bcopy (this_format_start
, this_format
,
3098 format
- this_format_start
);
3099 this_format
[format
- this_format_start
] = 0;
3101 if (INTEGERP (args
[n
]))
3102 sprintf (p
, this_format
, XINT (args
[n
]));
3104 sprintf (p
, this_format
, XFLOAT_DATA (args
[n
]));
3108 && !ASCII_BYTE_P (*((unsigned char *) p
- 1))
3109 && !CHAR_HEAD_P (*((unsigned char *) p
)))
3110 maybe_combine_byte
= 1;
3111 this_nchars
= strlen (p
);
3113 nchars
+= this_nchars
;
3116 else if (STRING_MULTIBYTE (args
[0]))
3118 /* Copy a whole multibyte character. */
3121 && !ASCII_BYTE_P (*((unsigned char *) p
- 1))
3122 && !CHAR_HEAD_P (*format
))
3123 maybe_combine_byte
= 1;
3125 while (! CHAR_HEAD_P (*format
)) *p
++ = *format
++;
3130 /* Convert a single-byte character to multibyte. */
3131 int len
= copy_text (format
, p
, 1, 0, 1);
3138 *p
++ = *format
++, nchars
++;
3141 if (maybe_combine_byte
)
3142 nchars
= multibyte_chars_in_text (buf
, p
- buf
);
3143 val
= make_specified_string (buf
, nchars
, p
- buf
, multibyte
);
3145 /* If we allocated BUF with malloc, free it too. */
3149 /* If the format string has text properties, or any of the string
3150 arguments has text properties, set up text properties of the
3153 if (XSTRING (args
[0])->intervals
|| info
)
3155 Lisp_Object len
, new_len
, props
;
3156 struct gcpro gcpro1
;
3158 /* Add text properties from the format string. */
3159 len
= make_number (XSTRING (args
[0])->size
);
3160 props
= text_property_list (args
[0], make_number (0), len
, Qnil
);
3165 new_len
= make_number (XSTRING (val
)->size
);
3166 extend_property_ranges (props
, len
, new_len
);
3167 add_text_properties_from_list (val
, props
, make_number (0));
3170 /* Add text properties from arguments. */
3172 for (n
= 1; n
< nargs
; ++n
)
3175 len
= make_number (XSTRING (args
[n
])->size
);
3176 new_len
= make_number (info
[n
].end
- info
[n
].start
);
3177 props
= text_property_list (args
[n
], make_number (0), len
, Qnil
);
3178 extend_property_ranges (props
, len
, new_len
);
3179 add_text_properties_from_list (val
, props
,
3180 make_number (info
[n
].start
));
3193 format1 (string1
, arg0
, arg1
, arg2
, arg3
, arg4
)
3194 EMACS_INT arg0
, arg1
, arg2
, arg3
, arg4
;
3208 doprnt (buf
, sizeof buf
, string1
, (char *)0, 5, (char **) args
);
3210 doprnt (buf
, sizeof buf
, string1
, (char *)0, 5, &string1
+ 1);
3212 return build_string (buf
);
3215 DEFUN ("char-equal", Fchar_equal
, Schar_equal
, 2, 2, 0,
3216 "Return t if two characters match, optionally ignoring case.\n\
3217 Both arguments must be characters (i.e. integers).\n\
3218 Case is ignored if `case-fold-search' is non-nil in the current buffer.")
3220 register Lisp_Object c1
, c2
;
3223 CHECK_NUMBER (c1
, 0);
3224 CHECK_NUMBER (c2
, 1);
3226 if (XINT (c1
) == XINT (c2
))
3228 if (NILP (current_buffer
->case_fold_search
))
3231 /* Do these in separate statements,
3232 then compare the variables.
3233 because of the way DOWNCASE uses temp variables. */
3234 i1
= DOWNCASE (XFASTINT (c1
));
3235 i2
= DOWNCASE (XFASTINT (c2
));
3236 return (i1
== i2
? Qt
: Qnil
);
3239 /* Transpose the markers in two regions of the current buffer, and
3240 adjust the ones between them if necessary (i.e.: if the regions
3243 START1, END1 are the character positions of the first region.
3244 START1_BYTE, END1_BYTE are the byte positions.
3245 START2, END2 are the character positions of the second region.
3246 START2_BYTE, END2_BYTE are the byte positions.
3248 Traverses the entire marker list of the buffer to do so, adding an
3249 appropriate amount to some, subtracting from some, and leaving the
3250 rest untouched. Most of this is copied from adjust_markers in insdel.c.
3252 It's the caller's job to ensure that START1 <= END1 <= START2 <= END2. */
3255 transpose_markers (start1
, end1
, start2
, end2
,
3256 start1_byte
, end1_byte
, start2_byte
, end2_byte
)
3257 register int start1
, end1
, start2
, end2
;
3258 register int start1_byte
, end1_byte
, start2_byte
, end2_byte
;
3260 register int amt1
, amt1_byte
, amt2
, amt2_byte
, diff
, diff_byte
, mpos
;
3261 register Lisp_Object marker
;
3263 /* Update point as if it were a marker. */
3267 TEMP_SET_PT_BOTH (PT
+ (end2
- end1
),
3268 PT_BYTE
+ (end2_byte
- end1_byte
));
3269 else if (PT
< start2
)
3270 TEMP_SET_PT_BOTH (PT
+ (end2
- start2
) - (end1
- start1
),
3271 (PT_BYTE
+ (end2_byte
- start2_byte
)
3272 - (end1_byte
- start1_byte
)));
3274 TEMP_SET_PT_BOTH (PT
- (start2
- start1
),
3275 PT_BYTE
- (start2_byte
- start1_byte
));
3277 /* We used to adjust the endpoints here to account for the gap, but that
3278 isn't good enough. Even if we assume the caller has tried to move the
3279 gap out of our way, it might still be at start1 exactly, for example;
3280 and that places it `inside' the interval, for our purposes. The amount
3281 of adjustment is nontrivial if there's a `denormalized' marker whose
3282 position is between GPT and GPT + GAP_SIZE, so it's simpler to leave
3283 the dirty work to Fmarker_position, below. */
3285 /* The difference between the region's lengths */
3286 diff
= (end2
- start2
) - (end1
- start1
);
3287 diff_byte
= (end2_byte
- start2_byte
) - (end1_byte
- start1_byte
);
3289 /* For shifting each marker in a region by the length of the other
3290 region plus the distance between the regions. */
3291 amt1
= (end2
- start2
) + (start2
- end1
);
3292 amt2
= (end1
- start1
) + (start2
- end1
);
3293 amt1_byte
= (end2_byte
- start2_byte
) + (start2_byte
- end1_byte
);
3294 amt2_byte
= (end1_byte
- start1_byte
) + (start2_byte
- end1_byte
);
3296 for (marker
= BUF_MARKERS (current_buffer
); !NILP (marker
);
3297 marker
= XMARKER (marker
)->chain
)
3299 mpos
= marker_byte_position (marker
);
3300 if (mpos
>= start1_byte
&& mpos
< end2_byte
)
3302 if (mpos
< end1_byte
)
3304 else if (mpos
< start2_byte
)
3308 XMARKER (marker
)->bytepos
= mpos
;
3310 mpos
= XMARKER (marker
)->charpos
;
3311 if (mpos
>= start1
&& mpos
< end2
)
3315 else if (mpos
< start2
)
3320 XMARKER (marker
)->charpos
= mpos
;
3324 DEFUN ("transpose-regions", Ftranspose_regions
, Stranspose_regions
, 4, 5, 0,
3325 "Transpose region START1 to END1 with START2 to END2.\n\
3326 The regions may not be overlapping, because the size of the buffer is\n\
3327 never changed in a transposition.\n\
3329 Optional fifth arg LEAVE_MARKERS, if non-nil, means don't update\n\
3330 any markers that happen to be located in the regions.\n\
3332 Transposing beyond buffer boundaries is an error.")
3333 (startr1
, endr1
, startr2
, endr2
, leave_markers
)
3334 Lisp_Object startr1
, endr1
, startr2
, endr2
, leave_markers
;
3336 register int start1
, end1
, start2
, end2
;
3337 int start1_byte
, start2_byte
, len1_byte
, len2_byte
;
3338 int gap
, len1
, len_mid
, len2
;
3339 unsigned char *start1_addr
, *start2_addr
, *temp
;
3340 int combined_before_bytes_1
, combined_after_bytes_1
;
3341 int combined_before_bytes_2
, combined_after_bytes_2
;
3342 struct gcpro gcpro1
, gcpro2
;
3344 #ifdef USE_TEXT_PROPERTIES
3345 INTERVAL cur_intv
, tmp_interval1
, tmp_interval_mid
, tmp_interval2
;
3346 cur_intv
= BUF_INTERVALS (current_buffer
);
3347 #endif /* USE_TEXT_PROPERTIES */
3349 validate_region (&startr1
, &endr1
);
3350 validate_region (&startr2
, &endr2
);
3352 start1
= XFASTINT (startr1
);
3353 end1
= XFASTINT (endr1
);
3354 start2
= XFASTINT (startr2
);
3355 end2
= XFASTINT (endr2
);
3358 /* Swap the regions if they're reversed. */
3361 register int glumph
= start1
;
3369 len1
= end1
- start1
;
3370 len2
= end2
- start2
;
3373 error ("Transposed regions overlap");
3374 else if (start1
== end1
|| start2
== end2
)
3375 error ("Transposed region has length 0");
3377 /* The possibilities are:
3378 1. Adjacent (contiguous) regions, or separate but equal regions
3379 (no, really equal, in this case!), or
3380 2. Separate regions of unequal size.
3382 The worst case is usually No. 2. It means that (aside from
3383 potential need for getting the gap out of the way), there also
3384 needs to be a shifting of the text between the two regions. So
3385 if they are spread far apart, we are that much slower... sigh. */
3387 /* It must be pointed out that the really studly thing to do would
3388 be not to move the gap at all, but to leave it in place and work
3389 around it if necessary. This would be extremely efficient,
3390 especially considering that people are likely to do
3391 transpositions near where they are working interactively, which
3392 is exactly where the gap would be found. However, such code
3393 would be much harder to write and to read. So, if you are
3394 reading this comment and are feeling squirrely, by all means have
3395 a go! I just didn't feel like doing it, so I will simply move
3396 the gap the minimum distance to get it out of the way, and then
3397 deal with an unbroken array. */
3399 /* Make sure the gap won't interfere, by moving it out of the text
3400 we will operate on. */
3401 if (start1
< gap
&& gap
< end2
)
3403 if (gap
- start1
< end2
- gap
)
3409 start1_byte
= CHAR_TO_BYTE (start1
);
3410 start2_byte
= CHAR_TO_BYTE (start2
);
3411 len1_byte
= CHAR_TO_BYTE (end1
) - start1_byte
;
3412 len2_byte
= CHAR_TO_BYTE (end2
) - start2_byte
;
3416 combined_before_bytes_2
3417 = count_combining_before (BYTE_POS_ADDR (start2_byte
),
3418 len2_byte
, start1
, start1_byte
);
3419 combined_before_bytes_1
3420 = count_combining_before (BYTE_POS_ADDR (start1_byte
),
3421 len1_byte
, end2
, start2_byte
+ len2_byte
);
3422 combined_after_bytes_1
3423 = count_combining_after (BYTE_POS_ADDR (start1_byte
),
3424 len1_byte
, end2
, start2_byte
+ len2_byte
);
3425 combined_after_bytes_2
= 0;
3429 combined_before_bytes_2
3430 = count_combining_before (BYTE_POS_ADDR (start2_byte
),
3431 len2_byte
, start1
, start1_byte
);
3432 combined_before_bytes_1
3433 = count_combining_before (BYTE_POS_ADDR (start1_byte
),
3434 len1_byte
, start2
, start2_byte
);
3435 combined_after_bytes_2
3436 = count_combining_after (BYTE_POS_ADDR (start2_byte
),
3437 len2_byte
, end1
, start1_byte
+ len1_byte
);
3438 combined_after_bytes_1
3439 = count_combining_after (BYTE_POS_ADDR (start1_byte
),
3440 len1_byte
, end2
, start2_byte
+ len2_byte
);
3443 /* If any combining is going to happen, do this the stupid way,
3444 because replace handles combining properly. */
3445 if (combined_before_bytes_1
|| combined_before_bytes_2
3446 || combined_after_bytes_1
|| combined_after_bytes_2
)
3448 Lisp_Object text1
, text2
;
3450 text1
= text2
= Qnil
;
3451 GCPRO2 (text1
, text2
);
3453 text1
= make_buffer_string_both (start1
, start1_byte
,
3454 end1
, start1_byte
+ len1_byte
, 1);
3455 text2
= make_buffer_string_both (start2
, start2_byte
,
3456 end2
, start2_byte
+ len2_byte
, 1);
3458 transpose_markers (start1
, end1
, start2
, end2
,
3459 start1_byte
, start1_byte
+ len1_byte
,
3460 start2_byte
, start2_byte
+ len2_byte
);
3462 replace_range (start2
, end2
, text1
, 1, 0, 0);
3463 replace_range (start1
, end1
, text2
, 1, 0, 0);
3469 /* Hmmm... how about checking to see if the gap is large
3470 enough to use as the temporary storage? That would avoid an
3471 allocation... interesting. Later, don't fool with it now. */
3473 /* Working without memmove, for portability (sigh), so must be
3474 careful of overlapping subsections of the array... */
3476 if (end1
== start2
) /* adjacent regions */
3478 modify_region (current_buffer
, start1
, end2
);
3479 record_change (start1
, len1
+ len2
);
3481 #ifdef USE_TEXT_PROPERTIES
3482 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
3483 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
3484 Fset_text_properties (make_number (start1
), make_number (end2
),
3486 #endif /* USE_TEXT_PROPERTIES */
3488 /* First region smaller than second. */
3489 if (len1_byte
< len2_byte
)
3491 /* We use alloca only if it is small,
3492 because we want to avoid stack overflow. */
3493 if (len2_byte
> 20000)
3494 temp
= (unsigned char *) xmalloc (len2_byte
);
3496 temp
= (unsigned char *) alloca (len2_byte
);
3498 /* Don't precompute these addresses. We have to compute them
3499 at the last minute, because the relocating allocator might
3500 have moved the buffer around during the xmalloc. */
3501 start1_addr
= BYTE_POS_ADDR (start1_byte
);
3502 start2_addr
= BYTE_POS_ADDR (start2_byte
);
3504 bcopy (start2_addr
, temp
, len2_byte
);
3505 bcopy (start1_addr
, start1_addr
+ len2_byte
, len1_byte
);
3506 bcopy (temp
, start1_addr
, len2_byte
);
3507 if (len2_byte
> 20000)
3511 /* First region not smaller than second. */
3513 if (len1_byte
> 20000)
3514 temp
= (unsigned char *) xmalloc (len1_byte
);
3516 temp
= (unsigned char *) alloca (len1_byte
);
3517 start1_addr
= BYTE_POS_ADDR (start1_byte
);
3518 start2_addr
= BYTE_POS_ADDR (start2_byte
);
3519 bcopy (start1_addr
, temp
, len1_byte
);
3520 bcopy (start2_addr
, start1_addr
, len2_byte
);
3521 bcopy (temp
, start1_addr
+ len2_byte
, len1_byte
);
3522 if (len1_byte
> 20000)
3525 #ifdef USE_TEXT_PROPERTIES
3526 graft_intervals_into_buffer (tmp_interval1
, start1
+ len2
,
3527 len1
, current_buffer
, 0);
3528 graft_intervals_into_buffer (tmp_interval2
, start1
,
3529 len2
, current_buffer
, 0);
3530 #endif /* USE_TEXT_PROPERTIES */
3532 /* Non-adjacent regions, because end1 != start2, bleagh... */
3535 len_mid
= start2_byte
- (start1_byte
+ len1_byte
);
3537 if (len1_byte
== len2_byte
)
3538 /* Regions are same size, though, how nice. */
3540 modify_region (current_buffer
, start1
, end1
);
3541 modify_region (current_buffer
, start2
, end2
);
3542 record_change (start1
, len1
);
3543 record_change (start2
, len2
);
3544 #ifdef USE_TEXT_PROPERTIES
3545 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
3546 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
3547 Fset_text_properties (make_number (start1
), make_number (end1
),
3549 Fset_text_properties (make_number (start2
), make_number (end2
),
3551 #endif /* USE_TEXT_PROPERTIES */
3553 if (len1_byte
> 20000)
3554 temp
= (unsigned char *) xmalloc (len1_byte
);
3556 temp
= (unsigned char *) alloca (len1_byte
);
3557 start1_addr
= BYTE_POS_ADDR (start1_byte
);
3558 start2_addr
= BYTE_POS_ADDR (start2_byte
);
3559 bcopy (start1_addr
, temp
, len1_byte
);
3560 bcopy (start2_addr
, start1_addr
, len2_byte
);
3561 bcopy (temp
, start2_addr
, len1_byte
);
3562 if (len1_byte
> 20000)
3564 #ifdef USE_TEXT_PROPERTIES
3565 graft_intervals_into_buffer (tmp_interval1
, start2
,
3566 len1
, current_buffer
, 0);
3567 graft_intervals_into_buffer (tmp_interval2
, start1
,
3568 len2
, current_buffer
, 0);
3569 #endif /* USE_TEXT_PROPERTIES */
3572 else if (len1_byte
< len2_byte
) /* Second region larger than first */
3573 /* Non-adjacent & unequal size, area between must also be shifted. */
3575 modify_region (current_buffer
, start1
, end2
);
3576 record_change (start1
, (end2
- start1
));
3577 #ifdef USE_TEXT_PROPERTIES
3578 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
3579 tmp_interval_mid
= copy_intervals (cur_intv
, end1
, len_mid
);
3580 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
3581 Fset_text_properties (make_number (start1
), make_number (end2
),
3583 #endif /* USE_TEXT_PROPERTIES */
3585 /* holds region 2 */
3586 if (len2_byte
> 20000)
3587 temp
= (unsigned char *) xmalloc (len2_byte
);
3589 temp
= (unsigned char *) alloca (len2_byte
);
3590 start1_addr
= BYTE_POS_ADDR (start1_byte
);
3591 start2_addr
= BYTE_POS_ADDR (start2_byte
);
3592 bcopy (start2_addr
, temp
, len2_byte
);
3593 bcopy (start1_addr
, start1_addr
+ len_mid
+ len2_byte
, len1_byte
);
3594 safe_bcopy (start1_addr
+ len1_byte
, start1_addr
+ len2_byte
, len_mid
);
3595 bcopy (temp
, start1_addr
, len2_byte
);
3596 if (len2_byte
> 20000)
3598 #ifdef USE_TEXT_PROPERTIES
3599 graft_intervals_into_buffer (tmp_interval1
, end2
- len1
,
3600 len1
, current_buffer
, 0);
3601 graft_intervals_into_buffer (tmp_interval_mid
, start1
+ len2
,
3602 len_mid
, current_buffer
, 0);
3603 graft_intervals_into_buffer (tmp_interval2
, start1
,
3604 len2
, current_buffer
, 0);
3605 #endif /* USE_TEXT_PROPERTIES */
3608 /* Second region smaller than first. */
3610 record_change (start1
, (end2
- start1
));
3611 modify_region (current_buffer
, start1
, end2
);
3613 #ifdef USE_TEXT_PROPERTIES
3614 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
3615 tmp_interval_mid
= copy_intervals (cur_intv
, end1
, len_mid
);
3616 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
3617 Fset_text_properties (make_number (start1
), make_number (end2
),
3619 #endif /* USE_TEXT_PROPERTIES */
3621 /* holds region 1 */
3622 if (len1_byte
> 20000)
3623 temp
= (unsigned char *) xmalloc (len1_byte
);
3625 temp
= (unsigned char *) alloca (len1_byte
);
3626 start1_addr
= BYTE_POS_ADDR (start1_byte
);
3627 start2_addr
= BYTE_POS_ADDR (start2_byte
);
3628 bcopy (start1_addr
, temp
, len1_byte
);
3629 bcopy (start2_addr
, start1_addr
, len2_byte
);
3630 bcopy (start1_addr
+ len1_byte
, start1_addr
+ len2_byte
, len_mid
);
3631 bcopy (temp
, start1_addr
+ len2_byte
+ len_mid
, len1_byte
);
3632 if (len1_byte
> 20000)
3634 #ifdef USE_TEXT_PROPERTIES
3635 graft_intervals_into_buffer (tmp_interval1
, end2
- len1
,
3636 len1
, current_buffer
, 0);
3637 graft_intervals_into_buffer (tmp_interval_mid
, start1
+ len2
,
3638 len_mid
, current_buffer
, 0);
3639 graft_intervals_into_buffer (tmp_interval2
, start1
,
3640 len2
, current_buffer
, 0);
3641 #endif /* USE_TEXT_PROPERTIES */
3645 /* When doing multiple transpositions, it might be nice
3646 to optimize this. Perhaps the markers in any one buffer
3647 should be organized in some sorted data tree. */
3648 if (NILP (leave_markers
))
3650 transpose_markers (start1
, end1
, start2
, end2
,
3651 start1_byte
, start1_byte
+ len1_byte
,
3652 start2_byte
, start2_byte
+ len2_byte
);
3653 fix_overlays_in_range (start1
, end2
);
3665 Qbuffer_access_fontify_functions
3666 = intern ("buffer-access-fontify-functions");
3667 staticpro (&Qbuffer_access_fontify_functions
);
3669 DEFVAR_LISP ("buffer-access-fontify-functions",
3670 &Vbuffer_access_fontify_functions
,
3671 "List of functions called by `buffer-substring' to fontify if necessary.\n\
3672 Each function is called with two arguments which specify the range\n\
3673 of the buffer being accessed.");
3674 Vbuffer_access_fontify_functions
= Qnil
;
3678 extern Lisp_Object Vprin1_to_string_buffer
;
3679 obuf
= Fcurrent_buffer ();
3680 /* Do this here, because init_buffer_once is too early--it won't work. */
3681 Fset_buffer (Vprin1_to_string_buffer
);
3682 /* Make sure buffer-access-fontify-functions is nil in this buffer. */
3683 Fset (Fmake_local_variable (intern ("buffer-access-fontify-functions")),
3688 DEFVAR_LISP ("buffer-access-fontified-property",
3689 &Vbuffer_access_fontified_property
,
3690 "Property which (if non-nil) indicates text has been fontified.\n\
3691 `buffer-substring' need not call the `buffer-access-fontify-functions'\n\
3692 functions if all the text being accessed has this property.");
3693 Vbuffer_access_fontified_property
= Qnil
;
3695 DEFVAR_LISP ("system-name", &Vsystem_name
,
3696 "The name of the machine Emacs is running on.");
3698 DEFVAR_LISP ("user-full-name", &Vuser_full_name
,
3699 "The full name of the user logged in.");
3701 DEFVAR_LISP ("user-login-name", &Vuser_login_name
,
3702 "The user's name, taken from environment variables if possible.");
3704 DEFVAR_LISP ("user-real-login-name", &Vuser_real_login_name
,
3705 "The user's name, based upon the real uid only.");
3707 defsubr (&Spropertize
);
3708 defsubr (&Schar_equal
);
3709 defsubr (&Sgoto_char
);
3710 defsubr (&Sstring_to_char
);
3711 defsubr (&Schar_to_string
);
3712 defsubr (&Sbuffer_substring
);
3713 defsubr (&Sbuffer_substring_no_properties
);
3714 defsubr (&Sbuffer_string
);
3716 defsubr (&Spoint_marker
);
3717 defsubr (&Smark_marker
);
3719 defsubr (&Sregion_beginning
);
3720 defsubr (&Sregion_end
);
3722 staticpro (&Qfield
);
3723 Qfield
= intern ("field");
3724 defsubr (&Sfield_beginning
);
3725 defsubr (&Sfield_end
);
3726 defsubr (&Sfield_string
);
3727 defsubr (&Sfield_string_no_properties
);
3728 defsubr (&Serase_field
);
3729 defsubr (&Sconstrain_to_field
);
3731 defsubr (&Sline_beginning_position
);
3732 defsubr (&Sline_end_position
);
3734 /* defsubr (&Smark); */
3735 /* defsubr (&Sset_mark); */
3736 defsubr (&Ssave_excursion
);
3737 defsubr (&Ssave_current_buffer
);
3739 defsubr (&Sbufsize
);
3740 defsubr (&Spoint_max
);
3741 defsubr (&Spoint_min
);
3742 defsubr (&Spoint_min_marker
);
3743 defsubr (&Spoint_max_marker
);
3744 defsubr (&Sgap_position
);
3745 defsubr (&Sgap_size
);
3746 defsubr (&Sposition_bytes
);
3747 defsubr (&Sbyte_to_position
);
3753 defsubr (&Sfollowing_char
);
3754 defsubr (&Sprevious_char
);
3755 defsubr (&Schar_after
);
3756 defsubr (&Schar_before
);
3758 defsubr (&Sinsert_before_markers
);
3759 defsubr (&Sinsert_and_inherit
);
3760 defsubr (&Sinsert_and_inherit_before_markers
);
3761 defsubr (&Sinsert_char
);
3763 defsubr (&Suser_login_name
);
3764 defsubr (&Suser_real_login_name
);
3765 defsubr (&Suser_uid
);
3766 defsubr (&Suser_real_uid
);
3767 defsubr (&Suser_full_name
);
3768 defsubr (&Semacs_pid
);
3769 defsubr (&Scurrent_time
);
3770 defsubr (&Sformat_time_string
);
3771 defsubr (&Sdecode_time
);
3772 defsubr (&Sencode_time
);
3773 defsubr (&Scurrent_time_string
);
3774 defsubr (&Scurrent_time_zone
);
3775 defsubr (&Sset_time_zone_rule
);
3776 defsubr (&Ssystem_name
);
3777 defsubr (&Smessage
);
3778 defsubr (&Smessage_box
);
3779 defsubr (&Smessage_or_box
);
3780 defsubr (&Scurrent_message
);
3783 defsubr (&Sinsert_buffer_substring
);
3784 defsubr (&Scompare_buffer_substrings
);
3785 defsubr (&Ssubst_char_in_region
);
3786 defsubr (&Stranslate_region
);
3787 defsubr (&Sdelete_region
);
3789 defsubr (&Snarrow_to_region
);
3790 defsubr (&Ssave_restriction
);
3791 defsubr (&Stranspose_regions
);