1 /* Lisp functions pertaining to editing.
2 Copyright (C) 1985,86,87,89,93,94,95,96,97,98 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))
47 extern char **environ
;
48 extern Lisp_Object
make_time ();
49 extern void insert_from_buffer ();
50 static int tm_diff ();
51 static void update_buffer_properties ();
52 size_t emacs_strftime ();
53 void set_time_zone_rule ();
55 Lisp_Object Vbuffer_access_fontify_functions
;
56 Lisp_Object Qbuffer_access_fontify_functions
;
57 Lisp_Object Vbuffer_access_fontified_property
;
59 Lisp_Object
Fuser_full_name ();
61 /* Some static data, and a function to initialize it for each run */
63 Lisp_Object Vsystem_name
;
64 Lisp_Object Vuser_real_login_name
; /* login name of current user ID */
65 Lisp_Object Vuser_full_name
; /* full name of current user */
66 Lisp_Object Vuser_login_name
; /* user name from LOGNAME or USER */
72 register unsigned char *p
, *q
, *r
;
73 struct passwd
*pw
; /* password entry for the current user */
76 /* Set up system_name even when dumping. */
80 /* Don't bother with this on initial start when just dumping out */
83 #endif /* not CANNOT_DUMP */
85 pw
= (struct passwd
*) getpwuid (getuid ());
87 /* We let the real user name default to "root" because that's quite
88 accurate on MSDOG and because it lets Emacs find the init file.
89 (The DVX libraries override the Djgpp libraries here.) */
90 Vuser_real_login_name
= build_string (pw
? pw
->pw_name
: "root");
92 Vuser_real_login_name
= build_string (pw
? pw
->pw_name
: "unknown");
95 /* Get the effective user name, by consulting environment variables,
96 or the effective uid if those are unset. */
97 user_name
= (char *) getenv ("LOGNAME");
100 user_name
= (char *) getenv ("USERNAME"); /* it's USERNAME on NT */
101 #else /* WINDOWSNT */
102 user_name
= (char *) getenv ("USER");
103 #endif /* WINDOWSNT */
106 pw
= (struct passwd
*) getpwuid (geteuid ());
107 user_name
= (char *) (pw
? pw
->pw_name
: "unknown");
109 Vuser_login_name
= build_string (user_name
);
111 /* If the user name claimed in the environment vars differs from
112 the real uid, use the claimed name to find the full name. */
113 tem
= Fstring_equal (Vuser_login_name
, Vuser_real_login_name
);
114 Vuser_full_name
= Fuser_full_name (NILP (tem
)? make_number (geteuid())
117 p
= (unsigned char *) getenv ("NAME");
119 Vuser_full_name
= build_string (p
);
120 else if (NILP (Vuser_full_name
))
121 Vuser_full_name
= build_string ("unknown");
124 DEFUN ("char-to-string", Fchar_to_string
, Schar_to_string
, 1, 1, 0,
125 "Convert arg CHAR to a string containing multi-byte form of that character.")
127 Lisp_Object character
;
130 unsigned char workbuf
[4], *str
;
132 CHECK_NUMBER (character
, 0);
134 len
= CHAR_STRING (XFASTINT (character
), workbuf
, str
);
135 return make_multibyte_string (str
, 1, len
);
138 DEFUN ("string-to-char", Fstring_to_char
, Sstring_to_char
, 1, 1, 0,
139 "Convert arg STRING to a character, the first character of that string.\n\
140 A multibyte character is handled correctly.")
142 register Lisp_Object string
;
144 register Lisp_Object val
;
145 register struct Lisp_String
*p
;
146 CHECK_STRING (string
, 0);
147 p
= XSTRING (string
);
149 XSETFASTINT (val
, STRING_CHAR (p
->data
, p
->size_byte
));
151 XSETFASTINT (val
, 0);
156 buildmark (charpos
, bytepos
)
157 int charpos
, bytepos
;
159 register Lisp_Object mark
;
160 mark
= Fmake_marker ();
161 set_marker_both (mark
, Qnil
, charpos
, bytepos
);
165 DEFUN ("point", Fpoint
, Spoint
, 0, 0, 0,
166 "Return value of point, as an integer.\n\
167 Beginning of buffer is position (point-min)")
171 XSETFASTINT (temp
, PT
);
175 DEFUN ("point-marker", Fpoint_marker
, Spoint_marker
, 0, 0, 0,
176 "Return value of point, as a marker object.")
179 return buildmark (PT
, PT_BYTE
);
183 clip_to_bounds (lower
, num
, upper
)
184 int lower
, num
, upper
;
188 else if (num
> upper
)
194 DEFUN ("goto-char", Fgoto_char
, Sgoto_char
, 1, 1, "NGoto char: ",
195 "Set point to POSITION, a number or marker.\n\
196 Beginning of buffer is position (point-min), end is (point-max).\n\
197 If the position is in the middle of a multibyte form,\n\
198 the actual point is set at the head of the multibyte form\n\
199 except in the case that `enable-multibyte-characters' is nil.")
201 register Lisp_Object position
;
206 if (MARKERP (position
))
208 pos
= marker_position (position
);
210 SET_PT_BOTH (BEGV
, BEGV_BYTE
);
212 SET_PT_BOTH (ZV
, ZV_BYTE
);
214 SET_PT_BOTH (pos
, marker_byte_position (position
));
219 CHECK_NUMBER_COERCE_MARKER (position
, 0);
221 pos
= clip_to_bounds (BEGV
, XINT (position
), ZV
);
227 region_limit (beginningp
)
230 extern Lisp_Object Vmark_even_if_inactive
; /* Defined in callint.c. */
231 register Lisp_Object m
;
232 if (!NILP (Vtransient_mark_mode
) && NILP (Vmark_even_if_inactive
)
233 && NILP (current_buffer
->mark_active
))
234 Fsignal (Qmark_inactive
, Qnil
);
235 m
= Fmarker_position (current_buffer
->mark
);
236 if (NILP (m
)) error ("There is no region now");
237 if ((PT
< XFASTINT (m
)) == beginningp
)
238 return (make_number (PT
));
243 DEFUN ("region-beginning", Fregion_beginning
, Sregion_beginning
, 0, 0, 0,
244 "Return position of beginning of region, as an integer.")
247 return (region_limit (1));
250 DEFUN ("region-end", Fregion_end
, Sregion_end
, 0, 0, 0,
251 "Return position of end of region, as an integer.")
254 return (region_limit (0));
257 DEFUN ("mark-marker", Fmark_marker
, Smark_marker
, 0, 0, 0,
258 "Return this buffer's mark, as a marker object.\n\
259 Watch out! Moving this marker changes the mark position.\n\
260 If you set the marker not to point anywhere, the buffer will have no mark.")
263 return current_buffer
->mark
;
266 DEFUN ("line-beginning-position", Fline_beginning_position
, Sline_beginning_position
,
268 "Return the character position of the first character on the current line.\n\
269 With argument N not nil or 1, move forward N - 1 lines first.\n\
270 If scan reaches end of buffer, return that position.\n\
271 This function does not move point.")
275 register int orig
, orig_byte
, end
;
284 Fforward_line (make_number (XINT (n
) - 1));
286 SET_PT_BOTH (orig
, orig_byte
);
288 return make_number (end
);
291 DEFUN ("line-end-position", Fline_end_position
, Sline_end_position
,
293 "Return the character position of the last character on the current line.\n\
294 With argument N not nil or 1, move forward N - 1 lines first.\n\
295 If scan reaches end of buffer, return that position.\n\
296 This function does not move point.")
305 return make_number (find_before_next_newline
306 (PT
, 0, XINT (n
) - (XINT (n
) <= 0)));
310 save_excursion_save ()
312 register int visible
= (XBUFFER (XWINDOW (selected_window
)->buffer
)
315 return Fcons (Fpoint_marker (),
316 Fcons (Fcopy_marker (current_buffer
->mark
, Qnil
),
317 Fcons (visible
? Qt
: Qnil
,
318 current_buffer
->mark_active
)));
322 save_excursion_restore (info
)
325 Lisp_Object tem
, tem1
, omark
, nmark
;
326 struct gcpro gcpro1
, gcpro2
, gcpro3
;
328 tem
= Fmarker_buffer (Fcar (info
));
329 /* If buffer being returned to is now deleted, avoid error */
330 /* Otherwise could get error here while unwinding to top level
332 /* In that case, Fmarker_buffer returns nil now. */
336 omark
= nmark
= Qnil
;
337 GCPRO3 (info
, omark
, nmark
);
342 unchain_marker (tem
);
343 tem
= Fcar (Fcdr (info
));
344 omark
= Fmarker_position (current_buffer
->mark
);
345 Fset_marker (current_buffer
->mark
, tem
, Fcurrent_buffer ());
346 nmark
= Fmarker_position (tem
);
347 unchain_marker (tem
);
348 tem
= Fcdr (Fcdr (info
));
349 #if 0 /* We used to make the current buffer visible in the selected window
350 if that was true previously. That avoids some anomalies.
351 But it creates others, and it wasn't documented, and it is simpler
352 and cleaner never to alter the window/buffer connections. */
355 && current_buffer
!= XBUFFER (XWINDOW (selected_window
)->buffer
))
356 Fswitch_to_buffer (Fcurrent_buffer (), Qnil
);
359 tem1
= current_buffer
->mark_active
;
360 current_buffer
->mark_active
= Fcdr (tem
);
361 if (!NILP (Vrun_hooks
))
363 /* If mark is active now, and either was not active
364 or was at a different place, run the activate hook. */
365 if (! NILP (current_buffer
->mark_active
))
367 if (! EQ (omark
, nmark
))
368 call1 (Vrun_hooks
, intern ("activate-mark-hook"));
370 /* If mark has ceased to be active, run deactivate hook. */
371 else if (! NILP (tem1
))
372 call1 (Vrun_hooks
, intern ("deactivate-mark-hook"));
378 DEFUN ("save-excursion", Fsave_excursion
, Ssave_excursion
, 0, UNEVALLED
, 0,
379 "Save point, mark, and current buffer; execute BODY; restore those things.\n\
380 Executes BODY just like `progn'.\n\
381 The values of point, mark and the current buffer are restored\n\
382 even in case of abnormal exit (throw or error).\n\
383 The state of activation of the mark is also restored.\n\
385 This construct does not save `deactivate-mark', and therefore\n\
386 functions that change the buffer will still cause deactivation\n\
387 of the mark at the end of the command. To prevent that, bind\n\
388 `deactivate-mark' with `let'.")
392 register Lisp_Object val
;
393 int count
= specpdl_ptr
- specpdl
;
395 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
398 return unbind_to (count
, val
);
401 DEFUN ("save-current-buffer", Fsave_current_buffer
, Ssave_current_buffer
, 0, UNEVALLED
, 0,
402 "Save the current buffer; execute BODY; restore the current buffer.\n\
403 Executes BODY just like `progn'.")
407 register Lisp_Object val
;
408 int count
= specpdl_ptr
- specpdl
;
410 record_unwind_protect (set_buffer_if_live
, Fcurrent_buffer ());
413 return unbind_to (count
, val
);
416 DEFUN ("buffer-size", Fbufsize
, Sbufsize
, 0, 0, 0,
417 "Return the number of characters in the current buffer.")
421 XSETFASTINT (temp
, Z
- BEG
);
425 DEFUN ("point-min", Fpoint_min
, Spoint_min
, 0, 0, 0,
426 "Return the minimum permissible value of point in the current buffer.\n\
427 This is 1, unless narrowing (a buffer restriction) is in effect.")
431 XSETFASTINT (temp
, BEGV
);
435 DEFUN ("point-min-marker", Fpoint_min_marker
, Spoint_min_marker
, 0, 0, 0,
436 "Return a marker to the minimum permissible value of point in this buffer.\n\
437 This is the beginning, unless narrowing (a buffer restriction) is in effect.")
440 return buildmark (BEGV
, BEGV_BYTE
);
443 DEFUN ("point-max", Fpoint_max
, Spoint_max
, 0, 0, 0,
444 "Return the maximum permissible value of point in the current buffer.\n\
445 This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
446 is in effect, in which case it is less.")
450 XSETFASTINT (temp
, ZV
);
454 DEFUN ("point-max-marker", Fpoint_max_marker
, Spoint_max_marker
, 0, 0, 0,
455 "Return a marker to the maximum permissible value of point in this buffer.\n\
456 This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
457 is in effect, in which case it is less.")
460 return buildmark (ZV
, ZV_BYTE
);
463 DEFUN ("position-bytes", Fposition_bytes
, Sposition_bytes
, 1, 1, 0,
464 "Return the byte position for character position POSITION.")
466 Lisp_Object position
;
468 CHECK_NUMBER_COERCE_MARKER (position
, 1);
469 return make_number (CHAR_TO_BYTE (XINT (position
)));
472 DEFUN ("following-char", Ffollowing_char
, Sfollowing_char
, 0, 0, 0,
473 "Return the character following point, as a number.\n\
474 At the end of the buffer or accessible region, return 0.\n\
475 If `enable-multibyte-characters' is nil or point is not\n\
476 at character boundary, multibyte form is ignored,\n\
477 and only one byte following point is returned as a character.")
482 XSETFASTINT (temp
, 0);
484 XSETFASTINT (temp
, FETCH_CHAR (PT_BYTE
));
488 DEFUN ("preceding-char", Fprevious_char
, Sprevious_char
, 0, 0, 0,
489 "Return the character preceding point, as a number.\n\
490 At the beginning of the buffer or accessible region, return 0.\n\
491 If `enable-multibyte-characters' is nil or point is not\n\
492 at character boundary, multi-byte form is ignored,\n\
493 and only one byte preceding point is returned as a character.")
498 XSETFASTINT (temp
, 0);
499 else if (!NILP (current_buffer
->enable_multibyte_characters
))
503 XSETFASTINT (temp
, FETCH_CHAR (pos
));
506 XSETFASTINT (temp
, FETCH_BYTE (PT_BYTE
- 1));
510 DEFUN ("bobp", Fbobp
, Sbobp
, 0, 0, 0,
511 "Return t if point is at the beginning of the buffer.\n\
512 If the buffer is narrowed, this means the beginning of the narrowed part.")
520 DEFUN ("eobp", Feobp
, Seobp
, 0, 0, 0,
521 "Return t if point is at the end of the buffer.\n\
522 If the buffer is narrowed, this means the end of the narrowed part.")
530 DEFUN ("bolp", Fbolp
, Sbolp
, 0, 0, 0,
531 "Return t if point is at the beginning of a line.")
534 if (PT
== BEGV
|| FETCH_BYTE (PT_BYTE
- 1) == '\n')
539 DEFUN ("eolp", Feolp
, Seolp
, 0, 0, 0,
540 "Return t if point is at the end of a line.\n\
541 `End of a line' includes point being at the end of the buffer.")
544 if (PT
== ZV
|| FETCH_BYTE (PT_BYTE
) == '\n')
549 DEFUN ("char-after", Fchar_after
, Schar_after
, 0, 1, 0,
550 "Return character in current buffer at position POS.\n\
551 POS is an integer or a buffer pointer.\n\
552 If POS is out of range, the value is nil.\n\
553 If `enable-multibyte-characters' is nil or POS is not at character boundary,\n\
554 multi-byte form is ignored, and only one byte at POS\n\
555 is returned as a character.")
559 register int pos_byte
;
560 register Lisp_Object val
;
564 else if (MARKERP (pos
))
566 pos_byte
= marker_byte_position (pos
);
567 if (pos_byte
< BEGV_BYTE
|| pos_byte
>= ZV_BYTE
)
572 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
573 if (pos
< BEGV
|| pos
>= ZV
)
576 pos_byte
= CHAR_TO_BYTE (XINT (pos
));
579 return make_number (FETCH_CHAR (pos_byte
));
582 DEFUN ("char-before", Fchar_before
, Schar_before
, 0, 1, 0,
583 "Return character in current buffer preceding position POS.\n\
584 POS is an integer or a buffer pointer.\n\
585 If POS is out of range, the value is nil.\n\
586 If `enable-multibyte-characters' is nil or POS is not at character boundary,\n\
587 multi-byte form is ignored, and only one byte preceding POS\n\
588 is returned as a character.")
592 register Lisp_Object val
;
593 register int pos_byte
;
597 else if (MARKERP (pos
))
599 pos_byte
= marker_byte_position (pos
);
601 if (pos_byte
<= BEGV_BYTE
|| pos_byte
> ZV_BYTE
)
606 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
608 if (pos
<= BEGV
|| pos
> ZV
)
611 pos_byte
= CHAR_TO_BYTE (XINT (pos
));
614 if (!NILP (current_buffer
->enable_multibyte_characters
))
617 XSETFASTINT (val
, FETCH_CHAR (pos_byte
));
622 XSETFASTINT (val
, FETCH_BYTE (pos_byte
));
627 DEFUN ("user-login-name", Fuser_login_name
, Suser_login_name
, 0, 1, 0,
628 "Return the name under which the user logged in, as a string.\n\
629 This is based on the effective uid, not the real uid.\n\
630 Also, if the environment variable LOGNAME or USER is set,\n\
631 that determines the value of this function.\n\n\
632 If optional argument UID is an integer, return the login name of the user\n\
633 with that uid, or nil if there is no such user.")
639 /* Set up the user name info if we didn't do it before.
640 (That can happen if Emacs is dumpable
641 but you decide to run `temacs -l loadup' and not dump. */
642 if (INTEGERP (Vuser_login_name
))
646 return Vuser_login_name
;
648 CHECK_NUMBER (uid
, 0);
649 pw
= (struct passwd
*) getpwuid (XINT (uid
));
650 return (pw
? build_string (pw
->pw_name
) : Qnil
);
653 DEFUN ("user-real-login-name", Fuser_real_login_name
, Suser_real_login_name
,
655 "Return the name of the user's real uid, as a string.\n\
656 This ignores the environment variables LOGNAME and USER, so it differs from\n\
657 `user-login-name' when running under `su'.")
660 /* Set up the user name info if we didn't do it before.
661 (That can happen if Emacs is dumpable
662 but you decide to run `temacs -l loadup' and not dump. */
663 if (INTEGERP (Vuser_login_name
))
665 return Vuser_real_login_name
;
668 DEFUN ("user-uid", Fuser_uid
, Suser_uid
, 0, 0, 0,
669 "Return the effective uid of Emacs, as an integer.")
672 return make_number (geteuid ());
675 DEFUN ("user-real-uid", Fuser_real_uid
, Suser_real_uid
, 0, 0, 0,
676 "Return the real uid of Emacs, as an integer.")
679 return make_number (getuid ());
682 DEFUN ("user-full-name", Fuser_full_name
, Suser_full_name
, 0, 1, 0,
683 "Return the full name of the user logged in, as a string.\n\
684 If optional argument UID is an integer, return the full name of the user\n\
685 with that uid, or \"unknown\" if there is no such user.\n\
686 If UID is a string, return the full name of the user with that login\n\
687 name, or \"unknown\" if no such user could be found.")
692 register unsigned char *p
, *q
;
693 extern char *index ();
697 return Vuser_full_name
;
698 else if (NUMBERP (uid
))
699 pw
= (struct passwd
*) getpwuid (XINT (uid
));
700 else if (STRINGP (uid
))
701 pw
= (struct passwd
*) getpwnam (XSTRING (uid
)->data
);
703 error ("Invalid UID specification");
708 p
= (unsigned char *) USER_FULL_NAME
;
709 /* Chop off everything after the first comma. */
710 q
= (unsigned char *) index (p
, ',');
711 full
= make_string (p
, q
? q
- p
: strlen (p
));
713 #ifdef AMPERSAND_FULL_NAME
714 p
= XSTRING (full
)->data
;
715 q
= (unsigned char *) index (p
, '&');
716 /* Substitute the login name for the &, upcasing the first character. */
719 register unsigned char *r
;
722 login
= Fuser_login_name (make_number (pw
->pw_uid
));
723 r
= (unsigned char *) alloca (strlen (p
) + XSTRING (login
)->size
+ 1);
726 strcat (r
, XSTRING (login
)->data
);
727 r
[q
- p
] = UPCASE (r
[q
- p
]);
729 full
= build_string (r
);
731 #endif /* AMPERSAND_FULL_NAME */
736 DEFUN ("system-name", Fsystem_name
, Ssystem_name
, 0, 0, 0,
737 "Return the name of the machine you are running on, as a string.")
743 /* For the benefit of callers who don't want to include lisp.h */
747 if (STRINGP (Vsystem_name
))
748 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
);
805 DEFUN ("format-time-string", Fformat_time_string, Sformat_time_string, 1, 3, 0,
806 "Use FORMAT-STRING to format the time TIME, or now if omitted.\n\
807 TIME is specified as (HIGH LOW . IGNORED) or (HIGH . LOW), as returned by\n\
808 `current-time' or `file-attributes'.\n\
809 The third, optional, argument UNIVERSAL, if non-nil, means describe TIME\n\
810 as Universal Time; nil means describe TIME in the local time zone.\n\
811 The value is a copy of FORMAT-STRING, but with certain constructs replaced\n\
812 by text that describes the specified date and time in TIME:\n\
814 %Y is the year, %y within the century, %C the century.\n\
815 %G is the year corresponding to the ISO week, %g within the century.\n\
816 %m is the numeric month.\n\
817 %b and %h are the locale's abbreviated month name, %B the full name.\n\
818 %d is the day of the month, zero-padded, %e is blank-padded.\n\
819 %u is the numeric day of week from 1 (Monday) to 7, %w from 0 (Sunday) to 6.\n\
820 %a is the locale's abbreviated name of the day of week, %A the full name.\n\
821 %U is the week number starting on Sunday, %W starting on Monday,\n\
822 %V according to ISO 8601.\n\
823 %j is the day of the year.\n\
825 %H is the hour on a 24-hour clock, %I is on a 12-hour clock, %k is like %H\n\
826 only blank-padded, %l is like %I blank-padded.\n\
827 %p is the locale's equivalent of either AM or PM.\n\
830 %Z is the time zone name, %z is the numeric form.\n\
831 %s is the number of seconds since 1970-01-01 00:00:00 +0000.\n\
833 %c is the locale's date and time format.\n\
834 %x is the locale's \"preferred\" date format.\n\
835 %D is like \"%m/%d/%y\".\n\
837 %R is like \"%H:%M\", %T is like \"%H:%M:%S\", %r is like \"%I:%M:%S %p\".\n\
838 %X is the locale's \"preferred\" time format.\n\
840 Finally, %n is a newline, %t is a tab, %% is a literal %.\n\
842 Certain flags and modifiers are available with some format controls.\n\
843 The flags are `_' and `-'. For certain characters X, %_X is like %X,\n\
844 but padded with blanks; %-X is like %X, but without padding.\n\
845 %NX (where N stands for an integer) is like %X,\n\
846 but takes up at least N (a number) positions.\n\
847 The modifiers are `E' and `O'. For certain characters X,\n\
848 %EX is a locale's alternative version of %X;\n\
849 %OX is like %X, but uses the locale's number symbols.\n\
851 For example, to produce full ISO 8601 format, use \"%Y-%m-%dT%T%z\".")
852 (format_string, time, universal)
855 DEFUN ("format-time-string", Fformat_time_string
, Sformat_time_string
, 1, 3, 0,
856 0 /* See immediately above */)
857 (format_string
, time
, universal
)
858 Lisp_Object format_string
, time
, universal
;
863 CHECK_STRING (format_string
, 1);
865 if (! lisp_time_argument (time
, &value
))
866 error ("Invalid time specification");
868 /* This is probably enough. */
869 size
= XSTRING (format_string
)->size_byte
* 6 + 50;
873 char *buf
= (char *) alloca (size
+ 1);
877 result
= emacs_strftime (buf
, size
, XSTRING (format_string
)->data
,
878 (NILP (universal
) ? localtime (&value
)
880 if ((result
> 0 && result
< size
) || (result
== 0 && buf
[0] == '\0'))
881 return build_string (buf
);
883 /* If buffer was too small, make it bigger and try again. */
884 result
= emacs_strftime (NULL
, 0x7fffffff, XSTRING (format_string
)->data
,
885 (NILP (universal
) ? localtime (&value
)
891 DEFUN ("decode-time", Fdecode_time
, Sdecode_time
, 0, 1, 0,
892 "Decode a time value as (SEC MINUTE HOUR DAY MONTH YEAR DOW DST ZONE).\n\
893 The optional SPECIFIED-TIME should be a list of (HIGH LOW . IGNORED)\n\
894 or (HIGH . LOW), as from `current-time' and `file-attributes', or `nil'\n\
895 to use the current time. The list has the following nine members:\n\
896 SEC is an integer between 0 and 60; SEC is 60 for a leap second, which\n\
897 only some operating systems support. MINUTE is an integer between 0 and 59.\n\
898 HOUR is an integer between 0 and 23. DAY is an integer between 1 and 31.\n\
899 MONTH is an integer between 1 and 12. YEAR is an integer indicating the\n\
900 four-digit year. DOW is the day of week, an integer between 0 and 6, where\n\
901 0 is Sunday. DST is t if daylight savings time is effect, otherwise nil.\n\
902 ZONE is an integer indicating the number of seconds east of Greenwich.\n\
903 \(Note that Common Lisp has different meanings for DOW and ZONE.)")
905 Lisp_Object specified_time
;
909 struct tm
*decoded_time
;
910 Lisp_Object list_args
[9];
912 if (! lisp_time_argument (specified_time
, &time_spec
))
913 error ("Invalid time specification");
915 decoded_time
= localtime (&time_spec
);
916 XSETFASTINT (list_args
[0], decoded_time
->tm_sec
);
917 XSETFASTINT (list_args
[1], decoded_time
->tm_min
);
918 XSETFASTINT (list_args
[2], decoded_time
->tm_hour
);
919 XSETFASTINT (list_args
[3], decoded_time
->tm_mday
);
920 XSETFASTINT (list_args
[4], decoded_time
->tm_mon
+ 1);
921 XSETINT (list_args
[5], decoded_time
->tm_year
+ 1900);
922 XSETFASTINT (list_args
[6], decoded_time
->tm_wday
);
923 list_args
[7] = (decoded_time
->tm_isdst
)? Qt
: Qnil
;
925 /* Make a copy, in case gmtime modifies the struct. */
926 save_tm
= *decoded_time
;
927 decoded_time
= gmtime (&time_spec
);
928 if (decoded_time
== 0)
931 XSETINT (list_args
[8], tm_diff (&save_tm
, decoded_time
));
932 return Flist (9, list_args
);
935 DEFUN ("encode-time", Fencode_time
, Sencode_time
, 6, MANY
, 0,
936 "Convert SECOND, MINUTE, HOUR, DAY, MONTH, YEAR and ZONE to internal time.\n\
937 This is the reverse operation of `decode-time', which see.\n\
938 ZONE defaults to the current time zone rule. This can\n\
939 be a string or t (as from `set-time-zone-rule'), or it can be a list\n\
940 \(as from `current-time-zone') or an integer (as from `decode-time')\n\
941 applied without consideration for daylight savings time.\n\
943 You can pass more than 7 arguments; then the first six arguments\n\
944 are used as SECOND through YEAR, and the *last* argument is used as ZONE.\n\
945 The intervening arguments are ignored.\n\
946 This feature lets (apply 'encode-time (decode-time ...)) work.\n\
948 Out-of-range values for SEC, MINUTE, HOUR, DAY, or MONTH are allowed;\n\
949 for example, a DAY of 0 means the day preceding the given month.\n\
950 Year numbers less than 100 are treated just like other year numbers.\n\
951 If you want them to stand for years in this century, you must do that yourself.")
954 register Lisp_Object
*args
;
958 Lisp_Object zone
= (nargs
> 6 ? args
[nargs
- 1] : Qnil
);
960 CHECK_NUMBER (args
[0], 0); /* second */
961 CHECK_NUMBER (args
[1], 1); /* minute */
962 CHECK_NUMBER (args
[2], 2); /* hour */
963 CHECK_NUMBER (args
[3], 3); /* day */
964 CHECK_NUMBER (args
[4], 4); /* month */
965 CHECK_NUMBER (args
[5], 5); /* year */
967 tm
.tm_sec
= XINT (args
[0]);
968 tm
.tm_min
= XINT (args
[1]);
969 tm
.tm_hour
= XINT (args
[2]);
970 tm
.tm_mday
= XINT (args
[3]);
971 tm
.tm_mon
= XINT (args
[4]) - 1;
972 tm
.tm_year
= XINT (args
[5]) - 1900;
983 char **oldenv
= environ
, **newenv
;
987 else if (STRINGP (zone
))
988 tzstring
= (char *) XSTRING (zone
)->data
;
989 else if (INTEGERP (zone
))
991 int abszone
= abs (XINT (zone
));
992 sprintf (tzbuf
, "XXX%s%d:%02d:%02d", "-" + (XINT (zone
) < 0),
993 abszone
/ (60*60), (abszone
/60) % 60, abszone
% 60);
997 error ("Invalid time zone specification");
999 /* Set TZ before calling mktime; merely adjusting mktime's returned
1000 value doesn't suffice, since that would mishandle leap seconds. */
1001 set_time_zone_rule (tzstring
);
1003 time
= mktime (&tm
);
1005 /* Restore TZ to previous value. */
1009 #ifdef LOCALTIME_CACHE
1014 if (time
== (time_t) -1)
1015 error ("Specified time is not representable");
1017 return make_time (time
);
1020 DEFUN ("current-time-string", Fcurrent_time_string
, Scurrent_time_string
, 0, 1, 0,
1021 "Return the current time, as a human-readable string.\n\
1022 Programs can use this function to decode a time,\n\
1023 since the number of columns in each field is fixed.\n\
1024 The format is `Sun Sep 16 01:03:52 1973'.\n\
1025 However, see also the functions `decode-time' and `format-time-string'\n\
1026 which provide a much more powerful and general facility.\n\
1028 If an argument is given, it specifies a time to format\n\
1029 instead of the current time. The argument should have the form:\n\
1032 (HIGH LOW . IGNORED).\n\
1033 Thus, you can use times obtained from `current-time'\n\
1034 and from `file-attributes'.")
1036 Lisp_Object specified_time
;
1042 if (! lisp_time_argument (specified_time
, &value
))
1044 tem
= (char *) ctime (&value
);
1046 strncpy (buf
, tem
, 24);
1049 return build_string (buf
);
1052 #define TM_YEAR_BASE 1900
1054 /* Yield A - B, measured in seconds.
1055 This function is copied from the GNU C Library. */
1060 /* Compute intervening leap days correctly even if year is negative.
1061 Take care to avoid int overflow in leap day calculations,
1062 but it's OK to assume that A and B are close to each other. */
1063 int a4
= (a
->tm_year
>> 2) + (TM_YEAR_BASE
>> 2) - ! (a
->tm_year
& 3);
1064 int b4
= (b
->tm_year
>> 2) + (TM_YEAR_BASE
>> 2) - ! (b
->tm_year
& 3);
1065 int a100
= a4
/ 25 - (a4
% 25 < 0);
1066 int b100
= b4
/ 25 - (b4
% 25 < 0);
1067 int a400
= a100
>> 2;
1068 int b400
= b100
>> 2;
1069 int intervening_leap_days
= (a4
- b4
) - (a100
- b100
) + (a400
- b400
);
1070 int years
= a
->tm_year
- b
->tm_year
;
1071 int days
= (365 * years
+ intervening_leap_days
1072 + (a
->tm_yday
- b
->tm_yday
));
1073 return (60 * (60 * (24 * days
+ (a
->tm_hour
- b
->tm_hour
))
1074 + (a
->tm_min
- b
->tm_min
))
1075 + (a
->tm_sec
- b
->tm_sec
));
1078 DEFUN ("current-time-zone", Fcurrent_time_zone
, Scurrent_time_zone
, 0, 1, 0,
1079 "Return the offset and name for the local time zone.\n\
1080 This returns a list of the form (OFFSET NAME).\n\
1081 OFFSET is an integer number of seconds ahead of UTC (east of Greenwich).\n\
1082 A negative value means west of Greenwich.\n\
1083 NAME is a string giving the name of the time zone.\n\
1084 If an argument is given, it specifies when the time zone offset is determined\n\
1085 instead of using the current time. The argument should have the form:\n\
1088 (HIGH LOW . IGNORED).\n\
1089 Thus, you can use times obtained from `current-time'\n\
1090 and from `file-attributes'.\n\
1092 Some operating systems cannot provide all this information to Emacs;\n\
1093 in this case, `current-time-zone' returns a list containing nil for\n\
1094 the data it can't find.")
1096 Lisp_Object specified_time
;
1101 if (lisp_time_argument (specified_time
, &value
)
1102 && (t
= gmtime (&value
)) != 0)
1108 gmt
= *t
; /* Make a copy, in case localtime modifies *t. */
1109 t
= localtime (&value
);
1110 offset
= tm_diff (t
, &gmt
);
1114 s
= (char *)t
->tm_zone
;
1115 #else /* not HAVE_TM_ZONE */
1117 if (t
->tm_isdst
== 0 || t
->tm_isdst
== 1)
1118 s
= tzname
[t
->tm_isdst
];
1120 #endif /* not HAVE_TM_ZONE */
1123 /* No local time zone name is available; use "+-NNNN" instead. */
1124 int am
= (offset
< 0 ? -offset
: offset
) / 60;
1125 sprintf (buf
, "%c%02d%02d", (offset
< 0 ? '-' : '+'), am
/60, am
%60);
1128 return Fcons (make_number (offset
), Fcons (build_string (s
), Qnil
));
1131 return Fmake_list (make_number (2), Qnil
);
1134 /* This holds the value of `environ' produced by the previous
1135 call to Fset_time_zone_rule, or 0 if Fset_time_zone_rule
1136 has never been called. */
1137 static char **environbuf
;
1139 DEFUN ("set-time-zone-rule", Fset_time_zone_rule
, Sset_time_zone_rule
, 1, 1, 0,
1140 "Set the local time zone using TZ, a string specifying a time zone rule.\n\
1141 If TZ is nil, use implementation-defined default time zone information.\n\
1142 If TZ is t, use Universal Time.")
1150 else if (EQ (tz
, Qt
))
1154 CHECK_STRING (tz
, 0);
1155 tzstring
= (char *) XSTRING (tz
)->data
;
1158 set_time_zone_rule (tzstring
);
1161 environbuf
= environ
;
1166 #ifdef LOCALTIME_CACHE
1168 /* These two values are known to load tz files in buggy implementations,
1169 i.e. Solaris 1 executables running under either Solaris 1 or Solaris 2.
1170 Their values shouldn't matter in non-buggy implementations.
1171 We don't use string literals for these strings,
1172 since if a string in the environment is in readonly
1173 storage, it runs afoul of bugs in SVR4 and Solaris 2.3.
1174 See Sun bugs 1113095 and 1114114, ``Timezone routines
1175 improperly modify environment''. */
1177 static char set_time_zone_rule_tz1
[] = "TZ=GMT+0";
1178 static char set_time_zone_rule_tz2
[] = "TZ=GMT+1";
1182 /* Set the local time zone rule to TZSTRING.
1183 This allocates memory into `environ', which it is the caller's
1184 responsibility to free. */
1186 set_time_zone_rule (tzstring
)
1190 char **from
, **to
, **newenv
;
1192 /* Make the ENVIRON vector longer with room for TZSTRING. */
1193 for (from
= environ
; *from
; from
++)
1195 envptrs
= from
- environ
+ 2;
1196 newenv
= to
= (char **) xmalloc (envptrs
* sizeof (char *)
1197 + (tzstring
? strlen (tzstring
) + 4 : 0));
1199 /* Add TZSTRING to the end of environ, as a value for TZ. */
1202 char *t
= (char *) (to
+ envptrs
);
1204 strcat (t
, tzstring
);
1208 /* Copy the old environ vector elements into NEWENV,
1209 but don't copy the TZ variable.
1210 So we have only one definition of TZ, which came from TZSTRING. */
1211 for (from
= environ
; *from
; from
++)
1212 if (strncmp (*from
, "TZ=", 3) != 0)
1218 /* If we do have a TZSTRING, NEWENV points to the vector slot where
1219 the TZ variable is stored. If we do not have a TZSTRING,
1220 TO points to the vector slot which has the terminating null. */
1222 #ifdef LOCALTIME_CACHE
1224 /* In SunOS 4.1.3_U1 and 4.1.4, if TZ has a value like
1225 "US/Pacific" that loads a tz file, then changes to a value like
1226 "XXX0" that does not load a tz file, and then changes back to
1227 its original value, the last change is (incorrectly) ignored.
1228 Also, if TZ changes twice in succession to values that do
1229 not load a tz file, tzset can dump core (see Sun bug#1225179).
1230 The following code works around these bugs. */
1234 /* Temporarily set TZ to a value that loads a tz file
1235 and that differs from tzstring. */
1237 *newenv
= (strcmp (tzstring
, set_time_zone_rule_tz1
+ 3) == 0
1238 ? set_time_zone_rule_tz2
: set_time_zone_rule_tz1
);
1244 /* The implied tzstring is unknown, so temporarily set TZ to
1245 two different values that each load a tz file. */
1246 *to
= set_time_zone_rule_tz1
;
1249 *to
= set_time_zone_rule_tz2
;
1254 /* Now TZ has the desired value, and tzset can be invoked safely. */
1261 /* Insert NARGS Lisp objects in the array ARGS by calling INSERT_FUNC
1262 (if a type of object is Lisp_Int) or INSERT_FROM_STRING_FUNC (if a
1263 type of object is Lisp_String). INHERIT is passed to
1264 INSERT_FROM_STRING_FUNC as the last argument. */
1267 general_insert_function (insert_func
, insert_from_string_func
,
1268 inherit
, nargs
, args
)
1269 void (*insert_func
) P_ ((unsigned char *, int));
1270 void (*insert_from_string_func
) P_ ((Lisp_Object
, int, int, int, int, int));
1272 register Lisp_Object
*args
;
1274 register int argnum
;
1275 register Lisp_Object val
;
1277 for (argnum
= 0; argnum
< nargs
; argnum
++)
1283 unsigned char workbuf
[4], *str
;
1286 if (!NILP (current_buffer
->enable_multibyte_characters
))
1287 len
= CHAR_STRING (XFASTINT (val
), workbuf
, str
);
1289 workbuf
[0] = XINT (val
), str
= workbuf
, len
= 1;
1290 (*insert_func
) (str
, len
);
1292 else if (STRINGP (val
))
1294 (*insert_from_string_func
) (val
, 0, 0,
1295 XSTRING (val
)->size
,
1296 XSTRING (val
)->size_byte
,
1301 val
= wrong_type_argument (Qchar_or_string_p
, val
);
1315 /* Callers passing one argument to Finsert need not gcpro the
1316 argument "array", since the only element of the array will
1317 not be used after calling insert or insert_from_string, so
1318 we don't care if it gets trashed. */
1320 DEFUN ("insert", Finsert
, Sinsert
, 0, MANY
, 0,
1321 "Insert the arguments, either strings or characters, at point.\n\
1322 Point and before-insertion-markers move forward so that it ends up\n\
1323 after the inserted text.\n\
1324 Any other markers at the point of insertion remain before the text.")
1327 register Lisp_Object
*args
;
1329 general_insert_function (insert
, insert_from_string
, 0, nargs
, args
);
1333 DEFUN ("insert-and-inherit", Finsert_and_inherit
, Sinsert_and_inherit
,
1335 "Insert the arguments at point, inheriting properties from adjoining text.\n\
1336 Point and before-insertion-markers move forward so that it ends up\n\
1337 after the inserted text.\n\
1338 Any other markers at the point of insertion remain before the text.")
1341 register Lisp_Object
*args
;
1343 general_insert_function (insert_and_inherit
, insert_from_string
, 1,
1348 DEFUN ("insert-before-markers", Finsert_before_markers
, Sinsert_before_markers
, 0, MANY
, 0,
1349 "Insert strings or characters at point, relocating markers after the text.\n\
1350 Point and before-insertion-markers move forward so that it ends up\n\
1351 after the inserted text.\n\
1352 Any other markers at the point of insertion also end up after the text.")
1355 register Lisp_Object
*args
;
1357 general_insert_function (insert_before_markers
,
1358 insert_from_string_before_markers
, 0,
1363 DEFUN ("insert-before-markers-and-inherit", Finsert_and_inherit_before_markers
,
1364 Sinsert_and_inherit_before_markers
, 0, MANY
, 0,
1365 "Insert text at point, relocating markers and inheriting properties.\n\
1366 Point moves forward so that it ends up after the inserted text.\n\
1367 Any other markers at the point of insertion also end up after the text.")
1370 register Lisp_Object
*args
;
1372 general_insert_function (insert_before_markers_and_inherit
,
1373 insert_from_string_before_markers
, 1,
1378 DEFUN ("insert-char", Finsert_char
, Sinsert_char
, 2, 3, 0,
1379 "Insert COUNT (second arg) copies of CHARACTER (first arg).\n\
1380 Point and before-insertion-markers are affected as in the function `insert'.\n\
1381 Both arguments are required.\n\
1382 The optional third arg INHERIT, if non-nil, says to inherit text properties\n\
1383 from adjoining text, if those properties are sticky.")
1384 (character
, count
, inherit
)
1385 Lisp_Object character
, count
, inherit
;
1387 register unsigned char *string
;
1388 register int strlen
;
1391 unsigned char workbuf
[4], *str
;
1393 CHECK_NUMBER (character
, 0);
1394 CHECK_NUMBER (count
, 1);
1396 if (!NILP (current_buffer
->enable_multibyte_characters
))
1397 len
= CHAR_STRING (XFASTINT (character
), workbuf
, str
);
1399 workbuf
[0] = XFASTINT (character
), str
= workbuf
, len
= 1;
1400 n
= XINT (count
) * len
;
1403 strlen
= min (n
, 256 * len
);
1404 string
= (unsigned char *) alloca (strlen
);
1405 for (i
= 0; i
< strlen
; i
++)
1406 string
[i
] = str
[i
% len
];
1410 if (!NILP (inherit
))
1411 insert_and_inherit (string
, strlen
);
1413 insert (string
, strlen
);
1418 if (!NILP (inherit
))
1419 insert_and_inherit (string
, n
);
1427 /* Making strings from buffer contents. */
1429 /* Return a Lisp_String containing the text of the current buffer from
1430 START to END. If text properties are in use and the current buffer
1431 has properties in the range specified, the resulting string will also
1432 have them, if PROPS is nonzero.
1434 We don't want to use plain old make_string here, because it calls
1435 make_uninit_string, which can cause the buffer arena to be
1436 compacted. make_string has no way of knowing that the data has
1437 been moved, and thus copies the wrong data into the string. This
1438 doesn't effect most of the other users of make_string, so it should
1439 be left as is. But we should use this function when conjuring
1440 buffer substrings. */
1443 make_buffer_string (start
, end
, props
)
1447 Lisp_Object result
, tem
, tem1
;
1448 int start_byte
= CHAR_TO_BYTE (start
);
1449 int end_byte
= CHAR_TO_BYTE (end
);
1451 if (start
< GPT
&& GPT
< end
)
1454 result
= make_uninit_multibyte_string (end
- start
, end_byte
- start_byte
);
1455 bcopy (BYTE_POS_ADDR (start_byte
), XSTRING (result
)->data
,
1456 end_byte
- start_byte
);
1458 /* If desired, update and copy the text properties. */
1459 #ifdef USE_TEXT_PROPERTIES
1462 update_buffer_properties (start
, end
);
1464 tem
= Fnext_property_change (make_number (start
), Qnil
, make_number (end
));
1465 tem1
= Ftext_properties_at (make_number (start
), Qnil
);
1467 if (XINT (tem
) != end
|| !NILP (tem1
))
1468 copy_intervals_to_string (result
, current_buffer
, start
,
1476 /* Call Vbuffer_access_fontify_functions for the range START ... END
1477 in the current buffer, if necessary. */
1480 update_buffer_properties (start
, end
)
1483 #ifdef USE_TEXT_PROPERTIES
1484 /* If this buffer has some access functions,
1485 call them, specifying the range of the buffer being accessed. */
1486 if (!NILP (Vbuffer_access_fontify_functions
))
1488 Lisp_Object args
[3];
1491 args
[0] = Qbuffer_access_fontify_functions
;
1492 XSETINT (args
[1], start
);
1493 XSETINT (args
[2], end
);
1495 /* But don't call them if we can tell that the work
1496 has already been done. */
1497 if (!NILP (Vbuffer_access_fontified_property
))
1499 tem
= Ftext_property_any (args
[1], args
[2],
1500 Vbuffer_access_fontified_property
,
1503 Frun_hook_with_args (3, args
);
1506 Frun_hook_with_args (3, args
);
1511 DEFUN ("buffer-substring", Fbuffer_substring
, Sbuffer_substring
, 2, 2, 0,
1512 "Return the contents of part of the current buffer as a string.\n\
1513 The two arguments START and END are character positions;\n\
1514 they can be in either order.")
1516 Lisp_Object start
, end
;
1520 validate_region (&start
, &end
);
1524 return make_buffer_string (b
, e
, 1);
1527 DEFUN ("buffer-substring-no-properties", Fbuffer_substring_no_properties
,
1528 Sbuffer_substring_no_properties
, 2, 2, 0,
1529 "Return the characters of part of the buffer, without the text properties.\n\
1530 The two arguments START and END are character positions;\n\
1531 they can be in either order.")
1533 Lisp_Object start
, end
;
1537 validate_region (&start
, &end
);
1541 return make_buffer_string (b
, e
, 0);
1544 DEFUN ("buffer-string", Fbuffer_string
, Sbuffer_string
, 0, 0, 0,
1545 "Return the contents of the current buffer as a string.\n\
1546 If narrowing is in effect, this function returns only the visible part\n\
1550 return make_buffer_string (BEGV
, ZV
, 1);
1553 DEFUN ("insert-buffer-substring", Finsert_buffer_substring
, Sinsert_buffer_substring
,
1555 "Insert before point a substring of the contents of buffer BUFFER.\n\
1556 BUFFER may be a buffer or a buffer name.\n\
1557 Arguments START and END are character numbers specifying the substring.\n\
1558 They default to the beginning and the end of BUFFER.")
1560 Lisp_Object buf
, start
, end
;
1562 register int b
, e
, temp
;
1563 register struct buffer
*bp
, *obuf
;
1566 buffer
= Fget_buffer (buf
);
1569 bp
= XBUFFER (buffer
);
1570 if (NILP (bp
->name
))
1571 error ("Selecting deleted buffer");
1577 CHECK_NUMBER_COERCE_MARKER (start
, 0);
1584 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1589 temp
= b
, b
= e
, e
= temp
;
1591 if (!(BUF_BEGV (bp
) <= b
&& e
<= BUF_ZV (bp
)))
1592 args_out_of_range (start
, end
);
1594 obuf
= current_buffer
;
1595 set_buffer_internal_1 (bp
);
1596 update_buffer_properties (b
, e
);
1597 set_buffer_internal_1 (obuf
);
1599 insert_from_buffer (bp
, b
, e
- b
, 0);
1603 DEFUN ("compare-buffer-substrings", Fcompare_buffer_substrings
, Scompare_buffer_substrings
,
1605 "Compare two substrings of two buffers; return result as number.\n\
1606 the value is -N if first string is less after N-1 chars,\n\
1607 +N if first string is greater after N-1 chars, or 0 if strings match.\n\
1608 Each substring is represented as three arguments: BUFFER, START and END.\n\
1609 That makes six args in all, three for each substring.\n\n\
1610 The value of `case-fold-search' in the current buffer\n\
1611 determines whether case is significant or ignored.")
1612 (buffer1
, start1
, end1
, buffer2
, start2
, end2
)
1613 Lisp_Object buffer1
, start1
, end1
, buffer2
, start2
, end2
;
1615 register int begp1
, endp1
, begp2
, endp2
, temp
, len1
, len2
, length
, i
;
1616 register struct buffer
*bp1
, *bp2
;
1617 register Lisp_Object
*trt
1618 = (!NILP (current_buffer
->case_fold_search
)
1619 ? XCHAR_TABLE (current_buffer
->case_canon_table
)->contents
: 0);
1621 int beg1_byte
, beg2_byte
;
1623 /* Find the first buffer and its substring. */
1626 bp1
= current_buffer
;
1630 buf1
= Fget_buffer (buffer1
);
1633 bp1
= XBUFFER (buf1
);
1634 if (NILP (bp1
->name
))
1635 error ("Selecting deleted buffer");
1639 begp1
= BUF_BEGV (bp1
);
1642 CHECK_NUMBER_COERCE_MARKER (start1
, 1);
1643 begp1
= XINT (start1
);
1646 endp1
= BUF_ZV (bp1
);
1649 CHECK_NUMBER_COERCE_MARKER (end1
, 2);
1650 endp1
= XINT (end1
);
1654 temp
= begp1
, begp1
= endp1
, endp1
= temp
;
1656 if (!(BUF_BEGV (bp1
) <= begp1
1658 && endp1
<= BUF_ZV (bp1
)))
1659 args_out_of_range (start1
, end1
);
1661 /* Likewise for second substring. */
1664 bp2
= current_buffer
;
1668 buf2
= Fget_buffer (buffer2
);
1671 bp2
= XBUFFER (buf2
);
1672 if (NILP (bp2
->name
))
1673 error ("Selecting deleted buffer");
1677 begp2
= BUF_BEGV (bp2
);
1680 CHECK_NUMBER_COERCE_MARKER (start2
, 4);
1681 begp2
= XINT (start2
);
1684 endp2
= BUF_ZV (bp2
);
1687 CHECK_NUMBER_COERCE_MARKER (end2
, 5);
1688 endp2
= XINT (end2
);
1692 temp
= begp2
, begp2
= endp2
, endp2
= temp
;
1694 if (!(BUF_BEGV (bp2
) <= begp2
1696 && endp2
<= BUF_ZV (bp2
)))
1697 args_out_of_range (start2
, end2
);
1699 beg1_byte
= buf_charpos_to_bytepos (bp1
, begp1
);
1700 beg2_byte
= buf_charpos_to_bytepos (bp2
, begp2
);
1701 len1
= buf_charpos_to_bytepos (bp1
, endp1
) - begp1
;
1702 len2
= buf_charpos_to_bytepos (bp2
, endp2
) - begp2
;
1707 for (i
= 0; i
< length
; i
++)
1709 unsigned char *p1
= BUF_BYTE_ADDRESS (bp1
, beg1_byte
+ i
);
1711 int c2
= *BUF_BYTE_ADDRESS (bp2
, beg2_byte
+ i
);
1713 /* If a character begins here,
1714 count the previous character now. */
1716 && (NILP (current_buffer
->enable_multibyte_characters
)
1717 || CHAR_HEAD_P (*p1
)))
1722 c1
= XINT (trt
[c1
]);
1723 c2
= XINT (trt
[c2
]);
1726 return make_number (- 1 - chars
);
1728 return make_number (chars
+ 1);
1731 /* The strings match as far as they go.
1732 If one is shorter, that one is less. */
1734 return make_number (chars
+ 1);
1735 else if (length
< len2
)
1736 return make_number (- chars
- 1);
1738 /* Same length too => they are equal. */
1739 return make_number (0);
1743 subst_char_in_region_unwind (arg
)
1746 return current_buffer
->undo_list
= arg
;
1750 subst_char_in_region_unwind_1 (arg
)
1753 return current_buffer
->filename
= arg
;
1756 DEFUN ("subst-char-in-region", Fsubst_char_in_region
,
1757 Ssubst_char_in_region
, 4, 5, 0,
1758 "From START to END, replace FROMCHAR with TOCHAR each time it occurs.\n\
1759 If optional arg NOUNDO is non-nil, don't record this change for undo\n\
1760 and don't mark the buffer as really changed.\n\
1761 Both characters must have the same length of multi-byte form.")
1762 (start
, end
, fromchar
, tochar
, noundo
)
1763 Lisp_Object start
, end
, fromchar
, tochar
, noundo
;
1765 register int pos
, pos_byte
, stop
, i
, len
, end_byte
;
1767 unsigned char fromwork
[4], *fromstr
, towork
[4], *tostr
, *p
;
1768 int count
= specpdl_ptr
- specpdl
;
1770 validate_region (&start
, &end
);
1771 CHECK_NUMBER (fromchar
, 2);
1772 CHECK_NUMBER (tochar
, 3);
1774 if (! NILP (current_buffer
->enable_multibyte_characters
))
1776 len
= CHAR_STRING (XFASTINT (fromchar
), fromwork
, fromstr
);
1777 if (CHAR_STRING (XFASTINT (tochar
), towork
, tostr
) != len
)
1778 error ("Characters in subst-char-in-region have different byte-lengths");
1783 fromwork
[0] = XFASTINT (fromchar
), fromstr
= fromwork
;
1784 towork
[0] = XFASTINT (tochar
), tostr
= towork
;
1788 pos_byte
= CHAR_TO_BYTE (pos
);
1789 stop
= CHAR_TO_BYTE (XINT (end
));
1792 /* If we don't want undo, turn off putting stuff on the list.
1793 That's faster than getting rid of things,
1794 and it prevents even the entry for a first change.
1795 Also inhibit locking the file. */
1798 record_unwind_protect (subst_char_in_region_unwind
,
1799 current_buffer
->undo_list
);
1800 current_buffer
->undo_list
= Qt
;
1801 /* Don't do file-locking. */
1802 record_unwind_protect (subst_char_in_region_unwind_1
,
1803 current_buffer
->filename
);
1804 current_buffer
->filename
= Qnil
;
1807 if (pos_byte
< GPT_BYTE
)
1808 stop
= min (stop
, GPT_BYTE
);
1811 if (pos_byte
>= stop
)
1813 if (pos_byte
>= end_byte
) break;
1816 p
= BYTE_POS_ADDR (pos_byte
);
1817 if (p
[0] == fromstr
[0]
1819 || (p
[1] == fromstr
[1]
1820 && (len
== 2 || (p
[2] == fromstr
[2]
1821 && (len
== 3 || p
[3] == fromstr
[3]))))))
1825 modify_region (current_buffer
, XINT (start
), XINT (end
));
1827 if (! NILP (noundo
))
1829 if (MODIFF
- 1 == SAVE_MODIFF
)
1831 if (MODIFF
- 1 == current_buffer
->auto_save_modified
)
1832 current_buffer
->auto_save_modified
++;
1839 record_change (pos
, 1);
1840 for (i
= 0; i
< len
; i
++) *p
++ = tostr
[i
];
1842 INC_BOTH (pos
, pos_byte
);
1846 signal_after_change (XINT (start
),
1847 XINT (end
) - XINT (start
), XINT (end
) - XINT (start
));
1849 unbind_to (count
, Qnil
);
1853 DEFUN ("translate-region", Ftranslate_region
, Stranslate_region
, 3, 3, 0,
1854 "From START to END, translate characters according to TABLE.\n\
1855 TABLE is a string; the Nth character in it is the mapping\n\
1856 for the character with code N.\n\
1857 This function does not alter multibyte characters.\n\
1858 It returns the number of characters changed.")
1862 register Lisp_Object table
;
1864 register int pos_byte
, stop
; /* Limits of the region. */
1865 register unsigned char *tt
; /* Trans table. */
1866 register int nc
; /* New character. */
1867 int cnt
; /* Number of changes made. */
1868 int size
; /* Size of translate table. */
1871 validate_region (&start
, &end
);
1872 CHECK_STRING (table
, 2);
1874 size
= XSTRING (table
)->size_byte
;
1875 tt
= XSTRING (table
)->data
;
1877 pos_byte
= CHAR_TO_BYTE (XINT (start
));
1878 stop
= CHAR_TO_BYTE (XINT (end
));
1879 modify_region (current_buffer
, XINT (start
), XINT (end
));
1883 for (; pos_byte
< stop
; )
1885 register unsigned char *p
= BYTE_POS_ADDR (pos_byte
);
1889 oc
= STRING_CHAR_AND_LENGTH (p
, stop
- pos_byte
, len
);
1890 if (oc
< size
&& len
== 1)
1895 record_change (pos
, 1);
1897 signal_after_change (pos
, 1, 1);
1905 return make_number (cnt
);
1908 DEFUN ("delete-region", Fdelete_region
, Sdelete_region
, 2, 2, "r",
1909 "Delete the text between point and mark.\n\
1910 When called from a program, expects two arguments,\n\
1911 positions (integers or markers) specifying the stretch to be deleted.")
1913 Lisp_Object start
, end
;
1915 validate_region (&start
, &end
);
1916 del_range (XINT (start
), XINT (end
));
1920 DEFUN ("widen", Fwiden
, Swiden
, 0, 0, "",
1921 "Remove restrictions (narrowing) from current buffer.\n\
1922 This allows the buffer's full text to be seen and edited.")
1925 if (BEG
!= BEGV
|| Z
!= ZV
)
1926 current_buffer
->clip_changed
= 1;
1928 BEGV_BYTE
= BEG_BYTE
;
1929 SET_BUF_ZV_BOTH (current_buffer
, Z
, Z_BYTE
);
1930 /* Changing the buffer bounds invalidates any recorded current column. */
1931 invalidate_current_column ();
1935 DEFUN ("narrow-to-region", Fnarrow_to_region
, Snarrow_to_region
, 2, 2, "r",
1936 "Restrict editing in this buffer to the current region.\n\
1937 The rest of the text becomes temporarily invisible and untouchable\n\
1938 but is not deleted; if you save the buffer in a file, the invisible\n\
1939 text is included in the file. \\[widen] makes all visible again.\n\
1940 See also `save-restriction'.\n\
1942 When calling from a program, pass two arguments; positions (integers\n\
1943 or markers) bounding the text that should remain visible.")
1945 register Lisp_Object start
, end
;
1947 CHECK_NUMBER_COERCE_MARKER (start
, 0);
1948 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1950 if (XINT (start
) > XINT (end
))
1953 tem
= start
; start
= end
; end
= tem
;
1956 if (!(BEG
<= XINT (start
) && XINT (start
) <= XINT (end
) && XINT (end
) <= Z
))
1957 args_out_of_range (start
, end
);
1959 if (BEGV
!= XFASTINT (start
) || ZV
!= XFASTINT (end
))
1960 current_buffer
->clip_changed
= 1;
1962 SET_BUF_BEGV (current_buffer
, XFASTINT (start
));
1963 SET_BUF_ZV (current_buffer
, XFASTINT (end
));
1964 if (PT
< XFASTINT (start
))
1965 SET_PT (XFASTINT (start
));
1966 if (PT
> XFASTINT (end
))
1967 SET_PT (XFASTINT (end
));
1968 /* Changing the buffer bounds invalidates any recorded current column. */
1969 invalidate_current_column ();
1974 save_restriction_save ()
1976 register Lisp_Object bottom
, top
;
1977 /* Note: I tried using markers here, but it does not win
1978 because insertion at the end of the saved region
1979 does not advance mh and is considered "outside" the saved region. */
1980 XSETFASTINT (bottom
, BEGV
- BEG
);
1981 XSETFASTINT (top
, Z
- ZV
);
1983 return Fcons (Fcurrent_buffer (), Fcons (bottom
, top
));
1987 save_restriction_restore (data
)
1990 register struct buffer
*buf
;
1991 register int newhead
, newtail
;
1992 register Lisp_Object tem
;
1995 buf
= XBUFFER (XCONS (data
)->car
);
1997 data
= XCONS (data
)->cdr
;
1999 tem
= XCONS (data
)->car
;
2000 newhead
= XINT (tem
);
2001 tem
= XCONS (data
)->cdr
;
2002 newtail
= XINT (tem
);
2003 if (newhead
+ newtail
> BUF_Z (buf
) - BUF_BEG (buf
))
2009 obegv
= BUF_BEGV (buf
);
2012 SET_BUF_BEGV (buf
, BUF_BEG (buf
) + newhead
);
2013 SET_BUF_ZV (buf
, BUF_Z (buf
) - newtail
);
2015 if (obegv
!= BUF_BEGV (buf
) || ozv
!= BUF_ZV (buf
))
2016 current_buffer
->clip_changed
= 1;
2018 /* If point is outside the new visible range, move it inside. */
2019 SET_BUF_PT_BOTH (buf
,
2020 clip_to_bounds (BUF_BEGV (buf
), BUF_PT (buf
), BUF_ZV (buf
)),
2021 clip_to_bounds (BUF_BEGV_BYTE (buf
), BUF_PT_BYTE (buf
),
2022 BUF_ZV_BYTE (buf
)));
2027 DEFUN ("save-restriction", Fsave_restriction
, Ssave_restriction
, 0, UNEVALLED
, 0,
2028 "Execute BODY, saving and restoring current buffer's restrictions.\n\
2029 The buffer's restrictions make parts of the beginning and end invisible.\n\
2030 \(They are set up with `narrow-to-region' and eliminated with `widen'.)\n\
2031 This special form, `save-restriction', saves the current buffer's restrictions\n\
2032 when it is entered, and restores them when it is exited.\n\
2033 So any `narrow-to-region' within BODY lasts only until the end of the form.\n\
2034 The old restrictions settings are restored\n\
2035 even in case of abnormal exit (throw or error).\n\
2037 The value returned is the value of the last form in BODY.\n\
2039 `save-restriction' can get confused if, within the BODY, you widen\n\
2040 and then make changes outside the area within the saved restrictions.\n\
2042 Note: if you are using both `save-excursion' and `save-restriction',\n\
2043 use `save-excursion' outermost:\n\
2044 (save-excursion (save-restriction ...))")
2048 register Lisp_Object val
;
2049 int count
= specpdl_ptr
- specpdl
;
2051 record_unwind_protect (save_restriction_restore
, save_restriction_save ());
2052 val
= Fprogn (body
);
2053 return unbind_to (count
, val
);
2056 /* Buffer for the most recent text displayed by Fmessage. */
2057 static char *message_text
;
2059 /* Allocated length of that buffer. */
2060 static int message_length
;
2062 DEFUN ("message", Fmessage
, Smessage
, 1, MANY
, 0,
2063 "Print a one-line message at the bottom of the screen.\n\
2064 The first argument is a format control string, and the rest are data\n\
2065 to be formatted under control of the string. See `format' for details.\n\
2067 If the first argument is nil, clear any existing message; let the\n\
2068 minibuffer contents show.")
2080 register Lisp_Object val
;
2081 val
= Fformat (nargs
, args
);
2082 /* Copy the data so that it won't move when we GC. */
2085 message_text
= (char *)xmalloc (80);
2086 message_length
= 80;
2088 if (XSTRING (val
)->size_byte
> message_length
)
2090 message_length
= XSTRING (val
)->size_byte
;
2091 message_text
= (char *)xrealloc (message_text
, message_length
);
2093 bcopy (XSTRING (val
)->data
, message_text
, XSTRING (val
)->size_byte
);
2094 message2 (message_text
, XSTRING (val
)->size_byte
,
2095 STRING_MULTIBYTE (val
));
2100 DEFUN ("message-box", Fmessage_box
, Smessage_box
, 1, MANY
, 0,
2101 "Display a message, in a dialog box if possible.\n\
2102 If a dialog box is not available, use the echo area.\n\
2103 The first argument is a format control string, and the rest are data\n\
2104 to be formatted under control of the string. See `format' for details.\n\
2106 If the first argument is nil, clear any existing message; let the\n\
2107 minibuffer contents show.")
2119 register Lisp_Object val
;
2120 val
= Fformat (nargs
, args
);
2123 Lisp_Object pane
, menu
, obj
;
2124 struct gcpro gcpro1
;
2125 pane
= Fcons (Fcons (build_string ("OK"), Qt
), Qnil
);
2127 menu
= Fcons (val
, pane
);
2128 obj
= Fx_popup_dialog (Qt
, menu
);
2132 #else /* not HAVE_MENUS */
2133 /* Copy the data so that it won't move when we GC. */
2136 message_text
= (char *)xmalloc (80);
2137 message_length
= 80;
2139 if (XSTRING (val
)->size_byte
> message_length
)
2141 message_length
= XSTRING (val
)->size_byte
;
2142 message_text
= (char *)xrealloc (message_text
, message_length
);
2144 bcopy (XSTRING (val
)->data
, message_text
, XSTRING (val
)->size_byte
);
2145 message2 (message_text
, XSTRING (val
)->size_byte
);
2147 #endif /* not HAVE_MENUS */
2151 extern Lisp_Object last_nonmenu_event
;
2154 DEFUN ("message-or-box", Fmessage_or_box
, Smessage_or_box
, 1, MANY
, 0,
2155 "Display a message in a dialog box or in the echo area.\n\
2156 If this command was invoked with the mouse, use a dialog box.\n\
2157 Otherwise, use the echo area.\n\
2158 The first argument is a format control string, and the rest are data\n\
2159 to be formatted under control of the string. See `format' for details.\n\
2161 If the first argument is nil, clear any existing message; let the\n\
2162 minibuffer contents show.")
2168 if (NILP (last_nonmenu_event
) || CONSP (last_nonmenu_event
))
2169 return Fmessage_box (nargs
, args
);
2171 return Fmessage (nargs
, args
);
2174 DEFUN ("current-message", Fcurrent_message
, Scurrent_message
, 0, 0, 0,
2175 "Return the string currently displayed in the echo area, or nil if none.")
2178 return (echo_area_glyphs
2179 ? make_string (echo_area_glyphs
, echo_area_glyphs_length
)
2183 /* Number of bytes that STRING will occupy when put into the result.
2184 MULTIBYTE is nonzero if the result should be multibyte. */
2186 #define CONVERTED_BYTE_SIZE(MULTIBYTE, STRING) \
2187 (((MULTIBYTE) && ! STRING_MULTIBYTE (STRING)) \
2188 ? count_size_as_multibyte (XSTRING (STRING)->data, \
2189 XSTRING (STRING)->size_byte) \
2190 : XSTRING (STRING)->size_byte)
2192 DEFUN ("format", Fformat
, Sformat
, 1, MANY
, 0,
2193 "Format a string out of a control-string and arguments.\n\
2194 The first argument is a control string.\n\
2195 The other arguments are substituted into it to make the result, a string.\n\
2196 It may contain %-sequences meaning to substitute the next argument.\n\
2197 %s means print a string argument. Actually, prints any object, with `princ'.\n\
2198 %d means print as number in decimal (%o octal, %x hex).\n\
2199 %e means print a number in exponential notation.\n\
2200 %f means print a number in decimal-point notation.\n\
2201 %g means print a number in exponential notation\n\
2202 or decimal-point notation, whichever uses fewer characters.\n\
2203 %c means print a number as a single character.\n\
2204 %S means print any object as an s-expression (using prin1).\n\
2205 The argument used for %d, %o, %x, %e, %f, %g or %c must be a number.\n\
2206 Use %% to put a single % into the output.")
2209 register Lisp_Object
*args
;
2211 register int n
; /* The number of the next arg to substitute */
2212 register int total
; /* An estimate of the final length */
2214 register unsigned char *format
, *end
;
2216 /* Nonzero if the output should be a multibyte string,
2217 which is true if any of the inputs is one. */
2219 unsigned char *this_format
;
2223 extern char *index ();
2225 /* It should not be necessary to GCPRO ARGS, because
2226 the caller in the interpreter should take care of that. */
2228 /* Try to determine whether the result should be multibyte.
2229 This is not always right; sometimes the result needs to be multibyte
2230 because of an object that we will pass through prin1,
2231 and in that case, we won't know it here. */
2232 for (n
= 0; n
< nargs
; n
++)
2233 if (STRINGP (args
[n
]) && STRING_MULTIBYTE (args
[n
]))
2236 CHECK_STRING (args
[0], 0);
2238 /* If we start out planning a unibyte result,
2239 and later find it has to be multibyte, we jump back to retry. */
2242 format
= XSTRING (args
[0])->data
;
2243 end
= format
+ XSTRING (args
[0])->size_byte
;
2246 /* Make room in result for all the non-%-codes in the control string. */
2247 total
= 5 + CONVERTED_BYTE_SIZE (multibyte
, args
[0]);
2249 /* Add to TOTAL enough space to hold the converted arguments. */
2252 while (format
!= end
)
2253 if (*format
++ == '%')
2255 int minlen
, thissize
= 0;
2256 unsigned char *this_format_start
= format
- 1;
2258 /* Process a numeric arg and skip it. */
2259 minlen
= atoi (format
);
2263 while ((*format
>= '0' && *format
<= '9')
2264 || *format
== '-' || *format
== ' ' || *format
== '.')
2267 if (format
- this_format_start
+ 1 > longest_format
)
2268 longest_format
= format
- this_format_start
+ 1;
2272 else if (++n
>= nargs
)
2273 error ("Not enough arguments for format string");
2274 else if (*format
== 'S')
2276 /* For `S', prin1 the argument and then treat like a string. */
2277 register Lisp_Object tem
;
2278 tem
= Fprin1_to_string (args
[n
], Qnil
);
2279 if (STRING_MULTIBYTE (tem
) && ! multibyte
)
2287 else if (SYMBOLP (args
[n
]))
2289 XSETSTRING (args
[n
], XSYMBOL (args
[n
])->name
);
2290 if (STRING_MULTIBYTE (args
[n
]) && ! multibyte
)
2297 else if (STRINGP (args
[n
]))
2300 if (*format
!= 's' && *format
!= 'S')
2301 error ("format specifier doesn't match argument type");
2302 thissize
= CONVERTED_BYTE_SIZE (multibyte
, args
[n
]);
2304 /* Would get MPV otherwise, since Lisp_Int's `point' to low memory. */
2305 else if (INTEGERP (args
[n
]) && *format
!= 's')
2307 #ifdef LISP_FLOAT_TYPE
2308 /* The following loop assumes the Lisp type indicates
2309 the proper way to pass the argument.
2310 So make sure we have a flonum if the argument should
2312 if (*format
== 'e' || *format
== 'f' || *format
== 'g')
2313 args
[n
] = Ffloat (args
[n
]);
2317 && (! SINGLE_BYTE_CHAR_P (XINT (args
[n
]))
2318 || XINT (args
[n
]) == 0))
2325 args
[n
] = Fchar_to_string (args
[n
]);
2326 thissize
= XSTRING (args
[n
])->size_byte
;
2329 #ifdef LISP_FLOAT_TYPE
2330 else if (FLOATP (args
[n
]) && *format
!= 's')
2332 if (! (*format
== 'e' || *format
== 'f' || *format
== 'g'))
2333 args
[n
] = Ftruncate (args
[n
], Qnil
);
2339 /* Anything but a string, convert to a string using princ. */
2340 register Lisp_Object tem
;
2341 tem
= Fprin1_to_string (args
[n
], Qt
);
2342 if (STRING_MULTIBYTE (tem
) & ! multibyte
)
2351 if (thissize
< minlen
)
2354 total
+= thissize
+ 4;
2357 /* Now we can no longer jump to retry.
2358 TOTAL and LONGEST_FORMAT are known for certain. */
2360 this_format
= (unsigned char *) alloca (longest_format
+ 1);
2362 /* Allocate the space for the result.
2363 Note that TOTAL is an overestimate. */
2365 buf
= (unsigned char *) alloca (total
+ 1);
2367 buf
= (unsigned char *) xmalloc (total
+ 1);
2373 /* Scan the format and store result in BUF. */
2374 format
= XSTRING (args
[0])->data
;
2375 while (format
!= end
)
2381 unsigned char *this_format_start
= format
;
2385 /* Process a numeric arg and skip it. */
2386 minlen
= atoi (format
);
2388 minlen
= - minlen
, negative
= 1;
2390 while ((*format
>= '0' && *format
<= '9')
2391 || *format
== '-' || *format
== ' ' || *format
== '.')
2394 if (*format
++ == '%')
2403 if (STRINGP (args
[n
]))
2405 int padding
, nbytes
;
2406 int width
= strwidth (XSTRING (args
[n
])->data
,
2407 XSTRING (args
[n
])->size_byte
);
2409 /* If spec requires it, pad on right with spaces. */
2410 padding
= minlen
- width
;
2412 while (padding
-- > 0)
2418 nbytes
= copy_text (XSTRING (args
[n
])->data
, p
,
2419 XSTRING (args
[n
])->size_byte
,
2420 STRING_MULTIBYTE (args
[n
]), multibyte
);
2422 nchars
+= XSTRING (args
[n
])->size
;
2425 while (padding
-- > 0)
2431 else if (INTEGERP (args
[n
]) || FLOATP (args
[n
]))
2435 bcopy (this_format_start
, this_format
,
2436 format
- this_format_start
);
2437 this_format
[format
- this_format_start
] = 0;
2439 if (INTEGERP (args
[n
]))
2440 sprintf (p
, this_format
, XINT (args
[n
]));
2442 sprintf (p
, this_format
, XFLOAT (args
[n
])->data
);
2444 this_nchars
= strlen (p
);
2446 nchars
+= this_nchars
;
2449 else if (STRING_MULTIBYTE (args
[0]))
2451 /* Copy a whole multibyte character. */
2453 while (! CHAR_HEAD_P (*format
)) *p
++ = *format
++;
2458 /* Convert a single-byte character to multibyte. */
2459 int len
= copy_text (format
, p
, 1, 0, 1);
2466 *p
++ = *format
++, nchars
++;
2469 val
= make_multibyte_string (buf
, nchars
, p
- buf
);
2471 /* If we allocated BUF with malloc, free it too. */
2481 format1 (string1
, arg0
, arg1
, arg2
, arg3
, arg4
)
2482 EMACS_INT arg0
, arg1
, arg2
, arg3
, arg4
;
2496 doprnt (buf
, sizeof buf
, string1
, (char *)0, 5, (char **) args
);
2498 doprnt (buf
, sizeof buf
, string1
, (char *)0, 5, &string1
+ 1);
2500 return build_string (buf
);
2503 DEFUN ("char-equal", Fchar_equal
, Schar_equal
, 2, 2, 0,
2504 "Return t if two characters match, optionally ignoring case.\n\
2505 Both arguments must be characters (i.e. integers).\n\
2506 Case is ignored if `case-fold-search' is non-nil in the current buffer.")
2508 register Lisp_Object c1
, c2
;
2511 CHECK_NUMBER (c1
, 0);
2512 CHECK_NUMBER (c2
, 1);
2514 if (XINT (c1
) == XINT (c2
))
2516 if (NILP (current_buffer
->case_fold_search
))
2519 /* Do these in separate statements,
2520 then compare the variables.
2521 because of the way DOWNCASE uses temp variables. */
2522 i1
= DOWNCASE (XFASTINT (c1
));
2523 i2
= DOWNCASE (XFASTINT (c2
));
2524 return (i1
== i2
? Qt
: Qnil
);
2527 /* Transpose the markers in two regions of the current buffer, and
2528 adjust the ones between them if necessary (i.e.: if the regions
2531 START1, END1 are the character positions of the first region.
2532 START1_BYTE, END1_BYTE are the byte positions.
2533 START2, END2 are the character positions of the second region.
2534 START2_BYTE, END2_BYTE are the byte positions.
2536 Traverses the entire marker list of the buffer to do so, adding an
2537 appropriate amount to some, subtracting from some, and leaving the
2538 rest untouched. Most of this is copied from adjust_markers in insdel.c.
2540 It's the caller's job to ensure that START1 <= END1 <= START2 <= END2. */
2543 transpose_markers (start1
, end1
, start2
, end2
,
2544 start1_byte
, end1_byte
, start2_byte
, end2_byte
)
2545 register int start1
, end1
, start2
, end2
;
2546 register int start1_byte
, end1_byte
, start2_byte
, end2_byte
;
2548 register int amt1
, amt1_byte
, amt2
, amt2_byte
, diff
, diff_byte
, mpos
;
2549 register Lisp_Object marker
;
2551 /* Update point as if it were a marker. */
2555 TEMP_SET_PT_BOTH (PT
+ (end2
- end1
),
2556 PT_BYTE
+ (end2_byte
- end1_byte
));
2557 else if (PT
< start2
)
2558 TEMP_SET_PT_BOTH (PT
+ (end2
- start2
) - (end1
- start1
),
2559 (PT_BYTE
+ (end2_byte
- start2_byte
)
2560 - (end1_byte
- start1_byte
)));
2562 TEMP_SET_PT_BOTH (PT
- (start2
- start1
),
2563 PT_BYTE
- (start2_byte
- start1_byte
));
2565 /* We used to adjust the endpoints here to account for the gap, but that
2566 isn't good enough. Even if we assume the caller has tried to move the
2567 gap out of our way, it might still be at start1 exactly, for example;
2568 and that places it `inside' the interval, for our purposes. The amount
2569 of adjustment is nontrivial if there's a `denormalized' marker whose
2570 position is between GPT and GPT + GAP_SIZE, so it's simpler to leave
2571 the dirty work to Fmarker_position, below. */
2573 /* The difference between the region's lengths */
2574 diff
= (end2
- start2
) - (end1
- start1
);
2575 diff_byte
= (end2_byte
- start2_byte
) - (end1_byte
- start1_byte
);
2577 /* For shifting each marker in a region by the length of the other
2578 region plus the distance between the regions. */
2579 amt1
= (end2
- start2
) + (start2
- end1
);
2580 amt2
= (end1
- start1
) + (start2
- end1
);
2581 amt1_byte
= (end2_byte
- start2_byte
) + (start2_byte
- end1_byte
);
2582 amt2_byte
= (end1_byte
- start1_byte
) + (start2_byte
- end1_byte
);
2584 for (marker
= BUF_MARKERS (current_buffer
); !NILP (marker
);
2585 marker
= XMARKER (marker
)->chain
)
2587 mpos
= marker_byte_position (marker
);
2588 if (mpos
>= start1_byte
&& mpos
< end2_byte
)
2590 if (mpos
< end1_byte
)
2592 else if (mpos
< start2_byte
)
2596 XMARKER (marker
)->bytepos
= mpos
;
2598 mpos
= XMARKER (marker
)->charpos
;
2599 if (mpos
>= start1
&& mpos
< end2
)
2603 else if (mpos
< start2
)
2608 XMARKER (marker
)->charpos
= mpos
;
2612 DEFUN ("transpose-regions", Ftranspose_regions
, Stranspose_regions
, 4, 5, 0,
2613 "Transpose region START1 to END1 with START2 to END2.\n\
2614 The regions may not be overlapping, because the size of the buffer is\n\
2615 never changed in a transposition.\n\
2617 Optional fifth arg LEAVE_MARKERS, if non-nil, means don't update\n\
2618 any markers that happen to be located in the regions.\n\
2620 Transposing beyond buffer boundaries is an error.")
2621 (startr1
, endr1
, startr2
, endr2
, leave_markers
)
2622 Lisp_Object startr1
, endr1
, startr2
, endr2
, leave_markers
;
2624 register int start1
, end1
, start2
, end2
;
2625 int start1_byte
, start2_byte
, len1_byte
, len2_byte
;
2626 int gap
, len1
, len_mid
, len2
;
2627 unsigned char *start1_addr
, *start2_addr
, *temp
;
2629 #ifdef USE_TEXT_PROPERTIES
2630 INTERVAL cur_intv
, tmp_interval1
, tmp_interval_mid
, tmp_interval2
;
2631 cur_intv
= BUF_INTERVALS (current_buffer
);
2632 #endif /* USE_TEXT_PROPERTIES */
2634 validate_region (&startr1
, &endr1
);
2635 validate_region (&startr2
, &endr2
);
2637 start1
= XFASTINT (startr1
);
2638 end1
= XFASTINT (endr1
);
2639 start2
= XFASTINT (startr2
);
2640 end2
= XFASTINT (endr2
);
2643 /* Swap the regions if they're reversed. */
2646 register int glumph
= start1
;
2654 len1
= end1
- start1
;
2655 len2
= end2
- start2
;
2658 error ("Transposed regions not properly ordered");
2659 else if (start1
== end1
|| start2
== end2
)
2660 error ("Transposed region may not be of length 0");
2662 /* The possibilities are:
2663 1. Adjacent (contiguous) regions, or separate but equal regions
2664 (no, really equal, in this case!), or
2665 2. Separate regions of unequal size.
2667 The worst case is usually No. 2. It means that (aside from
2668 potential need for getting the gap out of the way), there also
2669 needs to be a shifting of the text between the two regions. So
2670 if they are spread far apart, we are that much slower... sigh. */
2672 /* It must be pointed out that the really studly thing to do would
2673 be not to move the gap at all, but to leave it in place and work
2674 around it if necessary. This would be extremely efficient,
2675 especially considering that people are likely to do
2676 transpositions near where they are working interactively, which
2677 is exactly where the gap would be found. However, such code
2678 would be much harder to write and to read. So, if you are
2679 reading this comment and are feeling squirrely, by all means have
2680 a go! I just didn't feel like doing it, so I will simply move
2681 the gap the minimum distance to get it out of the way, and then
2682 deal with an unbroken array. */
2684 /* Make sure the gap won't interfere, by moving it out of the text
2685 we will operate on. */
2686 if (start1
< gap
&& gap
< end2
)
2688 if (gap
- start1
< end2
- gap
)
2694 start1_byte
= CHAR_TO_BYTE (start1
);
2695 start2_byte
= CHAR_TO_BYTE (start2
);
2696 len1_byte
= CHAR_TO_BYTE (end1
) - start1_byte
;
2697 len2_byte
= CHAR_TO_BYTE (end2
) - start2_byte
;
2699 /* Hmmm... how about checking to see if the gap is large
2700 enough to use as the temporary storage? That would avoid an
2701 allocation... interesting. Later, don't fool with it now. */
2703 /* Working without memmove, for portability (sigh), so must be
2704 careful of overlapping subsections of the array... */
2706 if (end1
== start2
) /* adjacent regions */
2708 modify_region (current_buffer
, start1
, end2
);
2709 record_change (start1
, len1
+ len2
);
2711 #ifdef USE_TEXT_PROPERTIES
2712 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2713 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2714 Fset_text_properties (make_number (start1
), make_number (end2
),
2716 #endif /* USE_TEXT_PROPERTIES */
2718 /* First region smaller than second. */
2719 if (len1_byte
< len2_byte
)
2721 /* We use alloca only if it is small,
2722 because we want to avoid stack overflow. */
2723 if (len2_byte
> 20000)
2724 temp
= (unsigned char *) xmalloc (len2_byte
);
2726 temp
= (unsigned char *) alloca (len2_byte
);
2728 /* Don't precompute these addresses. We have to compute them
2729 at the last minute, because the relocating allocator might
2730 have moved the buffer around during the xmalloc. */
2731 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1_byte
);
2732 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2_byte
);
2734 bcopy (start2_addr
, temp
, len2_byte
);
2735 bcopy (start1_addr
, start1_addr
+ len2_byte
, len1_byte
);
2736 bcopy (temp
, start1_addr
, len2_byte
);
2737 if (len2_byte
> 20000)
2741 /* First region not smaller than second. */
2743 if (len1_byte
> 20000)
2744 temp
= (unsigned char *) xmalloc (len1_byte
);
2746 temp
= (unsigned char *) alloca (len1_byte
);
2747 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1_byte
);
2748 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2_byte
);
2749 bcopy (start1_addr
, temp
, len1_byte
);
2750 bcopy (start2_addr
, start1_addr
, len2_byte
);
2751 bcopy (temp
, start1_addr
+ len2_byte
, len1_byte
);
2752 if (len1_byte
> 20000)
2755 #ifdef USE_TEXT_PROPERTIES
2756 graft_intervals_into_buffer (tmp_interval1
, start1
+ len2
,
2757 len1
, current_buffer
, 0);
2758 graft_intervals_into_buffer (tmp_interval2
, start1
,
2759 len2
, current_buffer
, 0);
2760 #endif /* USE_TEXT_PROPERTIES */
2762 /* Non-adjacent regions, because end1 != start2, bleagh... */
2765 len_mid
= start2_byte
- (start1_byte
+ len1_byte
);
2767 if (len1_byte
== len2_byte
)
2768 /* Regions are same size, though, how nice. */
2770 modify_region (current_buffer
, start1
, end1
);
2771 modify_region (current_buffer
, start2
, end2
);
2772 record_change (start1
, len1
);
2773 record_change (start2
, len2
);
2774 #ifdef USE_TEXT_PROPERTIES
2775 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2776 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2777 Fset_text_properties (make_number (start1
), make_number (end1
),
2779 Fset_text_properties (make_number (start2
), make_number (end2
),
2781 #endif /* USE_TEXT_PROPERTIES */
2783 if (len1_byte
> 20000)
2784 temp
= (unsigned char *) xmalloc (len1_byte
);
2786 temp
= (unsigned char *) alloca (len1_byte
);
2787 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1_byte
);
2788 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2_byte
);
2789 bcopy (start1_addr
, temp
, len1_byte
);
2790 bcopy (start2_addr
, start1_addr
, len2_byte
);
2791 bcopy (temp
, start2_addr
, len1_byte
);
2792 if (len1_byte
> 20000)
2794 #ifdef USE_TEXT_PROPERTIES
2795 graft_intervals_into_buffer (tmp_interval1
, start2
,
2796 len1
, current_buffer
, 0);
2797 graft_intervals_into_buffer (tmp_interval2
, start1
,
2798 len2
, current_buffer
, 0);
2799 #endif /* USE_TEXT_PROPERTIES */
2802 else if (len1_byte
< len2_byte
) /* Second region larger than first */
2803 /* Non-adjacent & unequal size, area between must also be shifted. */
2805 modify_region (current_buffer
, start1
, end2
);
2806 record_change (start1
, (end2
- start1
));
2807 #ifdef USE_TEXT_PROPERTIES
2808 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2809 tmp_interval_mid
= copy_intervals (cur_intv
, end1
, len_mid
);
2810 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2811 Fset_text_properties (make_number (start1
), make_number (end2
),
2813 #endif /* USE_TEXT_PROPERTIES */
2815 /* holds region 2 */
2816 if (len2_byte
> 20000)
2817 temp
= (unsigned char *) xmalloc (len2_byte
);
2819 temp
= (unsigned char *) alloca (len2_byte
);
2820 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1_byte
);
2821 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2_byte
);
2822 bcopy (start2_addr
, temp
, len2_byte
);
2823 bcopy (start1_addr
, start1_addr
+ len_mid
+ len2_byte
, len1_byte
);
2824 safe_bcopy (start1_addr
+ len1_byte
, start1_addr
+ len2_byte
, len_mid
);
2825 bcopy (temp
, start1_addr
, len2_byte
);
2826 if (len2_byte
> 20000)
2828 #ifdef USE_TEXT_PROPERTIES
2829 graft_intervals_into_buffer (tmp_interval1
, end2
- len1
,
2830 len1
, current_buffer
, 0);
2831 graft_intervals_into_buffer (tmp_interval_mid
, start1
+ len2
,
2832 len_mid
, current_buffer
, 0);
2833 graft_intervals_into_buffer (tmp_interval2
, start1
,
2834 len2
, current_buffer
, 0);
2835 #endif /* USE_TEXT_PROPERTIES */
2838 /* Second region smaller than first. */
2840 record_change (start1
, (end2
- start1
));
2841 modify_region (current_buffer
, start1
, end2
);
2843 #ifdef USE_TEXT_PROPERTIES
2844 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2845 tmp_interval_mid
= copy_intervals (cur_intv
, end1
, len_mid
);
2846 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2847 Fset_text_properties (make_number (start1
), make_number (end2
),
2849 #endif /* USE_TEXT_PROPERTIES */
2851 /* holds region 1 */
2852 if (len1_byte
> 20000)
2853 temp
= (unsigned char *) xmalloc (len1_byte
);
2855 temp
= (unsigned char *) alloca (len1_byte
);
2856 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1_byte
);
2857 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2_byte
);
2858 bcopy (start1_addr
, temp
, len1_byte
);
2859 bcopy (start2_addr
, start1_addr
, len2_byte
);
2860 bcopy (start1_addr
+ len1_byte
, start1_addr
+ len2_byte
, len_mid
);
2861 bcopy (temp
, start1_addr
+ len2_byte
+ len_mid
, len1_byte
);
2862 if (len1_byte
> 20000)
2864 #ifdef USE_TEXT_PROPERTIES
2865 graft_intervals_into_buffer (tmp_interval1
, end2
- len1
,
2866 len1
, current_buffer
, 0);
2867 graft_intervals_into_buffer (tmp_interval_mid
, start1
+ len2
,
2868 len_mid
, current_buffer
, 0);
2869 graft_intervals_into_buffer (tmp_interval2
, start1
,
2870 len2
, current_buffer
, 0);
2871 #endif /* USE_TEXT_PROPERTIES */
2875 /* When doing multiple transpositions, it might be nice
2876 to optimize this. Perhaps the markers in any one buffer
2877 should be organized in some sorted data tree. */
2878 if (NILP (leave_markers
))
2880 transpose_markers (start1
, end1
, start2
, end2
,
2881 start1_byte
, start1_byte
+ len1_byte
,
2882 start2_byte
, start2_byte
+ len2_byte
);
2883 fix_overlays_in_range (start1
, end2
);
2895 Qbuffer_access_fontify_functions
2896 = intern ("buffer-access-fontify-functions");
2897 staticpro (&Qbuffer_access_fontify_functions
);
2899 DEFVAR_LISP ("buffer-access-fontify-functions",
2900 &Vbuffer_access_fontify_functions
,
2901 "List of functions called by `buffer-substring' to fontify if necessary.\n\
2902 Each function is called with two arguments which specify the range\n\
2903 of the buffer being accessed.");
2904 Vbuffer_access_fontify_functions
= Qnil
;
2908 extern Lisp_Object Vprin1_to_string_buffer
;
2909 obuf
= Fcurrent_buffer ();
2910 /* Do this here, because init_buffer_once is too early--it won't work. */
2911 Fset_buffer (Vprin1_to_string_buffer
);
2912 /* Make sure buffer-access-fontify-functions is nil in this buffer. */
2913 Fset (Fmake_local_variable (intern ("buffer-access-fontify-functions")),
2918 DEFVAR_LISP ("buffer-access-fontified-property",
2919 &Vbuffer_access_fontified_property
,
2920 "Property which (if non-nil) indicates text has been fontified.\n\
2921 `buffer-substring' need not call the `buffer-access-fontify-functions'\n\
2922 functions if all the text being accessed has this property.");
2923 Vbuffer_access_fontified_property
= Qnil
;
2925 DEFVAR_LISP ("system-name", &Vsystem_name
,
2926 "The name of the machine Emacs is running on.");
2928 DEFVAR_LISP ("user-full-name", &Vuser_full_name
,
2929 "The full name of the user logged in.");
2931 DEFVAR_LISP ("user-login-name", &Vuser_login_name
,
2932 "The user's name, taken from environment variables if possible.");
2934 DEFVAR_LISP ("user-real-login-name", &Vuser_real_login_name
,
2935 "The user's name, based upon the real uid only.");
2937 defsubr (&Schar_equal
);
2938 defsubr (&Sgoto_char
);
2939 defsubr (&Sstring_to_char
);
2940 defsubr (&Schar_to_string
);
2941 defsubr (&Sbuffer_substring
);
2942 defsubr (&Sbuffer_substring_no_properties
);
2943 defsubr (&Sbuffer_string
);
2945 defsubr (&Spoint_marker
);
2946 defsubr (&Smark_marker
);
2948 defsubr (&Sregion_beginning
);
2949 defsubr (&Sregion_end
);
2951 defsubr (&Sline_beginning_position
);
2952 defsubr (&Sline_end_position
);
2954 /* defsubr (&Smark); */
2955 /* defsubr (&Sset_mark); */
2956 defsubr (&Ssave_excursion
);
2957 defsubr (&Ssave_current_buffer
);
2959 defsubr (&Sbufsize
);
2960 defsubr (&Spoint_max
);
2961 defsubr (&Spoint_min
);
2962 defsubr (&Spoint_min_marker
);
2963 defsubr (&Spoint_max_marker
);
2964 defsubr (&Sposition_bytes
);
2970 defsubr (&Sfollowing_char
);
2971 defsubr (&Sprevious_char
);
2972 defsubr (&Schar_after
);
2973 defsubr (&Schar_before
);
2975 defsubr (&Sinsert_before_markers
);
2976 defsubr (&Sinsert_and_inherit
);
2977 defsubr (&Sinsert_and_inherit_before_markers
);
2978 defsubr (&Sinsert_char
);
2980 defsubr (&Suser_login_name
);
2981 defsubr (&Suser_real_login_name
);
2982 defsubr (&Suser_uid
);
2983 defsubr (&Suser_real_uid
);
2984 defsubr (&Suser_full_name
);
2985 defsubr (&Semacs_pid
);
2986 defsubr (&Scurrent_time
);
2987 defsubr (&Sformat_time_string
);
2988 defsubr (&Sdecode_time
);
2989 defsubr (&Sencode_time
);
2990 defsubr (&Scurrent_time_string
);
2991 defsubr (&Scurrent_time_zone
);
2992 defsubr (&Sset_time_zone_rule
);
2993 defsubr (&Ssystem_name
);
2994 defsubr (&Smessage
);
2995 defsubr (&Smessage_box
);
2996 defsubr (&Smessage_or_box
);
2997 defsubr (&Scurrent_message
);
3000 defsubr (&Sinsert_buffer_substring
);
3001 defsubr (&Scompare_buffer_substrings
);
3002 defsubr (&Ssubst_char_in_region
);
3003 defsubr (&Stranslate_region
);
3004 defsubr (&Sdelete_region
);
3006 defsubr (&Snarrow_to_region
);
3007 defsubr (&Ssave_restriction
);
3008 defsubr (&Stranspose_regions
);