1 /* Lisp functions pertaining to editing.
2 Copyright (C) 1985,86,87,89,93,94,95,96,97 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. */
22 #include <sys/types.h>
33 #include "intervals.h"
40 #define min(a, b) ((a) < (b) ? (a) : (b))
41 #define max(a, b) ((a) > (b) ? (a) : (b))
43 extern char **environ
;
44 extern Lisp_Object
make_time ();
45 extern void insert_from_buffer ();
46 static int tm_diff ();
47 static void update_buffer_properties ();
48 void set_time_zone_rule ();
50 Lisp_Object Vbuffer_access_fontify_functions
;
51 Lisp_Object Qbuffer_access_fontify_functions
;
52 Lisp_Object Vbuffer_access_fontified_property
;
54 Lisp_Object
Fuser_full_name ();
56 /* Some static data, and a function to initialize it for each run */
58 Lisp_Object Vsystem_name
;
59 Lisp_Object Vuser_real_login_name
; /* login name of current user ID */
60 Lisp_Object Vuser_full_name
; /* full name of current user */
61 Lisp_Object Vuser_login_name
; /* user name from LOGNAME or USER */
67 register unsigned char *p
, *q
, *r
;
68 struct passwd
*pw
; /* password entry for the current user */
71 /* Set up system_name even when dumping. */
75 /* Don't bother with this on initial start when just dumping out */
78 #endif /* not CANNOT_DUMP */
80 pw
= (struct passwd
*) getpwuid (getuid ());
82 /* We let the real user name default to "root" because that's quite
83 accurate on MSDOG and because it lets Emacs find the init file.
84 (The DVX libraries override the Djgpp libraries here.) */
85 Vuser_real_login_name
= build_string (pw
? pw
->pw_name
: "root");
87 Vuser_real_login_name
= build_string (pw
? pw
->pw_name
: "unknown");
90 /* Get the effective user name, by consulting environment variables,
91 or the effective uid if those are unset. */
92 user_name
= (char *) getenv ("LOGNAME");
95 user_name
= (char *) getenv ("USERNAME"); /* it's USERNAME on NT */
97 user_name
= (char *) getenv ("USER");
98 #endif /* WINDOWSNT */
101 pw
= (struct passwd
*) getpwuid (geteuid ());
102 user_name
= (char *) (pw
? pw
->pw_name
: "unknown");
104 Vuser_login_name
= build_string (user_name
);
106 /* If the user name claimed in the environment vars differs from
107 the real uid, use the claimed name to find the full name. */
108 tem
= Fstring_equal (Vuser_login_name
, Vuser_real_login_name
);
109 Vuser_full_name
= Fuser_full_name (NILP (tem
)? make_number (geteuid())
112 p
= (unsigned char *) getenv ("NAME");
114 Vuser_full_name
= build_string (p
);
115 else if (NILP (Vuser_full_name
))
116 Vuser_full_name
= build_string ("unknown");
119 DEFUN ("char-to-string", Fchar_to_string
, Schar_to_string
, 1, 1, 0,
120 "Convert arg CHAR to a string containing multi-byte form of that character.")
122 Lisp_Object character
;
125 char workbuf
[4], *str
;
127 CHECK_NUMBER (character
, 0);
129 len
= CHAR_STRING (XFASTINT (character
), workbuf
, str
);
130 return make_string (str
, len
);
133 DEFUN ("string-to-char", Fstring_to_char
, Sstring_to_char
, 1, 1, 0,
134 "Convert arg STRING to a character, the first character of that string.\n\
135 A multibyte character is handled correctly.")
137 register Lisp_Object string
;
139 register Lisp_Object val
;
140 register struct Lisp_String
*p
;
141 CHECK_STRING (string
, 0);
142 p
= XSTRING (string
);
144 XSETFASTINT (val
, STRING_CHAR (p
->data
, p
->size
));
146 XSETFASTINT (val
, 0);
150 DEFUN ("sref", Fsref
, Ssref
, 2, 2, 0,
151 "Return the character in STRING at INDEX. INDEX starts at 0.\n\
152 A multibyte character is handled correctly.\n\
153 INDEX not pointing at character boundary is an error.")
155 Lisp_Object str
, idx
;
157 register int idxval
, len
;
158 register unsigned char *p
;
159 register Lisp_Object val
;
161 CHECK_STRING (str
, 0);
162 CHECK_NUMBER (idx
, 1);
164 if (idxval
< 0 || idxval
>= (len
= XVECTOR (str
)->size
))
165 args_out_of_range (str
, idx
);
166 p
= XSTRING (str
)->data
+ idxval
;
167 if (!CHAR_HEAD_P (p
))
168 error ("Not character boundary");
170 len
= XSTRING (str
)->size
- idxval
;
171 XSETFASTINT (val
, STRING_CHAR (p
, len
));
180 register Lisp_Object mark
;
181 mark
= Fmake_marker ();
182 Fset_marker (mark
, make_number (val
), Qnil
);
186 DEFUN ("point", Fpoint
, Spoint
, 0, 0, 0,
187 "Return value of point, as an integer.\n\
188 Beginning of buffer is position (point-min)")
192 XSETFASTINT (temp
, PT
);
196 DEFUN ("point-marker", Fpoint_marker
, Spoint_marker
, 0, 0, 0,
197 "Return value of point, as a marker object.")
200 return buildmark (PT
);
204 clip_to_bounds (lower
, num
, upper
)
205 int lower
, num
, upper
;
209 else if (num
> upper
)
215 DEFUN ("goto-char", Fgoto_char
, Sgoto_char
, 1, 1, "NGoto char: ",
216 "Set point to POSITION, a number or marker.\n\
217 Beginning of buffer is position (point-min), end is (point-max).\n\
218 If the position is in the middle of a multibyte form,\n\
219 the actual point is set at the head of the multibyte form\n\
220 except in the case that `enable-multibyte-characters' is nil.")
222 register Lisp_Object position
;
227 CHECK_NUMBER_COERCE_MARKER (position
, 0);
229 pos
= clip_to_bounds (BEGV
, XINT (position
), ZV
);
230 /* If POS is in a middle of multi-byte form (i.e. *P >= 0xA0), we
231 must decrement POS until it points the head of the multi-byte
233 if (!NILP (current_buffer
->enable_multibyte_characters
)
234 && *(p
= POS_ADDR (pos
)) >= 0xA0
237 /* Since a multi-byte form does not contain the gap, POS should
238 not stride over the gap while it is being decreased. So, we
239 set the limit as below. */
240 unsigned char *p_min
= pos
< GPT
? BEG_ADDR
: GAP_END_ADDR
;
241 unsigned int saved_pos
= pos
;
245 } while (p
> p_min
&& *p
>= 0xA0);
247 /* This was an invalid multi-byte form. */
249 XSETFASTINT (position
, pos
);
256 region_limit (beginningp
)
259 extern Lisp_Object Vmark_even_if_inactive
; /* Defined in callint.c. */
260 register Lisp_Object m
;
261 if (!NILP (Vtransient_mark_mode
) && NILP (Vmark_even_if_inactive
)
262 && NILP (current_buffer
->mark_active
))
263 Fsignal (Qmark_inactive
, Qnil
);
264 m
= Fmarker_position (current_buffer
->mark
);
265 if (NILP (m
)) error ("There is no region now");
266 if ((PT
< XFASTINT (m
)) == beginningp
)
267 return (make_number (PT
));
272 DEFUN ("region-beginning", Fregion_beginning
, Sregion_beginning
, 0, 0, 0,
273 "Return position of beginning of region, as an integer.")
276 return (region_limit (1));
279 DEFUN ("region-end", Fregion_end
, Sregion_end
, 0, 0, 0,
280 "Return position of end of region, as an integer.")
283 return (region_limit (0));
286 DEFUN ("mark-marker", Fmark_marker
, Smark_marker
, 0, 0, 0,
287 "Return this buffer's mark, as a marker object.\n\
288 Watch out! Moving this marker changes the mark position.\n\
289 If you set the marker not to point anywhere, the buffer will have no mark.")
292 return current_buffer
->mark
;
295 DEFUN ("line-beginning-position", Fline_beginning_position
, Sline_beginning_position
,
297 "Return the character position of the first character on the current line.\n\
298 With argument N not nil or 1, move forward N - 1 lines first.\n\
299 If scan reaches end of buffer, return that position.\n\
300 This function does not move point.")
304 register int orig
, end
;
312 Fforward_line (make_number (XINT (n
) - 1));
316 return make_number (end
);
319 DEFUN ("line-end-position", Fline_end_position
, Sline_end_position
,
321 "Return the character position of the last character on the current line.\n\
322 With argument N not nil or 1, move forward N - 1 lines first.\n\
323 If scan reaches end of buffer, return that position.\n\
324 This function does not move point.")
333 return make_number (find_before_next_newline
334 (PT
, 0, XINT (n
) - (XINT (n
) <= 0)));
338 save_excursion_save ()
340 register int visible
= (XBUFFER (XWINDOW (selected_window
)->buffer
)
343 return Fcons (Fpoint_marker (),
344 Fcons (Fcopy_marker (current_buffer
->mark
, Qnil
),
345 Fcons (visible
? Qt
: Qnil
,
346 current_buffer
->mark_active
)));
350 save_excursion_restore (info
)
353 Lisp_Object tem
, tem1
, omark
, nmark
;
354 struct gcpro gcpro1
, gcpro2
, gcpro3
;
356 tem
= Fmarker_buffer (Fcar (info
));
357 /* If buffer being returned to is now deleted, avoid error */
358 /* Otherwise could get error here while unwinding to top level
360 /* In that case, Fmarker_buffer returns nil now. */
364 omark
= nmark
= Qnil
;
365 GCPRO3 (info
, omark
, nmark
);
370 unchain_marker (tem
);
371 tem
= Fcar (Fcdr (info
));
372 omark
= Fmarker_position (current_buffer
->mark
);
373 Fset_marker (current_buffer
->mark
, tem
, Fcurrent_buffer ());
374 nmark
= Fmarker_position (tem
);
375 unchain_marker (tem
);
376 tem
= Fcdr (Fcdr (info
));
377 #if 0 /* We used to make the current buffer visible in the selected window
378 if that was true previously. That avoids some anomalies.
379 But it creates others, and it wasn't documented, and it is simpler
380 and cleaner never to alter the window/buffer connections. */
383 && current_buffer
!= XBUFFER (XWINDOW (selected_window
)->buffer
))
384 Fswitch_to_buffer (Fcurrent_buffer (), Qnil
);
387 tem1
= current_buffer
->mark_active
;
388 current_buffer
->mark_active
= Fcdr (tem
);
389 if (!NILP (Vrun_hooks
))
391 /* If mark is active now, and either was not active
392 or was at a different place, run the activate hook. */
393 if (! NILP (current_buffer
->mark_active
))
395 if (! EQ (omark
, nmark
))
396 call1 (Vrun_hooks
, intern ("activate-mark-hook"));
398 /* If mark has ceased to be active, run deactivate hook. */
399 else if (! NILP (tem1
))
400 call1 (Vrun_hooks
, intern ("deactivate-mark-hook"));
406 DEFUN ("save-excursion", Fsave_excursion
, Ssave_excursion
, 0, UNEVALLED
, 0,
407 "Save point, mark, and current buffer; execute BODY; restore those things.\n\
408 Executes BODY just like `progn'.\n\
409 The values of point, mark and the current buffer are restored\n\
410 even in case of abnormal exit (throw or error).\n\
411 The state of activation of the mark is also restored.")
415 register Lisp_Object val
;
416 int count
= specpdl_ptr
- specpdl
;
418 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
421 return unbind_to (count
, val
);
424 DEFUN ("save-current-buffer", Fsave_current_buffer
, Ssave_current_buffer
, 0, UNEVALLED
, 0,
425 "Save the current buffer; execute BODY; restore the current buffer.\n\
426 Executes BODY just like `progn'.")
430 register Lisp_Object val
;
431 int count
= specpdl_ptr
- specpdl
;
433 record_unwind_protect (Fset_buffer
, Fcurrent_buffer ());
436 return unbind_to (count
, val
);
439 DEFUN ("buffer-size", Fbufsize
, Sbufsize
, 0, 0, 0,
440 "Return the number of characters in the current buffer.")
444 XSETFASTINT (temp
, Z
- BEG
);
448 DEFUN ("point-min", Fpoint_min
, Spoint_min
, 0, 0, 0,
449 "Return the minimum permissible value of point in the current buffer.\n\
450 This is 1, unless narrowing (a buffer restriction) is in effect.")
454 XSETFASTINT (temp
, BEGV
);
458 DEFUN ("point-min-marker", Fpoint_min_marker
, Spoint_min_marker
, 0, 0, 0,
459 "Return a marker to the minimum permissible value of point in this buffer.\n\
460 This is the beginning, unless narrowing (a buffer restriction) is in effect.")
463 return buildmark (BEGV
);
466 DEFUN ("point-max", Fpoint_max
, Spoint_max
, 0, 0, 0,
467 "Return the maximum permissible value of point in the current buffer.\n\
468 This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
469 is in effect, in which case it is less.")
473 XSETFASTINT (temp
, ZV
);
477 DEFUN ("point-max-marker", Fpoint_max_marker
, Spoint_max_marker
, 0, 0, 0,
478 "Return a marker to the maximum permissible value of point in this buffer.\n\
479 This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
480 is in effect, in which case it is less.")
483 return buildmark (ZV
);
486 DEFUN ("following-char", Ffollowing_char
, Sfollowing_char
, 0, 0, 0,
487 "Return the character following point, as a number.\n\
488 At the end of the buffer or accessible region, return 0.\n\
489 If `enable-multibyte-characters' is nil or point is not\n\
490 at character boundary, multibyte form is ignored,\n\
491 and only one byte following point is returned as a character.")
496 XSETFASTINT (temp
, 0);
498 XSETFASTINT (temp
, FETCH_CHAR (PT
));
502 DEFUN ("preceding-char", Fprevious_char
, Sprevious_char
, 0, 0, 0,
503 "Return the character preceding point, as a number.\n\
504 At the beginning of the buffer or accessible region, return 0.\n\
505 If `enable-multibyte-characters' is nil or point is not\n\
506 at character boundary, multi-byte form is ignored,\n\
507 and only one byte preceding point is returned as a character.")
512 XSETFASTINT (temp
, 0);
513 else if (!NILP (current_buffer
->enable_multibyte_characters
))
517 XSETFASTINT (temp
, FETCH_CHAR (pos
));
520 XSETFASTINT (temp
, FETCH_BYTE (PT
- 1));
524 DEFUN ("bobp", Fbobp
, Sbobp
, 0, 0, 0,
525 "Return T if point is at the beginning of the buffer.\n\
526 If the buffer is narrowed, this means the beginning of the narrowed part.")
534 DEFUN ("eobp", Feobp
, Seobp
, 0, 0, 0,
535 "Return T if point is at the end of the buffer.\n\
536 If the buffer is narrowed, this means the end of the narrowed part.")
544 DEFUN ("bolp", Fbolp
, Sbolp
, 0, 0, 0,
545 "Return T if point is at the beginning of a line.")
548 if (PT
== BEGV
|| FETCH_BYTE (PT
- 1) == '\n')
553 DEFUN ("eolp", Feolp
, Seolp
, 0, 0, 0,
554 "Return T if point is at the end of a line.\n\
555 `End of a line' includes point being at the end of the buffer.")
558 if (PT
== ZV
|| FETCH_BYTE (PT
) == '\n')
563 DEFUN ("char-after", Fchar_after
, Schar_after
, 0, 1, 0,
564 "Return character in current buffer at position POS.\n\
565 POS is an integer or a buffer pointer.\n\
566 If POS is out of range, the value is nil.\n\
567 If `enable-multibyte-characters' is nil or POS is not at character boundary,\n\
568 multi-byte form is ignored, and only one byte at POS\n\
569 is returned as a character.")
573 register Lisp_Object val
;
580 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
583 if (n
< BEGV
|| n
>= ZV
)
587 XSETFASTINT (val
, FETCH_CHAR (n
));
591 DEFUN ("char-before", Fchar_before
, Schar_before
, 0, 1, 0,
592 "Return character in current buffer preceding position POS.\n\
593 POS is an integer or a buffer pointer.\n\
594 If POS is out of range, the value is nil.\n\
595 If `enable-multibyte-characters' is nil or POS is not at character boundary,\n\
596 multi-byte form is ignored, and only one byte preceding POS\n\
597 is returned as a character.")
601 register Lisp_Object val
;
608 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
613 if (!NILP (current_buffer
->enable_multibyte_characters
))
616 if (n
< BEGV
|| n
>= ZV
)
618 XSETFASTINT (val
, FETCH_CHAR (n
));
623 if (n
< BEGV
|| n
>= ZV
)
625 XSETFASTINT (val
, FETCH_BYTE (n
));
630 DEFUN ("user-login-name", Fuser_login_name
, Suser_login_name
, 0, 1, 0,
631 "Return the name under which the user logged in, as a string.\n\
632 This is based on the effective uid, not the real uid.\n\
633 Also, if the environment variable LOGNAME or USER is set,\n\
634 that determines the value of this function.\n\n\
635 If optional argument UID is an integer, return the login name of the user\n\
636 with that uid, or nil if there is no such user.")
642 /* Set up the user name info if we didn't do it before.
643 (That can happen if Emacs is dumpable
644 but you decide to run `temacs -l loadup' and not dump. */
645 if (INTEGERP (Vuser_login_name
))
649 return Vuser_login_name
;
651 CHECK_NUMBER (uid
, 0);
652 pw
= (struct passwd
*) getpwuid (XINT (uid
));
653 return (pw
? build_string (pw
->pw_name
) : Qnil
);
656 DEFUN ("user-real-login-name", Fuser_real_login_name
, Suser_real_login_name
,
658 "Return the name of the user's real uid, as a string.\n\
659 This ignores the environment variables LOGNAME and USER, so it differs from\n\
660 `user-login-name' when running under `su'.")
663 /* Set up the user name info if we didn't do it before.
664 (That can happen if Emacs is dumpable
665 but you decide to run `temacs -l loadup' and not dump. */
666 if (INTEGERP (Vuser_login_name
))
668 return Vuser_real_login_name
;
671 DEFUN ("user-uid", Fuser_uid
, Suser_uid
, 0, 0, 0,
672 "Return the effective uid of Emacs, as an integer.")
675 return make_number (geteuid ());
678 DEFUN ("user-real-uid", Fuser_real_uid
, Suser_real_uid
, 0, 0, 0,
679 "Return the real uid of Emacs, as an integer.")
682 return make_number (getuid ());
685 DEFUN ("user-full-name", Fuser_full_name
, Suser_full_name
, 0, 1, 0,
686 "Return the full name of the user logged in, as a string.\n\
687 If optional argument UID is an integer, return the full name of the user\n\
688 with that uid, or \"unknown\" if there is no such user.\n\
689 If UID is a string, return the full name of the user with that login\n\
690 name, or \"unknown\" if no such user could be found.")
695 register char *p
, *q
;
696 extern char *index ();
700 return Vuser_full_name
;
701 else if (NUMBERP (uid
))
702 pw
= (struct passwd
*) getpwuid (XINT (uid
));
703 else if (STRINGP (uid
))
704 pw
= (struct passwd
*) getpwnam (XSTRING (uid
)->data
);
706 error ("Invalid UID specification");
711 p
= (unsigned char *) USER_FULL_NAME
;
712 /* Chop off everything after the first comma. */
713 q
= (unsigned char *) index (p
, ',');
714 full
= make_string (p
, q
? q
- p
: strlen (p
));
716 #ifdef AMPERSAND_FULL_NAME
717 p
= XSTRING (full
)->data
;
718 q
= (unsigned char *) index (p
, '&');
719 /* Substitute the login name for the &, upcasing the first character. */
725 login
= Fuser_login_name (make_number (pw
->pw_uid
));
726 r
= (unsigned char *) alloca (strlen (p
) + XSTRING (login
)->size
+ 1);
729 strcat (r
, XSTRING (login
)->data
);
730 r
[q
- p
] = UPCASE (r
[q
- p
]);
732 full
= build_string (r
);
734 #endif /* AMPERSAND_FULL_NAME */
739 DEFUN ("system-name", Fsystem_name
, Ssystem_name
, 0, 0, 0,
740 "Return the name of the machine you are running on, as a string.")
746 /* For the benefit of callers who don't want to include lisp.h */
750 return (char *) XSTRING (Vsystem_name
)->data
;
753 DEFUN ("emacs-pid", Femacs_pid
, Semacs_pid
, 0, 0, 0,
754 "Return the process ID of Emacs, as an integer.")
757 return make_number (getpid ());
760 DEFUN ("current-time", Fcurrent_time
, Scurrent_time
, 0, 0, 0,
761 "Return the current time, as the number of seconds since 1970-01-01 00:00:00.\n\
762 The time is returned as a list of three integers. The first has the\n\
763 most significant 16 bits of the seconds, while the second has the\n\
764 least significant 16 bits. The third integer gives the microsecond\n\
767 The microsecond count is zero on systems that do not provide\n\
768 resolution finer than a second.")
772 Lisp_Object result
[3];
775 XSETINT (result
[0], (EMACS_SECS (t
) >> 16) & 0xffff);
776 XSETINT (result
[1], (EMACS_SECS (t
) >> 0) & 0xffff);
777 XSETINT (result
[2], EMACS_USECS (t
));
779 return Flist (3, result
);
784 lisp_time_argument (specified_time
, result
)
785 Lisp_Object specified_time
;
788 if (NILP (specified_time
))
789 return time (result
) != -1;
792 Lisp_Object high
, low
;
793 high
= Fcar (specified_time
);
794 CHECK_NUMBER (high
, 0);
795 low
= Fcdr (specified_time
);
798 CHECK_NUMBER (low
, 0);
799 *result
= (XINT (high
) << 16) + (XINT (low
) & 0xffff);
800 return *result
>> 16 == XINT (high
);
804 DEFUN ("format-time-string", Fformat_time_string
, Sformat_time_string
, 1, 3, 0,
805 "Use FORMAT-STRING to format the time TIME, or now if omitted.\n\
806 TIME is specified as (HIGH LOW . IGNORED) or (HIGH . LOW), as returned by\n\
807 `current-time' or `file-attributes'.\n\
808 The third, optional, argument UNIVERSAL, if non-nil, means describe TIME\n\
809 as Universal Time; nil means describe TIME in the local time zone.\n\
810 The value is a copy of FORMAT-STRING, but with certain constructs replaced\n\
811 by text that describes the specified date and time in TIME:\n\
813 %Y is the year, %y within the century, %C the century.\n\
814 %G is the year corresponding to the ISO week, %g within the century.\n\
815 %m is the numeric month, %b and %h the abbreviated name, %B the full name.\n\
816 %d is the day of the month, zero-padded, %e is blank-padded.\n\
817 %u is the numeric day of week from 1 (Monday) to 7, %w from 0 (Sunday) to 6.\n\
818 %a is the abbreviated name of the day of week, %A the full name.\n\
819 %U is the week number starting on Sunday, %W starting on Monday,\n\
820 %V according to ISO 8601.\n\
821 %j is the day of the year.\n\
823 %H is the hour on a 24-hour clock, %I is on a 12-hour clock, %k is like %H\n\
824 only blank-padded, %l is like %I blank-padded.\n\
828 %Z is the time zone name, %z is the numeric form.\n\
829 %s is the number of seconds since 1970-01-01 00:00:00 +0000.\n\
831 %c is the locale's date and time format.\n\
832 %x is the locale's \"preferred\" date format.\n\
833 %D is like \"%m/%d/%y\".\n\
835 %R is like \"%H:%M\", %T is like \"%H:%M:%S\", %r is like \"%I:%M:%S %p\".\n\
836 %X is the locale's \"preferred\" time format.\n\
838 Finally, %n is like \n, %t is like \t, %% is a literal %.\n\
840 Certain flags and modifiers are available with some format controls.
841 The flags are `_' and `-'. For certain characters X, %_X is like %X,\n\
842 but padded with blanks; %-X is like %X, but without padding.\n\
843 %NX (where N stands for an integer) is like %X,\n\
844 but takes up at least N (a number) positions.\n\
845 The modifiers are `E' and `O'. For certain characters X,\n\
846 %EX is a locale's alternative version of %X;\n\
847 %OX is like %X, but uses the locale's number symbols.\n\
849 For example, to produce full ISO 8601 format, use \"%Y-%m-%dT%T%z\".")
850 (format_string
, time
, universal
)
851 Lisp_Object format_string
, time
, universal
;
856 CHECK_STRING (format_string
, 1);
858 if (! lisp_time_argument (time
, &value
))
859 error ("Invalid time specification");
861 /* This is probably enough. */
862 size
= XSTRING (format_string
)->size
* 6 + 50;
866 char *buf
= (char *) alloca (size
+ 1);
869 result
= emacs_strftime (buf
, size
, XSTRING (format_string
)->data
,
870 (NILP (universal
) ? localtime (&value
)
872 if (result
> 0 && result
< size
)
873 return build_string (buf
);
875 error ("Invalid time format specification");
877 /* If buffer was too small, make it bigger and try again. */
878 result
= emacs_strftime (buf
, 0, XSTRING (format_string
)->data
,
879 (NILP (universal
) ? localtime (&value
)
885 DEFUN ("decode-time", Fdecode_time
, Sdecode_time
, 0, 1, 0,
886 "Decode a time value as (SEC MINUTE HOUR DAY MONTH YEAR DOW DST ZONE).\n\
887 The optional SPECIFIED-TIME should be a list of (HIGH LOW . IGNORED)\n\
888 or (HIGH . LOW), as from `current-time' and `file-attributes', or `nil'\n\
889 to use the current time. The list has the following nine members:\n\
890 SEC is an integer between 0 and 60; SEC is 60 for a leap second, which\n\
891 only some operating systems support. MINUTE is an integer between 0 and 59.\n\
892 HOUR is an integer between 0 and 23. DAY is an integer between 1 and 31.\n\
893 MONTH is an integer between 1 and 12. YEAR is an integer indicating the\n\
894 four-digit year. DOW is the day of week, an integer between 0 and 6, where\n\
895 0 is Sunday. DST is t if daylight savings time is effect, otherwise nil.\n\
896 ZONE is an integer indicating the number of seconds east of Greenwich.\n\
897 \(Note that Common Lisp has different meanings for DOW and ZONE.)")
899 Lisp_Object specified_time
;
903 struct tm
*decoded_time
;
904 Lisp_Object list_args
[9];
906 if (! lisp_time_argument (specified_time
, &time_spec
))
907 error ("Invalid time specification");
909 decoded_time
= localtime (&time_spec
);
910 XSETFASTINT (list_args
[0], decoded_time
->tm_sec
);
911 XSETFASTINT (list_args
[1], decoded_time
->tm_min
);
912 XSETFASTINT (list_args
[2], decoded_time
->tm_hour
);
913 XSETFASTINT (list_args
[3], decoded_time
->tm_mday
);
914 XSETFASTINT (list_args
[4], decoded_time
->tm_mon
+ 1);
915 XSETINT (list_args
[5], decoded_time
->tm_year
+ 1900);
916 XSETFASTINT (list_args
[6], decoded_time
->tm_wday
);
917 list_args
[7] = (decoded_time
->tm_isdst
)? Qt
: Qnil
;
919 /* Make a copy, in case gmtime modifies the struct. */
920 save_tm
= *decoded_time
;
921 decoded_time
= gmtime (&time_spec
);
922 if (decoded_time
== 0)
925 XSETINT (list_args
[8], tm_diff (&save_tm
, decoded_time
));
926 return Flist (9, list_args
);
929 DEFUN ("encode-time", Fencode_time
, Sencode_time
, 6, MANY
, 0,
930 "Convert SECOND, MINUTE, HOUR, DAY, MONTH, YEAR and ZONE to internal time.\n\
931 This is the reverse operation of `decode-time', which see.\n\
932 ZONE defaults to the current time zone rule. This can\n\
933 be a string or t (as from `set-time-zone-rule'), or it can be a list\n\
934 \(as from `current-time-zone') or an integer (as from `decode-time')\n\
935 applied without consideration for daylight savings time.\n\
937 You can pass more than 7 arguments; then the first six arguments\n\
938 are used as SECOND through YEAR, and the *last* argument is used as ZONE.\n\
939 The intervening arguments are ignored.\n\
940 This feature lets (apply 'encode-time (decode-time ...)) work.\n\
942 Out-of-range values for SEC, MINUTE, HOUR, DAY, or MONTH are allowed;\n\
943 for example, a DAY of 0 means the day preceding the given month.\n\
944 Year numbers less than 100 are treated just like other year numbers.\n\
945 If you want them to stand for years in this century, you must do that yourself.")
948 register Lisp_Object
*args
;
952 Lisp_Object zone
= (nargs
> 6 ? args
[nargs
- 1] : Qnil
);
954 CHECK_NUMBER (args
[0], 0); /* second */
955 CHECK_NUMBER (args
[1], 1); /* minute */
956 CHECK_NUMBER (args
[2], 2); /* hour */
957 CHECK_NUMBER (args
[3], 3); /* day */
958 CHECK_NUMBER (args
[4], 4); /* month */
959 CHECK_NUMBER (args
[5], 5); /* year */
961 tm
.tm_sec
= XINT (args
[0]);
962 tm
.tm_min
= XINT (args
[1]);
963 tm
.tm_hour
= XINT (args
[2]);
964 tm
.tm_mday
= XINT (args
[3]);
965 tm
.tm_mon
= XINT (args
[4]) - 1;
966 tm
.tm_year
= XINT (args
[5]) - 1900;
977 char **oldenv
= environ
, **newenv
;
981 else if (STRINGP (zone
))
982 tzstring
= (char *) XSTRING (zone
)->data
;
983 else if (INTEGERP (zone
))
985 int abszone
= abs (XINT (zone
));
986 sprintf (tzbuf
, "XXX%s%d:%02d:%02d", "-" + (XINT (zone
) < 0),
987 abszone
/ (60*60), (abszone
/60) % 60, abszone
% 60);
991 error ("Invalid time zone specification");
993 /* Set TZ before calling mktime; merely adjusting mktime's returned
994 value doesn't suffice, since that would mishandle leap seconds. */
995 set_time_zone_rule (tzstring
);
999 /* Restore TZ to previous value. */
1003 #ifdef LOCALTIME_CACHE
1008 if (time
== (time_t) -1)
1009 error ("Specified time is not representable");
1011 return make_time (time
);
1014 DEFUN ("current-time-string", Fcurrent_time_string
, Scurrent_time_string
, 0, 1, 0,
1015 "Return the current time, as a human-readable string.\n\
1016 Programs can use this function to decode a time,\n\
1017 since the number of columns in each field is fixed.\n\
1018 The format is `Sun Sep 16 01:03:52 1973'.\n\
1019 However, see also the functions `decode-time' and `format-time-string'\n\
1020 which provide a much more powerful and general facility.\n\
1022 If an argument is given, it specifies a time to format\n\
1023 instead of the current time. The argument should have the form:\n\
1026 (HIGH LOW . IGNORED).\n\
1027 Thus, you can use times obtained from `current-time'\n\
1028 and from `file-attributes'.")
1030 Lisp_Object specified_time
;
1036 if (! lisp_time_argument (specified_time
, &value
))
1038 tem
= (char *) ctime (&value
);
1040 strncpy (buf
, tem
, 24);
1043 return build_string (buf
);
1046 #define TM_YEAR_BASE 1900
1048 /* Yield A - B, measured in seconds.
1049 This function is copied from the GNU C Library. */
1054 /* Compute intervening leap days correctly even if year is negative.
1055 Take care to avoid int overflow in leap day calculations,
1056 but it's OK to assume that A and B are close to each other. */
1057 int a4
= (a
->tm_year
>> 2) + (TM_YEAR_BASE
>> 2) - ! (a
->tm_year
& 3);
1058 int b4
= (b
->tm_year
>> 2) + (TM_YEAR_BASE
>> 2) - ! (b
->tm_year
& 3);
1059 int a100
= a4
/ 25 - (a4
% 25 < 0);
1060 int b100
= b4
/ 25 - (b4
% 25 < 0);
1061 int a400
= a100
>> 2;
1062 int b400
= b100
>> 2;
1063 int intervening_leap_days
= (a4
- b4
) - (a100
- b100
) + (a400
- b400
);
1064 int years
= a
->tm_year
- b
->tm_year
;
1065 int days
= (365 * years
+ intervening_leap_days
1066 + (a
->tm_yday
- b
->tm_yday
));
1067 return (60 * (60 * (24 * days
+ (a
->tm_hour
- b
->tm_hour
))
1068 + (a
->tm_min
- b
->tm_min
))
1069 + (a
->tm_sec
- b
->tm_sec
));
1072 DEFUN ("current-time-zone", Fcurrent_time_zone
, Scurrent_time_zone
, 0, 1, 0,
1073 "Return the offset and name for the local time zone.\n\
1074 This returns a list of the form (OFFSET NAME).\n\
1075 OFFSET is an integer number of seconds ahead of UTC (east of Greenwich).\n\
1076 A negative value means west of Greenwich.\n\
1077 NAME is a string giving the name of the time zone.\n\
1078 If an argument is given, it specifies when the time zone offset is determined\n\
1079 instead of using the current time. The argument should have the form:\n\
1082 (HIGH LOW . IGNORED).\n\
1083 Thus, you can use times obtained from `current-time'\n\
1084 and from `file-attributes'.\n\
1086 Some operating systems cannot provide all this information to Emacs;\n\
1087 in this case, `current-time-zone' returns a list containing nil for\n\
1088 the data it can't find.")
1090 Lisp_Object specified_time
;
1095 if (lisp_time_argument (specified_time
, &value
)
1096 && (t
= gmtime (&value
)) != 0)
1102 gmt
= *t
; /* Make a copy, in case localtime modifies *t. */
1103 t
= localtime (&value
);
1104 offset
= tm_diff (t
, &gmt
);
1108 s
= (char *)t
->tm_zone
;
1109 #else /* not HAVE_TM_ZONE */
1111 if (t
->tm_isdst
== 0 || t
->tm_isdst
== 1)
1112 s
= tzname
[t
->tm_isdst
];
1114 #endif /* not HAVE_TM_ZONE */
1117 /* No local time zone name is available; use "+-NNNN" instead. */
1118 int am
= (offset
< 0 ? -offset
: offset
) / 60;
1119 sprintf (buf
, "%c%02d%02d", (offset
< 0 ? '-' : '+'), am
/60, am
%60);
1122 return Fcons (make_number (offset
), Fcons (build_string (s
), Qnil
));
1125 return Fmake_list (2, Qnil
);
1128 /* This holds the value of `environ' produced by the previous
1129 call to Fset_time_zone_rule, or 0 if Fset_time_zone_rule
1130 has never been called. */
1131 static char **environbuf
;
1133 DEFUN ("set-time-zone-rule", Fset_time_zone_rule
, Sset_time_zone_rule
, 1, 1, 0,
1134 "Set the local time zone using TZ, a string specifying a time zone rule.\n\
1135 If TZ is nil, use implementation-defined default time zone information.\n\
1136 If TZ is t, use Universal Time.")
1148 CHECK_STRING (tz
, 0);
1149 tzstring
= (char *) XSTRING (tz
)->data
;
1152 set_time_zone_rule (tzstring
);
1155 environbuf
= environ
;
1160 #ifdef LOCALTIME_CACHE
1162 /* These two values are known to load tz files in buggy implementations,
1163 i.e. Solaris 1 executables running under either Solaris 1 or Solaris 2.
1164 Their values shouldn't matter in non-buggy implementations.
1165 We don't use string literals for these strings,
1166 since if a string in the environment is in readonly
1167 storage, it runs afoul of bugs in SVR4 and Solaris 2.3.
1168 See Sun bugs 1113095 and 1114114, ``Timezone routines
1169 improperly modify environment''. */
1171 static char set_time_zone_rule_tz1
[] = "TZ=GMT+0";
1172 static char set_time_zone_rule_tz2
[] = "TZ=GMT+1";
1176 /* Set the local time zone rule to TZSTRING.
1177 This allocates memory into `environ', which it is the caller's
1178 responsibility to free. */
1180 set_time_zone_rule (tzstring
)
1184 char **from
, **to
, **newenv
;
1186 /* Make the ENVIRON vector longer with room for TZSTRING. */
1187 for (from
= environ
; *from
; from
++)
1189 envptrs
= from
- environ
+ 2;
1190 newenv
= to
= (char **) xmalloc (envptrs
* sizeof (char *)
1191 + (tzstring
? strlen (tzstring
) + 4 : 0));
1193 /* Add TZSTRING to the end of environ, as a value for TZ. */
1196 char *t
= (char *) (to
+ envptrs
);
1198 strcat (t
, tzstring
);
1202 /* Copy the old environ vector elements into NEWENV,
1203 but don't copy the TZ variable.
1204 So we have only one definition of TZ, which came from TZSTRING. */
1205 for (from
= environ
; *from
; from
++)
1206 if (strncmp (*from
, "TZ=", 3) != 0)
1212 /* If we do have a TZSTRING, NEWENV points to the vector slot where
1213 the TZ variable is stored. If we do not have a TZSTRING,
1214 TO points to the vector slot which has the terminating null. */
1216 #ifdef LOCALTIME_CACHE
1218 /* In SunOS 4.1.3_U1 and 4.1.4, if TZ has a value like
1219 "US/Pacific" that loads a tz file, then changes to a value like
1220 "XXX0" that does not load a tz file, and then changes back to
1221 its original value, the last change is (incorrectly) ignored.
1222 Also, if TZ changes twice in succession to values that do
1223 not load a tz file, tzset can dump core (see Sun bug#1225179).
1224 The following code works around these bugs. */
1228 /* Temporarily set TZ to a value that loads a tz file
1229 and that differs from tzstring. */
1231 *newenv
= (strcmp (tzstring
, set_time_zone_rule_tz1
+ 3) == 0
1232 ? set_time_zone_rule_tz2
: set_time_zone_rule_tz1
);
1238 /* The implied tzstring is unknown, so temporarily set TZ to
1239 two different values that each load a tz file. */
1240 *to
= set_time_zone_rule_tz1
;
1243 *to
= set_time_zone_rule_tz2
;
1248 /* Now TZ has the desired value, and tzset can be invoked safely. */
1255 /* Insert NARGS Lisp objects in the array ARGS by calling INSERT_FUNC
1256 (if a type of object is Lisp_Int) or INSERT_FROM_STRING_FUNC (if a
1257 type of object is Lisp_String). INHERIT is passed to
1258 INSERT_FROM_STRING_FUNC as the last argument. */
1260 general_insert_function (insert_func
, insert_from_string_func
,
1261 inherit
, nargs
, args
)
1262 int (*insert_func
)(), (*insert_from_string_func
)();
1264 register Lisp_Object
*args
;
1266 register int argnum
;
1267 register Lisp_Object val
;
1269 for (argnum
= 0; argnum
< nargs
; argnum
++)
1275 char workbuf
[4], *str
;
1278 if (!NILP (current_buffer
->enable_multibyte_characters
))
1279 len
= CHAR_STRING (XFASTINT (val
), workbuf
, str
);
1281 workbuf
[0] = XINT (val
), str
= workbuf
, len
= 1;
1282 (*insert_func
) (str
, len
);
1284 else if (STRINGP (val
))
1286 (*insert_from_string_func
) (val
, 0, XSTRING (val
)->size
, inherit
);
1290 val
= wrong_type_argument (Qchar_or_string_p
, val
);
1304 /* Callers passing one argument to Finsert need not gcpro the
1305 argument "array", since the only element of the array will
1306 not be used after calling insert or insert_from_string, so
1307 we don't care if it gets trashed. */
1309 DEFUN ("insert", Finsert
, Sinsert
, 0, MANY
, 0,
1310 "Insert the arguments, either strings or characters, at point.\n\
1311 Point and before-insertion-markers move forward so that it ends up\n\
1312 after the inserted text.\n\
1313 Any other markers at the point of insertion remain before the text.")
1316 register Lisp_Object
*args
;
1318 general_insert_function (insert
, insert_from_string
, 0, nargs
, args
);
1322 DEFUN ("insert-and-inherit", Finsert_and_inherit
, Sinsert_and_inherit
,
1324 "Insert the arguments at point, inheriting properties from adjoining text.\n\
1325 Point and before-insertion-markers move forward so that it ends up\n\
1326 after the inserted text.\n\
1327 Any other markers at the point of insertion remain before the text.")
1330 register Lisp_Object
*args
;
1332 general_insert_function (insert_and_inherit
, insert_from_string
, 1,
1337 DEFUN ("insert-before-markers", Finsert_before_markers
, Sinsert_before_markers
, 0, MANY
, 0,
1338 "Insert strings or characters at point, relocating markers after the text.\n\
1339 Point and before-insertion-markers move forward so that it ends up\n\
1340 after the inserted text.\n\
1341 Any other markers at the point of insertion also end up after the text.")
1344 register Lisp_Object
*args
;
1346 general_insert_function (insert_before_markers
,
1347 insert_from_string_before_markers
, 0,
1352 DEFUN ("insert-before-markers-and-inherit", Finsert_and_inherit_before_markers
,
1353 Sinsert_and_inherit_before_markers
, 0, MANY
, 0,
1354 "Insert text at point, relocating markers and inheriting properties.\n\
1355 Point moves forward so that it ends up after the inserted text.\n\
1356 Any other markers at the point of insertion also end up after the text.")
1359 register Lisp_Object
*args
;
1361 general_insert_function (insert_before_markers_and_inherit
,
1362 insert_from_string_before_markers
, 1,
1367 DEFUN ("insert-char", Finsert_char
, Sinsert_char
, 2, 3, 0,
1368 "Insert COUNT (second arg) copies of CHARACTER (first arg).\n\
1369 Point and before-insertion-markers are affected as in the function `insert'.\n\
1370 Both arguments are required.\n\
1371 The optional third arg INHERIT, if non-nil, says to inherit text properties\n\
1372 from adjoining text, if those properties are sticky.")
1373 (character
, count
, inherit
)
1374 Lisp_Object character
, count
, inherit
;
1376 register unsigned char *string
;
1377 register int strlen
;
1380 unsigned char workbuf
[4], *str
;
1382 CHECK_NUMBER (character
, 0);
1383 CHECK_NUMBER (count
, 1);
1385 if (!NILP (current_buffer
->enable_multibyte_characters
))
1386 len
= CHAR_STRING (XFASTINT (character
), workbuf
, str
);
1388 workbuf
[0] = XFASTINT (character
), str
= workbuf
, len
= 1;
1389 n
= XINT (count
) * len
;
1392 strlen
= min (n
, 256 * len
);
1393 string
= (unsigned char *) alloca (strlen
);
1394 for (i
= 0; i
< strlen
; i
++)
1395 string
[i
] = str
[i
% len
];
1399 if (!NILP (inherit
))
1400 insert_and_inherit (string
, strlen
);
1402 insert (string
, strlen
);
1407 if (!NILP (inherit
))
1408 insert_and_inherit (string
, n
);
1416 /* Making strings from buffer contents. */
1418 /* Return a Lisp_String containing the text of the current buffer from
1419 START to END. If text properties are in use and the current buffer
1420 has properties in the range specified, the resulting string will also
1421 have them, if PROPS is nonzero.
1423 We don't want to use plain old make_string here, because it calls
1424 make_uninit_string, which can cause the buffer arena to be
1425 compacted. make_string has no way of knowing that the data has
1426 been moved, and thus copies the wrong data into the string. This
1427 doesn't effect most of the other users of make_string, so it should
1428 be left as is. But we should use this function when conjuring
1429 buffer substrings. */
1432 make_buffer_string (start
, end
, props
)
1436 Lisp_Object result
, tem
, tem1
;
1438 if (start
< GPT
&& GPT
< end
)
1441 result
= make_uninit_string (end
- start
);
1442 bcopy (POS_ADDR (start
), XSTRING (result
)->data
, end
- start
);
1444 /* If desired, update and copy the text properties. */
1445 #ifdef USE_TEXT_PROPERTIES
1448 update_buffer_properties (start
, end
);
1450 tem
= Fnext_property_change (make_number (start
), Qnil
, make_number (end
));
1451 tem1
= Ftext_properties_at (make_number (start
), Qnil
);
1453 if (XINT (tem
) != end
|| !NILP (tem1
))
1454 copy_intervals_to_string (result
, current_buffer
, start
, end
- start
);
1461 /* Call Vbuffer_access_fontify_functions for the range START ... END
1462 in the current buffer, if necessary. */
1465 update_buffer_properties (start
, end
)
1468 #ifdef USE_TEXT_PROPERTIES
1469 /* If this buffer has some access functions,
1470 call them, specifying the range of the buffer being accessed. */
1471 if (!NILP (Vbuffer_access_fontify_functions
))
1473 Lisp_Object args
[3];
1476 args
[0] = Qbuffer_access_fontify_functions
;
1477 XSETINT (args
[1], start
);
1478 XSETINT (args
[2], end
);
1480 /* But don't call them if we can tell that the work
1481 has already been done. */
1482 if (!NILP (Vbuffer_access_fontified_property
))
1484 tem
= Ftext_property_any (args
[1], args
[2],
1485 Vbuffer_access_fontified_property
,
1488 Frun_hook_with_args (3, args
);
1491 Frun_hook_with_args (3, args
);
1496 DEFUN ("buffer-substring", Fbuffer_substring
, Sbuffer_substring
, 2, 2, 0,
1497 "Return the contents of part of the current buffer as a string.\n\
1498 The two arguments START and END are character positions;\n\
1499 they can be in either order.")
1501 Lisp_Object start
, end
;
1505 validate_region (&start
, &end
);
1509 return make_buffer_string (b
, e
, 1);
1512 DEFUN ("buffer-substring-no-properties", Fbuffer_substring_no_properties
,
1513 Sbuffer_substring_no_properties
, 2, 2, 0,
1514 "Return the characters of part of the buffer, without the text properties.\n\
1515 The two arguments START and END are character positions;\n\
1516 they can be in either order.")
1518 Lisp_Object start
, end
;
1522 validate_region (&start
, &end
);
1526 return make_buffer_string (b
, e
, 0);
1529 DEFUN ("buffer-string", Fbuffer_string
, Sbuffer_string
, 0, 0, 0,
1530 "Return the contents of the current buffer as a string.\n\
1531 If narrowing is in effect, this function returns only the visible part\n\
1535 return make_buffer_string (BEGV
, ZV
, 1);
1538 DEFUN ("insert-buffer-substring", Finsert_buffer_substring
, Sinsert_buffer_substring
,
1540 "Insert before point a substring of the contents of buffer BUFFER.\n\
1541 BUFFER may be a buffer or a buffer name.\n\
1542 Arguments START and END are character numbers specifying the substring.\n\
1543 They default to the beginning and the end of BUFFER.")
1545 Lisp_Object buf
, start
, end
;
1547 register int b
, e
, temp
;
1548 register struct buffer
*bp
, *obuf
;
1551 buffer
= Fget_buffer (buf
);
1554 bp
= XBUFFER (buffer
);
1555 if (NILP (bp
->name
))
1556 error ("Selecting deleted buffer");
1562 CHECK_NUMBER_COERCE_MARKER (start
, 0);
1569 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1574 temp
= b
, b
= e
, e
= temp
;
1576 if (!(BUF_BEGV (bp
) <= b
&& e
<= BUF_ZV (bp
)))
1577 args_out_of_range (start
, end
);
1579 obuf
= current_buffer
;
1580 set_buffer_internal_1 (bp
);
1581 update_buffer_properties (b
, e
);
1582 set_buffer_internal_1 (obuf
);
1584 insert_from_buffer (bp
, b
, e
- b
, 0);
1588 DEFUN ("compare-buffer-substrings", Fcompare_buffer_substrings
, Scompare_buffer_substrings
,
1590 "Compare two substrings of two buffers; return result as number.\n\
1591 the value is -N if first string is less after N-1 chars,\n\
1592 +N if first string is greater after N-1 chars, or 0 if strings match.\n\
1593 Each substring is represented as three arguments: BUFFER, START and END.\n\
1594 That makes six args in all, three for each substring.\n\n\
1595 The value of `case-fold-search' in the current buffer\n\
1596 determines whether case is significant or ignored.")
1597 (buffer1
, start1
, end1
, buffer2
, start2
, end2
)
1598 Lisp_Object buffer1
, start1
, end1
, buffer2
, start2
, end2
;
1600 register int begp1
, endp1
, begp2
, endp2
, temp
, len1
, len2
, length
, i
;
1601 register struct buffer
*bp1
, *bp2
;
1602 register Lisp_Object
*trt
1603 = (!NILP (current_buffer
->case_fold_search
)
1604 ? XCHAR_TABLE (current_buffer
->case_canon_table
)->contents
: 0);
1606 /* Find the first buffer and its substring. */
1609 bp1
= current_buffer
;
1613 buf1
= Fget_buffer (buffer1
);
1616 bp1
= XBUFFER (buf1
);
1617 if (NILP (bp1
->name
))
1618 error ("Selecting deleted buffer");
1622 begp1
= BUF_BEGV (bp1
);
1625 CHECK_NUMBER_COERCE_MARKER (start1
, 1);
1626 begp1
= XINT (start1
);
1629 endp1
= BUF_ZV (bp1
);
1632 CHECK_NUMBER_COERCE_MARKER (end1
, 2);
1633 endp1
= XINT (end1
);
1637 temp
= begp1
, begp1
= endp1
, endp1
= temp
;
1639 if (!(BUF_BEGV (bp1
) <= begp1
1641 && endp1
<= BUF_ZV (bp1
)))
1642 args_out_of_range (start1
, end1
);
1644 /* Likewise for second substring. */
1647 bp2
= current_buffer
;
1651 buf2
= Fget_buffer (buffer2
);
1654 bp2
= XBUFFER (buf2
);
1655 if (NILP (bp2
->name
))
1656 error ("Selecting deleted buffer");
1660 begp2
= BUF_BEGV (bp2
);
1663 CHECK_NUMBER_COERCE_MARKER (start2
, 4);
1664 begp2
= XINT (start2
);
1667 endp2
= BUF_ZV (bp2
);
1670 CHECK_NUMBER_COERCE_MARKER (end2
, 5);
1671 endp2
= XINT (end2
);
1675 temp
= begp2
, begp2
= endp2
, endp2
= temp
;
1677 if (!(BUF_BEGV (bp2
) <= begp2
1679 && endp2
<= BUF_ZV (bp2
)))
1680 args_out_of_range (start2
, end2
);
1682 len1
= endp1
- begp1
;
1683 len2
= endp2
- begp2
;
1688 for (i
= 0; i
< length
; i
++)
1690 int c1
= *BUF_CHAR_ADDRESS (bp1
, begp1
+ i
);
1691 int c2
= *BUF_CHAR_ADDRESS (bp2
, begp2
+ i
);
1694 c1
= XINT (trt
[c1
]);
1695 c2
= XINT (trt
[c2
]);
1698 return make_number (- 1 - i
);
1700 return make_number (i
+ 1);
1703 /* The strings match as far as they go.
1704 If one is shorter, that one is less. */
1706 return make_number (length
+ 1);
1707 else if (length
< len2
)
1708 return make_number (- length
- 1);
1710 /* Same length too => they are equal. */
1711 return make_number (0);
1715 subst_char_in_region_unwind (arg
)
1718 return current_buffer
->undo_list
= arg
;
1722 subst_char_in_region_unwind_1 (arg
)
1725 return current_buffer
->filename
= arg
;
1728 DEFUN ("subst-char-in-region", Fsubst_char_in_region
,
1729 Ssubst_char_in_region
, 4, 5, 0,
1730 "From START to END, replace FROMCHAR with TOCHAR each time it occurs.\n\
1731 If optional arg NOUNDO is non-nil, don't record this change for undo\n\
1732 and don't mark the buffer as really changed.\n\
1733 Both characters must have the same length of multi-byte form.")
1734 (start
, end
, fromchar
, tochar
, noundo
)
1735 Lisp_Object start
, end
, fromchar
, tochar
, noundo
;
1737 register int pos
, stop
, i
, len
;
1739 unsigned char fromwork
[4], *fromstr
, towork
[4], *tostr
, *p
;
1740 int count
= specpdl_ptr
- specpdl
;
1742 validate_region (&start
, &end
);
1743 CHECK_NUMBER (fromchar
, 2);
1744 CHECK_NUMBER (tochar
, 3);
1746 if (! NILP (current_buffer
->enable_multibyte_characters
))
1748 len
= CHAR_STRING (XFASTINT (fromchar
), fromwork
, fromstr
);
1749 if (CHAR_STRING (XFASTINT (tochar
), towork
, tostr
) != len
)
1750 error ("Characters in subst-char-in-region have different byte-lengths");
1755 fromwork
[0] = XFASTINT (fromchar
), fromstr
= fromwork
;
1756 towork
[0] = XFASTINT (tochar
), tostr
= towork
;
1762 /* If we don't want undo, turn off putting stuff on the list.
1763 That's faster than getting rid of things,
1764 and it prevents even the entry for a first change.
1765 Also inhibit locking the file. */
1768 record_unwind_protect (subst_char_in_region_unwind
,
1769 current_buffer
->undo_list
);
1770 current_buffer
->undo_list
= Qt
;
1771 /* Don't do file-locking. */
1772 record_unwind_protect (subst_char_in_region_unwind_1
,
1773 current_buffer
->filename
);
1774 current_buffer
->filename
= Qnil
;
1778 stop
= min(stop
, GPT
);
1784 if (pos
>= XINT (end
)) break;
1788 if (p
[0] == fromstr
[0]
1790 || (p
[1] == fromstr
[1]
1791 && (len
== 2 || (p
[2] == fromstr
[2]
1792 && (len
== 3 || p
[3] == fromstr
[3]))))))
1796 modify_region (current_buffer
, XINT (start
), XINT (end
));
1798 if (! NILP (noundo
))
1800 if (MODIFF
- 1 == SAVE_MODIFF
)
1802 if (MODIFF
- 1 == current_buffer
->auto_save_modified
)
1803 current_buffer
->auto_save_modified
++;
1810 record_change (pos
, len
);
1811 for (i
= 0; i
< len
; i
++) *p
++ = tostr
[i
];
1819 signal_after_change (XINT (start
),
1820 stop
- XINT (start
), stop
- XINT (start
));
1822 unbind_to (count
, Qnil
);
1826 DEFUN ("translate-region", Ftranslate_region
, Stranslate_region
, 3, 3, 0,
1827 "From START to END, translate characters according to TABLE.\n\
1828 TABLE is a string; the Nth character in it is the mapping\n\
1829 for the character with code N. Returns the number of characters changed.")
1833 register Lisp_Object table
;
1835 register int pos
, stop
; /* Limits of the region. */
1836 register unsigned char *tt
; /* Trans table. */
1837 register int oc
; /* Old character. */
1838 register int nc
; /* New character. */
1839 int cnt
; /* Number of changes made. */
1840 Lisp_Object z
; /* Return. */
1841 int size
; /* Size of translate table. */
1843 validate_region (&start
, &end
);
1844 CHECK_STRING (table
, 2);
1846 size
= XSTRING (table
)->size
;
1847 tt
= XSTRING (table
)->data
;
1851 modify_region (current_buffer
, pos
, stop
);
1854 for (; pos
< stop
; ++pos
)
1856 oc
= FETCH_BYTE (pos
);
1862 record_change (pos
, 1);
1863 *(POS_ADDR (pos
)) = nc
;
1864 signal_after_change (pos
, 1, 1);
1870 XSETFASTINT (z
, cnt
);
1874 DEFUN ("delete-region", Fdelete_region
, Sdelete_region
, 2, 2, "r",
1875 "Delete the text between point and mark.\n\
1876 When called from a program, expects two arguments,\n\
1877 positions (integers or markers) specifying the stretch to be deleted.")
1879 Lisp_Object start
, end
;
1881 validate_region (&start
, &end
);
1882 del_range (XINT (start
), XINT (end
));
1886 DEFUN ("widen", Fwiden
, Swiden
, 0, 0, "",
1887 "Remove restrictions (narrowing) from current buffer.\n\
1888 This allows the buffer's full text to be seen and edited.")
1892 SET_BUF_ZV (current_buffer
, Z
);
1893 current_buffer
->clip_changed
= 1;
1894 /* Changing the buffer bounds invalidates any recorded current column. */
1895 invalidate_current_column ();
1899 DEFUN ("narrow-to-region", Fnarrow_to_region
, Snarrow_to_region
, 2, 2, "r",
1900 "Restrict editing in this buffer to the current region.\n\
1901 The rest of the text becomes temporarily invisible and untouchable\n\
1902 but is not deleted; if you save the buffer in a file, the invisible\n\
1903 text is included in the file. \\[widen] makes all visible again.\n\
1904 See also `save-restriction'.\n\
1906 When calling from a program, pass two arguments; positions (integers\n\
1907 or markers) bounding the text that should remain visible.")
1909 register Lisp_Object start
, end
;
1911 CHECK_NUMBER_COERCE_MARKER (start
, 0);
1912 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1914 if (XINT (start
) > XINT (end
))
1917 tem
= start
; start
= end
; end
= tem
;
1920 if (!(BEG
<= XINT (start
) && XINT (start
) <= XINT (end
) && XINT (end
) <= Z
))
1921 args_out_of_range (start
, end
);
1923 BEGV
= XFASTINT (start
);
1924 SET_BUF_ZV (current_buffer
, XFASTINT (end
));
1925 if (PT
< XFASTINT (start
))
1926 SET_PT (XFASTINT (start
));
1927 if (PT
> XFASTINT (end
))
1928 SET_PT (XFASTINT (end
));
1929 current_buffer
->clip_changed
= 1;
1930 /* Changing the buffer bounds invalidates any recorded current column. */
1931 invalidate_current_column ();
1936 save_restriction_save ()
1938 register Lisp_Object bottom
, top
;
1939 /* Note: I tried using markers here, but it does not win
1940 because insertion at the end of the saved region
1941 does not advance mh and is considered "outside" the saved region. */
1942 XSETFASTINT (bottom
, BEGV
- BEG
);
1943 XSETFASTINT (top
, Z
- ZV
);
1945 return Fcons (Fcurrent_buffer (), Fcons (bottom
, top
));
1949 save_restriction_restore (data
)
1952 register struct buffer
*buf
;
1953 register int newhead
, newtail
;
1954 register Lisp_Object tem
;
1956 buf
= XBUFFER (XCONS (data
)->car
);
1958 data
= XCONS (data
)->cdr
;
1960 tem
= XCONS (data
)->car
;
1961 newhead
= XINT (tem
);
1962 tem
= XCONS (data
)->cdr
;
1963 newtail
= XINT (tem
);
1964 if (newhead
+ newtail
> BUF_Z (buf
) - BUF_BEG (buf
))
1969 BUF_BEGV (buf
) = BUF_BEG (buf
) + newhead
;
1970 SET_BUF_ZV (buf
, BUF_Z (buf
) - newtail
);
1971 current_buffer
->clip_changed
= 1;
1973 /* If point is outside the new visible range, move it inside. */
1975 clip_to_bounds (BUF_BEGV (buf
), BUF_PT (buf
), BUF_ZV (buf
)));
1980 DEFUN ("save-restriction", Fsave_restriction
, Ssave_restriction
, 0, UNEVALLED
, 0,
1981 "Execute BODY, saving and restoring current buffer's restrictions.\n\
1982 The buffer's restrictions make parts of the beginning and end invisible.\n\
1983 \(They are set up with `narrow-to-region' and eliminated with `widen'.)\n\
1984 This special form, `save-restriction', saves the current buffer's restrictions\n\
1985 when it is entered, and restores them when it is exited.\n\
1986 So any `narrow-to-region' within BODY lasts only until the end of the form.\n\
1987 The old restrictions settings are restored\n\
1988 even in case of abnormal exit (throw or error).\n\
1990 The value returned is the value of the last form in BODY.\n\
1992 `save-restriction' can get confused if, within the BODY, you widen\n\
1993 and then make changes outside the area within the saved restrictions.\n\
1995 Note: if you are using both `save-excursion' and `save-restriction',\n\
1996 use `save-excursion' outermost:\n\
1997 (save-excursion (save-restriction ...))")
2001 register Lisp_Object val
;
2002 int count
= specpdl_ptr
- specpdl
;
2004 record_unwind_protect (save_restriction_restore
, save_restriction_save ());
2005 val
= Fprogn (body
);
2006 return unbind_to (count
, val
);
2009 /* Buffer for the most recent text displayed by Fmessage. */
2010 static char *message_text
;
2012 /* Allocated length of that buffer. */
2013 static int message_length
;
2015 DEFUN ("message", Fmessage
, Smessage
, 1, MANY
, 0,
2016 "Print a one-line message at the bottom of the screen.\n\
2017 The first argument is a format control string, and the rest are data\n\
2018 to be formatted under control of the string. See `format' for details.\n\
2020 If the first argument is nil, clear any existing message; let the\n\
2021 minibuffer contents show.")
2033 register Lisp_Object val
;
2034 val
= Fformat (nargs
, args
);
2035 /* Copy the data so that it won't move when we GC. */
2038 message_text
= (char *)xmalloc (80);
2039 message_length
= 80;
2041 if (XSTRING (val
)->size
> message_length
)
2043 message_length
= XSTRING (val
)->size
;
2044 message_text
= (char *)xrealloc (message_text
, message_length
);
2046 bcopy (XSTRING (val
)->data
, message_text
, XSTRING (val
)->size
);
2047 message2 (message_text
, XSTRING (val
)->size
);
2052 DEFUN ("message-box", Fmessage_box
, Smessage_box
, 1, MANY
, 0,
2053 "Display a message, in a dialog box if possible.\n\
2054 If a dialog box is not available, use the echo area.\n\
2055 The first argument is a format control string, and the rest are data\n\
2056 to be formatted under control of the string. See `format' for details.\n\
2058 If the first argument is nil, clear any existing message; let the\n\
2059 minibuffer contents show.")
2071 register Lisp_Object val
;
2072 val
= Fformat (nargs
, args
);
2075 Lisp_Object pane
, menu
, obj
;
2076 struct gcpro gcpro1
;
2077 pane
= Fcons (Fcons (build_string ("OK"), Qt
), Qnil
);
2079 menu
= Fcons (val
, pane
);
2080 obj
= Fx_popup_dialog (Qt
, menu
);
2084 #else /* not HAVE_MENUS */
2085 /* Copy the data so that it won't move when we GC. */
2088 message_text
= (char *)xmalloc (80);
2089 message_length
= 80;
2091 if (XSTRING (val
)->size
> message_length
)
2093 message_length
= XSTRING (val
)->size
;
2094 message_text
= (char *)xrealloc (message_text
, message_length
);
2096 bcopy (XSTRING (val
)->data
, message_text
, XSTRING (val
)->size
);
2097 message2 (message_text
, XSTRING (val
)->size
);
2099 #endif /* not HAVE_MENUS */
2103 extern Lisp_Object last_nonmenu_event
;
2106 DEFUN ("message-or-box", Fmessage_or_box
, Smessage_or_box
, 1, MANY
, 0,
2107 "Display a message in a dialog box or in the echo area.\n\
2108 If this command was invoked with the mouse, use a dialog box.\n\
2109 Otherwise, use the echo area.\n\
2110 The first argument is a format control string, and the rest are data\n\
2111 to be formatted under control of the string. See `format' for details.\n\
2113 If the first argument is nil, clear any existing message; let the\n\
2114 minibuffer contents show.")
2120 if (NILP (last_nonmenu_event
) || CONSP (last_nonmenu_event
))
2121 return Fmessage_box (nargs
, args
);
2123 return Fmessage (nargs
, args
);
2126 DEFUN ("format", Fformat
, Sformat
, 1, MANY
, 0,
2127 "Format a string out of a control-string and arguments.\n\
2128 The first argument is a control string.\n\
2129 The other arguments are substituted into it to make the result, a string.\n\
2130 It may contain %-sequences meaning to substitute the next argument.\n\
2131 %s means print a string argument. Actually, prints any object, with `princ'.\n\
2132 %d means print as number in decimal (%o octal, %x hex).\n\
2133 %e means print a number in exponential notation.\n\
2134 %f means print a number in decimal-point notation.\n\
2135 %g means print a number in exponential notation\n\
2136 or decimal-point notation, whichever uses fewer characters.\n\
2137 %c means print a number as a single character.\n\
2138 %S means print any object as an s-expression (using prin1).\n\
2139 The argument used for %d, %o, %x, %e, %f, %g or %c must be a number.\n\
2140 Use %% to put a single % into the output.")
2143 register Lisp_Object
*args
;
2145 register int n
; /* The number of the next arg to substitute */
2146 register int total
= 5; /* An estimate of the final length */
2148 register unsigned char *format
, *end
;
2150 extern char *index ();
2151 /* It should not be necessary to GCPRO ARGS, because
2152 the caller in the interpreter should take care of that. */
2154 CHECK_STRING (args
[0], 0);
2155 format
= XSTRING (args
[0])->data
;
2156 end
= format
+ XSTRING (args
[0])->size
;
2159 while (format
!= end
)
2160 if (*format
++ == '%')
2164 /* Process a numeric arg and skip it. */
2165 minlen
= atoi (format
);
2169 while ((*format
>= '0' && *format
<= '9')
2170 || *format
== '-' || *format
== ' ' || *format
== '.')
2175 else if (++n
>= nargs
)
2176 error ("Not enough arguments for format string");
2177 else if (*format
== 'S')
2179 /* For `S', prin1 the argument and then treat like a string. */
2180 register Lisp_Object tem
;
2181 tem
= Fprin1_to_string (args
[n
], Qnil
);
2185 else if (SYMBOLP (args
[n
]))
2187 XSETSTRING (args
[n
], XSYMBOL (args
[n
])->name
);
2190 else if (STRINGP (args
[n
]))
2193 if (*format
!= 's' && *format
!= 'S')
2194 error ("format specifier doesn't match argument type");
2195 total
+= XSTRING (args
[n
])->size
;
2196 /* We have to put an arbitrary limit on minlen
2197 since otherwise it could make alloca fail. */
2198 if (minlen
< XSTRING (args
[n
])->size
+ 1000)
2201 /* Would get MPV otherwise, since Lisp_Int's `point' to low memory. */
2202 else if (INTEGERP (args
[n
]) && *format
!= 's')
2204 #ifdef LISP_FLOAT_TYPE
2205 /* The following loop assumes the Lisp type indicates
2206 the proper way to pass the argument.
2207 So make sure we have a flonum if the argument should
2209 if (*format
== 'e' || *format
== 'f' || *format
== 'g')
2210 args
[n
] = Ffloat (args
[n
]);
2213 /* We have to put an arbitrary limit on minlen
2214 since otherwise it could make alloca fail. */
2218 #ifdef LISP_FLOAT_TYPE
2219 else if (FLOATP (args
[n
]) && *format
!= 's')
2221 if (! (*format
== 'e' || *format
== 'f' || *format
== 'g'))
2222 args
[n
] = Ftruncate (args
[n
]);
2224 /* We have to put an arbitrary limit on minlen
2225 since otherwise it could make alloca fail. */
2232 /* Anything but a string, convert to a string using princ. */
2233 register Lisp_Object tem
;
2234 tem
= Fprin1_to_string (args
[n
], Qt
);
2241 register int nstrings
= n
+ 1;
2243 /* Allocate twice as many strings as we have %-escapes; floats occupy
2244 two slots, and we're not sure how many of those we have. */
2245 register unsigned char **strings
2246 = (unsigned char **) alloca (2 * nstrings
* sizeof (unsigned char *));
2250 for (n
= 0; n
< nstrings
; n
++)
2253 strings
[i
++] = (unsigned char *) "";
2254 else if (INTEGERP (args
[n
]))
2255 /* We checked above that the corresponding format effector
2256 isn't %s, which would cause MPV. */
2257 strings
[i
++] = (unsigned char *) XINT (args
[n
]);
2258 #ifdef LISP_FLOAT_TYPE
2259 else if (FLOATP (args
[n
]))
2261 union { double d
; char *half
[2]; } u
;
2263 u
.d
= XFLOAT (args
[n
])->data
;
2264 strings
[i
++] = (unsigned char *) u
.half
[0];
2265 strings
[i
++] = (unsigned char *) u
.half
[1];
2269 /* The first string is treated differently
2270 because it is the format string. */
2271 strings
[i
++] = XSTRING (args
[n
])->data
;
2273 strings
[i
++] = (unsigned char *) XSTRING (args
[n
]);
2276 /* Make room in result for all the non-%-codes in the control string. */
2277 total
+= XSTRING (args
[0])->size
;
2279 /* Format it in bigger and bigger buf's until it all fits. */
2282 buf
= (char *) alloca (total
+ 1);
2285 length
= doprnt_lisp (buf
, total
+ 1, strings
[0],
2286 end
, i
-1, strings
+ 1);
2287 if (buf
[total
- 1] == 0)
2295 return make_string (buf
, length
);
2301 format1 (string1
, arg0
, arg1
, arg2
, arg3
, arg4
)
2302 EMACS_INT arg0
, arg1
, arg2
, arg3
, arg4
;
2316 doprnt (buf
, sizeof buf
, string1
, (char *)0, 5, args
);
2318 doprnt (buf
, sizeof buf
, string1
, (char *)0, 5, &string1
+ 1);
2320 return build_string (buf
);
2323 DEFUN ("char-equal", Fchar_equal
, Schar_equal
, 2, 2, 0,
2324 "Return t if two characters match, optionally ignoring case.\n\
2325 Both arguments must be characters (i.e. integers).\n\
2326 Case is ignored if `case-fold-search' is non-nil in the current buffer.")
2328 register Lisp_Object c1
, c2
;
2330 CHECK_NUMBER (c1
, 0);
2331 CHECK_NUMBER (c2
, 1);
2333 if (XINT (c1
) == XINT (c2
)
2334 && (NILP (current_buffer
->case_fold_search
)
2335 || DOWNCASE (XFASTINT (c1
)) == DOWNCASE (XFASTINT (c2
))))
2340 /* Transpose the markers in two regions of the current buffer, and
2341 adjust the ones between them if necessary (i.e.: if the regions
2344 Traverses the entire marker list of the buffer to do so, adding an
2345 appropriate amount to some, subtracting from some, and leaving the
2346 rest untouched. Most of this is copied from adjust_markers in insdel.c.
2348 It's the caller's job to see that (start1 <= end1 <= start2 <= end2). */
2351 transpose_markers (start1
, end1
, start2
, end2
)
2352 register int start1
, end1
, start2
, end2
;
2354 register int amt1
, amt2
, diff
, mpos
;
2355 register Lisp_Object marker
;
2357 /* Update point as if it were a marker. */
2361 TEMP_SET_PT (PT
+ (end2
- end1
));
2362 else if (PT
< start2
)
2363 TEMP_SET_PT (PT
+ (end2
- start2
) - (end1
- start1
));
2365 TEMP_SET_PT (PT
- (start2
- start1
));
2367 /* We used to adjust the endpoints here to account for the gap, but that
2368 isn't good enough. Even if we assume the caller has tried to move the
2369 gap out of our way, it might still be at start1 exactly, for example;
2370 and that places it `inside' the interval, for our purposes. The amount
2371 of adjustment is nontrivial if there's a `denormalized' marker whose
2372 position is between GPT and GPT + GAP_SIZE, so it's simpler to leave
2373 the dirty work to Fmarker_position, below. */
2375 /* The difference between the region's lengths */
2376 diff
= (end2
- start2
) - (end1
- start1
);
2378 /* For shifting each marker in a region by the length of the other
2379 * region plus the distance between the regions.
2381 amt1
= (end2
- start2
) + (start2
- end1
);
2382 amt2
= (end1
- start1
) + (start2
- end1
);
2384 for (marker
= BUF_MARKERS (current_buffer
); !NILP (marker
);
2385 marker
= XMARKER (marker
)->chain
)
2387 mpos
= marker_position (marker
);
2388 if (mpos
>= start1
&& mpos
< end2
)
2392 else if (mpos
< start2
)
2396 if (mpos
> GPT
) mpos
+= GAP_SIZE
;
2397 XMARKER (marker
)->bufpos
= mpos
;
2402 DEFUN ("transpose-regions", Ftranspose_regions
, Stranspose_regions
, 4, 5, 0,
2403 "Transpose region START1 to END1 with START2 to END2.\n\
2404 The regions may not be overlapping, because the size of the buffer is\n\
2405 never changed in a transposition.\n\
2407 Optional fifth arg LEAVE_MARKERS, if non-nil, means don't transpose\n\
2408 any markers that happen to be located in the regions.\n\
2410 Transposing beyond buffer boundaries is an error.")
2411 (startr1
, endr1
, startr2
, endr2
, leave_markers
)
2412 Lisp_Object startr1
, endr1
, startr2
, endr2
, leave_markers
;
2414 register int start1
, end1
, start2
, end2
,
2415 gap
, len1
, len_mid
, len2
;
2416 unsigned char *start1_addr
, *start2_addr
, *temp
;
2418 #ifdef USE_TEXT_PROPERTIES
2419 INTERVAL cur_intv
, tmp_interval1
, tmp_interval_mid
, tmp_interval2
;
2420 cur_intv
= BUF_INTERVALS (current_buffer
);
2421 #endif /* USE_TEXT_PROPERTIES */
2423 validate_region (&startr1
, &endr1
);
2424 validate_region (&startr2
, &endr2
);
2426 start1
= XFASTINT (startr1
);
2427 end1
= XFASTINT (endr1
);
2428 start2
= XFASTINT (startr2
);
2429 end2
= XFASTINT (endr2
);
2432 /* Swap the regions if they're reversed. */
2435 register int glumph
= start1
;
2443 len1
= end1
- start1
;
2444 len2
= end2
- start2
;
2447 error ("transposed regions not properly ordered");
2448 else if (start1
== end1
|| start2
== end2
)
2449 error ("transposed region may not be of length 0");
2451 /* The possibilities are:
2452 1. Adjacent (contiguous) regions, or separate but equal regions
2453 (no, really equal, in this case!), or
2454 2. Separate regions of unequal size.
2456 The worst case is usually No. 2. It means that (aside from
2457 potential need for getting the gap out of the way), there also
2458 needs to be a shifting of the text between the two regions. So
2459 if they are spread far apart, we are that much slower... sigh. */
2461 /* It must be pointed out that the really studly thing to do would
2462 be not to move the gap at all, but to leave it in place and work
2463 around it if necessary. This would be extremely efficient,
2464 especially considering that people are likely to do
2465 transpositions near where they are working interactively, which
2466 is exactly where the gap would be found. However, such code
2467 would be much harder to write and to read. So, if you are
2468 reading this comment and are feeling squirrely, by all means have
2469 a go! I just didn't feel like doing it, so I will simply move
2470 the gap the minimum distance to get it out of the way, and then
2471 deal with an unbroken array. */
2473 /* Make sure the gap won't interfere, by moving it out of the text
2474 we will operate on. */
2475 if (start1
< gap
&& gap
< end2
)
2477 if (gap
- start1
< end2
- gap
)
2483 /* Hmmm... how about checking to see if the gap is large
2484 enough to use as the temporary storage? That would avoid an
2485 allocation... interesting. Later, don't fool with it now. */
2487 /* Working without memmove, for portability (sigh), so must be
2488 careful of overlapping subsections of the array... */
2490 if (end1
== start2
) /* adjacent regions */
2492 modify_region (current_buffer
, start1
, end2
);
2493 record_change (start1
, len1
+ len2
);
2495 #ifdef USE_TEXT_PROPERTIES
2496 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2497 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2498 Fset_text_properties (start1
, end2
, Qnil
, Qnil
);
2499 #endif /* USE_TEXT_PROPERTIES */
2501 /* First region smaller than second. */
2504 /* We use alloca only if it is small,
2505 because we want to avoid stack overflow. */
2507 temp
= (unsigned char *) xmalloc (len2
);
2509 temp
= (unsigned char *) alloca (len2
);
2511 /* Don't precompute these addresses. We have to compute them
2512 at the last minute, because the relocating allocator might
2513 have moved the buffer around during the xmalloc. */
2514 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1
);
2515 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2
);
2517 bcopy (start2_addr
, temp
, len2
);
2518 bcopy (start1_addr
, start1_addr
+ len2
, len1
);
2519 bcopy (temp
, start1_addr
, len2
);
2524 /* First region not smaller than second. */
2527 temp
= (unsigned char *) xmalloc (len1
);
2529 temp
= (unsigned char *) alloca (len1
);
2530 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1
);
2531 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2
);
2532 bcopy (start1_addr
, temp
, len1
);
2533 bcopy (start2_addr
, start1_addr
, len2
);
2534 bcopy (temp
, start1_addr
+ len2
, len1
);
2538 #ifdef USE_TEXT_PROPERTIES
2539 graft_intervals_into_buffer (tmp_interval1
, start1
+ len2
,
2540 len1
, current_buffer
, 0);
2541 graft_intervals_into_buffer (tmp_interval2
, start1
,
2542 len2
, current_buffer
, 0);
2543 #endif /* USE_TEXT_PROPERTIES */
2545 /* Non-adjacent regions, because end1 != start2, bleagh... */
2549 /* Regions are same size, though, how nice. */
2551 modify_region (current_buffer
, start1
, end1
);
2552 modify_region (current_buffer
, start2
, end2
);
2553 record_change (start1
, len1
);
2554 record_change (start2
, len2
);
2555 #ifdef USE_TEXT_PROPERTIES
2556 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2557 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2558 Fset_text_properties (start1
, end1
, Qnil
, Qnil
);
2559 Fset_text_properties (start2
, end2
, Qnil
, Qnil
);
2560 #endif /* USE_TEXT_PROPERTIES */
2563 temp
= (unsigned char *) xmalloc (len1
);
2565 temp
= (unsigned char *) alloca (len1
);
2566 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1
);
2567 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2
);
2568 bcopy (start1_addr
, temp
, len1
);
2569 bcopy (start2_addr
, start1_addr
, len2
);
2570 bcopy (temp
, start2_addr
, len1
);
2573 #ifdef USE_TEXT_PROPERTIES
2574 graft_intervals_into_buffer (tmp_interval1
, start2
,
2575 len1
, current_buffer
, 0);
2576 graft_intervals_into_buffer (tmp_interval2
, start1
,
2577 len2
, current_buffer
, 0);
2578 #endif /* USE_TEXT_PROPERTIES */
2581 else if (len1
< len2
) /* Second region larger than first */
2582 /* Non-adjacent & unequal size, area between must also be shifted. */
2584 len_mid
= start2
- end1
;
2585 modify_region (current_buffer
, start1
, end2
);
2586 record_change (start1
, (end2
- start1
));
2587 #ifdef USE_TEXT_PROPERTIES
2588 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2589 tmp_interval_mid
= copy_intervals (cur_intv
, end1
, len_mid
);
2590 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2591 Fset_text_properties (start1
, end2
, Qnil
, Qnil
);
2592 #endif /* USE_TEXT_PROPERTIES */
2594 /* holds region 2 */
2596 temp
= (unsigned char *) xmalloc (len2
);
2598 temp
= (unsigned char *) alloca (len2
);
2599 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1
);
2600 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2
);
2601 bcopy (start2_addr
, temp
, len2
);
2602 bcopy (start1_addr
, start1_addr
+ len_mid
+ len2
, len1
);
2603 safe_bcopy (start1_addr
+ len1
, start1_addr
+ len2
, len_mid
);
2604 bcopy (temp
, start1_addr
, len2
);
2607 #ifdef USE_TEXT_PROPERTIES
2608 graft_intervals_into_buffer (tmp_interval1
, end2
- len1
,
2609 len1
, current_buffer
, 0);
2610 graft_intervals_into_buffer (tmp_interval_mid
, start1
+ len2
,
2611 len_mid
, current_buffer
, 0);
2612 graft_intervals_into_buffer (tmp_interval2
, start1
,
2613 len2
, current_buffer
, 0);
2614 #endif /* USE_TEXT_PROPERTIES */
2617 /* Second region smaller than first. */
2619 len_mid
= start2
- end1
;
2620 record_change (start1
, (end2
- start1
));
2621 modify_region (current_buffer
, start1
, end2
);
2623 #ifdef USE_TEXT_PROPERTIES
2624 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2625 tmp_interval_mid
= copy_intervals (cur_intv
, end1
, len_mid
);
2626 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2627 Fset_text_properties (start1
, end2
, Qnil
, Qnil
);
2628 #endif /* USE_TEXT_PROPERTIES */
2630 /* holds region 1 */
2632 temp
= (unsigned char *) xmalloc (len1
);
2634 temp
= (unsigned char *) alloca (len1
);
2635 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1
);
2636 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2
);
2637 bcopy (start1_addr
, temp
, len1
);
2638 bcopy (start2_addr
, start1_addr
, len2
);
2639 bcopy (start1_addr
+ len1
, start1_addr
+ len2
, len_mid
);
2640 bcopy (temp
, start1_addr
+ len2
+ len_mid
, len1
);
2643 #ifdef USE_TEXT_PROPERTIES
2644 graft_intervals_into_buffer (tmp_interval1
, end2
- len1
,
2645 len1
, current_buffer
, 0);
2646 graft_intervals_into_buffer (tmp_interval_mid
, start1
+ len2
,
2647 len_mid
, current_buffer
, 0);
2648 graft_intervals_into_buffer (tmp_interval2
, start1
,
2649 len2
, current_buffer
, 0);
2650 #endif /* USE_TEXT_PROPERTIES */
2654 /* todo: this will be slow, because for every transposition, we
2655 traverse the whole friggin marker list. Possible solutions:
2656 somehow get a list of *all* the markers across multiple
2657 transpositions and do it all in one swell phoop. Or maybe modify
2658 Emacs' marker code to keep an ordered list or tree. This might
2659 be nicer, and more beneficial in the long run, but would be a
2660 bunch of work. Plus the way they're arranged now is nice. */
2661 if (NILP (leave_markers
))
2663 transpose_markers (start1
, end1
, start2
, end2
);
2664 fix_overlays_in_range (start1
, end2
);
2676 Qbuffer_access_fontify_functions
2677 = intern ("buffer-access-fontify-functions");
2678 staticpro (&Qbuffer_access_fontify_functions
);
2680 DEFVAR_LISP ("buffer-access-fontify-functions",
2681 &Vbuffer_access_fontify_functions
,
2682 "List of functions called by `buffer-substring' to fontify if necessary.\n\
2683 Each function is called with two arguments which specify the range\n\
2684 of the buffer being accessed.");
2685 Vbuffer_access_fontify_functions
= Qnil
;
2689 extern Lisp_Object Vprin1_to_string_buffer
;
2690 obuf
= Fcurrent_buffer ();
2691 /* Do this here, because init_buffer_once is too early--it won't work. */
2692 Fset_buffer (Vprin1_to_string_buffer
);
2693 /* Make sure buffer-access-fontify-functions is nil in this buffer. */
2694 Fset (Fmake_local_variable (intern ("buffer-access-fontify-functions")),
2699 DEFVAR_LISP ("buffer-access-fontified-property",
2700 &Vbuffer_access_fontified_property
,
2701 "Property which (if non-nil) indicates text has been fontified.\n\
2702 `buffer-substring' need not call the `buffer-access-fontify-functions'\n\
2703 functions if all the text being accessed has this property.");
2704 Vbuffer_access_fontified_property
= Qnil
;
2706 DEFVAR_LISP ("system-name", &Vsystem_name
,
2707 "The name of the machine Emacs is running on.");
2709 DEFVAR_LISP ("user-full-name", &Vuser_full_name
,
2710 "The full name of the user logged in.");
2712 DEFVAR_LISP ("user-login-name", &Vuser_login_name
,
2713 "The user's name, taken from environment variables if possible.");
2715 DEFVAR_LISP ("user-real-login-name", &Vuser_real_login_name
,
2716 "The user's name, based upon the real uid only.");
2718 defsubr (&Schar_equal
);
2719 defsubr (&Sgoto_char
);
2720 defsubr (&Sstring_to_char
);
2721 defsubr (&Schar_to_string
);
2723 defsubr (&Sbuffer_substring
);
2724 defsubr (&Sbuffer_substring_no_properties
);
2725 defsubr (&Sbuffer_string
);
2727 defsubr (&Spoint_marker
);
2728 defsubr (&Smark_marker
);
2730 defsubr (&Sregion_beginning
);
2731 defsubr (&Sregion_end
);
2732 /* defsubr (&Smark); */
2733 /* defsubr (&Sset_mark); */
2734 defsubr (&Ssave_excursion
);
2735 defsubr (&Ssave_current_buffer
);
2737 defsubr (&Sbufsize
);
2738 defsubr (&Spoint_max
);
2739 defsubr (&Spoint_min
);
2740 defsubr (&Spoint_min_marker
);
2741 defsubr (&Spoint_max_marker
);
2743 defsubr (&Sline_beginning_position
);
2744 defsubr (&Sline_end_position
);
2750 defsubr (&Sfollowing_char
);
2751 defsubr (&Sprevious_char
);
2752 defsubr (&Schar_after
);
2753 defsubr (&Schar_before
);
2755 defsubr (&Sinsert_before_markers
);
2756 defsubr (&Sinsert_and_inherit
);
2757 defsubr (&Sinsert_and_inherit_before_markers
);
2758 defsubr (&Sinsert_char
);
2760 defsubr (&Suser_login_name
);
2761 defsubr (&Suser_real_login_name
);
2762 defsubr (&Suser_uid
);
2763 defsubr (&Suser_real_uid
);
2764 defsubr (&Suser_full_name
);
2765 defsubr (&Semacs_pid
);
2766 defsubr (&Scurrent_time
);
2767 defsubr (&Sformat_time_string
);
2768 defsubr (&Sdecode_time
);
2769 defsubr (&Sencode_time
);
2770 defsubr (&Scurrent_time_string
);
2771 defsubr (&Scurrent_time_zone
);
2772 defsubr (&Sset_time_zone_rule
);
2773 defsubr (&Ssystem_name
);
2774 defsubr (&Smessage
);
2775 defsubr (&Smessage_box
);
2776 defsubr (&Smessage_or_box
);
2779 defsubr (&Sinsert_buffer_substring
);
2780 defsubr (&Scompare_buffer_substrings
);
2781 defsubr (&Ssubst_char_in_region
);
2782 defsubr (&Stranslate_region
);
2783 defsubr (&Sdelete_region
);
2785 defsubr (&Snarrow_to_region
);
2786 defsubr (&Ssave_restriction
);
2787 defsubr (&Stranspose_regions
);