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>
41 #include "intervals.h"
48 #define min(a, b) ((a) < (b) ? (a) : (b))
49 #define max(a, b) ((a) > (b) ? (a) : (b))
55 extern char **environ
;
56 extern Lisp_Object
make_time ();
57 extern void insert_from_buffer ();
58 static int tm_diff ();
59 static void update_buffer_properties ();
60 size_t emacs_strftime ();
61 void set_time_zone_rule ();
63 Lisp_Object Vbuffer_access_fontify_functions
;
64 Lisp_Object Qbuffer_access_fontify_functions
;
65 Lisp_Object Vbuffer_access_fontified_property
;
67 Lisp_Object
Fuser_full_name ();
69 /* Some static data, and a function to initialize it for each run */
71 Lisp_Object Vsystem_name
;
72 Lisp_Object Vuser_real_login_name
; /* login name of current user ID */
73 Lisp_Object Vuser_full_name
; /* full name of current user */
74 Lisp_Object Vuser_login_name
; /* user name from LOGNAME or USER */
80 register unsigned char *p
, *q
, *r
;
81 struct passwd
*pw
; /* password entry for the current user */
84 /* Set up system_name even when dumping. */
88 /* Don't bother with this on initial start when just dumping out */
91 #endif /* not CANNOT_DUMP */
93 pw
= (struct passwd
*) getpwuid (getuid ());
95 /* We let the real user name default to "root" because that's quite
96 accurate on MSDOG and because it lets Emacs find the init file.
97 (The DVX libraries override the Djgpp libraries here.) */
98 Vuser_real_login_name
= build_string (pw
? pw
->pw_name
: "root");
100 Vuser_real_login_name
= build_string (pw
? pw
->pw_name
: "unknown");
103 /* Get the effective user name, by consulting environment variables,
104 or the effective uid if those are unset. */
105 user_name
= (char *) getenv ("LOGNAME");
108 user_name
= (char *) getenv ("USERNAME"); /* it's USERNAME on NT */
109 #else /* WINDOWSNT */
110 user_name
= (char *) getenv ("USER");
111 #endif /* WINDOWSNT */
114 pw
= (struct passwd
*) getpwuid (geteuid ());
115 user_name
= (char *) (pw
? pw
->pw_name
: "unknown");
117 Vuser_login_name
= build_string (user_name
);
119 /* If the user name claimed in the environment vars differs from
120 the real uid, use the claimed name to find the full name. */
121 tem
= Fstring_equal (Vuser_login_name
, Vuser_real_login_name
);
122 Vuser_full_name
= Fuser_full_name (NILP (tem
)? make_number (geteuid())
125 p
= (unsigned char *) getenv ("NAME");
127 Vuser_full_name
= build_string (p
);
128 else if (NILP (Vuser_full_name
))
129 Vuser_full_name
= build_string ("unknown");
132 DEFUN ("char-to-string", Fchar_to_string
, Schar_to_string
, 1, 1, 0,
133 "Convert arg CHAR to a string containing that character.")
135 Lisp_Object character
;
138 unsigned char workbuf
[4], *str
;
140 CHECK_NUMBER (character
, 0);
142 len
= CHAR_STRING (XFASTINT (character
), workbuf
, str
);
143 return make_string_from_bytes (str
, 1, len
);
146 DEFUN ("string-to-char", Fstring_to_char
, Sstring_to_char
, 1, 1, 0,
147 "Convert arg STRING to a character, the first character of that string.\n\
148 A multibyte character is handled correctly.")
150 register Lisp_Object string
;
152 register Lisp_Object val
;
153 register struct Lisp_String
*p
;
154 CHECK_STRING (string
, 0);
155 p
= XSTRING (string
);
157 XSETFASTINT (val
, STRING_CHAR (p
->data
, STRING_BYTES (p
)));
159 XSETFASTINT (val
, 0);
164 buildmark (charpos
, bytepos
)
165 int charpos
, bytepos
;
167 register Lisp_Object mark
;
168 mark
= Fmake_marker ();
169 set_marker_both (mark
, Qnil
, charpos
, bytepos
);
173 DEFUN ("point", Fpoint
, Spoint
, 0, 0, 0,
174 "Return value of point, as an integer.\n\
175 Beginning of buffer is position (point-min)")
179 XSETFASTINT (temp
, PT
);
183 DEFUN ("point-marker", Fpoint_marker
, Spoint_marker
, 0, 0, 0,
184 "Return value of point, as a marker object.")
187 return buildmark (PT
, PT_BYTE
);
191 clip_to_bounds (lower
, num
, upper
)
192 int lower
, num
, upper
;
196 else if (num
> upper
)
202 DEFUN ("goto-char", Fgoto_char
, Sgoto_char
, 1, 1, "NGoto char: ",
203 "Set point to POSITION, a number or marker.\n\
204 Beginning of buffer is position (point-min), end is (point-max).\n\
205 If the position is in the middle of a multibyte form,\n\
206 the actual point is set at the head of the multibyte form\n\
207 except in the case that `enable-multibyte-characters' is nil.")
209 register Lisp_Object position
;
214 if (MARKERP (position
)
215 && current_buffer
== XMARKER (position
)->buffer
)
217 pos
= marker_position (position
);
219 SET_PT_BOTH (BEGV
, BEGV_BYTE
);
221 SET_PT_BOTH (ZV
, ZV_BYTE
);
223 SET_PT_BOTH (pos
, marker_byte_position (position
));
228 CHECK_NUMBER_COERCE_MARKER (position
, 0);
230 pos
= clip_to_bounds (BEGV
, XINT (position
), ZV
);
236 region_limit (beginningp
)
239 extern Lisp_Object Vmark_even_if_inactive
; /* Defined in callint.c. */
240 register Lisp_Object m
;
241 if (!NILP (Vtransient_mark_mode
) && NILP (Vmark_even_if_inactive
)
242 && NILP (current_buffer
->mark_active
))
243 Fsignal (Qmark_inactive
, Qnil
);
244 m
= Fmarker_position (current_buffer
->mark
);
245 if (NILP (m
)) error ("There is no region now");
246 if ((PT
< XFASTINT (m
)) == beginningp
)
247 return (make_number (PT
));
252 DEFUN ("region-beginning", Fregion_beginning
, Sregion_beginning
, 0, 0, 0,
253 "Return position of beginning of region, as an integer.")
256 return (region_limit (1));
259 DEFUN ("region-end", Fregion_end
, Sregion_end
, 0, 0, 0,
260 "Return position of end of region, as an integer.")
263 return (region_limit (0));
266 DEFUN ("mark-marker", Fmark_marker
, Smark_marker
, 0, 0, 0,
267 "Return this buffer's mark, as a marker object.\n\
268 Watch out! Moving this marker changes the mark position.\n\
269 If you set the marker not to point anywhere, the buffer will have no mark.")
272 return current_buffer
->mark
;
275 DEFUN ("line-beginning-position", Fline_beginning_position
, Sline_beginning_position
,
277 "Return the character position of the first character on the current line.\n\
278 With argument N not nil or 1, move forward N - 1 lines first.\n\
279 If scan reaches end of buffer, return that position.\n\
280 This function does not move point.")
284 register int orig
, orig_byte
, end
;
293 Fforward_line (make_number (XINT (n
) - 1));
295 SET_PT_BOTH (orig
, orig_byte
);
297 return make_number (end
);
300 DEFUN ("line-end-position", Fline_end_position
, Sline_end_position
,
302 "Return the character position of the last character on the current line.\n\
303 With argument N not nil or 1, move forward N - 1 lines first.\n\
304 If scan reaches end of buffer, return that position.\n\
305 This function does not move point.")
314 return make_number (find_before_next_newline
315 (PT
, 0, XINT (n
) - (XINT (n
) <= 0)));
319 save_excursion_save ()
321 register int visible
= (XBUFFER (XWINDOW (selected_window
)->buffer
)
324 return Fcons (Fpoint_marker (),
325 Fcons (Fcopy_marker (current_buffer
->mark
, Qnil
),
326 Fcons (visible
? Qt
: Qnil
,
327 current_buffer
->mark_active
)));
331 save_excursion_restore (info
)
334 Lisp_Object tem
, tem1
, omark
, nmark
;
335 struct gcpro gcpro1
, gcpro2
, gcpro3
;
337 tem
= Fmarker_buffer (Fcar (info
));
338 /* If buffer being returned to is now deleted, avoid error */
339 /* Otherwise could get error here while unwinding to top level
341 /* In that case, Fmarker_buffer returns nil now. */
345 omark
= nmark
= Qnil
;
346 GCPRO3 (info
, omark
, nmark
);
351 unchain_marker (tem
);
352 tem
= Fcar (Fcdr (info
));
353 omark
= Fmarker_position (current_buffer
->mark
);
354 Fset_marker (current_buffer
->mark
, tem
, Fcurrent_buffer ());
355 nmark
= Fmarker_position (tem
);
356 unchain_marker (tem
);
357 tem
= Fcdr (Fcdr (info
));
358 #if 0 /* We used to make the current buffer visible in the selected window
359 if that was true previously. That avoids some anomalies.
360 But it creates others, and it wasn't documented, and it is simpler
361 and cleaner never to alter the window/buffer connections. */
364 && current_buffer
!= XBUFFER (XWINDOW (selected_window
)->buffer
))
365 Fswitch_to_buffer (Fcurrent_buffer (), Qnil
);
368 tem1
= current_buffer
->mark_active
;
369 current_buffer
->mark_active
= Fcdr (tem
);
370 if (!NILP (Vrun_hooks
))
372 /* If mark is active now, and either was not active
373 or was at a different place, run the activate hook. */
374 if (! NILP (current_buffer
->mark_active
))
376 if (! EQ (omark
, nmark
))
377 call1 (Vrun_hooks
, intern ("activate-mark-hook"));
379 /* If mark has ceased to be active, run deactivate hook. */
380 else if (! NILP (tem1
))
381 call1 (Vrun_hooks
, intern ("deactivate-mark-hook"));
387 DEFUN ("save-excursion", Fsave_excursion
, Ssave_excursion
, 0, UNEVALLED
, 0,
388 "Save point, mark, and current buffer; execute BODY; restore those things.\n\
389 Executes BODY just like `progn'.\n\
390 The values of point, mark and the current buffer are restored\n\
391 even in case of abnormal exit (throw or error).\n\
392 The state of activation of the mark is also restored.\n\
394 This construct does not save `deactivate-mark', and therefore\n\
395 functions that change the buffer will still cause deactivation\n\
396 of the mark at the end of the command. To prevent that, bind\n\
397 `deactivate-mark' with `let'.")
401 register Lisp_Object val
;
402 int count
= specpdl_ptr
- specpdl
;
404 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
407 return unbind_to (count
, val
);
410 DEFUN ("save-current-buffer", Fsave_current_buffer
, Ssave_current_buffer
, 0, UNEVALLED
, 0,
411 "Save the current buffer; execute BODY; restore the current buffer.\n\
412 Executes BODY just like `progn'.")
416 register Lisp_Object val
;
417 int count
= specpdl_ptr
- specpdl
;
419 record_unwind_protect (set_buffer_if_live
, Fcurrent_buffer ());
422 return unbind_to (count
, val
);
425 DEFUN ("buffer-size", Fbufsize
, Sbufsize
, 0, 0, 0,
426 "Return the number of characters in the current buffer.")
430 XSETFASTINT (temp
, Z
- BEG
);
434 DEFUN ("point-min", Fpoint_min
, Spoint_min
, 0, 0, 0,
435 "Return the minimum permissible value of point in the current buffer.\n\
436 This is 1, unless narrowing (a buffer restriction) is in effect.")
440 XSETFASTINT (temp
, BEGV
);
444 DEFUN ("point-min-marker", Fpoint_min_marker
, Spoint_min_marker
, 0, 0, 0,
445 "Return a marker to the minimum permissible value of point in this buffer.\n\
446 This is the beginning, unless narrowing (a buffer restriction) is in effect.")
449 return buildmark (BEGV
, BEGV_BYTE
);
452 DEFUN ("point-max", Fpoint_max
, Spoint_max
, 0, 0, 0,
453 "Return the maximum permissible value of point in the current buffer.\n\
454 This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
455 is in effect, in which case it is less.")
459 XSETFASTINT (temp
, ZV
);
463 DEFUN ("point-max-marker", Fpoint_max_marker
, Spoint_max_marker
, 0, 0, 0,
464 "Return a marker to the maximum permissible value of point in this buffer.\n\
465 This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
466 is in effect, in which case it is less.")
469 return buildmark (ZV
, ZV_BYTE
);
472 DEFUN ("gap-position", Fgap_position
, Sgap_position
, 0, 0, 0,
473 "Return the position of the gap, in the current buffer.\n\
474 See also `gap-size'.")
478 XSETFASTINT (temp
, GPT
);
482 DEFUN ("gap-size", Fgap_size
, Sgap_size
, 0, 0, 0,
483 "Return the size of the current buffer's gap.\n\
484 See also `gap-position'.")
488 XSETFASTINT (temp
, GAP_SIZE
);
492 DEFUN ("position-bytes", Fposition_bytes
, Sposition_bytes
, 1, 1, 0,
493 "Return the byte position for character position POSITION.")
495 Lisp_Object position
;
497 CHECK_NUMBER_COERCE_MARKER (position
, 1);
498 return make_number (CHAR_TO_BYTE (XINT (position
)));
501 DEFUN ("byte-to-position", Fbyte_to_position
, Sbyte_to_position
, 1, 1, 0,
502 "Return the character position for byte position BYTEPOS.")
506 CHECK_NUMBER (bytepos
, 1);
507 return make_number (BYTE_TO_CHAR (XINT (bytepos
)));
510 DEFUN ("following-char", Ffollowing_char
, Sfollowing_char
, 0, 0, 0,
511 "Return the character following point, as a number.\n\
512 At the end of the buffer or accessible region, return 0.\n\
513 If `enable-multibyte-characters' is nil or point is not\n\
514 at character boundary, multibyte form is ignored,\n\
515 and only one byte following point is returned as a character.")
520 XSETFASTINT (temp
, 0);
522 XSETFASTINT (temp
, FETCH_CHAR (PT_BYTE
));
526 DEFUN ("preceding-char", Fprevious_char
, Sprevious_char
, 0, 0, 0,
527 "Return the character preceding point, as a number.\n\
528 At the beginning of the buffer or accessible region, return 0.\n\
529 If `enable-multibyte-characters' is nil or point is not\n\
530 at character boundary, multi-byte form is ignored,\n\
531 and only one byte preceding point is returned as a character.")
536 XSETFASTINT (temp
, 0);
537 else if (!NILP (current_buffer
->enable_multibyte_characters
))
541 XSETFASTINT (temp
, FETCH_CHAR (pos
));
544 XSETFASTINT (temp
, FETCH_BYTE (PT_BYTE
- 1));
548 DEFUN ("bobp", Fbobp
, Sbobp
, 0, 0, 0,
549 "Return t if point is at the beginning of the buffer.\n\
550 If the buffer is narrowed, this means the beginning of the narrowed part.")
558 DEFUN ("eobp", Feobp
, Seobp
, 0, 0, 0,
559 "Return t if point is at the end of the buffer.\n\
560 If the buffer is narrowed, this means the end of the narrowed part.")
568 DEFUN ("bolp", Fbolp
, Sbolp
, 0, 0, 0,
569 "Return t if point is at the beginning of a line.")
572 if (PT
== BEGV
|| FETCH_BYTE (PT_BYTE
- 1) == '\n')
577 DEFUN ("eolp", Feolp
, Seolp
, 0, 0, 0,
578 "Return t if point is at the end of a line.\n\
579 `End of a line' includes point being at the end of the buffer.")
582 if (PT
== ZV
|| FETCH_BYTE (PT_BYTE
) == '\n')
587 DEFUN ("char-after", Fchar_after
, Schar_after
, 0, 1, 0,
588 "Return character in current buffer at position POS.\n\
589 POS is an integer or a buffer pointer.\n\
590 If POS is out of range, the value is nil.")
594 register int pos_byte
;
595 register Lisp_Object val
;
605 pos_byte
= marker_byte_position (pos
);
606 if (pos_byte
< BEGV_BYTE
|| pos_byte
>= ZV_BYTE
)
611 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
612 if (XINT (pos
) < BEGV
|| XINT (pos
) >= ZV
)
615 pos_byte
= CHAR_TO_BYTE (XINT (pos
));
618 return make_number (FETCH_CHAR (pos_byte
));
621 DEFUN ("char-before", Fchar_before
, Schar_before
, 0, 1, 0,
622 "Return character in current buffer preceding position POS.\n\
623 POS is an integer or a buffer pointer.\n\
624 If POS is out of range, the value is nil.")
628 register Lisp_Object val
;
629 register int pos_byte
;
639 pos_byte
= marker_byte_position (pos
);
641 if (pos_byte
<= BEGV_BYTE
|| pos_byte
> ZV_BYTE
)
646 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
648 if (XINT (pos
) <= BEGV
|| XINT (pos
) > ZV
)
651 pos_byte
= CHAR_TO_BYTE (XINT (pos
));
654 if (!NILP (current_buffer
->enable_multibyte_characters
))
657 XSETFASTINT (val
, FETCH_CHAR (pos_byte
));
662 XSETFASTINT (val
, FETCH_BYTE (pos_byte
));
667 DEFUN ("user-login-name", Fuser_login_name
, Suser_login_name
, 0, 1, 0,
668 "Return the name under which the user logged in, as a string.\n\
669 This is based on the effective uid, not the real uid.\n\
670 Also, if the environment variable LOGNAME or USER is set,\n\
671 that determines the value of this function.\n\n\
672 If optional argument UID is an integer, return the login name of the user\n\
673 with that uid, or nil if there is no such user.")
679 /* Set up the user name info if we didn't do it before.
680 (That can happen if Emacs is dumpable
681 but you decide to run `temacs -l loadup' and not dump. */
682 if (INTEGERP (Vuser_login_name
))
686 return Vuser_login_name
;
688 CHECK_NUMBER (uid
, 0);
689 pw
= (struct passwd
*) getpwuid (XINT (uid
));
690 return (pw
? build_string (pw
->pw_name
) : Qnil
);
693 DEFUN ("user-real-login-name", Fuser_real_login_name
, Suser_real_login_name
,
695 "Return the name of the user's real uid, as a string.\n\
696 This ignores the environment variables LOGNAME and USER, so it differs from\n\
697 `user-login-name' when running under `su'.")
700 /* Set up the user name info if we didn't do it before.
701 (That can happen if Emacs is dumpable
702 but you decide to run `temacs -l loadup' and not dump. */
703 if (INTEGERP (Vuser_login_name
))
705 return Vuser_real_login_name
;
708 DEFUN ("user-uid", Fuser_uid
, Suser_uid
, 0, 0, 0,
709 "Return the effective uid of Emacs, as an integer.")
712 return make_number (geteuid ());
715 DEFUN ("user-real-uid", Fuser_real_uid
, Suser_real_uid
, 0, 0, 0,
716 "Return the real uid of Emacs, as an integer.")
719 return make_number (getuid ());
722 DEFUN ("user-full-name", Fuser_full_name
, Suser_full_name
, 0, 1, 0,
723 "Return the full name of the user logged in, as a string.\n\
724 If optional argument UID is an integer, return the full name of the user\n\
725 with that uid, or \"unknown\" if there is no such user.\n\
726 If UID is a string, return the full name of the user with that login\n\
727 name, or \"unknown\" if no such user could be found.")
732 register unsigned char *p
, *q
;
733 extern char *index ();
737 return Vuser_full_name
;
738 else if (NUMBERP (uid
))
739 pw
= (struct passwd
*) getpwuid (XINT (uid
));
740 else if (STRINGP (uid
))
741 pw
= (struct passwd
*) getpwnam (XSTRING (uid
)->data
);
743 error ("Invalid UID specification");
748 p
= (unsigned char *) USER_FULL_NAME
;
749 /* Chop off everything after the first comma. */
750 q
= (unsigned char *) index (p
, ',');
751 full
= make_string (p
, q
? q
- p
: strlen (p
));
753 #ifdef AMPERSAND_FULL_NAME
754 p
= XSTRING (full
)->data
;
755 q
= (unsigned char *) index (p
, '&');
756 /* Substitute the login name for the &, upcasing the first character. */
759 register unsigned char *r
;
762 login
= Fuser_login_name (make_number (pw
->pw_uid
));
763 r
= (unsigned char *) alloca (strlen (p
) + XSTRING (login
)->size
+ 1);
766 strcat (r
, XSTRING (login
)->data
);
767 r
[q
- p
] = UPCASE (r
[q
- p
]);
769 full
= build_string (r
);
771 #endif /* AMPERSAND_FULL_NAME */
776 DEFUN ("system-name", Fsystem_name
, Ssystem_name
, 0, 0, 0,
777 "Return the name of the machine you are running on, as a string.")
783 /* For the benefit of callers who don't want to include lisp.h */
787 if (STRINGP (Vsystem_name
))
788 return (char *) XSTRING (Vsystem_name
)->data
;
793 DEFUN ("emacs-pid", Femacs_pid
, Semacs_pid
, 0, 0, 0,
794 "Return the process ID of Emacs, as an integer.")
797 return make_number (getpid ());
800 DEFUN ("current-time", Fcurrent_time
, Scurrent_time
, 0, 0, 0,
801 "Return the current time, as the number of seconds since 1970-01-01 00:00:00.\n\
802 The time is returned as a list of three integers. The first has the\n\
803 most significant 16 bits of the seconds, while the second has the\n\
804 least significant 16 bits. The third integer gives the microsecond\n\
807 The microsecond count is zero on systems that do not provide\n\
808 resolution finer than a second.")
812 Lisp_Object result
[3];
815 XSETINT (result
[0], (EMACS_SECS (t
) >> 16) & 0xffff);
816 XSETINT (result
[1], (EMACS_SECS (t
) >> 0) & 0xffff);
817 XSETINT (result
[2], EMACS_USECS (t
));
819 return Flist (3, result
);
824 lisp_time_argument (specified_time
, result
)
825 Lisp_Object specified_time
;
828 if (NILP (specified_time
))
829 return time (result
) != -1;
832 Lisp_Object high
, low
;
833 high
= Fcar (specified_time
);
834 CHECK_NUMBER (high
, 0);
835 low
= Fcdr (specified_time
);
838 CHECK_NUMBER (low
, 0);
839 *result
= (XINT (high
) << 16) + (XINT (low
) & 0xffff);
840 return *result
>> 16 == XINT (high
);
845 DEFUN ("format-time-string", Fformat_time_string, Sformat_time_string, 1, 3, 0,
846 "Use FORMAT-STRING to format the time TIME, or now if omitted.\n\
847 TIME is specified as (HIGH LOW . IGNORED) or (HIGH . LOW), as returned by\n\
848 `current-time' or `file-attributes'.\n\
849 The third, optional, argument UNIVERSAL, if non-nil, means describe TIME\n\
850 as Universal Time; nil means describe TIME in the local time zone.\n\
851 The value is a copy of FORMAT-STRING, but with certain constructs replaced\n\
852 by text that describes the specified date and time in TIME:\n\
854 %Y is the year, %y within the century, %C the century.\n\
855 %G is the year corresponding to the ISO week, %g within the century.\n\
856 %m is the numeric month.\n\
857 %b and %h are the locale's abbreviated month name, %B the full name.\n\
858 %d is the day of the month, zero-padded, %e is blank-padded.\n\
859 %u is the numeric day of week from 1 (Monday) to 7, %w from 0 (Sunday) to 6.\n\
860 %a is the locale's abbreviated name of the day of week, %A the full name.\n\
861 %U is the week number starting on Sunday, %W starting on Monday,\n\
862 %V according to ISO 8601.\n\
863 %j is the day of the year.\n\
865 %H is the hour on a 24-hour clock, %I is on a 12-hour clock, %k is like %H\n\
866 only blank-padded, %l is like %I blank-padded.\n\
867 %p is the locale's equivalent of either AM or PM.\n\
870 %Z is the time zone name, %z is the numeric form.\n\
871 %s is the number of seconds since 1970-01-01 00:00:00 +0000.\n\
873 %c is the locale's date and time format.\n\
874 %x is the locale's \"preferred\" date format.\n\
875 %D is like \"%m/%d/%y\".\n\
877 %R is like \"%H:%M\", %T is like \"%H:%M:%S\", %r is like \"%I:%M:%S %p\".\n\
878 %X is the locale's \"preferred\" time format.\n\
880 Finally, %n is a newline, %t is a tab, %% is a literal %.\n\
882 Certain flags and modifiers are available with some format controls.\n\
883 The flags are `_' and `-'. For certain characters X, %_X is like %X,\n\
884 but padded with blanks; %-X is like %X, but without padding.\n\
885 %NX (where N stands for an integer) is like %X,\n\
886 but takes up at least N (a number) positions.\n\
887 The modifiers are `E' and `O'. For certain characters X,\n\
888 %EX is a locale's alternative version of %X;\n\
889 %OX is like %X, but uses the locale's number symbols.\n\
891 For example, to produce full ISO 8601 format, use \"%Y-%m-%dT%T%z\".")
892 (format_string, time, universal)
895 DEFUN ("format-time-string", Fformat_time_string
, Sformat_time_string
, 1, 3, 0,
896 0 /* See immediately above */)
897 (format_string
, time
, universal
)
898 Lisp_Object format_string
, time
, universal
;
903 CHECK_STRING (format_string
, 1);
905 if (! lisp_time_argument (time
, &value
))
906 error ("Invalid time specification");
908 /* This is probably enough. */
909 size
= STRING_BYTES (XSTRING (format_string
)) * 6 + 50;
913 char *buf
= (char *) alloca (size
+ 1);
917 result
= emacs_strftime (buf
, size
, XSTRING (format_string
)->data
,
918 (NILP (universal
) ? localtime (&value
)
920 if ((result
> 0 && result
< size
) || (result
== 0 && buf
[0] == '\0'))
921 return build_string (buf
);
923 /* If buffer was too small, make it bigger and try again. */
924 result
= emacs_strftime (NULL
, 0x7fffffff, XSTRING (format_string
)->data
,
925 (NILP (universal
) ? localtime (&value
)
931 DEFUN ("decode-time", Fdecode_time
, Sdecode_time
, 0, 1, 0,
932 "Decode a time value as (SEC MINUTE HOUR DAY MONTH YEAR DOW DST ZONE).\n\
933 The optional SPECIFIED-TIME should be a list of (HIGH LOW . IGNORED)\n\
934 or (HIGH . LOW), as from `current-time' and `file-attributes', or `nil'\n\
935 to use the current time. The list has the following nine members:\n\
936 SEC is an integer between 0 and 60; SEC is 60 for a leap second, which\n\
937 only some operating systems support. MINUTE is an integer between 0 and 59.\n\
938 HOUR is an integer between 0 and 23. DAY is an integer between 1 and 31.\n\
939 MONTH is an integer between 1 and 12. YEAR is an integer indicating the\n\
940 four-digit year. DOW is the day of week, an integer between 0 and 6, where\n\
941 0 is Sunday. DST is t if daylight savings time is effect, otherwise nil.\n\
942 ZONE is an integer indicating the number of seconds east of Greenwich.\n\
943 \(Note that Common Lisp has different meanings for DOW and ZONE.)")
945 Lisp_Object specified_time
;
949 struct tm
*decoded_time
;
950 Lisp_Object list_args
[9];
952 if (! lisp_time_argument (specified_time
, &time_spec
))
953 error ("Invalid time specification");
955 decoded_time
= localtime (&time_spec
);
956 XSETFASTINT (list_args
[0], decoded_time
->tm_sec
);
957 XSETFASTINT (list_args
[1], decoded_time
->tm_min
);
958 XSETFASTINT (list_args
[2], decoded_time
->tm_hour
);
959 XSETFASTINT (list_args
[3], decoded_time
->tm_mday
);
960 XSETFASTINT (list_args
[4], decoded_time
->tm_mon
+ 1);
961 XSETINT (list_args
[5], decoded_time
->tm_year
+ 1900);
962 XSETFASTINT (list_args
[6], decoded_time
->tm_wday
);
963 list_args
[7] = (decoded_time
->tm_isdst
)? Qt
: Qnil
;
965 /* Make a copy, in case gmtime modifies the struct. */
966 save_tm
= *decoded_time
;
967 decoded_time
= gmtime (&time_spec
);
968 if (decoded_time
== 0)
971 XSETINT (list_args
[8], tm_diff (&save_tm
, decoded_time
));
972 return Flist (9, list_args
);
975 DEFUN ("encode-time", Fencode_time
, Sencode_time
, 6, MANY
, 0,
976 "Convert SECOND, MINUTE, HOUR, DAY, MONTH, YEAR and ZONE to internal time.\n\
977 This is the reverse operation of `decode-time', which see.\n\
978 ZONE defaults to the current time zone rule. This can\n\
979 be a string or t (as from `set-time-zone-rule'), or it can be a list\n\
980 \(as from `current-time-zone') or an integer (as from `decode-time')\n\
981 applied without consideration for daylight savings time.\n\
983 You can pass more than 7 arguments; then the first six arguments\n\
984 are used as SECOND through YEAR, and the *last* argument is used as ZONE.\n\
985 The intervening arguments are ignored.\n\
986 This feature lets (apply 'encode-time (decode-time ...)) work.\n\
988 Out-of-range values for SEC, MINUTE, HOUR, DAY, or MONTH are allowed;\n\
989 for example, a DAY of 0 means the day preceding the given month.\n\
990 Year numbers less than 100 are treated just like other year numbers.\n\
991 If you want them to stand for years in this century, you must do that yourself.")
994 register Lisp_Object
*args
;
998 Lisp_Object zone
= (nargs
> 6 ? args
[nargs
- 1] : Qnil
);
1000 CHECK_NUMBER (args
[0], 0); /* second */
1001 CHECK_NUMBER (args
[1], 1); /* minute */
1002 CHECK_NUMBER (args
[2], 2); /* hour */
1003 CHECK_NUMBER (args
[3], 3); /* day */
1004 CHECK_NUMBER (args
[4], 4); /* month */
1005 CHECK_NUMBER (args
[5], 5); /* year */
1007 tm
.tm_sec
= XINT (args
[0]);
1008 tm
.tm_min
= XINT (args
[1]);
1009 tm
.tm_hour
= XINT (args
[2]);
1010 tm
.tm_mday
= XINT (args
[3]);
1011 tm
.tm_mon
= XINT (args
[4]) - 1;
1012 tm
.tm_year
= XINT (args
[5]) - 1900;
1018 time
= mktime (&tm
);
1023 char **oldenv
= environ
, **newenv
;
1027 else if (STRINGP (zone
))
1028 tzstring
= (char *) XSTRING (zone
)->data
;
1029 else if (INTEGERP (zone
))
1031 int abszone
= abs (XINT (zone
));
1032 sprintf (tzbuf
, "XXX%s%d:%02d:%02d", "-" + (XINT (zone
) < 0),
1033 abszone
/ (60*60), (abszone
/60) % 60, abszone
% 60);
1037 error ("Invalid time zone specification");
1039 /* Set TZ before calling mktime; merely adjusting mktime's returned
1040 value doesn't suffice, since that would mishandle leap seconds. */
1041 set_time_zone_rule (tzstring
);
1043 time
= mktime (&tm
);
1045 /* Restore TZ to previous value. */
1049 #ifdef LOCALTIME_CACHE
1054 if (time
== (time_t) -1)
1055 error ("Specified time is not representable");
1057 return make_time (time
);
1060 DEFUN ("current-time-string", Fcurrent_time_string
, Scurrent_time_string
, 0, 1, 0,
1061 "Return the current time, as a human-readable string.\n\
1062 Programs can use this function to decode a time,\n\
1063 since the number of columns in each field is fixed.\n\
1064 The format is `Sun Sep 16 01:03:52 1973'.\n\
1065 However, see also the functions `decode-time' and `format-time-string'\n\
1066 which provide a much more powerful and general facility.\n\
1068 If an argument is given, it specifies a time to format\n\
1069 instead of the current time. The argument should have the form:\n\
1072 (HIGH LOW . IGNORED).\n\
1073 Thus, you can use times obtained from `current-time'\n\
1074 and from `file-attributes'.")
1076 Lisp_Object specified_time
;
1082 if (! lisp_time_argument (specified_time
, &value
))
1084 tem
= (char *) ctime (&value
);
1086 strncpy (buf
, tem
, 24);
1089 return build_string (buf
);
1092 #define TM_YEAR_BASE 1900
1094 /* Yield A - B, measured in seconds.
1095 This function is copied from the GNU C Library. */
1100 /* Compute intervening leap days correctly even if year is negative.
1101 Take care to avoid int overflow in leap day calculations,
1102 but it's OK to assume that A and B are close to each other. */
1103 int a4
= (a
->tm_year
>> 2) + (TM_YEAR_BASE
>> 2) - ! (a
->tm_year
& 3);
1104 int b4
= (b
->tm_year
>> 2) + (TM_YEAR_BASE
>> 2) - ! (b
->tm_year
& 3);
1105 int a100
= a4
/ 25 - (a4
% 25 < 0);
1106 int b100
= b4
/ 25 - (b4
% 25 < 0);
1107 int a400
= a100
>> 2;
1108 int b400
= b100
>> 2;
1109 int intervening_leap_days
= (a4
- b4
) - (a100
- b100
) + (a400
- b400
);
1110 int years
= a
->tm_year
- b
->tm_year
;
1111 int days
= (365 * years
+ intervening_leap_days
1112 + (a
->tm_yday
- b
->tm_yday
));
1113 return (60 * (60 * (24 * days
+ (a
->tm_hour
- b
->tm_hour
))
1114 + (a
->tm_min
- b
->tm_min
))
1115 + (a
->tm_sec
- b
->tm_sec
));
1118 DEFUN ("current-time-zone", Fcurrent_time_zone
, Scurrent_time_zone
, 0, 1, 0,
1119 "Return the offset and name for the local time zone.\n\
1120 This returns a list of the form (OFFSET NAME).\n\
1121 OFFSET is an integer number of seconds ahead of UTC (east of Greenwich).\n\
1122 A negative value means west of Greenwich.\n\
1123 NAME is a string giving the name of the time zone.\n\
1124 If an argument is given, it specifies when the time zone offset is determined\n\
1125 instead of using the current time. The argument should have the form:\n\
1128 (HIGH LOW . IGNORED).\n\
1129 Thus, you can use times obtained from `current-time'\n\
1130 and from `file-attributes'.\n\
1132 Some operating systems cannot provide all this information to Emacs;\n\
1133 in this case, `current-time-zone' returns a list containing nil for\n\
1134 the data it can't find.")
1136 Lisp_Object specified_time
;
1141 if (lisp_time_argument (specified_time
, &value
)
1142 && (t
= gmtime (&value
)) != 0)
1148 gmt
= *t
; /* Make a copy, in case localtime modifies *t. */
1149 t
= localtime (&value
);
1150 offset
= tm_diff (t
, &gmt
);
1154 s
= (char *)t
->tm_zone
;
1155 #else /* not HAVE_TM_ZONE */
1157 if (t
->tm_isdst
== 0 || t
->tm_isdst
== 1)
1158 s
= tzname
[t
->tm_isdst
];
1160 #endif /* not HAVE_TM_ZONE */
1163 /* No local time zone name is available; use "+-NNNN" instead. */
1164 int am
= (offset
< 0 ? -offset
: offset
) / 60;
1165 sprintf (buf
, "%c%02d%02d", (offset
< 0 ? '-' : '+'), am
/60, am
%60);
1168 return Fcons (make_number (offset
), Fcons (build_string (s
), Qnil
));
1171 return Fmake_list (make_number (2), Qnil
);
1174 /* This holds the value of `environ' produced by the previous
1175 call to Fset_time_zone_rule, or 0 if Fset_time_zone_rule
1176 has never been called. */
1177 static char **environbuf
;
1179 DEFUN ("set-time-zone-rule", Fset_time_zone_rule
, Sset_time_zone_rule
, 1, 1, 0,
1180 "Set the local time zone using TZ, a string specifying a time zone rule.\n\
1181 If TZ is nil, use implementation-defined default time zone information.\n\
1182 If TZ is t, use Universal Time.")
1190 else if (EQ (tz
, Qt
))
1194 CHECK_STRING (tz
, 0);
1195 tzstring
= (char *) XSTRING (tz
)->data
;
1198 set_time_zone_rule (tzstring
);
1201 environbuf
= environ
;
1206 #ifdef LOCALTIME_CACHE
1208 /* These two values are known to load tz files in buggy implementations,
1209 i.e. Solaris 1 executables running under either Solaris 1 or Solaris 2.
1210 Their values shouldn't matter in non-buggy implementations.
1211 We don't use string literals for these strings,
1212 since if a string in the environment is in readonly
1213 storage, it runs afoul of bugs in SVR4 and Solaris 2.3.
1214 See Sun bugs 1113095 and 1114114, ``Timezone routines
1215 improperly modify environment''. */
1217 static char set_time_zone_rule_tz1
[] = "TZ=GMT+0";
1218 static char set_time_zone_rule_tz2
[] = "TZ=GMT+1";
1222 /* Set the local time zone rule to TZSTRING.
1223 This allocates memory into `environ', which it is the caller's
1224 responsibility to free. */
1226 set_time_zone_rule (tzstring
)
1230 char **from
, **to
, **newenv
;
1232 /* Make the ENVIRON vector longer with room for TZSTRING. */
1233 for (from
= environ
; *from
; from
++)
1235 envptrs
= from
- environ
+ 2;
1236 newenv
= to
= (char **) xmalloc (envptrs
* sizeof (char *)
1237 + (tzstring
? strlen (tzstring
) + 4 : 0));
1239 /* Add TZSTRING to the end of environ, as a value for TZ. */
1242 char *t
= (char *) (to
+ envptrs
);
1244 strcat (t
, tzstring
);
1248 /* Copy the old environ vector elements into NEWENV,
1249 but don't copy the TZ variable.
1250 So we have only one definition of TZ, which came from TZSTRING. */
1251 for (from
= environ
; *from
; from
++)
1252 if (strncmp (*from
, "TZ=", 3) != 0)
1258 /* If we do have a TZSTRING, NEWENV points to the vector slot where
1259 the TZ variable is stored. If we do not have a TZSTRING,
1260 TO points to the vector slot which has the terminating null. */
1262 #ifdef LOCALTIME_CACHE
1264 /* In SunOS 4.1.3_U1 and 4.1.4, if TZ has a value like
1265 "US/Pacific" that loads a tz file, then changes to a value like
1266 "XXX0" that does not load a tz file, and then changes back to
1267 its original value, the last change is (incorrectly) ignored.
1268 Also, if TZ changes twice in succession to values that do
1269 not load a tz file, tzset can dump core (see Sun bug#1225179).
1270 The following code works around these bugs. */
1274 /* Temporarily set TZ to a value that loads a tz file
1275 and that differs from tzstring. */
1277 *newenv
= (strcmp (tzstring
, set_time_zone_rule_tz1
+ 3) == 0
1278 ? set_time_zone_rule_tz2
: set_time_zone_rule_tz1
);
1284 /* The implied tzstring is unknown, so temporarily set TZ to
1285 two different values that each load a tz file. */
1286 *to
= set_time_zone_rule_tz1
;
1289 *to
= set_time_zone_rule_tz2
;
1294 /* Now TZ has the desired value, and tzset can be invoked safely. */
1301 /* Insert NARGS Lisp objects in the array ARGS by calling INSERT_FUNC
1302 (if a type of object is Lisp_Int) or INSERT_FROM_STRING_FUNC (if a
1303 type of object is Lisp_String). INHERIT is passed to
1304 INSERT_FROM_STRING_FUNC as the last argument. */
1307 general_insert_function (insert_func
, insert_from_string_func
,
1308 inherit
, nargs
, args
)
1309 void (*insert_func
) P_ ((unsigned char *, int));
1310 void (*insert_from_string_func
) P_ ((Lisp_Object
, int, int, int, int, int));
1312 register Lisp_Object
*args
;
1314 register int argnum
;
1315 register Lisp_Object val
;
1317 for (argnum
= 0; argnum
< nargs
; argnum
++)
1323 unsigned char workbuf
[4], *str
;
1326 if (!NILP (current_buffer
->enable_multibyte_characters
))
1327 len
= CHAR_STRING (XFASTINT (val
), workbuf
, str
);
1329 workbuf
[0] = XINT (val
), str
= workbuf
, len
= 1;
1330 (*insert_func
) (str
, len
);
1332 else if (STRINGP (val
))
1334 (*insert_from_string_func
) (val
, 0, 0,
1335 XSTRING (val
)->size
,
1336 STRING_BYTES (XSTRING (val
)),
1341 val
= wrong_type_argument (Qchar_or_string_p
, val
);
1355 /* Callers passing one argument to Finsert need not gcpro the
1356 argument "array", since the only element of the array will
1357 not be used after calling insert or insert_from_string, so
1358 we don't care if it gets trashed. */
1360 DEFUN ("insert", Finsert
, Sinsert
, 0, MANY
, 0,
1361 "Insert the arguments, either strings or characters, at point.\n\
1362 Point and before-insertion markers move forward to end up\n\
1363 after the inserted text.\n\
1364 Any other markers at the point of insertion remain before the text.\n\
1366 If the current buffer is multibyte, unibyte strings are converted\n\
1367 to multibyte for insertion (see `unibyte-char-to-multibyte').\n\
1368 If the current buffer is unibyte, multibyte strings are converted\n\
1369 to unibyte for insertion.")
1372 register Lisp_Object
*args
;
1374 general_insert_function (insert
, insert_from_string
, 0, nargs
, args
);
1378 DEFUN ("insert-and-inherit", Finsert_and_inherit
, Sinsert_and_inherit
,
1380 "Insert the arguments at point, inheriting properties from adjoining text.\n\
1381 Point and before-insertion markers move forward to end up\n\
1382 after the inserted text.\n\
1383 Any other markers at the point of insertion remain before the text.\n\
1385 If the current buffer is multibyte, unibyte strings are converted\n\
1386 to multibyte for insertion (see `unibyte-char-to-multibyte').\n\
1387 If the current buffer is unibyte, multibyte strings are converted\n\
1388 to unibyte for insertion.")
1391 register Lisp_Object
*args
;
1393 general_insert_function (insert_and_inherit
, insert_from_string
, 1,
1398 DEFUN ("insert-before-markers", Finsert_before_markers
, Sinsert_before_markers
, 0, MANY
, 0,
1399 "Insert strings or characters at point, relocating markers after the text.\n\
1400 Point and markers move forward to end up after the inserted text.\n\
1402 If the current buffer is multibyte, unibyte strings are converted\n\
1403 to multibyte for insertion (see `unibyte-char-to-multibyte').\n\
1404 If the current buffer is unibyte, multibyte strings are converted\n\
1405 to unibyte for insertion.")
1408 register Lisp_Object
*args
;
1410 general_insert_function (insert_before_markers
,
1411 insert_from_string_before_markers
, 0,
1416 DEFUN ("insert-before-markers-and-inherit", Finsert_and_inherit_before_markers
,
1417 Sinsert_and_inherit_before_markers
, 0, MANY
, 0,
1418 "Insert text at point, relocating markers and inheriting properties.\n\
1419 Point and markers move forward to end up after the inserted text.\n\
1421 If the current buffer is multibyte, unibyte strings are converted\n\
1422 to multibyte for insertion (see `unibyte-char-to-multibyte').\n\
1423 If the current buffer is unibyte, multibyte strings are converted\n\
1424 to unibyte for insertion.")
1427 register Lisp_Object
*args
;
1429 general_insert_function (insert_before_markers_and_inherit
,
1430 insert_from_string_before_markers
, 1,
1435 DEFUN ("insert-char", Finsert_char
, Sinsert_char
, 2, 3, 0,
1436 "Insert COUNT (second arg) copies of CHARACTER (first arg).\n\
1437 Both arguments are required.\n\
1438 Point, and before-insertion markers, are relocated as in the function `insert'.\n\
1439 The optional third arg INHERIT, if non-nil, says to inherit text properties\n\
1440 from adjoining text, if those properties are sticky.")
1441 (character
, count
, inherit
)
1442 Lisp_Object character
, count
, inherit
;
1444 register unsigned char *string
;
1445 register int strlen
;
1448 unsigned char workbuf
[4], *str
;
1450 CHECK_NUMBER (character
, 0);
1451 CHECK_NUMBER (count
, 1);
1453 if (!NILP (current_buffer
->enable_multibyte_characters
))
1454 len
= CHAR_STRING (XFASTINT (character
), workbuf
, str
);
1456 workbuf
[0] = XFASTINT (character
), str
= workbuf
, len
= 1;
1457 n
= XINT (count
) * len
;
1460 strlen
= min (n
, 256 * len
);
1461 string
= (unsigned char *) alloca (strlen
);
1462 for (i
= 0; i
< strlen
; i
++)
1463 string
[i
] = str
[i
% len
];
1467 if (!NILP (inherit
))
1468 insert_and_inherit (string
, strlen
);
1470 insert (string
, strlen
);
1475 if (!NILP (inherit
))
1476 insert_and_inherit (string
, n
);
1484 /* Making strings from buffer contents. */
1486 /* Return a Lisp_String containing the text of the current buffer from
1487 START to END. If text properties are in use and the current buffer
1488 has properties in the range specified, the resulting string will also
1489 have them, if PROPS is nonzero.
1491 We don't want to use plain old make_string here, because it calls
1492 make_uninit_string, which can cause the buffer arena to be
1493 compacted. make_string has no way of knowing that the data has
1494 been moved, and thus copies the wrong data into the string. This
1495 doesn't effect most of the other users of make_string, so it should
1496 be left as is. But we should use this function when conjuring
1497 buffer substrings. */
1500 make_buffer_string (start
, end
, props
)
1504 int start_byte
= CHAR_TO_BYTE (start
);
1505 int end_byte
= CHAR_TO_BYTE (end
);
1507 return make_buffer_string_both (start
, start_byte
, end
, end_byte
, props
);
1510 /* Return a Lisp_String containing the text of the current buffer from
1511 START / START_BYTE to END / END_BYTE.
1513 If text properties are in use and the current buffer
1514 has properties in the range specified, the resulting string will also
1515 have them, if PROPS is nonzero.
1517 We don't want to use plain old make_string here, because it calls
1518 make_uninit_string, which can cause the buffer arena to be
1519 compacted. make_string has no way of knowing that the data has
1520 been moved, and thus copies the wrong data into the string. This
1521 doesn't effect most of the other users of make_string, so it should
1522 be left as is. But we should use this function when conjuring
1523 buffer substrings. */
1526 make_buffer_string_both (start
, start_byte
, end
, end_byte
, props
)
1527 int start
, start_byte
, end
, end_byte
;
1530 Lisp_Object result
, tem
, tem1
;
1532 if (start
< GPT
&& GPT
< end
)
1535 if (! NILP (current_buffer
->enable_multibyte_characters
))
1536 result
= make_uninit_multibyte_string (end
- start
, end_byte
- start_byte
);
1538 result
= make_uninit_string (end
- start
);
1539 bcopy (BYTE_POS_ADDR (start_byte
), XSTRING (result
)->data
,
1540 end_byte
- start_byte
);
1542 /* If desired, update and copy the text properties. */
1543 #ifdef USE_TEXT_PROPERTIES
1546 update_buffer_properties (start
, end
);
1548 tem
= Fnext_property_change (make_number (start
), Qnil
, make_number (end
));
1549 tem1
= Ftext_properties_at (make_number (start
), Qnil
);
1551 if (XINT (tem
) != end
|| !NILP (tem1
))
1552 copy_intervals_to_string (result
, current_buffer
, start
,
1560 /* Call Vbuffer_access_fontify_functions for the range START ... END
1561 in the current buffer, if necessary. */
1564 update_buffer_properties (start
, end
)
1567 #ifdef USE_TEXT_PROPERTIES
1568 /* If this buffer has some access functions,
1569 call them, specifying the range of the buffer being accessed. */
1570 if (!NILP (Vbuffer_access_fontify_functions
))
1572 Lisp_Object args
[3];
1575 args
[0] = Qbuffer_access_fontify_functions
;
1576 XSETINT (args
[1], start
);
1577 XSETINT (args
[2], end
);
1579 /* But don't call them if we can tell that the work
1580 has already been done. */
1581 if (!NILP (Vbuffer_access_fontified_property
))
1583 tem
= Ftext_property_any (args
[1], args
[2],
1584 Vbuffer_access_fontified_property
,
1587 Frun_hook_with_args (3, args
);
1590 Frun_hook_with_args (3, args
);
1595 DEFUN ("buffer-substring", Fbuffer_substring
, Sbuffer_substring
, 2, 2, 0,
1596 "Return the contents of part of the current buffer as a string.\n\
1597 The two arguments START and END are character positions;\n\
1598 they can be in either order.\n\
1599 The string returned is multibyte if the buffer is multibyte.")
1601 Lisp_Object start
, end
;
1605 validate_region (&start
, &end
);
1609 return make_buffer_string (b
, e
, 1);
1612 DEFUN ("buffer-substring-no-properties", Fbuffer_substring_no_properties
,
1613 Sbuffer_substring_no_properties
, 2, 2, 0,
1614 "Return the characters of part of the buffer, without the text properties.\n\
1615 The two arguments START and END are character positions;\n\
1616 they can be in either order.")
1618 Lisp_Object start
, end
;
1622 validate_region (&start
, &end
);
1626 return make_buffer_string (b
, e
, 0);
1629 DEFUN ("buffer-string", Fbuffer_string
, Sbuffer_string
, 0, 0, 0,
1630 "Return the contents of the current buffer as a string.\n\
1631 If narrowing is in effect, this function returns only the visible part\n\
1635 return make_buffer_string (BEGV
, ZV
, 1);
1638 DEFUN ("insert-buffer-substring", Finsert_buffer_substring
, Sinsert_buffer_substring
,
1640 "Insert before point a substring of the contents of buffer BUFFER.\n\
1641 BUFFER may be a buffer or a buffer name.\n\
1642 Arguments START and END are character numbers specifying the substring.\n\
1643 They default to the beginning and the end of BUFFER.")
1645 Lisp_Object buf
, start
, end
;
1647 register int b
, e
, temp
;
1648 register struct buffer
*bp
, *obuf
;
1651 buffer
= Fget_buffer (buf
);
1654 bp
= XBUFFER (buffer
);
1655 if (NILP (bp
->name
))
1656 error ("Selecting deleted buffer");
1662 CHECK_NUMBER_COERCE_MARKER (start
, 0);
1669 CHECK_NUMBER_COERCE_MARKER (end
, 1);
1674 temp
= b
, b
= e
, e
= temp
;
1676 if (!(BUF_BEGV (bp
) <= b
&& e
<= BUF_ZV (bp
)))
1677 args_out_of_range (start
, end
);
1679 obuf
= current_buffer
;
1680 set_buffer_internal_1 (bp
);
1681 update_buffer_properties (b
, e
);
1682 set_buffer_internal_1 (obuf
);
1684 insert_from_buffer (bp
, b
, e
- b
, 0);
1688 DEFUN ("compare-buffer-substrings", Fcompare_buffer_substrings
, Scompare_buffer_substrings
,
1690 "Compare two substrings of two buffers; return result as number.\n\
1691 the value is -N if first string is less after N-1 chars,\n\
1692 +N if first string is greater after N-1 chars, or 0 if strings match.\n\
1693 Each substring is represented as three arguments: BUFFER, START and END.\n\
1694 That makes six args in all, three for each substring.\n\n\
1695 The value of `case-fold-search' in the current buffer\n\
1696 determines whether case is significant or ignored.")
1697 (buffer1
, start1
, end1
, buffer2
, start2
, end2
)
1698 Lisp_Object buffer1
, start1
, end1
, buffer2
, start2
, end2
;
1700 register int begp1
, endp1
, begp2
, endp2
, temp
;
1701 register struct buffer
*bp1
, *bp2
;
1702 register Lisp_Object
*trt
1703 = (!NILP (current_buffer
->case_fold_search
)
1704 ? XCHAR_TABLE (current_buffer
->case_canon_table
)->contents
: 0);
1706 int i1
, i2
, i1_byte
, i2_byte
;
1708 /* Find the first buffer and its substring. */
1711 bp1
= current_buffer
;
1715 buf1
= Fget_buffer (buffer1
);
1718 bp1
= XBUFFER (buf1
);
1719 if (NILP (bp1
->name
))
1720 error ("Selecting deleted buffer");
1724 begp1
= BUF_BEGV (bp1
);
1727 CHECK_NUMBER_COERCE_MARKER (start1
, 1);
1728 begp1
= XINT (start1
);
1731 endp1
= BUF_ZV (bp1
);
1734 CHECK_NUMBER_COERCE_MARKER (end1
, 2);
1735 endp1
= XINT (end1
);
1739 temp
= begp1
, begp1
= endp1
, endp1
= temp
;
1741 if (!(BUF_BEGV (bp1
) <= begp1
1743 && endp1
<= BUF_ZV (bp1
)))
1744 args_out_of_range (start1
, end1
);
1746 /* Likewise for second substring. */
1749 bp2
= current_buffer
;
1753 buf2
= Fget_buffer (buffer2
);
1756 bp2
= XBUFFER (buf2
);
1757 if (NILP (bp2
->name
))
1758 error ("Selecting deleted buffer");
1762 begp2
= BUF_BEGV (bp2
);
1765 CHECK_NUMBER_COERCE_MARKER (start2
, 4);
1766 begp2
= XINT (start2
);
1769 endp2
= BUF_ZV (bp2
);
1772 CHECK_NUMBER_COERCE_MARKER (end2
, 5);
1773 endp2
= XINT (end2
);
1777 temp
= begp2
, begp2
= endp2
, endp2
= temp
;
1779 if (!(BUF_BEGV (bp2
) <= begp2
1781 && endp2
<= BUF_ZV (bp2
)))
1782 args_out_of_range (start2
, end2
);
1786 i1_byte
= buf_charpos_to_bytepos (bp1
, i1
);
1787 i2_byte
= buf_charpos_to_bytepos (bp2
, i2
);
1789 while (i1
< endp1
&& i2
< endp2
)
1791 /* When we find a mismatch, we must compare the
1792 characters, not just the bytes. */
1795 if (! NILP (bp1
->enable_multibyte_characters
))
1797 c1
= BUF_FETCH_MULTIBYTE_CHAR (bp1
, i1_byte
);
1798 BUF_INC_POS (bp1
, i1_byte
);
1803 c1
= BUF_FETCH_BYTE (bp1
, i1
);
1804 c1
= unibyte_char_to_multibyte (c1
);
1808 if (! NILP (bp2
->enable_multibyte_characters
))
1810 c2
= BUF_FETCH_MULTIBYTE_CHAR (bp2
, i2_byte
);
1811 BUF_INC_POS (bp2
, i2_byte
);
1816 c2
= BUF_FETCH_BYTE (bp2
, i2
);
1817 c2
= unibyte_char_to_multibyte (c2
);
1823 c1
= XINT (trt
[c1
]);
1824 c2
= XINT (trt
[c2
]);
1827 return make_number (- 1 - chars
);
1829 return make_number (chars
+ 1);
1834 /* The strings match as far as they go.
1835 If one is shorter, that one is less. */
1836 if (chars
< endp1
- begp1
)
1837 return make_number (chars
+ 1);
1838 else if (chars
< endp2
- begp2
)
1839 return make_number (- chars
- 1);
1841 /* Same length too => they are equal. */
1842 return make_number (0);
1846 subst_char_in_region_unwind (arg
)
1849 return current_buffer
->undo_list
= arg
;
1853 subst_char_in_region_unwind_1 (arg
)
1856 return current_buffer
->filename
= arg
;
1859 DEFUN ("subst-char-in-region", Fsubst_char_in_region
,
1860 Ssubst_char_in_region
, 4, 5, 0,
1861 "From START to END, replace FROMCHAR with TOCHAR each time it occurs.\n\
1862 If optional arg NOUNDO is non-nil, don't record this change for undo\n\
1863 and don't mark the buffer as really changed.\n\
1864 Both characters must have the same length of multi-byte form.")
1865 (start
, end
, fromchar
, tochar
, noundo
)
1866 Lisp_Object start
, end
, fromchar
, tochar
, noundo
;
1868 register int pos
, pos_byte
, stop
, i
, len
, end_byte
;
1870 unsigned char fromwork
[4], *fromstr
, towork
[4], *tostr
, *p
;
1871 int count
= specpdl_ptr
- specpdl
;
1873 validate_region (&start
, &end
);
1874 CHECK_NUMBER (fromchar
, 2);
1875 CHECK_NUMBER (tochar
, 3);
1877 if (! NILP (current_buffer
->enable_multibyte_characters
))
1879 len
= CHAR_STRING (XFASTINT (fromchar
), fromwork
, fromstr
);
1880 if (CHAR_STRING (XFASTINT (tochar
), towork
, tostr
) != len
)
1881 error ("Characters in subst-char-in-region have different byte-lengths");
1886 fromwork
[0] = XFASTINT (fromchar
), fromstr
= fromwork
;
1887 towork
[0] = XFASTINT (tochar
), tostr
= towork
;
1891 pos_byte
= CHAR_TO_BYTE (pos
);
1892 stop
= CHAR_TO_BYTE (XINT (end
));
1895 /* If we don't want undo, turn off putting stuff on the list.
1896 That's faster than getting rid of things,
1897 and it prevents even the entry for a first change.
1898 Also inhibit locking the file. */
1901 record_unwind_protect (subst_char_in_region_unwind
,
1902 current_buffer
->undo_list
);
1903 current_buffer
->undo_list
= Qt
;
1904 /* Don't do file-locking. */
1905 record_unwind_protect (subst_char_in_region_unwind_1
,
1906 current_buffer
->filename
);
1907 current_buffer
->filename
= Qnil
;
1910 if (pos_byte
< GPT_BYTE
)
1911 stop
= min (stop
, GPT_BYTE
);
1914 if (pos_byte
>= stop
)
1916 if (pos_byte
>= end_byte
) break;
1919 p
= BYTE_POS_ADDR (pos_byte
);
1920 if (p
[0] == fromstr
[0]
1922 || (p
[1] == fromstr
[1]
1923 && (len
== 2 || (p
[2] == fromstr
[2]
1924 && (len
== 3 || p
[3] == fromstr
[3]))))))
1928 modify_region (current_buffer
, XINT (start
), XINT (end
));
1930 if (! NILP (noundo
))
1932 if (MODIFF
- 1 == SAVE_MODIFF
)
1934 if (MODIFF
- 1 == current_buffer
->auto_save_modified
)
1935 current_buffer
->auto_save_modified
++;
1942 record_change (pos
, 1);
1943 for (i
= 0; i
< len
; i
++) *p
++ = tostr
[i
];
1945 INC_BOTH (pos
, pos_byte
);
1949 signal_after_change (XINT (start
),
1950 XINT (end
) - XINT (start
), XINT (end
) - XINT (start
));
1952 unbind_to (count
, Qnil
);
1956 DEFUN ("translate-region", Ftranslate_region
, Stranslate_region
, 3, 3, 0,
1957 "From START to END, translate characters according to TABLE.\n\
1958 TABLE is a string; the Nth character in it is the mapping\n\
1959 for the character with code N.\n\
1960 This function does not alter multibyte characters.\n\
1961 It returns the number of characters changed.")
1965 register Lisp_Object table
;
1967 register int pos_byte
, stop
; /* Limits of the region. */
1968 register unsigned char *tt
; /* Trans table. */
1969 register int nc
; /* New character. */
1970 int cnt
; /* Number of changes made. */
1971 int size
; /* Size of translate table. */
1974 validate_region (&start
, &end
);
1975 CHECK_STRING (table
, 2);
1977 size
= STRING_BYTES (XSTRING (table
));
1978 tt
= XSTRING (table
)->data
;
1980 pos_byte
= CHAR_TO_BYTE (XINT (start
));
1981 stop
= CHAR_TO_BYTE (XINT (end
));
1982 modify_region (current_buffer
, XINT (start
), XINT (end
));
1986 for (; pos_byte
< stop
; )
1988 register unsigned char *p
= BYTE_POS_ADDR (pos_byte
);
1992 oc
= STRING_CHAR_AND_LENGTH (p
, stop
- pos_byte
, len
);
1993 if (oc
< size
&& len
== 1)
1998 record_change (pos
, 1);
2000 signal_after_change (pos
, 1, 1);
2008 return make_number (cnt
);
2011 DEFUN ("delete-region", Fdelete_region
, Sdelete_region
, 2, 2, "r",
2012 "Delete the text between point and mark.\n\
2013 When called from a program, expects two arguments,\n\
2014 positions (integers or markers) specifying the stretch to be deleted.")
2016 Lisp_Object start
, end
;
2018 validate_region (&start
, &end
);
2019 del_range (XINT (start
), XINT (end
));
2023 DEFUN ("widen", Fwiden
, Swiden
, 0, 0, "",
2024 "Remove restrictions (narrowing) from current buffer.\n\
2025 This allows the buffer's full text to be seen and edited.")
2028 if (BEG
!= BEGV
|| Z
!= ZV
)
2029 current_buffer
->clip_changed
= 1;
2031 BEGV_BYTE
= BEG_BYTE
;
2032 SET_BUF_ZV_BOTH (current_buffer
, Z
, Z_BYTE
);
2033 /* Changing the buffer bounds invalidates any recorded current column. */
2034 invalidate_current_column ();
2038 DEFUN ("narrow-to-region", Fnarrow_to_region
, Snarrow_to_region
, 2, 2, "r",
2039 "Restrict editing in this buffer to the current region.\n\
2040 The rest of the text becomes temporarily invisible and untouchable\n\
2041 but is not deleted; if you save the buffer in a file, the invisible\n\
2042 text is included in the file. \\[widen] makes all visible again.\n\
2043 See also `save-restriction'.\n\
2045 When calling from a program, pass two arguments; positions (integers\n\
2046 or markers) bounding the text that should remain visible.")
2048 register Lisp_Object start
, end
;
2050 CHECK_NUMBER_COERCE_MARKER (start
, 0);
2051 CHECK_NUMBER_COERCE_MARKER (end
, 1);
2053 if (XINT (start
) > XINT (end
))
2056 tem
= start
; start
= end
; end
= tem
;
2059 if (!(BEG
<= XINT (start
) && XINT (start
) <= XINT (end
) && XINT (end
) <= Z
))
2060 args_out_of_range (start
, end
);
2062 if (BEGV
!= XFASTINT (start
) || ZV
!= XFASTINT (end
))
2063 current_buffer
->clip_changed
= 1;
2065 SET_BUF_BEGV (current_buffer
, XFASTINT (start
));
2066 SET_BUF_ZV (current_buffer
, XFASTINT (end
));
2067 if (PT
< XFASTINT (start
))
2068 SET_PT (XFASTINT (start
));
2069 if (PT
> XFASTINT (end
))
2070 SET_PT (XFASTINT (end
));
2071 /* Changing the buffer bounds invalidates any recorded current column. */
2072 invalidate_current_column ();
2077 save_restriction_save ()
2079 register Lisp_Object bottom
, top
;
2080 /* Note: I tried using markers here, but it does not win
2081 because insertion at the end of the saved region
2082 does not advance mh and is considered "outside" the saved region. */
2083 XSETFASTINT (bottom
, BEGV
- BEG
);
2084 XSETFASTINT (top
, Z
- ZV
);
2086 return Fcons (Fcurrent_buffer (), Fcons (bottom
, top
));
2090 save_restriction_restore (data
)
2093 register struct buffer
*buf
;
2094 register int newhead
, newtail
;
2095 register Lisp_Object tem
;
2098 buf
= XBUFFER (XCONS (data
)->car
);
2100 data
= XCONS (data
)->cdr
;
2102 tem
= XCONS (data
)->car
;
2103 newhead
= XINT (tem
);
2104 tem
= XCONS (data
)->cdr
;
2105 newtail
= XINT (tem
);
2106 if (newhead
+ newtail
> BUF_Z (buf
) - BUF_BEG (buf
))
2112 obegv
= BUF_BEGV (buf
);
2115 SET_BUF_BEGV (buf
, BUF_BEG (buf
) + newhead
);
2116 SET_BUF_ZV (buf
, BUF_Z (buf
) - newtail
);
2118 if (obegv
!= BUF_BEGV (buf
) || ozv
!= BUF_ZV (buf
))
2119 current_buffer
->clip_changed
= 1;
2121 /* If point is outside the new visible range, move it inside. */
2122 SET_BUF_PT_BOTH (buf
,
2123 clip_to_bounds (BUF_BEGV (buf
), BUF_PT (buf
), BUF_ZV (buf
)),
2124 clip_to_bounds (BUF_BEGV_BYTE (buf
), BUF_PT_BYTE (buf
),
2125 BUF_ZV_BYTE (buf
)));
2130 DEFUN ("save-restriction", Fsave_restriction
, Ssave_restriction
, 0, UNEVALLED
, 0,
2131 "Execute BODY, saving and restoring current buffer's restrictions.\n\
2132 The buffer's restrictions make parts of the beginning and end invisible.\n\
2133 \(They are set up with `narrow-to-region' and eliminated with `widen'.)\n\
2134 This special form, `save-restriction', saves the current buffer's restrictions\n\
2135 when it is entered, and restores them when it is exited.\n\
2136 So any `narrow-to-region' within BODY lasts only until the end of the form.\n\
2137 The old restrictions settings are restored\n\
2138 even in case of abnormal exit (throw or error).\n\
2140 The value returned is the value of the last form in BODY.\n\
2142 `save-restriction' can get confused if, within the BODY, you widen\n\
2143 and then make changes outside the area within the saved restrictions.\n\
2145 Note: if you are using both `save-excursion' and `save-restriction',\n\
2146 use `save-excursion' outermost:\n\
2147 (save-excursion (save-restriction ...))")
2151 register Lisp_Object val
;
2152 int count
= specpdl_ptr
- specpdl
;
2154 record_unwind_protect (save_restriction_restore
, save_restriction_save ());
2155 val
= Fprogn (body
);
2156 return unbind_to (count
, val
);
2159 /* Buffer for the most recent text displayed by Fmessage. */
2160 static char *message_text
;
2162 /* Allocated length of that buffer. */
2163 static int message_length
;
2165 DEFUN ("message", Fmessage
, Smessage
, 1, MANY
, 0,
2166 "Print a one-line message at the bottom of the screen.\n\
2167 The first argument is a format control string, and the rest are data\n\
2168 to be formatted under control of the string. See `format' for details.\n\
2170 If the first argument is nil, clear any existing message; let the\n\
2171 minibuffer contents show.")
2183 register Lisp_Object val
;
2184 val
= Fformat (nargs
, args
);
2185 /* Copy the data so that it won't move when we GC. */
2188 message_text
= (char *)xmalloc (80);
2189 message_length
= 80;
2191 if (STRING_BYTES (XSTRING (val
)) > message_length
)
2193 message_length
= STRING_BYTES (XSTRING (val
));
2194 message_text
= (char *)xrealloc (message_text
, message_length
);
2196 bcopy (XSTRING (val
)->data
, message_text
, STRING_BYTES (XSTRING (val
)));
2197 message2 (message_text
, STRING_BYTES (XSTRING (val
)),
2198 STRING_MULTIBYTE (val
));
2203 DEFUN ("message-box", Fmessage_box
, Smessage_box
, 1, MANY
, 0,
2204 "Display a message, in a dialog box if possible.\n\
2205 If a dialog box is not available, use the echo area.\n\
2206 The first argument is a format control string, and the rest are data\n\
2207 to be formatted under control of the string. See `format' for details.\n\
2209 If the first argument is nil, clear any existing message; let the\n\
2210 minibuffer contents show.")
2222 register Lisp_Object val
;
2223 val
= Fformat (nargs
, args
);
2226 Lisp_Object pane
, menu
, obj
;
2227 struct gcpro gcpro1
;
2228 pane
= Fcons (Fcons (build_string ("OK"), Qt
), Qnil
);
2230 menu
= Fcons (val
, pane
);
2231 obj
= Fx_popup_dialog (Qt
, menu
);
2235 #else /* not HAVE_MENUS */
2236 /* Copy the data so that it won't move when we GC. */
2239 message_text
= (char *)xmalloc (80);
2240 message_length
= 80;
2242 if (STRING_BYTES (XSTRING (val
)) > message_length
)
2244 message_length
= STRING_BYTES (XSTRING (val
));
2245 message_text
= (char *)xrealloc (message_text
, message_length
);
2247 bcopy (XSTRING (val
)->data
, message_text
, STRING_BYTES (XSTRING (val
)));
2248 message2 (message_text
, STRING_BYTES (XSTRING (val
)),
2249 STRING_MULTIBYTE (val
));
2251 #endif /* not HAVE_MENUS */
2255 extern Lisp_Object last_nonmenu_event
;
2258 DEFUN ("message-or-box", Fmessage_or_box
, Smessage_or_box
, 1, MANY
, 0,
2259 "Display a message in a dialog box or in the echo area.\n\
2260 If this command was invoked with the mouse, use a dialog box.\n\
2261 Otherwise, use the echo area.\n\
2262 The first argument is a format control string, and the rest are data\n\
2263 to be formatted under control of the string. See `format' for details.\n\
2265 If the first argument is nil, clear any existing message; let the\n\
2266 minibuffer contents show.")
2272 if (NILP (last_nonmenu_event
) || CONSP (last_nonmenu_event
))
2273 return Fmessage_box (nargs
, args
);
2275 return Fmessage (nargs
, args
);
2278 DEFUN ("current-message", Fcurrent_message
, Scurrent_message
, 0, 0, 0,
2279 "Return the string currently displayed in the echo area, or nil if none.")
2282 return (echo_area_glyphs
2283 ? make_string (echo_area_glyphs
, echo_area_glyphs_length
)
2287 /* Number of bytes that STRING will occupy when put into the result.
2288 MULTIBYTE is nonzero if the result should be multibyte. */
2290 #define CONVERTED_BYTE_SIZE(MULTIBYTE, STRING) \
2291 (((MULTIBYTE) && ! STRING_MULTIBYTE (STRING)) \
2292 ? count_size_as_multibyte (XSTRING (STRING)->data, \
2293 STRING_BYTES (XSTRING (STRING))) \
2294 : STRING_BYTES (XSTRING (STRING)))
2296 DEFUN ("format", Fformat
, Sformat
, 1, MANY
, 0,
2297 "Format a string out of a control-string and arguments.\n\
2298 The first argument is a control string.\n\
2299 The other arguments are substituted into it to make the result, a string.\n\
2300 It may contain %-sequences meaning to substitute the next argument.\n\
2301 %s means print a string argument. Actually, prints any object, with `princ'.\n\
2302 %d means print as number in decimal (%o octal, %x hex).\n\
2303 %e means print a number in exponential notation.\n\
2304 %f means print a number in decimal-point notation.\n\
2305 %g means print a number in exponential notation\n\
2306 or decimal-point notation, whichever uses fewer characters.\n\
2307 %c means print a number as a single character.\n\
2308 %S means print any object as an s-expression (using prin1).\n\
2309 The argument used for %d, %o, %x, %e, %f, %g or %c must be a number.\n\
2310 Use %% to put a single % into the output.")
2313 register Lisp_Object
*args
;
2315 register int n
; /* The number of the next arg to substitute */
2316 register int total
; /* An estimate of the final length */
2318 register unsigned char *format
, *end
;
2320 /* Nonzero if the output should be a multibyte string,
2321 which is true if any of the inputs is one. */
2323 unsigned char *this_format
;
2327 extern char *index ();
2329 /* It should not be necessary to GCPRO ARGS, because
2330 the caller in the interpreter should take care of that. */
2332 /* Try to determine whether the result should be multibyte.
2333 This is not always right; sometimes the result needs to be multibyte
2334 because of an object that we will pass through prin1,
2335 and in that case, we won't know it here. */
2336 for (n
= 0; n
< nargs
; n
++)
2337 if (STRINGP (args
[n
]) && STRING_MULTIBYTE (args
[n
]))
2340 CHECK_STRING (args
[0], 0);
2342 /* If we start out planning a unibyte result,
2343 and later find it has to be multibyte, we jump back to retry. */
2346 format
= XSTRING (args
[0])->data
;
2347 end
= format
+ STRING_BYTES (XSTRING (args
[0]));
2350 /* Make room in result for all the non-%-codes in the control string. */
2351 total
= 5 + CONVERTED_BYTE_SIZE (multibyte
, args
[0]);
2353 /* Add to TOTAL enough space to hold the converted arguments. */
2356 while (format
!= end
)
2357 if (*format
++ == '%')
2359 int minlen
, thissize
= 0;
2360 unsigned char *this_format_start
= format
- 1;
2362 /* Process a numeric arg and skip it. */
2363 minlen
= atoi (format
);
2367 while ((*format
>= '0' && *format
<= '9')
2368 || *format
== '-' || *format
== ' ' || *format
== '.')
2371 if (format
- this_format_start
+ 1 > longest_format
)
2372 longest_format
= format
- this_format_start
+ 1;
2376 else if (++n
>= nargs
)
2377 error ("Not enough arguments for format string");
2378 else if (*format
== 'S')
2380 /* For `S', prin1 the argument and then treat like a string. */
2381 register Lisp_Object tem
;
2382 tem
= Fprin1_to_string (args
[n
], Qnil
);
2383 if (STRING_MULTIBYTE (tem
) && ! multibyte
)
2391 else if (SYMBOLP (args
[n
]))
2393 XSETSTRING (args
[n
], XSYMBOL (args
[n
])->name
);
2394 if (STRING_MULTIBYTE (args
[n
]) && ! multibyte
)
2401 else if (STRINGP (args
[n
]))
2404 if (*format
!= 's' && *format
!= 'S')
2405 error ("format specifier doesn't match argument type");
2406 thissize
= CONVERTED_BYTE_SIZE (multibyte
, args
[n
]);
2408 /* Would get MPV otherwise, since Lisp_Int's `point' to low memory. */
2409 else if (INTEGERP (args
[n
]) && *format
!= 's')
2411 #ifdef LISP_FLOAT_TYPE
2412 /* The following loop assumes the Lisp type indicates
2413 the proper way to pass the argument.
2414 So make sure we have a flonum if the argument should
2416 if (*format
== 'e' || *format
== 'f' || *format
== 'g')
2417 args
[n
] = Ffloat (args
[n
]);
2421 && (! SINGLE_BYTE_CHAR_P (XINT (args
[n
]))
2422 || XINT (args
[n
]) == 0))
2429 args
[n
] = Fchar_to_string (args
[n
]);
2430 thissize
= STRING_BYTES (XSTRING (args
[n
]));
2433 #ifdef LISP_FLOAT_TYPE
2434 else if (FLOATP (args
[n
]) && *format
!= 's')
2436 if (! (*format
== 'e' || *format
== 'f' || *format
== 'g'))
2437 args
[n
] = Ftruncate (args
[n
], Qnil
);
2443 /* Anything but a string, convert to a string using princ. */
2444 register Lisp_Object tem
;
2445 tem
= Fprin1_to_string (args
[n
], Qt
);
2446 if (STRING_MULTIBYTE (tem
) & ! multibyte
)
2455 if (thissize
< minlen
)
2458 total
+= thissize
+ 4;
2461 /* Now we can no longer jump to retry.
2462 TOTAL and LONGEST_FORMAT are known for certain. */
2464 this_format
= (unsigned char *) alloca (longest_format
+ 1);
2466 /* Allocate the space for the result.
2467 Note that TOTAL is an overestimate. */
2469 buf
= (char *) alloca (total
+ 1);
2471 buf
= (char *) xmalloc (total
+ 1);
2477 /* Scan the format and store result in BUF. */
2478 format
= XSTRING (args
[0])->data
;
2479 while (format
!= end
)
2485 unsigned char *this_format_start
= format
;
2489 /* Process a numeric arg and skip it. */
2490 minlen
= atoi (format
);
2492 minlen
= - minlen
, negative
= 1;
2494 while ((*format
>= '0' && *format
<= '9')
2495 || *format
== '-' || *format
== ' ' || *format
== '.')
2498 if (*format
++ == '%')
2507 if (STRINGP (args
[n
]))
2509 int padding
, nbytes
;
2510 int width
= strwidth (XSTRING (args
[n
])->data
,
2511 STRING_BYTES (XSTRING (args
[n
])));
2513 /* If spec requires it, pad on right with spaces. */
2514 padding
= minlen
- width
;
2516 while (padding
-- > 0)
2522 nbytes
= copy_text (XSTRING (args
[n
])->data
, p
,
2523 STRING_BYTES (XSTRING (args
[n
])),
2524 STRING_MULTIBYTE (args
[n
]), multibyte
);
2526 nchars
+= XSTRING (args
[n
])->size
;
2529 while (padding
-- > 0)
2535 else if (INTEGERP (args
[n
]) || FLOATP (args
[n
]))
2539 bcopy (this_format_start
, this_format
,
2540 format
- this_format_start
);
2541 this_format
[format
- this_format_start
] = 0;
2543 if (INTEGERP (args
[n
]))
2544 sprintf (p
, this_format
, XINT (args
[n
]));
2546 sprintf (p
, this_format
, XFLOAT (args
[n
])->data
);
2548 this_nchars
= strlen (p
);
2550 nchars
+= this_nchars
;
2553 else if (STRING_MULTIBYTE (args
[0]))
2555 /* Copy a whole multibyte character. */
2557 while (! CHAR_HEAD_P (*format
)) *p
++ = *format
++;
2562 /* Convert a single-byte character to multibyte. */
2563 int len
= copy_text (format
, p
, 1, 0, 1);
2570 *p
++ = *format
++, nchars
++;
2573 val
= make_specified_string (buf
, nchars
, p
- buf
, multibyte
);
2575 /* If we allocated BUF with malloc, free it too. */
2585 format1 (string1
, arg0
, arg1
, arg2
, arg3
, arg4
)
2586 EMACS_INT arg0
, arg1
, arg2
, arg3
, arg4
;
2600 doprnt (buf
, sizeof buf
, string1
, (char *)0, 5, (char **) args
);
2602 doprnt (buf
, sizeof buf
, string1
, (char *)0, 5, &string1
+ 1);
2604 return build_string (buf
);
2607 DEFUN ("char-equal", Fchar_equal
, Schar_equal
, 2, 2, 0,
2608 "Return t if two characters match, optionally ignoring case.\n\
2609 Both arguments must be characters (i.e. integers).\n\
2610 Case is ignored if `case-fold-search' is non-nil in the current buffer.")
2612 register Lisp_Object c1
, c2
;
2615 CHECK_NUMBER (c1
, 0);
2616 CHECK_NUMBER (c2
, 1);
2618 if (XINT (c1
) == XINT (c2
))
2620 if (NILP (current_buffer
->case_fold_search
))
2623 /* Do these in separate statements,
2624 then compare the variables.
2625 because of the way DOWNCASE uses temp variables. */
2626 i1
= DOWNCASE (XFASTINT (c1
));
2627 i2
= DOWNCASE (XFASTINT (c2
));
2628 return (i1
== i2
? Qt
: Qnil
);
2631 /* Transpose the markers in two regions of the current buffer, and
2632 adjust the ones between them if necessary (i.e.: if the regions
2635 START1, END1 are the character positions of the first region.
2636 START1_BYTE, END1_BYTE are the byte positions.
2637 START2, END2 are the character positions of the second region.
2638 START2_BYTE, END2_BYTE are the byte positions.
2640 Traverses the entire marker list of the buffer to do so, adding an
2641 appropriate amount to some, subtracting from some, and leaving the
2642 rest untouched. Most of this is copied from adjust_markers in insdel.c.
2644 It's the caller's job to ensure that START1 <= END1 <= START2 <= END2. */
2647 transpose_markers (start1
, end1
, start2
, end2
,
2648 start1_byte
, end1_byte
, start2_byte
, end2_byte
)
2649 register int start1
, end1
, start2
, end2
;
2650 register int start1_byte
, end1_byte
, start2_byte
, end2_byte
;
2652 register int amt1
, amt1_byte
, amt2
, amt2_byte
, diff
, diff_byte
, mpos
;
2653 register Lisp_Object marker
;
2655 /* Update point as if it were a marker. */
2659 TEMP_SET_PT_BOTH (PT
+ (end2
- end1
),
2660 PT_BYTE
+ (end2_byte
- end1_byte
));
2661 else if (PT
< start2
)
2662 TEMP_SET_PT_BOTH (PT
+ (end2
- start2
) - (end1
- start1
),
2663 (PT_BYTE
+ (end2_byte
- start2_byte
)
2664 - (end1_byte
- start1_byte
)));
2666 TEMP_SET_PT_BOTH (PT
- (start2
- start1
),
2667 PT_BYTE
- (start2_byte
- start1_byte
));
2669 /* We used to adjust the endpoints here to account for the gap, but that
2670 isn't good enough. Even if we assume the caller has tried to move the
2671 gap out of our way, it might still be at start1 exactly, for example;
2672 and that places it `inside' the interval, for our purposes. The amount
2673 of adjustment is nontrivial if there's a `denormalized' marker whose
2674 position is between GPT and GPT + GAP_SIZE, so it's simpler to leave
2675 the dirty work to Fmarker_position, below. */
2677 /* The difference between the region's lengths */
2678 diff
= (end2
- start2
) - (end1
- start1
);
2679 diff_byte
= (end2_byte
- start2_byte
) - (end1_byte
- start1_byte
);
2681 /* For shifting each marker in a region by the length of the other
2682 region plus the distance between the regions. */
2683 amt1
= (end2
- start2
) + (start2
- end1
);
2684 amt2
= (end1
- start1
) + (start2
- end1
);
2685 amt1_byte
= (end2_byte
- start2_byte
) + (start2_byte
- end1_byte
);
2686 amt2_byte
= (end1_byte
- start1_byte
) + (start2_byte
- end1_byte
);
2688 for (marker
= BUF_MARKERS (current_buffer
); !NILP (marker
);
2689 marker
= XMARKER (marker
)->chain
)
2691 mpos
= marker_byte_position (marker
);
2692 if (mpos
>= start1_byte
&& mpos
< end2_byte
)
2694 if (mpos
< end1_byte
)
2696 else if (mpos
< start2_byte
)
2700 XMARKER (marker
)->bytepos
= mpos
;
2702 mpos
= XMARKER (marker
)->charpos
;
2703 if (mpos
>= start1
&& mpos
< end2
)
2707 else if (mpos
< start2
)
2712 XMARKER (marker
)->charpos
= mpos
;
2716 DEFUN ("transpose-regions", Ftranspose_regions
, Stranspose_regions
, 4, 5, 0,
2717 "Transpose region START1 to END1 with START2 to END2.\n\
2718 The regions may not be overlapping, because the size of the buffer is\n\
2719 never changed in a transposition.\n\
2721 Optional fifth arg LEAVE_MARKERS, if non-nil, means don't update\n\
2722 any markers that happen to be located in the regions.\n\
2724 Transposing beyond buffer boundaries is an error.")
2725 (startr1
, endr1
, startr2
, endr2
, leave_markers
)
2726 Lisp_Object startr1
, endr1
, startr2
, endr2
, leave_markers
;
2728 register int start1
, end1
, start2
, end2
;
2729 int start1_byte
, start2_byte
, len1_byte
, len2_byte
;
2730 int gap
, len1
, len_mid
, len2
;
2731 unsigned char *start1_addr
, *start2_addr
, *temp
;
2732 int combined_before_bytes_1
, combined_after_bytes_1
;
2733 int combined_before_bytes_2
, combined_after_bytes_2
;
2734 struct gcpro gcpro1
, gcpro2
;
2736 #ifdef USE_TEXT_PROPERTIES
2737 INTERVAL cur_intv
, tmp_interval1
, tmp_interval_mid
, tmp_interval2
;
2738 cur_intv
= BUF_INTERVALS (current_buffer
);
2739 #endif /* USE_TEXT_PROPERTIES */
2741 validate_region (&startr1
, &endr1
);
2742 validate_region (&startr2
, &endr2
);
2744 start1
= XFASTINT (startr1
);
2745 end1
= XFASTINT (endr1
);
2746 start2
= XFASTINT (startr2
);
2747 end2
= XFASTINT (endr2
);
2750 /* Swap the regions if they're reversed. */
2753 register int glumph
= start1
;
2761 len1
= end1
- start1
;
2762 len2
= end2
- start2
;
2765 error ("Transposed regions overlap");
2766 else if (start1
== end1
|| start2
== end2
)
2767 error ("Transposed region has length 0");
2769 /* The possibilities are:
2770 1. Adjacent (contiguous) regions, or separate but equal regions
2771 (no, really equal, in this case!), or
2772 2. Separate regions of unequal size.
2774 The worst case is usually No. 2. It means that (aside from
2775 potential need for getting the gap out of the way), there also
2776 needs to be a shifting of the text between the two regions. So
2777 if they are spread far apart, we are that much slower... sigh. */
2779 /* It must be pointed out that the really studly thing to do would
2780 be not to move the gap at all, but to leave it in place and work
2781 around it if necessary. This would be extremely efficient,
2782 especially considering that people are likely to do
2783 transpositions near where they are working interactively, which
2784 is exactly where the gap would be found. However, such code
2785 would be much harder to write and to read. So, if you are
2786 reading this comment and are feeling squirrely, by all means have
2787 a go! I just didn't feel like doing it, so I will simply move
2788 the gap the minimum distance to get it out of the way, and then
2789 deal with an unbroken array. */
2791 /* Make sure the gap won't interfere, by moving it out of the text
2792 we will operate on. */
2793 if (start1
< gap
&& gap
< end2
)
2795 if (gap
- start1
< end2
- gap
)
2801 start1_byte
= CHAR_TO_BYTE (start1
);
2802 start2_byte
= CHAR_TO_BYTE (start2
);
2803 len1_byte
= CHAR_TO_BYTE (end1
) - start1_byte
;
2804 len2_byte
= CHAR_TO_BYTE (end2
) - start2_byte
;
2808 combined_before_bytes_2
2809 = count_combining_before (BYTE_POS_ADDR (start2_byte
),
2810 len2_byte
, start1
, start1_byte
);
2811 combined_before_bytes_1
2812 = count_combining_before (BYTE_POS_ADDR (start1_byte
),
2813 len1_byte
, end2
, start2_byte
+ len2_byte
);
2814 combined_after_bytes_1
2815 = count_combining_after (BYTE_POS_ADDR (start1_byte
),
2816 len1_byte
, end2
, start2_byte
+ len2_byte
);
2817 combined_after_bytes_2
= 0;
2821 combined_before_bytes_2
2822 = count_combining_before (BYTE_POS_ADDR (start2_byte
),
2823 len2_byte
, start1
, start1_byte
);
2824 combined_before_bytes_1
2825 = count_combining_before (BYTE_POS_ADDR (start1_byte
),
2826 len1_byte
, start2
, start2_byte
);
2827 combined_after_bytes_2
2828 = count_combining_after (BYTE_POS_ADDR (start2_byte
),
2829 len2_byte
, end1
, start1_byte
+ len1_byte
);
2830 combined_after_bytes_1
2831 = count_combining_after (BYTE_POS_ADDR (start1_byte
),
2832 len1_byte
, end2
, start2_byte
+ len2_byte
);
2835 /* If any combining is going to happen, do this the stupid way,
2836 because replace handles combining properly. */
2837 if (combined_before_bytes_1
|| combined_before_bytes_2
2838 || combined_after_bytes_1
|| combined_after_bytes_2
)
2840 Lisp_Object text1
, text2
;
2842 text1
= text2
= Qnil
;
2843 GCPRO2 (text1
, text2
);
2845 text1
= make_buffer_string_both (start1
, start1_byte
,
2846 end1
, start1_byte
+ len1_byte
, 1);
2847 text2
= make_buffer_string_both (start2
, start2_byte
,
2848 end2
, start2_byte
+ len2_byte
, 1);
2850 transpose_markers (start1
, end1
, start2
, end2
,
2851 start1_byte
, start1_byte
+ len1_byte
,
2852 start2_byte
, start2_byte
+ len2_byte
);
2854 replace_range (start2
, end2
, text1
, 1, 0, 1);
2855 replace_range (start1
, end1
, text2
, 1, 0, 1);
2861 /* Hmmm... how about checking to see if the gap is large
2862 enough to use as the temporary storage? That would avoid an
2863 allocation... interesting. Later, don't fool with it now. */
2865 /* Working without memmove, for portability (sigh), so must be
2866 careful of overlapping subsections of the array... */
2868 if (end1
== start2
) /* adjacent regions */
2870 modify_region (current_buffer
, start1
, end2
);
2871 record_change (start1
, len1
+ len2
);
2873 #ifdef USE_TEXT_PROPERTIES
2874 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2875 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2876 Fset_text_properties (make_number (start1
), make_number (end2
),
2878 #endif /* USE_TEXT_PROPERTIES */
2880 /* First region smaller than second. */
2881 if (len1_byte
< len2_byte
)
2883 /* We use alloca only if it is small,
2884 because we want to avoid stack overflow. */
2885 if (len2_byte
> 20000)
2886 temp
= (unsigned char *) xmalloc (len2_byte
);
2888 temp
= (unsigned char *) alloca (len2_byte
);
2890 /* Don't precompute these addresses. We have to compute them
2891 at the last minute, because the relocating allocator might
2892 have moved the buffer around during the xmalloc. */
2893 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1_byte
);
2894 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2_byte
);
2896 bcopy (start2_addr
, temp
, len2_byte
);
2897 bcopy (start1_addr
, start1_addr
+ len2_byte
, len1_byte
);
2898 bcopy (temp
, start1_addr
, len2_byte
);
2899 if (len2_byte
> 20000)
2903 /* First region not smaller than second. */
2905 if (len1_byte
> 20000)
2906 temp
= (unsigned char *) xmalloc (len1_byte
);
2908 temp
= (unsigned char *) alloca (len1_byte
);
2909 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1_byte
);
2910 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2_byte
);
2911 bcopy (start1_addr
, temp
, len1_byte
);
2912 bcopy (start2_addr
, start1_addr
, len2_byte
);
2913 bcopy (temp
, start1_addr
+ len2_byte
, len1_byte
);
2914 if (len1_byte
> 20000)
2917 #ifdef USE_TEXT_PROPERTIES
2918 graft_intervals_into_buffer (tmp_interval1
, start1
+ len2
,
2919 len1
, current_buffer
, 0);
2920 graft_intervals_into_buffer (tmp_interval2
, start1
,
2921 len2
, current_buffer
, 0);
2922 #endif /* USE_TEXT_PROPERTIES */
2924 /* Non-adjacent regions, because end1 != start2, bleagh... */
2927 len_mid
= start2_byte
- (start1_byte
+ len1_byte
);
2929 if (len1_byte
== len2_byte
)
2930 /* Regions are same size, though, how nice. */
2932 modify_region (current_buffer
, start1
, end1
);
2933 modify_region (current_buffer
, start2
, end2
);
2934 record_change (start1
, len1
);
2935 record_change (start2
, len2
);
2936 #ifdef USE_TEXT_PROPERTIES
2937 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2938 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2939 Fset_text_properties (make_number (start1
), make_number (end1
),
2941 Fset_text_properties (make_number (start2
), make_number (end2
),
2943 #endif /* USE_TEXT_PROPERTIES */
2945 if (len1_byte
> 20000)
2946 temp
= (unsigned char *) xmalloc (len1_byte
);
2948 temp
= (unsigned char *) alloca (len1_byte
);
2949 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1_byte
);
2950 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2_byte
);
2951 bcopy (start1_addr
, temp
, len1_byte
);
2952 bcopy (start2_addr
, start1_addr
, len2_byte
);
2953 bcopy (temp
, start2_addr
, len1_byte
);
2954 if (len1_byte
> 20000)
2956 #ifdef USE_TEXT_PROPERTIES
2957 graft_intervals_into_buffer (tmp_interval1
, start2
,
2958 len1
, current_buffer
, 0);
2959 graft_intervals_into_buffer (tmp_interval2
, start1
,
2960 len2
, current_buffer
, 0);
2961 #endif /* USE_TEXT_PROPERTIES */
2964 else if (len1_byte
< len2_byte
) /* Second region larger than first */
2965 /* Non-adjacent & unequal size, area between must also be shifted. */
2967 modify_region (current_buffer
, start1
, end2
);
2968 record_change (start1
, (end2
- start1
));
2969 #ifdef USE_TEXT_PROPERTIES
2970 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2971 tmp_interval_mid
= copy_intervals (cur_intv
, end1
, len_mid
);
2972 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2973 Fset_text_properties (make_number (start1
), make_number (end2
),
2975 #endif /* USE_TEXT_PROPERTIES */
2977 /* holds region 2 */
2978 if (len2_byte
> 20000)
2979 temp
= (unsigned char *) xmalloc (len2_byte
);
2981 temp
= (unsigned char *) alloca (len2_byte
);
2982 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1_byte
);
2983 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2_byte
);
2984 bcopy (start2_addr
, temp
, len2_byte
);
2985 bcopy (start1_addr
, start1_addr
+ len_mid
+ len2_byte
, len1_byte
);
2986 safe_bcopy (start1_addr
+ len1_byte
, start1_addr
+ len2_byte
, len_mid
);
2987 bcopy (temp
, start1_addr
, len2_byte
);
2988 if (len2_byte
> 20000)
2990 #ifdef USE_TEXT_PROPERTIES
2991 graft_intervals_into_buffer (tmp_interval1
, end2
- len1
,
2992 len1
, current_buffer
, 0);
2993 graft_intervals_into_buffer (tmp_interval_mid
, start1
+ len2
,
2994 len_mid
, current_buffer
, 0);
2995 graft_intervals_into_buffer (tmp_interval2
, start1
,
2996 len2
, current_buffer
, 0);
2997 #endif /* USE_TEXT_PROPERTIES */
3000 /* Second region smaller than first. */
3002 record_change (start1
, (end2
- start1
));
3003 modify_region (current_buffer
, start1
, end2
);
3005 #ifdef USE_TEXT_PROPERTIES
3006 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
3007 tmp_interval_mid
= copy_intervals (cur_intv
, end1
, len_mid
);
3008 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
3009 Fset_text_properties (make_number (start1
), make_number (end2
),
3011 #endif /* USE_TEXT_PROPERTIES */
3013 /* holds region 1 */
3014 if (len1_byte
> 20000)
3015 temp
= (unsigned char *) xmalloc (len1_byte
);
3017 temp
= (unsigned char *) alloca (len1_byte
);
3018 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1_byte
);
3019 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2_byte
);
3020 bcopy (start1_addr
, temp
, len1_byte
);
3021 bcopy (start2_addr
, start1_addr
, len2_byte
);
3022 bcopy (start1_addr
+ len1_byte
, start1_addr
+ len2_byte
, len_mid
);
3023 bcopy (temp
, start1_addr
+ len2_byte
+ len_mid
, len1_byte
);
3024 if (len1_byte
> 20000)
3026 #ifdef USE_TEXT_PROPERTIES
3027 graft_intervals_into_buffer (tmp_interval1
, end2
- len1
,
3028 len1
, current_buffer
, 0);
3029 graft_intervals_into_buffer (tmp_interval_mid
, start1
+ len2
,
3030 len_mid
, current_buffer
, 0);
3031 graft_intervals_into_buffer (tmp_interval2
, start1
,
3032 len2
, current_buffer
, 0);
3033 #endif /* USE_TEXT_PROPERTIES */
3037 /* When doing multiple transpositions, it might be nice
3038 to optimize this. Perhaps the markers in any one buffer
3039 should be organized in some sorted data tree. */
3040 if (NILP (leave_markers
))
3042 transpose_markers (start1
, end1
, start2
, end2
,
3043 start1_byte
, start1_byte
+ len1_byte
,
3044 start2_byte
, start2_byte
+ len2_byte
);
3045 fix_overlays_in_range (start1
, end2
);
3057 Qbuffer_access_fontify_functions
3058 = intern ("buffer-access-fontify-functions");
3059 staticpro (&Qbuffer_access_fontify_functions
);
3061 DEFVAR_LISP ("buffer-access-fontify-functions",
3062 &Vbuffer_access_fontify_functions
,
3063 "List of functions called by `buffer-substring' to fontify if necessary.\n\
3064 Each function is called with two arguments which specify the range\n\
3065 of the buffer being accessed.");
3066 Vbuffer_access_fontify_functions
= Qnil
;
3070 extern Lisp_Object Vprin1_to_string_buffer
;
3071 obuf
= Fcurrent_buffer ();
3072 /* Do this here, because init_buffer_once is too early--it won't work. */
3073 Fset_buffer (Vprin1_to_string_buffer
);
3074 /* Make sure buffer-access-fontify-functions is nil in this buffer. */
3075 Fset (Fmake_local_variable (intern ("buffer-access-fontify-functions")),
3080 DEFVAR_LISP ("buffer-access-fontified-property",
3081 &Vbuffer_access_fontified_property
,
3082 "Property which (if non-nil) indicates text has been fontified.\n\
3083 `buffer-substring' need not call the `buffer-access-fontify-functions'\n\
3084 functions if all the text being accessed has this property.");
3085 Vbuffer_access_fontified_property
= Qnil
;
3087 DEFVAR_LISP ("system-name", &Vsystem_name
,
3088 "The name of the machine Emacs is running on.");
3090 DEFVAR_LISP ("user-full-name", &Vuser_full_name
,
3091 "The full name of the user logged in.");
3093 DEFVAR_LISP ("user-login-name", &Vuser_login_name
,
3094 "The user's name, taken from environment variables if possible.");
3096 DEFVAR_LISP ("user-real-login-name", &Vuser_real_login_name
,
3097 "The user's name, based upon the real uid only.");
3099 defsubr (&Schar_equal
);
3100 defsubr (&Sgoto_char
);
3101 defsubr (&Sstring_to_char
);
3102 defsubr (&Schar_to_string
);
3103 defsubr (&Sbuffer_substring
);
3104 defsubr (&Sbuffer_substring_no_properties
);
3105 defsubr (&Sbuffer_string
);
3107 defsubr (&Spoint_marker
);
3108 defsubr (&Smark_marker
);
3110 defsubr (&Sregion_beginning
);
3111 defsubr (&Sregion_end
);
3113 defsubr (&Sline_beginning_position
);
3114 defsubr (&Sline_end_position
);
3116 /* defsubr (&Smark); */
3117 /* defsubr (&Sset_mark); */
3118 defsubr (&Ssave_excursion
);
3119 defsubr (&Ssave_current_buffer
);
3121 defsubr (&Sbufsize
);
3122 defsubr (&Spoint_max
);
3123 defsubr (&Spoint_min
);
3124 defsubr (&Spoint_min_marker
);
3125 defsubr (&Spoint_max_marker
);
3126 defsubr (&Sgap_position
);
3127 defsubr (&Sgap_size
);
3128 defsubr (&Sposition_bytes
);
3129 defsubr (&Sbyte_to_position
);
3135 defsubr (&Sfollowing_char
);
3136 defsubr (&Sprevious_char
);
3137 defsubr (&Schar_after
);
3138 defsubr (&Schar_before
);
3140 defsubr (&Sinsert_before_markers
);
3141 defsubr (&Sinsert_and_inherit
);
3142 defsubr (&Sinsert_and_inherit_before_markers
);
3143 defsubr (&Sinsert_char
);
3145 defsubr (&Suser_login_name
);
3146 defsubr (&Suser_real_login_name
);
3147 defsubr (&Suser_uid
);
3148 defsubr (&Suser_real_uid
);
3149 defsubr (&Suser_full_name
);
3150 defsubr (&Semacs_pid
);
3151 defsubr (&Scurrent_time
);
3152 defsubr (&Sformat_time_string
);
3153 defsubr (&Sdecode_time
);
3154 defsubr (&Sencode_time
);
3155 defsubr (&Scurrent_time_string
);
3156 defsubr (&Scurrent_time_zone
);
3157 defsubr (&Sset_time_zone_rule
);
3158 defsubr (&Ssystem_name
);
3159 defsubr (&Smessage
);
3160 defsubr (&Smessage_box
);
3161 defsubr (&Smessage_or_box
);
3162 defsubr (&Scurrent_message
);
3165 defsubr (&Sinsert_buffer_substring
);
3166 defsubr (&Scompare_buffer_substrings
);
3167 defsubr (&Ssubst_char_in_region
);
3168 defsubr (&Stranslate_region
);
3169 defsubr (&Sdelete_region
);
3171 defsubr (&Snarrow_to_region
);
3172 defsubr (&Ssave_restriction
);
3173 defsubr (&Stranspose_regions
);