1 /* Lisp functions pertaining to editing.
2 Copyright (C) 1985,86,87,89,93,94,95 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 1, 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, 675 Mass Ave, Cambridge, MA 02139, USA. */
21 #include <sys/types.h>
32 #include "intervals.h"
38 #define min(a, b) ((a) < (b) ? (a) : (b))
39 #define max(a, b) ((a) > (b) ? (a) : (b))
41 extern void insert_from_buffer ();
42 static long difftm ();
44 /* Some static data, and a function to initialize it for each run */
46 Lisp_Object Vsystem_name
;
47 Lisp_Object Vuser_real_name
; /* login name of current user ID */
48 Lisp_Object Vuser_full_name
; /* full name of current user */
49 Lisp_Object Vuser_name
; /* user name from LOGNAME or USER */
55 register unsigned char *p
, *q
, *r
;
56 struct passwd
*pw
; /* password entry for the current user */
57 extern char *index ();
60 /* Set up system_name even when dumping. */
64 /* Don't bother with this on initial start when just dumping out */
67 #endif /* not CANNOT_DUMP */
69 pw
= (struct passwd
*) getpwuid (getuid ());
71 /* We let the real user name default to "root" because that's quite
72 accurate on MSDOG and because it lets Emacs find the init file.
73 (The DVX libraries override the Djgpp libraries here.) */
74 Vuser_real_name
= build_string (pw
? pw
->pw_name
: "root");
76 Vuser_real_name
= build_string (pw
? pw
->pw_name
: "unknown");
79 /* Get the effective user name, by consulting environment variables,
80 or the effective uid if those are unset. */
81 user_name
= (char *) getenv ("LOGNAME");
84 user_name
= (char *) getenv ("USERNAME"); /* it's USERNAME on NT */
86 user_name
= (char *) getenv ("USER");
87 #endif /* WINDOWSNT */
90 pw
= (struct passwd
*) getpwuid (geteuid ());
91 user_name
= (char *) (pw
? pw
->pw_name
: "unknown");
93 Vuser_name
= build_string (user_name
);
95 /* If the user name claimed in the environment vars differs from
96 the real uid, use the claimed name to find the full name. */
97 tem
= Fstring_equal (Vuser_name
, Vuser_real_name
);
99 pw
= (struct passwd
*) getpwnam (XSTRING (Vuser_name
)->data
);
101 p
= (unsigned char *) (pw
? USER_FULL_NAME
: "unknown");
102 q
= (unsigned char *) index (p
, ',');
103 Vuser_full_name
= make_string (p
, q
? q
- p
: strlen (p
));
105 #ifdef AMPERSAND_FULL_NAME
106 p
= XSTRING (Vuser_full_name
)->data
;
107 q
= (unsigned char *) index (p
, '&');
108 /* Substitute the login name for the &, upcasing the first character. */
111 r
= (unsigned char *) alloca (strlen (p
) + XSTRING (Vuser_name
)->size
+ 1);
114 strcat (r
, XSTRING (Vuser_name
)->data
);
115 r
[q
- p
] = UPCASE (r
[q
- p
]);
117 Vuser_full_name
= build_string (r
);
119 #endif /* AMPERSAND_FULL_NAME */
121 p
= (unsigned char *) getenv ("NAME");
123 Vuser_full_name
= build_string (p
);
126 DEFUN ("char-to-string", Fchar_to_string
, Schar_to_string
, 1, 1, 0,
127 "Convert arg CHAR to a one-character string containing that character.")
135 return make_string (&c
, 1);
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.")
141 register Lisp_Object str
;
143 register Lisp_Object val
;
144 register struct Lisp_String
*p
;
145 CHECK_STRING (str
, 0);
149 XSETFASTINT (val
, ((unsigned char *) p
->data
)[0]);
151 XSETFASTINT (val
, 0);
159 register Lisp_Object mark
;
160 mark
= Fmake_marker ();
161 Fset_marker (mark
, make_number (val
), Qnil
);
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
, point
);
175 DEFUN ("point-marker", Fpoint_marker
, Spoint_marker
, 0, 0, 0,
176 "Return value of point, as a marker object.")
179 return buildmark (point
);
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).")
198 register Lisp_Object n
;
200 CHECK_NUMBER_COERCE_MARKER (n
, 0);
202 SET_PT (clip_to_bounds (BEGV
, XINT (n
), ZV
));
207 region_limit (beginningp
)
210 extern Lisp_Object Vmark_even_if_inactive
; /* Defined in callint.c. */
211 register Lisp_Object m
;
212 if (!NILP (Vtransient_mark_mode
) && NILP (Vmark_even_if_inactive
)
213 && NILP (current_buffer
->mark_active
))
214 Fsignal (Qmark_inactive
, Qnil
);
215 m
= Fmarker_position (current_buffer
->mark
);
216 if (NILP (m
)) error ("There is no region now");
217 if ((point
< XFASTINT (m
)) == beginningp
)
218 return (make_number (point
));
223 DEFUN ("region-beginning", Fregion_beginning
, Sregion_beginning
, 0, 0, 0,
224 "Return position of beginning of region, as an integer.")
227 return (region_limit (1));
230 DEFUN ("region-end", Fregion_end
, Sregion_end
, 0, 0, 0,
231 "Return position of end of region, as an integer.")
234 return (region_limit (0));
237 #if 0 /* now in lisp code */
238 DEFUN ("mark", Fmark
, Smark
, 0, 0, 0,
239 "Return this buffer's mark value as integer, or nil if no mark.\n\
240 If you are using this in an editing command, you are most likely making\n\
241 a mistake; see the documentation of `set-mark'.")
244 return Fmarker_position (current_buffer
->mark
);
246 #endif /* commented out code */
248 DEFUN ("mark-marker", Fmark_marker
, Smark_marker
, 0, 0, 0,
249 "Return this buffer's mark, as a marker object.\n\
250 Watch out! Moving this marker changes the mark position.\n\
251 If you set the marker not to point anywhere, the buffer will have no mark.")
254 return current_buffer
->mark
;
257 #if 0 /* this is now in lisp code */
258 DEFUN ("set-mark", Fset_mark
, Sset_mark
, 1, 1, 0,
259 "Set this buffer's mark to POS. Don't use this function!\n\
260 That is to say, don't use this function unless you want\n\
261 the user to see that the mark has moved, and you want the previous\n\
262 mark position to be lost.\n\
264 Normally, when a new mark is set, the old one should go on the stack.\n\
265 This is why most applications should use push-mark, not set-mark.\n\
267 Novice programmers often try to use the mark for the wrong purposes.\n\
268 The mark saves a location for the user's convenience.\n\
269 Most editing commands should not alter the mark.\n\
270 To remember a location for internal use in the Lisp program,\n\
271 store it in a Lisp variable. Example:\n\
273 (let ((beg (point))) (forward-line 1) (delete-region beg (point))).")
279 current_buffer
->mark
= Qnil
;
282 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
284 if (NILP (current_buffer
->mark
))
285 current_buffer
->mark
= Fmake_marker ();
287 Fset_marker (current_buffer
->mark
, pos
, Qnil
);
290 #endif /* commented-out code */
293 save_excursion_save ()
295 register int visible
= (XBUFFER (XWINDOW (selected_window
)->buffer
)
298 return Fcons (Fpoint_marker (),
299 Fcons (Fcopy_marker (current_buffer
->mark
),
300 Fcons (visible
? Qt
: Qnil
,
301 current_buffer
->mark_active
)));
305 save_excursion_restore (info
)
306 register Lisp_Object info
;
308 register Lisp_Object tem
, tem1
, omark
, nmark
;
310 tem
= Fmarker_buffer (Fcar (info
));
311 /* If buffer being returned to is now deleted, avoid error */
312 /* Otherwise could get error here while unwinding to top level
314 /* In that case, Fmarker_buffer returns nil now. */
320 unchain_marker (tem
);
321 tem
= Fcar (Fcdr (info
));
322 omark
= Fmarker_position (current_buffer
->mark
);
323 Fset_marker (current_buffer
->mark
, tem
, Fcurrent_buffer ());
324 nmark
= Fmarker_position (tem
);
325 unchain_marker (tem
);
326 tem
= Fcdr (Fcdr (info
));
327 #if 0 /* We used to make the current buffer visible in the selected window
328 if that was true previously. That avoids some anomalies.
329 But it creates others, and it wasn't documented, and it is simpler
330 and cleaner never to alter the window/buffer connections. */
333 && current_buffer
!= XBUFFER (XWINDOW (selected_window
)->buffer
))
334 Fswitch_to_buffer (Fcurrent_buffer (), Qnil
);
337 tem1
= current_buffer
->mark_active
;
338 current_buffer
->mark_active
= Fcdr (tem
);
339 if (!NILP (Vrun_hooks
))
341 /* If mark is active now, and either was not active
342 or was at a different place, run the activate hook. */
343 if (! NILP (current_buffer
->mark_active
))
345 if (! EQ (omark
, nmark
))
346 call1 (Vrun_hooks
, intern ("activate-mark-hook"));
348 /* If mark has ceased to be active, run deactivate hook. */
349 else if (! NILP (tem1
))
350 call1 (Vrun_hooks
, intern ("deactivate-mark-hook"));
355 DEFUN ("save-excursion", Fsave_excursion
, Ssave_excursion
, 0, UNEVALLED
, 0,
356 "Save point, mark, and current buffer; execute BODY; restore those things.\n\
357 Executes BODY just like `progn'.\n\
358 The values of point, mark and the current buffer are restored\n\
359 even in case of abnormal exit (throw or error).\n\
360 The state of activation of the mark is also restored.")
364 register Lisp_Object val
;
365 int count
= specpdl_ptr
- specpdl
;
367 record_unwind_protect (save_excursion_restore
, save_excursion_save ());
370 return unbind_to (count
, val
);
373 DEFUN ("buffer-size", Fbufsize
, Sbufsize
, 0, 0, 0,
374 "Return the number of characters in the current buffer.")
378 XSETFASTINT (temp
, Z
- BEG
);
382 DEFUN ("point-min", Fpoint_min
, Spoint_min
, 0, 0, 0,
383 "Return the minimum permissible value of point in the current buffer.\n\
384 This is 1, unless narrowing (a buffer restriction) is in effect.")
388 XSETFASTINT (temp
, BEGV
);
392 DEFUN ("point-min-marker", Fpoint_min_marker
, Spoint_min_marker
, 0, 0, 0,
393 "Return a marker to the minimum permissible value of point in this buffer.\n\
394 This is the beginning, unless narrowing (a buffer restriction) is in effect.")
397 return buildmark (BEGV
);
400 DEFUN ("point-max", Fpoint_max
, Spoint_max
, 0, 0, 0,
401 "Return the maximum permissible value of point in the current buffer.\n\
402 This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
403 is in effect, in which case it is less.")
407 XSETFASTINT (temp
, ZV
);
411 DEFUN ("point-max-marker", Fpoint_max_marker
, Spoint_max_marker
, 0, 0, 0,
412 "Return a marker to the maximum permissible value of point in this buffer.\n\
413 This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
414 is in effect, in which case it is less.")
417 return buildmark (ZV
);
420 DEFUN ("following-char", Ffollowing_char
, Sfollowing_char
, 0, 0, 0,
421 "Return the character following point, as a number.\n\
422 At the end of the buffer or accessible region, return 0.")
427 XSETFASTINT (temp
, 0);
429 XSETFASTINT (temp
, FETCH_CHAR (point
));
433 DEFUN ("preceding-char", Fprevious_char
, Sprevious_char
, 0, 0, 0,
434 "Return the character preceding point, as a number.\n\
435 At the beginning of the buffer or accessible region, return 0.")
440 XSETFASTINT (temp
, 0);
442 XSETFASTINT (temp
, FETCH_CHAR (point
- 1));
446 DEFUN ("bobp", Fbobp
, Sbobp
, 0, 0, 0,
447 "Return T if point is at the beginning of the buffer.\n\
448 If the buffer is narrowed, this means the beginning of the narrowed part.")
456 DEFUN ("eobp", Feobp
, Seobp
, 0, 0, 0,
457 "Return T if point is at the end of the buffer.\n\
458 If the buffer is narrowed, this means the end of the narrowed part.")
466 DEFUN ("bolp", Fbolp
, Sbolp
, 0, 0, 0,
467 "Return T if point is at the beginning of a line.")
470 if (point
== BEGV
|| FETCH_CHAR (point
- 1) == '\n')
475 DEFUN ("eolp", Feolp
, Seolp
, 0, 0, 0,
476 "Return T if point is at the end of a line.\n\
477 `End of a line' includes point being at the end of the buffer.")
480 if (point
== ZV
|| FETCH_CHAR (point
) == '\n')
485 DEFUN ("char-after", Fchar_after
, Schar_after
, 1, 1, 0,
486 "Return character in current buffer at position POS.\n\
487 POS is an integer or a buffer pointer.\n\
488 If POS is out of range, the value is nil.")
492 register Lisp_Object val
;
495 CHECK_NUMBER_COERCE_MARKER (pos
, 0);
498 if (n
< BEGV
|| n
>= ZV
) return Qnil
;
500 XSETFASTINT (val
, FETCH_CHAR (n
));
504 DEFUN ("user-login-name", Fuser_login_name
, Suser_login_name
, 0, 1, 0,
505 "Return the name under which the user logged in, as a string.\n\
506 This is based on the effective uid, not the real uid.\n\
507 Also, if the environment variable LOGNAME or USER is set,\n\
508 that determines the value of this function.\n\n\
509 If optional argument UID is an integer, return the login name of the user\n\
510 with that uid, or nil if there is no such user.")
516 /* Set up the user name info if we didn't do it before.
517 (That can happen if Emacs is dumpable
518 but you decide to run `temacs -l loadup' and not dump. */
519 if (INTEGERP (Vuser_name
))
525 CHECK_NUMBER (uid
, 0);
526 pw
= (struct passwd
*) getpwuid (XINT (uid
));
527 return (pw
? build_string (pw
->pw_name
) : Qnil
);
530 DEFUN ("user-real-login-name", Fuser_real_login_name
, Suser_real_login_name
,
532 "Return the name of the user's real uid, as a string.\n\
533 This ignores the environment variables LOGNAME and USER, so it differs from\n\
534 `user-login-name' when running under `su'.")
537 /* Set up the user name info if we didn't do it before.
538 (That can happen if Emacs is dumpable
539 but you decide to run `temacs -l loadup' and not dump. */
540 if (INTEGERP (Vuser_name
))
542 return Vuser_real_name
;
545 DEFUN ("user-uid", Fuser_uid
, Suser_uid
, 0, 0, 0,
546 "Return the effective uid of Emacs, as an integer.")
549 return make_number (geteuid ());
552 DEFUN ("user-real-uid", Fuser_real_uid
, Suser_real_uid
, 0, 0, 0,
553 "Return the real uid of Emacs, as an integer.")
556 return make_number (getuid ());
559 DEFUN ("user-full-name", Fuser_full_name
, Suser_full_name
, 0, 0, 0,
560 "Return the full name of the user logged in, as a string.")
563 return Vuser_full_name
;
566 DEFUN ("system-name", Fsystem_name
, Ssystem_name
, 0, 0, 0,
567 "Return the name of the machine you are running on, as a string.")
573 /* For the benefit of callers who don't want to include lisp.h */
577 return (char *) XSTRING (Vsystem_name
)->data
;
580 DEFUN ("emacs-pid", Femacs_pid
, Semacs_pid
, 0, 0, 0,
581 "Return the process ID of Emacs, as an integer.")
584 return make_number (getpid ());
587 DEFUN ("current-time", Fcurrent_time
, Scurrent_time
, 0, 0, 0,
588 "Return the current time, as the number of seconds since 12:00 AM January 1970.\n\
589 The time is returned as a list of three integers. The first has the\n\
590 most significant 16 bits of the seconds, while the second has the\n\
591 least significant 16 bits. The third integer gives the microsecond\n\
594 The microsecond count is zero on systems that do not provide\n\
595 resolution finer than a second.")
599 Lisp_Object result
[3];
602 XSETINT (result
[0], (EMACS_SECS (t
) >> 16) & 0xffff);
603 XSETINT (result
[1], (EMACS_SECS (t
) >> 0) & 0xffff);
604 XSETINT (result
[2], EMACS_USECS (t
));
606 return Flist (3, result
);
611 lisp_time_argument (specified_time
, result
)
612 Lisp_Object specified_time
;
615 if (NILP (specified_time
))
616 return time (result
) != -1;
619 Lisp_Object high
, low
;
620 high
= Fcar (specified_time
);
621 CHECK_NUMBER (high
, 0);
622 low
= Fcdr (specified_time
);
625 CHECK_NUMBER (low
, 0);
626 *result
= (XINT (high
) << 16) + (XINT (low
) & 0xffff);
627 return *result
>> 16 == XINT (high
);
631 DEFUN ("format-time-string", Fformat_time_string
, Sformat_time_string
, 2, 2, 0,
632 "Use FORMAT-STRING to format the time TIME.\n\
633 TIME is specified as (HIGH LOW . IGNORED) or (HIGH . LOW), as from\n\
634 `current-time' and `file-attributes'.\n\
635 FORMAT-STRING may contain %-sequences to substitute parts of the time.\n\
636 %a is replaced by the abbreviated name of the day of week.\n\
637 %A is replaced by the full name of the day of week.\n\
638 %b is replaced by the abbreviated name of the month.\n\
639 %B is replaced by the full name of the month.\n\
640 %c is a synonym for \"%x %X\".\n\
641 %C is a locale-specific synonym, which defaults to \"%A, %B %e, %Y\" in the C locale.\n\
642 %d is replaced by the day of month, zero-padded.\n\
643 %D is a synonym for \"%m/%d/%y\".\n\
644 %e is replaced by the day of month, blank-padded.\n\
645 %h is a synonym for \"%b\".\n\
646 %H is replaced by the hour (00-23).\n\
647 %I is replaced by the hour (00-12).\n\
648 %j is replaced by the day of the year (001-366).\n\
649 %k is replaced by the hour (0-23), blank padded.\n\
650 %l is replaced by the hour (1-12), blank padded.\n\
651 %m is replaced by the month (01-12).\n\
652 %M is replaced by the minut (00-59).\n\
653 %n is a synonym for \"\\n\".\n\
654 %p is replaced by AM or PM, as appropriate.\n\
655 %r is a synonym for \"%I:%M:%S %p\".\n\
656 %R is a synonym for \"%H:%M\".\n\
657 %S is replaced by the seconds (00-60).\n\
658 %t is a synonym for \"\\t\".\n\
659 %T is a synonym for \"%H:%M:%S\".\n\
660 %U is replaced by the week of the year (01-52), first day of week is Sunday.\n\
661 %w is replaced by the day of week (0-6), Sunday is day 0.\n\
662 %W is replaced by the week of the year (01-52), first day of week is Monday.\n\
663 %x is a locale-specific synonym, which defaults to \"%D\" in the C locale.\n\
664 %X is a locale-specific synonym, which defaults to \"%T\" in the C locale.\n\
665 %y is replaced by the year without century (00-99).\n\
666 %Y is replaced by the year with century.\n\
667 %Z is replaced by the time zone abbreviation.\n\
669 The number of options reflects the `strftime' function.")
670 (format_string
, time
)
671 Lisp_Object format_string
, time
;
676 CHECK_STRING (format_string
, 1);
678 if (! lisp_time_argument (time
, &value
))
679 error ("Invalid time specification");
681 /* This is probably enough. */
682 size
= XSTRING (format_string
)->size
* 6 + 50;
686 char *buf
= (char *) alloca (size
);
687 if (emacs_strftime (buf
, size
, XSTRING (format_string
)->data
,
689 return build_string (buf
);
690 /* If buffer was too small, make it bigger. */
695 DEFUN ("decode-time", Fdecode_time
, Sdecode_time
, 0, 1, 0,
696 "Decode a time value as (SEC MINUTE HOUR DAY MONTH YEAR DOW DST ZONE).\n\
697 The optional SPECIFIED-TIME should be a list of (HIGH LOW . IGNORED)\n\
698 or (HIGH . LOW), as from `current-time' and `file-attributes', or `nil'\n\
699 to use the current time. The list has the following nine members:\n\
700 SEC is an integer between 0 and 59. MINUTE is an integer between 0 and 59.\n\
701 HOUR is an integer between 0 and 23. DAY is an integer between 1 and 31.\n\
702 MONTH is an integer between 1 and 12. YEAR is an integer indicating the\n\
703 four-digit year. DOW is the day of week, an integer between 0 and 6, where\n\
704 0 is Sunday. DST is t if daylight savings time is effect, otherwise nil.\n\
705 ZONE is an integer indicating the number of seconds east of Greenwich.\n\
706 (Note that Common Lisp has different meanings for DOW and ZONE.)")
708 Lisp_Object specified_time
;
712 struct tm
*decoded_time
;
713 Lisp_Object list_args
[9];
715 if (! lisp_time_argument (specified_time
, &time_spec
))
716 error ("Invalid time specification");
718 decoded_time
= localtime (&time_spec
);
719 XSETFASTINT (list_args
[0], decoded_time
->tm_sec
);
720 XSETFASTINT (list_args
[1], decoded_time
->tm_min
);
721 XSETFASTINT (list_args
[2], decoded_time
->tm_hour
);
722 XSETFASTINT (list_args
[3], decoded_time
->tm_mday
);
723 XSETFASTINT (list_args
[4], decoded_time
->tm_mon
+ 1);
724 XSETFASTINT (list_args
[5], decoded_time
->tm_year
+ 1900);
725 XSETFASTINT (list_args
[6], decoded_time
->tm_wday
);
726 list_args
[7] = (decoded_time
->tm_isdst
)? Qt
: Qnil
;
728 /* Make a copy, in case gmtime modifies the struct. */
729 save_tm
= *decoded_time
;
730 decoded_time
= gmtime (&time_spec
);
731 if (decoded_time
== 0)
734 XSETINT (list_args
[8], difftm (&save_tm
, decoded_time
));
735 return Flist (9, list_args
);
738 DEFUN ("encode-time", Fencode_time
, Sencode_time
, 6, 7, 0,
739 "Convert SEC, MIN, HOUR, DAY, MONTH, YEAR and ZONE to internal time.\n\
740 This is the reverse operation of `decode-time', which see. ZONE defaults
741 to the current time zone and daylight savings time if not specified; if
742 specified, it can be either a list (as from `current-time-zone') or an
743 integer (as from `decode-time'), and is applied without consideration for
744 daylight savings time. If YEAR is less than 100, values in the range 0 to
745 37 are interpreted as in the 21st century, all other values arein the 20th
747 (sec
, min
, hour
, day
, month
, year
, zone
)
748 Lisp_Object sec
, min
, hour
, day
, month
, year
, zone
;
752 static char days
[11] = { 31, 30, 31, 30, 31, 31, 30, 31, 30, 31, 31 };
754 CHECK_NATNUM (sec
, 0);
755 CHECK_NATNUM (min
, 1);
756 CHECK_NATNUM (hour
, 2);
757 CHECK_NATNUM (day
, 3);
758 CHECK_NATNUM (month
, 4);
759 CHECK_NATNUM (year
, 5);
761 fullyear
= XINT (year
);
764 if (fullyear
< 38) /* end of time: 2038-01-19 03:14:08 */
771 zone
= Fcurrent_time_zone (Qnil
);
775 CHECK_NUMBER (zone
, 6);
777 /* all of these should evaluate to compile-time constants. */
778 #define MIN 60.0 /* 60 */
779 #define HOUR (60*MIN) /* 3600 */
780 #define DAY (24*HOUR) /* 86400 */
781 #define YEAR (365*DAY) /* 31536000 */
782 #define YEAR4 (4*YEAR+DAY) /* 126230400 */
783 #define YEAR100 (25*YEAR4-DAY) /* 3155673600 */
784 #define YEAR400 (4*YEAR100+DAY) /* 12622780800 */
785 #define YEAR1900 (4*YEAR400+3*YEAR100) /* 59958144000 */
786 #define YEAR1970 (YEAR1900+17*YEAR4+2*YEAR) /* 62167132800 */
787 #define LEAPBIAS (59*DAY) /* 5097600 */
789 mon
= XINT (month
) - 1;
795 universal
= XINT (sec
) + XINT (min
) * MIN
+ XINT (hour
) * HOUR
;
797 universal
+= days
[mon
] * DAY
;
798 universal
+= (XINT (day
) - 1) * DAY
;
799 universal
+= YEAR400
* (fullyear
/400);
801 universal
+= YEAR100
* (fullyear
/100);
803 universal
+= YEAR4
* (fullyear
/4);
805 universal
+= YEAR
* fullyear
;
806 universal
-= YEAR1970
- LEAPBIAS
;
808 return make_time ((int)(universal
- XINT (zone
)));
822 DEFUN ("current-time-string", Fcurrent_time_string
, Scurrent_time_string
, 0, 1, 0,
823 "Return the current time, as a human-readable string.\n\
824 Programs can use this function to decode a time,\n\
825 since the number of columns in each field is fixed.\n\
826 The format is `Sun Sep 16 01:03:52 1973'.\n\
827 If an argument is given, it specifies a time to format\n\
828 instead of the current time. The argument should have the form:\n\
831 (HIGH LOW . IGNORED).\n\
832 Thus, you can use times obtained from `current-time'\n\
833 and from `file-attributes'.")
835 Lisp_Object specified_time
;
841 if (! lisp_time_argument (specified_time
, &value
))
843 tem
= (char *) ctime (&value
);
845 strncpy (buf
, tem
, 24);
848 return build_string (buf
);
851 #define TM_YEAR_ORIGIN 1900
853 /* Yield A - B, measured in seconds. */
858 int ay
= a
->tm_year
+ (TM_YEAR_ORIGIN
- 1);
859 int by
= b
->tm_year
+ (TM_YEAR_ORIGIN
- 1);
860 /* Some compilers can't handle this as a single return statement. */
862 /* difference in day of year */
863 a
->tm_yday
- b
->tm_yday
864 /* + intervening leap days */
865 + ((ay
>> 2) - (by
>> 2))
867 + ((ay
/100 >> 2) - (by
/100 >> 2))
868 /* + difference in years * 365 */
869 + (long)(ay
-by
) * 365
871 return (60*(60*(24*days
+ (a
->tm_hour
- b
->tm_hour
))
872 + (a
->tm_min
- b
->tm_min
))
873 + (a
->tm_sec
- b
->tm_sec
));
876 DEFUN ("current-time-zone", Fcurrent_time_zone
, Scurrent_time_zone
, 0, 1, 0,
877 "Return the offset and name for the local time zone.\n\
878 This returns a list of the form (OFFSET NAME).\n\
879 OFFSET is an integer number of seconds ahead of UTC (east of Greenwich).\n\
880 A negative value means west of Greenwich.\n\
881 NAME is a string giving the name of the time zone.\n\
882 If an argument is given, it specifies when the time zone offset is determined\n\
883 instead of using the current time. The argument should have the form:\n\
886 (HIGH LOW . IGNORED).\n\
887 Thus, you can use times obtained from `current-time'\n\
888 and from `file-attributes'.\n\
890 Some operating systems cannot provide all this information to Emacs;\n\
891 in this case, `current-time-zone' returns a list containing nil for\n\
892 the data it can't find.")
894 Lisp_Object specified_time
;
899 if (lisp_time_argument (specified_time
, &value
)
900 && (t
= gmtime (&value
)) != 0)
906 gmt
= *t
; /* Make a copy, in case localtime modifies *t. */
907 t
= localtime (&value
);
908 offset
= difftm (t
, &gmt
);
912 s
= (char *)t
->tm_zone
;
913 #else /* not HAVE_TM_ZONE */
915 if (t
->tm_isdst
== 0 || t
->tm_isdst
== 1)
916 s
= tzname
[t
->tm_isdst
];
918 #endif /* not HAVE_TM_ZONE */
921 /* No local time zone name is available; use "+-NNNN" instead. */
922 int am
= (offset
< 0 ? -offset
: offset
) / 60;
923 sprintf (buf
, "%c%02d%02d", (offset
< 0 ? '-' : '+'), am
/60, am
%60);
926 return Fcons (make_number (offset
), Fcons (build_string (s
), Qnil
));
929 return Fmake_list (2, Qnil
);
941 /* Callers passing one argument to Finsert need not gcpro the
942 argument "array", since the only element of the array will
943 not be used after calling insert or insert_from_string, so
944 we don't care if it gets trashed. */
946 DEFUN ("insert", Finsert
, Sinsert
, 0, MANY
, 0,
947 "Insert the arguments, either strings or characters, at point.\n\
948 Point moves forward so that it ends up after the inserted text.\n\
949 Any other markers at the point of insertion remain before the text.")
952 register Lisp_Object
*args
;
955 register Lisp_Object tem
;
958 for (argnum
= 0; argnum
< nargs
; argnum
++)
967 else if (STRINGP (tem
))
969 insert_from_string (tem
, 0, XSTRING (tem
)->size
, 0);
973 tem
= wrong_type_argument (Qchar_or_string_p
, tem
);
981 DEFUN ("insert-and-inherit", Finsert_and_inherit
, Sinsert_and_inherit
,
983 "Insert the arguments at point, inheriting properties from adjoining text.\n\
984 Point moves forward so that it ends up after the inserted text.\n\
985 Any other markers at the point of insertion remain before the text.")
988 register Lisp_Object
*args
;
991 register Lisp_Object tem
;
994 for (argnum
= 0; argnum
< nargs
; argnum
++)
1000 str
[0] = XINT (tem
);
1001 insert_and_inherit (str
, 1);
1003 else if (STRINGP (tem
))
1005 insert_from_string (tem
, 0, XSTRING (tem
)->size
, 1);
1009 tem
= wrong_type_argument (Qchar_or_string_p
, tem
);
1017 DEFUN ("insert-before-markers", Finsert_before_markers
, Sinsert_before_markers
, 0, MANY
, 0,
1018 "Insert strings or characters at point, relocating markers after the text.\n\
1019 Point moves forward so that it ends up after the inserted text.\n\
1020 Any other markers at the point of insertion also end up after the text.")
1023 register Lisp_Object
*args
;
1025 register int argnum
;
1026 register Lisp_Object tem
;
1029 for (argnum
= 0; argnum
< nargs
; argnum
++)
1035 str
[0] = XINT (tem
);
1036 insert_before_markers (str
, 1);
1038 else if (STRINGP (tem
))
1040 insert_from_string_before_markers (tem
, 0, XSTRING (tem
)->size
, 0);
1044 tem
= wrong_type_argument (Qchar_or_string_p
, tem
);
1052 DEFUN ("insert-before-markers-and-inherit",
1053 Finsert_and_inherit_before_markers
, Sinsert_and_inherit_before_markers
,
1055 "Insert text at point, relocating markers and inheriting properties.\n\
1056 Point moves forward so that it ends up after the inserted text.\n\
1057 Any other markers at the point of insertion also end up after the text.")
1060 register Lisp_Object
*args
;
1062 register int argnum
;
1063 register Lisp_Object tem
;
1066 for (argnum
= 0; argnum
< nargs
; argnum
++)
1072 str
[0] = XINT (tem
);
1073 insert_before_markers_and_inherit (str
, 1);
1075 else if (STRINGP (tem
))
1077 insert_from_string_before_markers (tem
, 0, XSTRING (tem
)->size
, 1);
1081 tem
= wrong_type_argument (Qchar_or_string_p
, tem
);
1089 DEFUN ("insert-char", Finsert_char
, Sinsert_char
, 2, 3, 0,
1090 "Insert COUNT (second arg) copies of CHAR (first arg).\n\
1091 Point and all markers are affected as in the function `insert'.\n\
1092 Both arguments are required.\n\
1093 The optional third arg INHERIT, if non-nil, says to inherit text properties\n\
1094 from adjoining text, if those properties are sticky.")
1095 (chr
, count
, inherit
)
1096 Lisp_Object chr
, count
, inherit
;
1098 register unsigned char *string
;
1099 register int strlen
;
1102 CHECK_NUMBER (chr
, 0);
1103 CHECK_NUMBER (count
, 1);
1108 strlen
= min (n
, 256);
1109 string
= (unsigned char *) alloca (strlen
);
1110 for (i
= 0; i
< strlen
; i
++)
1111 string
[i
] = XFASTINT (chr
);
1114 if (!NILP (inherit
))
1115 insert_and_inherit (string
, strlen
);
1117 insert (string
, strlen
);
1122 if (!NILP (inherit
))
1123 insert_and_inherit (string
, n
);
1131 /* Making strings from buffer contents. */
1133 /* Return a Lisp_String containing the text of the current buffer from
1134 START to END. If text properties are in use and the current buffer
1135 has properties in the range specified, the resulting string will also
1138 We don't want to use plain old make_string here, because it calls
1139 make_uninit_string, which can cause the buffer arena to be
1140 compacted. make_string has no way of knowing that the data has
1141 been moved, and thus copies the wrong data into the string. This
1142 doesn't effect most of the other users of make_string, so it should
1143 be left as is. But we should use this function when conjuring
1144 buffer substrings. */
1147 make_buffer_string (start
, end
)
1150 Lisp_Object result
, tem
, tem1
;
1152 if (start
< GPT
&& GPT
< end
)
1155 result
= make_uninit_string (end
- start
);
1156 bcopy (&FETCH_CHAR (start
), XSTRING (result
)->data
, end
- start
);
1158 tem
= Fnext_property_change (make_number (start
), Qnil
, make_number (end
));
1159 tem1
= Ftext_properties_at (make_number (start
), Qnil
);
1161 #ifdef USE_TEXT_PROPERTIES
1162 if (XINT (tem
) != end
|| !NILP (tem1
))
1163 copy_intervals_to_string (result
, current_buffer
, start
, end
- start
);
1169 DEFUN ("buffer-substring", Fbuffer_substring
, Sbuffer_substring
, 2, 2, 0,
1170 "Return the contents of part of the current buffer as a string.\n\
1171 The two arguments START and END are character positions;\n\
1172 they can be in either order.")
1176 register int beg
, end
;
1178 validate_region (&b
, &e
);
1182 return make_buffer_string (beg
, end
);
1185 DEFUN ("buffer-string", Fbuffer_string
, Sbuffer_string
, 0, 0, 0,
1186 "Return the contents of the current buffer as a string.\n\
1187 If narrowing is in effect, this function returns only the visible part\n\
1191 return make_buffer_string (BEGV
, ZV
);
1194 DEFUN ("insert-buffer-substring", Finsert_buffer_substring
, Sinsert_buffer_substring
,
1196 "Insert before point a substring of the contents of buffer BUFFER.\n\
1197 BUFFER may be a buffer or a buffer name.\n\
1198 Arguments START and END are character numbers specifying the substring.\n\
1199 They default to the beginning and the end of BUFFER.")
1201 Lisp_Object buf
, b
, e
;
1203 register int beg
, end
, temp
;
1204 register struct buffer
*bp
;
1207 buffer
= Fget_buffer (buf
);
1210 bp
= XBUFFER (buffer
);
1213 beg
= BUF_BEGV (bp
);
1216 CHECK_NUMBER_COERCE_MARKER (b
, 0);
1223 CHECK_NUMBER_COERCE_MARKER (e
, 1);
1228 temp
= beg
, beg
= end
, end
= temp
;
1230 if (!(BUF_BEGV (bp
) <= beg
&& end
<= BUF_ZV (bp
)))
1231 args_out_of_range (b
, e
);
1233 insert_from_buffer (bp
, beg
, end
- beg
, 0);
1237 DEFUN ("compare-buffer-substrings", Fcompare_buffer_substrings
, Scompare_buffer_substrings
,
1239 "Compare two substrings of two buffers; return result as number.\n\
1240 the value is -N if first string is less after N-1 chars,\n\
1241 +N if first string is greater after N-1 chars, or 0 if strings match.\n\
1242 Each substring is represented as three arguments: BUFFER, START and END.\n\
1243 That makes six args in all, three for each substring.\n\n\
1244 The value of `case-fold-search' in the current buffer\n\
1245 determines whether case is significant or ignored.")
1246 (buffer1
, start1
, end1
, buffer2
, start2
, end2
)
1247 Lisp_Object buffer1
, start1
, end1
, buffer2
, start2
, end2
;
1249 register int begp1
, endp1
, begp2
, endp2
, temp
, len1
, len2
, length
, i
;
1250 register struct buffer
*bp1
, *bp2
;
1251 register unsigned char *trt
1252 = (!NILP (current_buffer
->case_fold_search
)
1253 ? XSTRING (current_buffer
->case_canon_table
)->data
: 0);
1255 /* Find the first buffer and its substring. */
1258 bp1
= current_buffer
;
1262 buf1
= Fget_buffer (buffer1
);
1265 bp1
= XBUFFER (buf1
);
1269 begp1
= BUF_BEGV (bp1
);
1272 CHECK_NUMBER_COERCE_MARKER (start1
, 1);
1273 begp1
= XINT (start1
);
1276 endp1
= BUF_ZV (bp1
);
1279 CHECK_NUMBER_COERCE_MARKER (end1
, 2);
1280 endp1
= XINT (end1
);
1284 temp
= begp1
, begp1
= endp1
, endp1
= temp
;
1286 if (!(BUF_BEGV (bp1
) <= begp1
1288 && endp1
<= BUF_ZV (bp1
)))
1289 args_out_of_range (start1
, end1
);
1291 /* Likewise for second substring. */
1294 bp2
= current_buffer
;
1298 buf2
= Fget_buffer (buffer2
);
1301 bp2
= XBUFFER (buffer2
);
1305 begp2
= BUF_BEGV (bp2
);
1308 CHECK_NUMBER_COERCE_MARKER (start2
, 4);
1309 begp2
= XINT (start2
);
1312 endp2
= BUF_ZV (bp2
);
1315 CHECK_NUMBER_COERCE_MARKER (end2
, 5);
1316 endp2
= XINT (end2
);
1320 temp
= begp2
, begp2
= endp2
, endp2
= temp
;
1322 if (!(BUF_BEGV (bp2
) <= begp2
1324 && endp2
<= BUF_ZV (bp2
)))
1325 args_out_of_range (start2
, end2
);
1327 len1
= endp1
- begp1
;
1328 len2
= endp2
- begp2
;
1333 for (i
= 0; i
< length
; i
++)
1335 int c1
= *BUF_CHAR_ADDRESS (bp1
, begp1
+ i
);
1336 int c2
= *BUF_CHAR_ADDRESS (bp2
, begp2
+ i
);
1343 return make_number (- 1 - i
);
1345 return make_number (i
+ 1);
1348 /* The strings match as far as they go.
1349 If one is shorter, that one is less. */
1351 return make_number (length
+ 1);
1352 else if (length
< len2
)
1353 return make_number (- length
- 1);
1355 /* Same length too => they are equal. */
1356 return make_number (0);
1360 subst_char_in_region_unwind (arg
)
1363 return current_buffer
->undo_list
= arg
;
1366 DEFUN ("subst-char-in-region", Fsubst_char_in_region
,
1367 Ssubst_char_in_region
, 4, 5, 0,
1368 "From START to END, replace FROMCHAR with TOCHAR each time it occurs.\n\
1369 If optional arg NOUNDO is non-nil, don't record this change for undo\n\
1370 and don't mark the buffer as really changed.")
1371 (start
, end
, fromchar
, tochar
, noundo
)
1372 Lisp_Object start
, end
, fromchar
, tochar
, noundo
;
1374 register int pos
, stop
, look
;
1376 int count
= specpdl_ptr
- specpdl
;
1378 validate_region (&start
, &end
);
1379 CHECK_NUMBER (fromchar
, 2);
1380 CHECK_NUMBER (tochar
, 3);
1384 look
= XINT (fromchar
);
1386 /* If we don't want undo, turn off putting stuff on the list.
1387 That's faster than getting rid of things,
1388 and it prevents even the entry for a first change. */
1391 record_unwind_protect (subst_char_in_region_unwind
,
1392 current_buffer
->undo_list
);
1393 current_buffer
->undo_list
= Qt
;
1398 if (FETCH_CHAR (pos
) == look
)
1402 modify_region (current_buffer
, XINT (start
), stop
);
1404 if (! NILP (noundo
))
1406 if (MODIFF
- 1 == SAVE_MODIFF
)
1408 if (MODIFF
- 1 == current_buffer
->auto_save_modified
)
1409 current_buffer
->auto_save_modified
++;
1416 record_change (pos
, 1);
1417 FETCH_CHAR (pos
) = XINT (tochar
);
1423 signal_after_change (XINT (start
),
1424 stop
- XINT (start
), stop
- XINT (start
));
1426 unbind_to (count
, Qnil
);
1430 DEFUN ("translate-region", Ftranslate_region
, Stranslate_region
, 3, 3, 0,
1431 "From START to END, translate characters according to TABLE.\n\
1432 TABLE is a string; the Nth character in it is the mapping\n\
1433 for the character with code N. Returns the number of characters changed.")
1437 register Lisp_Object table
;
1439 register int pos
, stop
; /* Limits of the region. */
1440 register unsigned char *tt
; /* Trans table. */
1441 register int oc
; /* Old character. */
1442 register int nc
; /* New character. */
1443 int cnt
; /* Number of changes made. */
1444 Lisp_Object z
; /* Return. */
1445 int size
; /* Size of translate table. */
1447 validate_region (&start
, &end
);
1448 CHECK_STRING (table
, 2);
1450 size
= XSTRING (table
)->size
;
1451 tt
= XSTRING (table
)->data
;
1455 modify_region (current_buffer
, pos
, stop
);
1458 for (; pos
< stop
; ++pos
)
1460 oc
= FETCH_CHAR (pos
);
1466 record_change (pos
, 1);
1467 FETCH_CHAR (pos
) = nc
;
1468 signal_after_change (pos
, 1, 1);
1474 XSETFASTINT (z
, cnt
);
1478 DEFUN ("delete-region", Fdelete_region
, Sdelete_region
, 2, 2, "r",
1479 "Delete the text between point and mark.\n\
1480 When called from a program, expects two arguments,\n\
1481 positions (integers or markers) specifying the stretch to be deleted.")
1485 validate_region (&b
, &e
);
1486 del_range (XINT (b
), XINT (e
));
1490 DEFUN ("widen", Fwiden
, Swiden
, 0, 0, "",
1491 "Remove restrictions (narrowing) from current buffer.\n\
1492 This allows the buffer's full text to be seen and edited.")
1496 SET_BUF_ZV (current_buffer
, Z
);
1498 /* Changing the buffer bounds invalidates any recorded current column. */
1499 invalidate_current_column ();
1503 DEFUN ("narrow-to-region", Fnarrow_to_region
, Snarrow_to_region
, 2, 2, "r",
1504 "Restrict editing in this buffer to the current region.\n\
1505 The rest of the text becomes temporarily invisible and untouchable\n\
1506 but is not deleted; if you save the buffer in a file, the invisible\n\
1507 text is included in the file. \\[widen] makes all visible again.\n\
1508 See also `save-restriction'.\n\
1510 When calling from a program, pass two arguments; positions (integers\n\
1511 or markers) bounding the text that should remain visible.")
1513 register Lisp_Object b
, e
;
1515 CHECK_NUMBER_COERCE_MARKER (b
, 0);
1516 CHECK_NUMBER_COERCE_MARKER (e
, 1);
1518 if (XINT (b
) > XINT (e
))
1521 tem
= b
; b
= e
; e
= tem
;
1524 if (!(BEG
<= XINT (b
) && XINT (b
) <= XINT (e
) && XINT (e
) <= Z
))
1525 args_out_of_range (b
, e
);
1527 BEGV
= XFASTINT (b
);
1528 SET_BUF_ZV (current_buffer
, XFASTINT (e
));
1529 if (point
< XFASTINT (b
))
1530 SET_PT (XFASTINT (b
));
1531 if (point
> XFASTINT (e
))
1532 SET_PT (XFASTINT (e
));
1534 /* Changing the buffer bounds invalidates any recorded current column. */
1535 invalidate_current_column ();
1540 save_restriction_save ()
1542 register Lisp_Object bottom
, top
;
1543 /* Note: I tried using markers here, but it does not win
1544 because insertion at the end of the saved region
1545 does not advance mh and is considered "outside" the saved region. */
1546 XSETFASTINT (bottom
, BEGV
- BEG
);
1547 XSETFASTINT (top
, Z
- ZV
);
1549 return Fcons (Fcurrent_buffer (), Fcons (bottom
, top
));
1553 save_restriction_restore (data
)
1556 register struct buffer
*buf
;
1557 register int newhead
, newtail
;
1558 register Lisp_Object tem
;
1560 buf
= XBUFFER (XCONS (data
)->car
);
1562 data
= XCONS (data
)->cdr
;
1564 tem
= XCONS (data
)->car
;
1565 newhead
= XINT (tem
);
1566 tem
= XCONS (data
)->cdr
;
1567 newtail
= XINT (tem
);
1568 if (newhead
+ newtail
> BUF_Z (buf
) - BUF_BEG (buf
))
1573 BUF_BEGV (buf
) = BUF_BEG (buf
) + newhead
;
1574 SET_BUF_ZV (buf
, BUF_Z (buf
) - newtail
);
1577 /* If point is outside the new visible range, move it inside. */
1579 clip_to_bounds (BUF_BEGV (buf
), BUF_PT (buf
), BUF_ZV (buf
)));
1584 DEFUN ("save-restriction", Fsave_restriction
, Ssave_restriction
, 0, UNEVALLED
, 0,
1585 "Execute BODY, saving and restoring current buffer's restrictions.\n\
1586 The buffer's restrictions make parts of the beginning and end invisible.\n\
1587 \(They are set up with `narrow-to-region' and eliminated with `widen'.)\n\
1588 This special form, `save-restriction', saves the current buffer's restrictions\n\
1589 when it is entered, and restores them when it is exited.\n\
1590 So any `narrow-to-region' within BODY lasts only until the end of the form.\n\
1591 The old restrictions settings are restored\n\
1592 even in case of abnormal exit (throw or error).\n\
1594 The value returned is the value of the last form in BODY.\n\
1596 `save-restriction' can get confused if, within the BODY, you widen\n\
1597 and then make changes outside the area within the saved restrictions.\n\
1599 Note: if you are using both `save-excursion' and `save-restriction',\n\
1600 use `save-excursion' outermost:\n\
1601 (save-excursion (save-restriction ...))")
1605 register Lisp_Object val
;
1606 int count
= specpdl_ptr
- specpdl
;
1608 record_unwind_protect (save_restriction_restore
, save_restriction_save ());
1609 val
= Fprogn (body
);
1610 return unbind_to (count
, val
);
1613 /* Buffer for the most recent text displayed by Fmessage. */
1614 static char *message_text
;
1616 /* Allocated length of that buffer. */
1617 static int message_length
;
1619 DEFUN ("message", Fmessage
, Smessage
, 1, MANY
, 0,
1620 "Print a one-line message at the bottom of the screen.\n\
1621 The first argument is a control string.\n\
1622 It may contain %s or %d or %c to print successive following arguments.\n\
1623 %s means print an argument as a string, %d means print as number in decimal,\n\
1624 %c means print a number as a single character.\n\
1625 The argument used by %s must be a string or a symbol;\n\
1626 the argument used by %d or %c must be a number.\n\
1627 If the first argument is nil, clear any existing message; let the\n\
1628 minibuffer contents show.")
1640 register Lisp_Object val
;
1641 val
= Fformat (nargs
, args
);
1642 /* Copy the data so that it won't move when we GC. */
1645 message_text
= (char *)xmalloc (80);
1646 message_length
= 80;
1648 if (XSTRING (val
)->size
> message_length
)
1650 message_length
= XSTRING (val
)->size
;
1651 message_text
= (char *)xrealloc (message_text
, message_length
);
1653 bcopy (XSTRING (val
)->data
, message_text
, XSTRING (val
)->size
);
1654 message2 (message_text
, XSTRING (val
)->size
);
1659 DEFUN ("message-box", Fmessage_box
, Smessage_box
, 1, MANY
, 0,
1660 "Display a message, in a dialog box if possible.\n\
1661 If a dialog box is not available, use the echo area.\n\
1662 The first argument is a control string.\n\
1663 It may contain %s or %d or %c to print successive following arguments.\n\
1664 %s means print an argument as a string, %d means print as number in decimal,\n\
1665 %c means print a number as a single character.\n\
1666 The argument used by %s must be a string or a symbol;\n\
1667 the argument used by %d or %c must be a number.\n\
1668 If the first argument is nil, clear any existing message; let the\n\
1669 minibuffer contents show.")
1681 register Lisp_Object val
;
1682 val
= Fformat (nargs
, args
);
1685 Lisp_Object pane
, menu
, obj
;
1686 struct gcpro gcpro1
;
1687 pane
= Fcons (Fcons (build_string ("OK"), Qt
), Qnil
);
1689 menu
= Fcons (val
, pane
);
1690 obj
= Fx_popup_dialog (Qt
, menu
);
1695 /* Copy the data so that it won't move when we GC. */
1698 message_text
= (char *)xmalloc (80);
1699 message_length
= 80;
1701 if (XSTRING (val
)->size
> message_length
)
1703 message_length
= XSTRING (val
)->size
;
1704 message_text
= (char *)xrealloc (message_text
, message_length
);
1706 bcopy (XSTRING (val
)->data
, message_text
, XSTRING (val
)->size
);
1707 message2 (message_text
, XSTRING (val
)->size
);
1713 extern Lisp_Object last_nonmenu_event
;
1715 DEFUN ("message-or-box", Fmessage_or_box
, Smessage_or_box
, 1, MANY
, 0,
1716 "Display a message in a dialog box or in the echo area.\n\
1717 If this command was invoked with the mouse, use a dialog box.\n\
1718 Otherwise, use the echo area.\n\
1720 The first argument is a control string.\n\
1721 It may contain %s or %d or %c to print successive following arguments.\n\
1722 %s means print an argument as a string, %d means print as number in decimal,\n\
1723 %c means print a number as a single character.\n\
1724 The argument used by %s must be a string or a symbol;\n\
1725 the argument used by %d or %c must be a number.\n\
1726 If the first argument is nil, clear any existing message; let the\n\
1727 minibuffer contents show.")
1733 if (NILP (last_nonmenu_event
) || CONSP (last_nonmenu_event
))
1734 return Fmessage_box (nargs
, args
);
1736 return Fmessage (nargs
, args
);
1739 DEFUN ("format", Fformat
, Sformat
, 1, MANY
, 0,
1740 "Format a string out of a control-string and arguments.\n\
1741 The first argument is a control string.\n\
1742 The other arguments are substituted into it to make the result, a string.\n\
1743 It may contain %-sequences meaning to substitute the next argument.\n\
1744 %s means print a string argument. Actually, prints any object, with `princ'.\n\
1745 %d means print as number in decimal (%o octal, %x hex).\n\
1746 %c means print a number as a single character.\n\
1747 %S means print any object as an s-expression (using prin1).\n\
1748 The argument used for %d, %o, %x or %c must be a number.\n\
1749 Use %% to put a single % into the output.")
1752 register Lisp_Object
*args
;
1754 register int n
; /* The number of the next arg to substitute */
1755 register int total
= 5; /* An estimate of the final length */
1757 register unsigned char *format
, *end
;
1759 extern char *index ();
1760 /* It should not be necessary to GCPRO ARGS, because
1761 the caller in the interpreter should take care of that. */
1763 CHECK_STRING (args
[0], 0);
1764 format
= XSTRING (args
[0])->data
;
1765 end
= format
+ XSTRING (args
[0])->size
;
1768 while (format
!= end
)
1769 if (*format
++ == '%')
1773 /* Process a numeric arg and skip it. */
1774 minlen
= atoi (format
);
1779 while ((*format
>= '0' && *format
<= '9')
1780 || *format
== '-' || *format
== ' ' || *format
== '.')
1785 else if (++n
>= nargs
)
1786 error ("not enough arguments for format string");
1787 else if (*format
== 'S')
1789 /* For `S', prin1 the argument and then treat like a string. */
1790 register Lisp_Object tem
;
1791 tem
= Fprin1_to_string (args
[n
], Qnil
);
1795 else if (SYMBOLP (args
[n
]))
1797 XSETSTRING (args
[n
], XSYMBOL (args
[n
])->name
);
1800 else if (STRINGP (args
[n
]))
1803 if (*format
!= 's' && *format
!= 'S')
1804 error ("format specifier doesn't match argument type");
1805 total
+= XSTRING (args
[n
])->size
;
1807 /* Would get MPV otherwise, since Lisp_Int's `point' to low memory. */
1808 else if (INTEGERP (args
[n
]) && *format
!= 's')
1810 #ifdef LISP_FLOAT_TYPE
1811 /* The following loop assumes the Lisp type indicates
1812 the proper way to pass the argument.
1813 So make sure we have a flonum if the argument should
1815 if (*format
== 'e' || *format
== 'f' || *format
== 'g')
1816 args
[n
] = Ffloat (args
[n
]);
1820 #ifdef LISP_FLOAT_TYPE
1821 else if (FLOATP (args
[n
]) && *format
!= 's')
1823 if (! (*format
== 'e' || *format
== 'f' || *format
== 'g'))
1824 args
[n
] = Ftruncate (args
[n
]);
1830 /* Anything but a string, convert to a string using princ. */
1831 register Lisp_Object tem
;
1832 tem
= Fprin1_to_string (args
[n
], Qt
);
1839 register int nstrings
= n
+ 1;
1841 /* Allocate twice as many strings as we have %-escapes; floats occupy
1842 two slots, and we're not sure how many of those we have. */
1843 register unsigned char **strings
1844 = (unsigned char **) alloca (2 * nstrings
* sizeof (unsigned char *));
1848 for (n
= 0; n
< nstrings
; n
++)
1851 strings
[i
++] = (unsigned char *) "";
1852 else if (INTEGERP (args
[n
]))
1853 /* We checked above that the corresponding format effector
1854 isn't %s, which would cause MPV. */
1855 strings
[i
++] = (unsigned char *) XINT (args
[n
]);
1856 #ifdef LISP_FLOAT_TYPE
1857 else if (FLOATP (args
[n
]))
1859 union { double d
; int half
[2]; } u
;
1861 u
.d
= XFLOAT (args
[n
])->data
;
1862 strings
[i
++] = (unsigned char *) (EMACS_INT
) u
.half
[0];
1863 strings
[i
++] = (unsigned char *) (EMACS_INT
) u
.half
[1];
1867 strings
[i
++] = XSTRING (args
[n
])->data
;
1870 /* Format it in bigger and bigger buf's until it all fits. */
1873 buf
= (char *) alloca (total
+ 1);
1876 length
= doprnt (buf
, total
+ 1, strings
[0], end
, i
-1, strings
+ 1);
1877 if (buf
[total
- 1] == 0)
1885 return make_string (buf
, length
);
1891 format1 (string1
, arg0
, arg1
, arg2
, arg3
, arg4
)
1892 EMACS_INT arg0
, arg1
, arg2
, arg3
, arg4
;
1906 doprnt (buf
, sizeof buf
, string1
, 0, 5, args
);
1908 doprnt (buf
, sizeof buf
, string1
, 0, 5, &string1
+ 1);
1910 return build_string (buf
);
1913 DEFUN ("char-equal", Fchar_equal
, Schar_equal
, 2, 2, 0,
1914 "Return t if two characters match, optionally ignoring case.\n\
1915 Both arguments must be characters (i.e. integers).\n\
1916 Case is ignored if `case-fold-search' is non-nil in the current buffer.")
1918 register Lisp_Object c1
, c2
;
1920 unsigned char *downcase
= DOWNCASE_TABLE
;
1921 CHECK_NUMBER (c1
, 0);
1922 CHECK_NUMBER (c2
, 1);
1924 if (!NILP (current_buffer
->case_fold_search
)
1925 ? (downcase
[0xff & XFASTINT (c1
)] == downcase
[0xff & XFASTINT (c2
)]
1926 && (XFASTINT (c1
) & ~0xff) == (XFASTINT (c2
) & ~0xff))
1927 : XINT (c1
) == XINT (c2
))
1932 /* Transpose the markers in two regions of the current buffer, and
1933 adjust the ones between them if necessary (i.e.: if the regions
1936 Traverses the entire marker list of the buffer to do so, adding an
1937 appropriate amount to some, subtracting from some, and leaving the
1938 rest untouched. Most of this is copied from adjust_markers in insdel.c.
1940 It's the caller's job to see that (start1 <= end1 <= start2 <= end2). */
1943 transpose_markers (start1
, end1
, start2
, end2
)
1944 register int start1
, end1
, start2
, end2
;
1946 register int amt1
, amt2
, diff
, mpos
;
1947 register Lisp_Object marker
;
1949 /* Update point as if it were a marker. */
1953 TEMP_SET_PT (PT
+ (end2
- end1
));
1954 else if (PT
< start2
)
1955 TEMP_SET_PT (PT
+ (end2
- start2
) - (end1
- start1
));
1957 TEMP_SET_PT (PT
- (start2
- start1
));
1959 /* We used to adjust the endpoints here to account for the gap, but that
1960 isn't good enough. Even if we assume the caller has tried to move the
1961 gap out of our way, it might still be at start1 exactly, for example;
1962 and that places it `inside' the interval, for our purposes. The amount
1963 of adjustment is nontrivial if there's a `denormalized' marker whose
1964 position is between GPT and GPT + GAP_SIZE, so it's simpler to leave
1965 the dirty work to Fmarker_position, below. */
1967 /* The difference between the region's lengths */
1968 diff
= (end2
- start2
) - (end1
- start1
);
1970 /* For shifting each marker in a region by the length of the other
1971 * region plus the distance between the regions.
1973 amt1
= (end2
- start2
) + (start2
- end1
);
1974 amt2
= (end1
- start1
) + (start2
- end1
);
1976 for (marker
= BUF_MARKERS (current_buffer
); !NILP (marker
);
1977 marker
= XMARKER (marker
)->chain
)
1979 mpos
= Fmarker_position (marker
);
1980 if (mpos
>= start1
&& mpos
< end2
)
1984 else if (mpos
< start2
)
1988 if (mpos
> GPT
) mpos
+= GAP_SIZE
;
1989 XMARKER (marker
)->bufpos
= mpos
;
1994 DEFUN ("transpose-regions", Ftranspose_regions
, Stranspose_regions
, 4, 5, 0,
1995 "Transpose region START1 to END1 with START2 to END2.\n\
1996 The regions may not be overlapping, because the size of the buffer is\n\
1997 never changed in a transposition.\n\
1999 Optional fifth arg LEAVE_MARKERS, if non-nil, means don't transpose\n\
2000 any markers that happen to be located in the regions.\n\
2002 Transposing beyond buffer boundaries is an error.")
2003 (startr1
, endr1
, startr2
, endr2
, leave_markers
)
2004 Lisp_Object startr1
, endr1
, startr2
, endr2
, leave_markers
;
2006 register int start1
, end1
, start2
, end2
,
2007 gap
, len1
, len_mid
, len2
;
2008 unsigned char *start1_addr
, *start2_addr
, *temp
;
2010 #ifdef USE_TEXT_PROPERTIES
2011 INTERVAL cur_intv
, tmp_interval1
, tmp_interval_mid
, tmp_interval2
;
2012 cur_intv
= BUF_INTERVALS (current_buffer
);
2013 #endif /* USE_TEXT_PROPERTIES */
2015 validate_region (&startr1
, &endr1
);
2016 validate_region (&startr2
, &endr2
);
2018 start1
= XFASTINT (startr1
);
2019 end1
= XFASTINT (endr1
);
2020 start2
= XFASTINT (startr2
);
2021 end2
= XFASTINT (endr2
);
2024 /* Swap the regions if they're reversed. */
2027 register int glumph
= start1
;
2035 len1
= end1
- start1
;
2036 len2
= end2
- start2
;
2039 error ("transposed regions not properly ordered");
2040 else if (start1
== end1
|| start2
== end2
)
2041 error ("transposed region may not be of length 0");
2043 /* The possibilities are:
2044 1. Adjacent (contiguous) regions, or separate but equal regions
2045 (no, really equal, in this case!), or
2046 2. Separate regions of unequal size.
2048 The worst case is usually No. 2. It means that (aside from
2049 potential need for getting the gap out of the way), there also
2050 needs to be a shifting of the text between the two regions. So
2051 if they are spread far apart, we are that much slower... sigh. */
2053 /* It must be pointed out that the really studly thing to do would
2054 be not to move the gap at all, but to leave it in place and work
2055 around it if necessary. This would be extremely efficient,
2056 especially considering that people are likely to do
2057 transpositions near where they are working interactively, which
2058 is exactly where the gap would be found. However, such code
2059 would be much harder to write and to read. So, if you are
2060 reading this comment and are feeling squirrely, by all means have
2061 a go! I just didn't feel like doing it, so I will simply move
2062 the gap the minimum distance to get it out of the way, and then
2063 deal with an unbroken array. */
2065 /* Make sure the gap won't interfere, by moving it out of the text
2066 we will operate on. */
2067 if (start1
< gap
&& gap
< end2
)
2069 if (gap
- start1
< end2
- gap
)
2075 /* Hmmm... how about checking to see if the gap is large
2076 enough to use as the temporary storage? That would avoid an
2077 allocation... interesting. Later, don't fool with it now. */
2079 /* Working without memmove, for portability (sigh), so must be
2080 careful of overlapping subsections of the array... */
2082 if (end1
== start2
) /* adjacent regions */
2084 modify_region (current_buffer
, start1
, end2
);
2085 record_change (start1
, len1
+ len2
);
2087 #ifdef USE_TEXT_PROPERTIES
2088 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2089 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2090 Fset_text_properties (start1
, end2
, Qnil
, Qnil
);
2091 #endif /* USE_TEXT_PROPERTIES */
2093 /* First region smaller than second. */
2096 /* We use alloca only if it is small,
2097 because we want to avoid stack overflow. */
2099 temp
= (unsigned char *) xmalloc (len2
);
2101 temp
= (unsigned char *) alloca (len2
);
2103 /* Don't precompute these addresses. We have to compute them
2104 at the last minute, because the relocating allocator might
2105 have moved the buffer around during the xmalloc. */
2106 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1
);
2107 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2
);
2109 bcopy (start2_addr
, temp
, len2
);
2110 bcopy (start1_addr
, start1_addr
+ len2
, len1
);
2111 bcopy (temp
, start1_addr
, len2
);
2116 /* First region not smaller than second. */
2119 temp
= (unsigned char *) xmalloc (len1
);
2121 temp
= (unsigned char *) alloca (len1
);
2122 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1
);
2123 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2
);
2124 bcopy (start1_addr
, temp
, len1
);
2125 bcopy (start2_addr
, start1_addr
, len2
);
2126 bcopy (temp
, start1_addr
+ len2
, len1
);
2130 #ifdef USE_TEXT_PROPERTIES
2131 graft_intervals_into_buffer (tmp_interval1
, start1
+ len2
,
2132 len1
, current_buffer
, 0);
2133 graft_intervals_into_buffer (tmp_interval2
, start1
,
2134 len2
, current_buffer
, 0);
2135 #endif /* USE_TEXT_PROPERTIES */
2137 /* Non-adjacent regions, because end1 != start2, bleagh... */
2141 /* Regions are same size, though, how nice. */
2143 modify_region (current_buffer
, start1
, end1
);
2144 modify_region (current_buffer
, start2
, end2
);
2145 record_change (start1
, len1
);
2146 record_change (start2
, len2
);
2147 #ifdef USE_TEXT_PROPERTIES
2148 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2149 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2150 Fset_text_properties (start1
, end1
, Qnil
, Qnil
);
2151 Fset_text_properties (start2
, end2
, Qnil
, Qnil
);
2152 #endif /* USE_TEXT_PROPERTIES */
2155 temp
= (unsigned char *) xmalloc (len1
);
2157 temp
= (unsigned char *) alloca (len1
);
2158 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1
);
2159 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2
);
2160 bcopy (start1_addr
, temp
, len1
);
2161 bcopy (start2_addr
, start1_addr
, len2
);
2162 bcopy (temp
, start2_addr
, len1
);
2165 #ifdef USE_TEXT_PROPERTIES
2166 graft_intervals_into_buffer (tmp_interval1
, start2
,
2167 len1
, current_buffer
, 0);
2168 graft_intervals_into_buffer (tmp_interval2
, start1
,
2169 len2
, current_buffer
, 0);
2170 #endif /* USE_TEXT_PROPERTIES */
2173 else if (len1
< len2
) /* Second region larger than first */
2174 /* Non-adjacent & unequal size, area between must also be shifted. */
2176 len_mid
= start2
- end1
;
2177 modify_region (current_buffer
, start1
, end2
);
2178 record_change (start1
, (end2
- start1
));
2179 #ifdef USE_TEXT_PROPERTIES
2180 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2181 tmp_interval_mid
= copy_intervals (cur_intv
, end1
, len_mid
);
2182 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2183 Fset_text_properties (start1
, end2
, Qnil
, Qnil
);
2184 #endif /* USE_TEXT_PROPERTIES */
2186 /* holds region 2 */
2188 temp
= (unsigned char *) xmalloc (len2
);
2190 temp
= (unsigned char *) alloca (len2
);
2191 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1
);
2192 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2
);
2193 bcopy (start2_addr
, temp
, len2
);
2194 bcopy (start1_addr
, start1_addr
+ len_mid
+ len2
, len1
);
2195 safe_bcopy (start1_addr
+ len1
, start1_addr
+ len2
, len_mid
);
2196 bcopy (temp
, start1_addr
, len2
);
2199 #ifdef USE_TEXT_PROPERTIES
2200 graft_intervals_into_buffer (tmp_interval1
, end2
- len1
,
2201 len1
, current_buffer
, 0);
2202 graft_intervals_into_buffer (tmp_interval_mid
, start1
+ len2
,
2203 len_mid
, current_buffer
, 0);
2204 graft_intervals_into_buffer (tmp_interval2
, start1
,
2205 len2
, current_buffer
, 0);
2206 #endif /* USE_TEXT_PROPERTIES */
2209 /* Second region smaller than first. */
2211 len_mid
= start2
- end1
;
2212 record_change (start1
, (end2
- start1
));
2213 modify_region (current_buffer
, start1
, end2
);
2215 #ifdef USE_TEXT_PROPERTIES
2216 tmp_interval1
= copy_intervals (cur_intv
, start1
, len1
);
2217 tmp_interval_mid
= copy_intervals (cur_intv
, end1
, len_mid
);
2218 tmp_interval2
= copy_intervals (cur_intv
, start2
, len2
);
2219 Fset_text_properties (start1
, end2
, Qnil
, Qnil
);
2220 #endif /* USE_TEXT_PROPERTIES */
2222 /* holds region 1 */
2224 temp
= (unsigned char *) xmalloc (len1
);
2226 temp
= (unsigned char *) alloca (len1
);
2227 start1_addr
= BUF_CHAR_ADDRESS (current_buffer
, start1
);
2228 start2_addr
= BUF_CHAR_ADDRESS (current_buffer
, start2
);
2229 bcopy (start1_addr
, temp
, len1
);
2230 bcopy (start2_addr
, start1_addr
, len2
);
2231 bcopy (start1_addr
+ len1
, start1_addr
+ len2
, len_mid
);
2232 bcopy (temp
, start1_addr
+ len2
+ len_mid
, len1
);
2235 #ifdef USE_TEXT_PROPERTIES
2236 graft_intervals_into_buffer (tmp_interval1
, end2
- len1
,
2237 len1
, current_buffer
, 0);
2238 graft_intervals_into_buffer (tmp_interval_mid
, start1
+ len2
,
2239 len_mid
, current_buffer
, 0);
2240 graft_intervals_into_buffer (tmp_interval2
, start1
,
2241 len2
, current_buffer
, 0);
2242 #endif /* USE_TEXT_PROPERTIES */
2246 /* todo: this will be slow, because for every transposition, we
2247 traverse the whole friggin marker list. Possible solutions:
2248 somehow get a list of *all* the markers across multiple
2249 transpositions and do it all in one swell phoop. Or maybe modify
2250 Emacs' marker code to keep an ordered list or tree. This might
2251 be nicer, and more beneficial in the long run, but would be a
2252 bunch of work. Plus the way they're arranged now is nice. */
2253 if (NILP (leave_markers
))
2255 transpose_markers (start1
, end1
, start2
, end2
);
2256 fix_overlays_in_range (start1
, end2
);
2266 DEFVAR_LISP ("system-name", &Vsystem_name
,
2267 "The name of the machine Emacs is running on.");
2269 DEFVAR_LISP ("user-full-name", &Vuser_full_name
,
2270 "The full name of the user logged in.");
2272 DEFVAR_LISP ("user-name", &Vuser_name
,
2273 "The user's name, taken from environment variables if possible.");
2275 DEFVAR_LISP ("user-real-name", &Vuser_real_name
,
2276 "The user's name, based upon the real uid only.");
2278 defsubr (&Schar_equal
);
2279 defsubr (&Sgoto_char
);
2280 defsubr (&Sstring_to_char
);
2281 defsubr (&Schar_to_string
);
2282 defsubr (&Sbuffer_substring
);
2283 defsubr (&Sbuffer_string
);
2285 defsubr (&Spoint_marker
);
2286 defsubr (&Smark_marker
);
2288 defsubr (&Sregion_beginning
);
2289 defsubr (&Sregion_end
);
2290 /* defsubr (&Smark); */
2291 /* defsubr (&Sset_mark); */
2292 defsubr (&Ssave_excursion
);
2294 defsubr (&Sbufsize
);
2295 defsubr (&Spoint_max
);
2296 defsubr (&Spoint_min
);
2297 defsubr (&Spoint_min_marker
);
2298 defsubr (&Spoint_max_marker
);
2304 defsubr (&Sfollowing_char
);
2305 defsubr (&Sprevious_char
);
2306 defsubr (&Schar_after
);
2308 defsubr (&Sinsert_before_markers
);
2309 defsubr (&Sinsert_and_inherit
);
2310 defsubr (&Sinsert_and_inherit_before_markers
);
2311 defsubr (&Sinsert_char
);
2313 defsubr (&Suser_login_name
);
2314 defsubr (&Suser_real_login_name
);
2315 defsubr (&Suser_uid
);
2316 defsubr (&Suser_real_uid
);
2317 defsubr (&Suser_full_name
);
2318 defsubr (&Semacs_pid
);
2319 defsubr (&Scurrent_time
);
2320 defsubr (&Sformat_time_string
);
2321 defsubr (&Sdecode_time
);
2322 defsubr (&Sencode_time
);
2323 defsubr (&Scurrent_time_string
);
2324 defsubr (&Scurrent_time_zone
);
2325 defsubr (&Ssystem_name
);
2326 defsubr (&Smessage
);
2327 defsubr (&Smessage_box
);
2328 defsubr (&Smessage_or_box
);
2331 defsubr (&Sinsert_buffer_substring
);
2332 defsubr (&Scompare_buffer_substrings
);
2333 defsubr (&Ssubst_char_in_region
);
2334 defsubr (&Stranslate_region
);
2335 defsubr (&Sdelete_region
);
2337 defsubr (&Snarrow_to_region
);
2338 defsubr (&Ssave_restriction
);
2339 defsubr (&Stranspose_regions
);