(overlays_in): Don't count empty overlays at END.
[bpt/emacs.git] / src / editfns.c
CommitLineData
35692fe0 1/* Lisp functions pertaining to editing.
f8c25f1b 2 Copyright (C) 1985,86,87,89,93,94,95 Free Software Foundation, Inc.
35692fe0
JB
3
4This file is part of GNU Emacs.
5
6GNU Emacs is free software; you can redistribute it and/or modify
7it under the terms of the GNU General Public License as published by
7c938215 8the Free Software Foundation; either version 2, or (at your option)
35692fe0
JB
9any later version.
10
11GNU Emacs is distributed in the hope that it will be useful,
12but WITHOUT ANY WARRANTY; without even the implied warranty of
13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14GNU General Public License for more details.
15
16You should have received a copy of the GNU General Public License
17along with GNU Emacs; see the file COPYING. If not, write to
18the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
19
20
738429d1
JB
21#include <sys/types.h>
22
18160b98 23#include <config.h>
bfb61299
JB
24
25#ifdef VMS
956ace37 26#include "vms-pwd.h"
bfb61299 27#else
35692fe0 28#include <pwd.h>
bfb61299
JB
29#endif
30
35692fe0 31#include "lisp.h"
74d6d8c5 32#include "intervals.h"
35692fe0
JB
33#include "buffer.h"
34#include "window.h"
35
956ace37 36#include "systime.h"
35692fe0
JB
37
38#define min(a, b) ((a) < (b) ? (a) : (b))
39#define max(a, b) ((a) > (b) ? (a) : (b))
40
b1b0ee5a 41extern void insert_from_buffer ();
3c887943 42static long difftm ();
b1b0ee5a 43
35692fe0
JB
44/* Some static data, and a function to initialize it for each run */
45
46Lisp_Object Vsystem_name;
35b34f72
KH
47Lisp_Object Vuser_real_login_name; /* login name of current user ID */
48Lisp_Object Vuser_full_name; /* full name of current user */
49Lisp_Object Vuser_login_name; /* user name from LOGNAME or USER */
35692fe0
JB
50
51void
52init_editfns ()
53{
52b14ac0 54 char *user_name;
35692fe0
JB
55 register unsigned char *p, *q, *r;
56 struct passwd *pw; /* password entry for the current user */
57 extern char *index ();
58 Lisp_Object tem;
59
60 /* Set up system_name even when dumping. */
ac988277 61 init_system_name ();
35692fe0
JB
62
63#ifndef CANNOT_DUMP
64 /* Don't bother with this on initial start when just dumping out */
65 if (!initialized)
66 return;
67#endif /* not CANNOT_DUMP */
68
69 pw = (struct passwd *) getpwuid (getuid ());
87485d6f
MW
70#ifdef MSDOS
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.) */
35b34f72 74 Vuser_real_login_name = build_string (pw ? pw->pw_name : "root");
87485d6f 75#else
35b34f72 76 Vuser_real_login_name = build_string (pw ? pw->pw_name : "unknown");
87485d6f 77#endif
35692fe0 78
52b14ac0
JB
79 /* Get the effective user name, by consulting environment variables,
80 or the effective uid if those are unset. */
2c9ae24e 81 user_name = (char *) getenv ("LOGNAME");
35692fe0 82 if (!user_name)
4691c06d
RS
83#ifdef WINDOWSNT
84 user_name = (char *) getenv ("USERNAME"); /* it's USERNAME on NT */
85#else /* WINDOWSNT */
2c9ae24e 86 user_name = (char *) getenv ("USER");
4691c06d 87#endif /* WINDOWSNT */
52b14ac0
JB
88 if (!user_name)
89 {
90 pw = (struct passwd *) getpwuid (geteuid ());
91 user_name = (char *) (pw ? pw->pw_name : "unknown");
92 }
35b34f72 93 Vuser_login_name = build_string (user_name);
35692fe0 94
52b14ac0
JB
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. */
35b34f72 97 tem = Fstring_equal (Vuser_login_name, Vuser_real_login_name);
56a98455 98 if (NILP (tem))
35b34f72 99 pw = (struct passwd *) getpwnam (XSTRING (Vuser_login_name)->data);
35692fe0
JB
100
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));
104
105#ifdef AMPERSAND_FULL_NAME
106 p = XSTRING (Vuser_full_name)->data;
8f1e2d16 107 q = (unsigned char *) index (p, '&');
35692fe0
JB
108 /* Substitute the login name for the &, upcasing the first character. */
109 if (q)
110 {
35b34f72
KH
111 r = (unsigned char *) alloca (strlen (p)
112 + XSTRING (Vuser_login_name)->size + 1);
35692fe0
JB
113 bcopy (p, r, q - p);
114 r[q - p] = 0;
35b34f72 115 strcat (r, XSTRING (Vuser_login_name)->data);
35692fe0
JB
116 r[q - p] = UPCASE (r[q - p]);
117 strcat (r, q + 1);
118 Vuser_full_name = build_string (r);
119 }
120#endif /* AMPERSAND_FULL_NAME */
9d36d071 121
8f1e2d16 122 p = (unsigned char *) getenv ("NAME");
9d36d071
RS
123 if (p)
124 Vuser_full_name = build_string (p);
35692fe0
JB
125}
126\f
127DEFUN ("char-to-string", Fchar_to_string, Schar_to_string, 1, 1, 0,
128 "Convert arg CHAR to a one-character string containing that character.")
129 (n)
130 Lisp_Object n;
131{
132 char c;
133 CHECK_NUMBER (n, 0);
134
135 c = XINT (n);
136 return make_string (&c, 1);
137}
138
139DEFUN ("string-to-char", Fstring_to_char, Sstring_to_char, 1, 1, 0,
140 "Convert arg STRING to a character, the first character of that string.")
141 (str)
142 register Lisp_Object str;
143{
144 register Lisp_Object val;
145 register struct Lisp_String *p;
146 CHECK_STRING (str, 0);
147
148 p = XSTRING (str);
149 if (p->size)
55561c63 150 XSETFASTINT (val, ((unsigned char *) p->data)[0]);
35692fe0 151 else
55561c63 152 XSETFASTINT (val, 0);
35692fe0
JB
153 return val;
154}
155\f
156static Lisp_Object
157buildmark (val)
158 int val;
159{
160 register Lisp_Object mark;
161 mark = Fmake_marker ();
162 Fset_marker (mark, make_number (val), Qnil);
163 return mark;
164}
165
166DEFUN ("point", Fpoint, Spoint, 0, 0, 0,
167 "Return value of point, as an integer.\n\
168Beginning of buffer is position (point-min)")
169 ()
170{
171 Lisp_Object temp;
55561c63 172 XSETFASTINT (temp, point);
35692fe0
JB
173 return temp;
174}
175
176DEFUN ("point-marker", Fpoint_marker, Spoint_marker, 0, 0, 0,
177 "Return value of point, as a marker object.")
178 ()
179{
180 return buildmark (point);
181}
182
183int
184clip_to_bounds (lower, num, upper)
185 int lower, num, upper;
186{
187 if (num < lower)
188 return lower;
189 else if (num > upper)
190 return upper;
191 else
192 return num;
193}
194
195DEFUN ("goto-char", Fgoto_char, Sgoto_char, 1, 1, "NGoto char: ",
196 "Set point to POSITION, a number or marker.\n\
197Beginning of buffer is position (point-min), end is (point-max).")
198 (n)
199 register Lisp_Object n;
200{
201 CHECK_NUMBER_COERCE_MARKER (n, 0);
202
203 SET_PT (clip_to_bounds (BEGV, XINT (n), ZV));
204 return n;
205}
206
207static Lisp_Object
208region_limit (beginningp)
209 int beginningp;
210{
646d9d18 211 extern Lisp_Object Vmark_even_if_inactive; /* Defined in callint.c. */
35692fe0 212 register Lisp_Object m;
c9dd14e1
RM
213 if (!NILP (Vtransient_mark_mode) && NILP (Vmark_even_if_inactive)
214 && NILP (current_buffer->mark_active))
215 Fsignal (Qmark_inactive, Qnil);
35692fe0 216 m = Fmarker_position (current_buffer->mark);
56a98455 217 if (NILP (m)) error ("There is no region now");
35692fe0
JB
218 if ((point < XFASTINT (m)) == beginningp)
219 return (make_number (point));
220 else
221 return (m);
222}
223
224DEFUN ("region-beginning", Fregion_beginning, Sregion_beginning, 0, 0, 0,
225 "Return position of beginning of region, as an integer.")
226 ()
227{
228 return (region_limit (1));
229}
230
231DEFUN ("region-end", Fregion_end, Sregion_end, 0, 0, 0,
232 "Return position of end of region, as an integer.")
233 ()
234{
235 return (region_limit (0));
236}
237
238#if 0 /* now in lisp code */
239DEFUN ("mark", Fmark, Smark, 0, 0, 0,
240 "Return this buffer's mark value as integer, or nil if no mark.\n\
241If you are using this in an editing command, you are most likely making\n\
242a mistake; see the documentation of `set-mark'.")
243 ()
244{
245 return Fmarker_position (current_buffer->mark);
246}
247#endif /* commented out code */
248
249DEFUN ("mark-marker", Fmark_marker, Smark_marker, 0, 0, 0,
250 "Return this buffer's mark, as a marker object.\n\
251Watch out! Moving this marker changes the mark position.\n\
252If you set the marker not to point anywhere, the buffer will have no mark.")
253 ()
254{
255 return current_buffer->mark;
256}
257
258#if 0 /* this is now in lisp code */
259DEFUN ("set-mark", Fset_mark, Sset_mark, 1, 1, 0,
260 "Set this buffer's mark to POS. Don't use this function!\n\
261That is to say, don't use this function unless you want\n\
262the user to see that the mark has moved, and you want the previous\n\
263mark position to be lost.\n\
264\n\
265Normally, when a new mark is set, the old one should go on the stack.\n\
266This is why most applications should use push-mark, not set-mark.\n\
267\n\
268Novice programmers often try to use the mark for the wrong purposes.\n\
269The mark saves a location for the user's convenience.\n\
270Most editing commands should not alter the mark.\n\
271To remember a location for internal use in the Lisp program,\n\
272store it in a Lisp variable. Example:\n\
273\n\
274 (let ((beg (point))) (forward-line 1) (delete-region beg (point))).")
275 (pos)
276 Lisp_Object pos;
277{
56a98455 278 if (NILP (pos))
35692fe0
JB
279 {
280 current_buffer->mark = Qnil;
281 return Qnil;
282 }
283 CHECK_NUMBER_COERCE_MARKER (pos, 0);
284
56a98455 285 if (NILP (current_buffer->mark))
35692fe0
JB
286 current_buffer->mark = Fmake_marker ();
287
288 Fset_marker (current_buffer->mark, pos, Qnil);
289 return pos;
290}
291#endif /* commented-out code */
292
293Lisp_Object
294save_excursion_save ()
295{
0e2c9c70
JB
296 register int visible = (XBUFFER (XWINDOW (selected_window)->buffer)
297 == current_buffer);
35692fe0
JB
298
299 return Fcons (Fpoint_marker (),
0e2c9c70 300 Fcons (Fcopy_marker (current_buffer->mark),
9772455e
RS
301 Fcons (visible ? Qt : Qnil,
302 current_buffer->mark_active)));
35692fe0
JB
303}
304
305Lisp_Object
306save_excursion_restore (info)
307 register Lisp_Object info;
308{
03d18690 309 register Lisp_Object tem, tem1, omark, nmark;
35692fe0
JB
310
311 tem = Fmarker_buffer (Fcar (info));
312 /* If buffer being returned to is now deleted, avoid error */
313 /* Otherwise could get error here while unwinding to top level
314 and crash */
315 /* In that case, Fmarker_buffer returns nil now. */
56a98455 316 if (NILP (tem))
35692fe0
JB
317 return Qnil;
318 Fset_buffer (tem);
319 tem = Fcar (info);
320 Fgoto_char (tem);
321 unchain_marker (tem);
322 tem = Fcar (Fcdr (info));
03d18690 323 omark = Fmarker_position (current_buffer->mark);
35692fe0 324 Fset_marker (current_buffer->mark, tem, Fcurrent_buffer ());
03d18690 325 nmark = Fmarker_position (tem);
35692fe0
JB
326 unchain_marker (tem);
327 tem = Fcdr (Fcdr (info));
ef580991
RS
328#if 0 /* We used to make the current buffer visible in the selected window
329 if that was true previously. That avoids some anomalies.
330 But it creates others, and it wasn't documented, and it is simpler
331 and cleaner never to alter the window/buffer connections. */
9772455e
RS
332 tem1 = Fcar (tem);
333 if (!NILP (tem1)
0e2c9c70 334 && current_buffer != XBUFFER (XWINDOW (selected_window)->buffer))
35692fe0 335 Fswitch_to_buffer (Fcurrent_buffer (), Qnil);
ef580991 336#endif /* 0 */
9772455e
RS
337
338 tem1 = current_buffer->mark_active;
339 current_buffer->mark_active = Fcdr (tem);
9fed2b18
RS
340 if (!NILP (Vrun_hooks))
341 {
03d18690
RS
342 /* If mark is active now, and either was not active
343 or was at a different place, run the activate hook. */
9fed2b18 344 if (! NILP (current_buffer->mark_active))
03d18690
RS
345 {
346 if (! EQ (omark, nmark))
347 call1 (Vrun_hooks, intern ("activate-mark-hook"));
348 }
349 /* If mark has ceased to be active, run deactivate hook. */
9fed2b18
RS
350 else if (! NILP (tem1))
351 call1 (Vrun_hooks, intern ("deactivate-mark-hook"));
352 }
35692fe0
JB
353 return Qnil;
354}
355
356DEFUN ("save-excursion", Fsave_excursion, Ssave_excursion, 0, UNEVALLED, 0,
357 "Save point, mark, and current buffer; execute BODY; restore those things.\n\
358Executes BODY just like `progn'.\n\
359The values of point, mark and the current buffer are restored\n\
9772455e
RS
360even in case of abnormal exit (throw or error).\n\
361The state of activation of the mark is also restored.")
35692fe0
JB
362 (args)
363 Lisp_Object args;
364{
365 register Lisp_Object val;
366 int count = specpdl_ptr - specpdl;
367
368 record_unwind_protect (save_excursion_restore, save_excursion_save ());
369
370 val = Fprogn (args);
371 return unbind_to (count, val);
372}
373\f
374DEFUN ("buffer-size", Fbufsize, Sbufsize, 0, 0, 0,
375 "Return the number of characters in the current buffer.")
376 ()
377{
378 Lisp_Object temp;
55561c63 379 XSETFASTINT (temp, Z - BEG);
35692fe0
JB
380 return temp;
381}
382
383DEFUN ("point-min", Fpoint_min, Spoint_min, 0, 0, 0,
384 "Return the minimum permissible value of point in the current buffer.\n\
4c390850 385This is 1, unless narrowing (a buffer restriction) is in effect.")
35692fe0
JB
386 ()
387{
388 Lisp_Object temp;
55561c63 389 XSETFASTINT (temp, BEGV);
35692fe0
JB
390 return temp;
391}
392
393DEFUN ("point-min-marker", Fpoint_min_marker, Spoint_min_marker, 0, 0, 0,
394 "Return a marker to the minimum permissible value of point in this buffer.\n\
4c390850 395This is the beginning, unless narrowing (a buffer restriction) is in effect.")
35692fe0
JB
396 ()
397{
398 return buildmark (BEGV);
399}
400
401DEFUN ("point-max", Fpoint_max, Spoint_max, 0, 0, 0,
402 "Return the maximum permissible value of point in the current buffer.\n\
4c390850
RS
403This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
404is in effect, in which case it is less.")
35692fe0
JB
405 ()
406{
407 Lisp_Object temp;
55561c63 408 XSETFASTINT (temp, ZV);
35692fe0
JB
409 return temp;
410}
411
412DEFUN ("point-max-marker", Fpoint_max_marker, Spoint_max_marker, 0, 0, 0,
413 "Return a marker to the maximum permissible value of point in this buffer.\n\
4c390850
RS
414This is (1+ (buffer-size)), unless narrowing (a buffer restriction)\n\
415is in effect, in which case it is less.")
35692fe0
JB
416 ()
417{
418 return buildmark (ZV);
419}
420
850a8179
JB
421DEFUN ("following-char", Ffollowing_char, Sfollowing_char, 0, 0, 0,
422 "Return the character following point, as a number.\n\
423At the end of the buffer or accessible region, return 0.")
35692fe0
JB
424 ()
425{
426 Lisp_Object temp;
850a8179 427 if (point >= ZV)
55561c63 428 XSETFASTINT (temp, 0);
850a8179 429 else
55561c63 430 XSETFASTINT (temp, FETCH_CHAR (point));
35692fe0
JB
431 return temp;
432}
433
850a8179
JB
434DEFUN ("preceding-char", Fprevious_char, Sprevious_char, 0, 0, 0,
435 "Return the character preceding point, as a number.\n\
436At the beginning of the buffer or accessible region, return 0.")
35692fe0
JB
437 ()
438{
439 Lisp_Object temp;
440 if (point <= BEGV)
55561c63 441 XSETFASTINT (temp, 0);
35692fe0 442 else
55561c63 443 XSETFASTINT (temp, FETCH_CHAR (point - 1));
35692fe0
JB
444 return temp;
445}
446
447DEFUN ("bobp", Fbobp, Sbobp, 0, 0, 0,
448 "Return T if point is at the beginning of the buffer.\n\
449If the buffer is narrowed, this means the beginning of the narrowed part.")
450 ()
451{
452 if (point == BEGV)
453 return Qt;
454 return Qnil;
455}
456
457DEFUN ("eobp", Feobp, Seobp, 0, 0, 0,
458 "Return T if point is at the end of the buffer.\n\
459If the buffer is narrowed, this means the end of the narrowed part.")
460 ()
461{
462 if (point == ZV)
463 return Qt;
464 return Qnil;
465}
466
467DEFUN ("bolp", Fbolp, Sbolp, 0, 0, 0,
468 "Return T if point is at the beginning of a line.")
469 ()
470{
471 if (point == BEGV || FETCH_CHAR (point - 1) == '\n')
472 return Qt;
473 return Qnil;
474}
475
476DEFUN ("eolp", Feolp, Seolp, 0, 0, 0,
477 "Return T if point is at the end of a line.\n\
478`End of a line' includes point being at the end of the buffer.")
479 ()
480{
481 if (point == ZV || FETCH_CHAR (point) == '\n')
482 return Qt;
483 return Qnil;
484}
485
486DEFUN ("char-after", Fchar_after, Schar_after, 1, 1, 0,
487 "Return character in current buffer at position POS.\n\
488POS is an integer or a buffer pointer.\n\
489If POS is out of range, the value is nil.")
490 (pos)
491 Lisp_Object pos;
492{
493 register Lisp_Object val;
494 register int n;
495
496 CHECK_NUMBER_COERCE_MARKER (pos, 0);
497
498 n = XINT (pos);
499 if (n < BEGV || n >= ZV) return Qnil;
500
55561c63 501 XSETFASTINT (val, FETCH_CHAR (n));
35692fe0
JB
502 return val;
503}
504\f
87485d6f 505DEFUN ("user-login-name", Fuser_login_name, Suser_login_name, 0, 1, 0,
35692fe0
JB
506 "Return the name under which the user logged in, as a string.\n\
507This is based on the effective uid, not the real uid.\n\
2c9ae24e 508Also, if the environment variable LOGNAME or USER is set,\n\
87485d6f
MW
509that determines the value of this function.\n\n\
510If optional argument UID is an integer, return the login name of the user\n\
511with that uid, or nil if there is no such user.")
512 (uid)
513 Lisp_Object uid;
35692fe0 514{
87485d6f
MW
515 struct passwd *pw;
516
f8a0e364
RS
517 /* Set up the user name info if we didn't do it before.
518 (That can happen if Emacs is dumpable
519 but you decide to run `temacs -l loadup' and not dump. */
35b34f72 520 if (INTEGERP (Vuser_login_name))
f8a0e364 521 init_editfns ();
87485d6f
MW
522
523 if (NILP (uid))
35b34f72 524 return Vuser_login_name;
87485d6f
MW
525
526 CHECK_NUMBER (uid, 0);
527 pw = (struct passwd *) getpwuid (XINT (uid));
528 return (pw ? build_string (pw->pw_name) : Qnil);
35692fe0
JB
529}
530
531DEFUN ("user-real-login-name", Fuser_real_login_name, Suser_real_login_name,
532 0, 0, 0,
533 "Return the name of the user's real uid, as a string.\n\
9658bdd0 534This ignores the environment variables LOGNAME and USER, so it differs from\n\
b1da234a 535`user-login-name' when running under `su'.")
35692fe0
JB
536 ()
537{
f8a0e364
RS
538 /* Set up the user name info if we didn't do it before.
539 (That can happen if Emacs is dumpable
540 but you decide to run `temacs -l loadup' and not dump. */
35b34f72 541 if (INTEGERP (Vuser_login_name))
f8a0e364 542 init_editfns ();
35b34f72 543 return Vuser_real_login_name;
35692fe0
JB
544}
545
546DEFUN ("user-uid", Fuser_uid, Suser_uid, 0, 0, 0,
547 "Return the effective uid of Emacs, as an integer.")
548 ()
549{
550 return make_number (geteuid ());
551}
552
553DEFUN ("user-real-uid", Fuser_real_uid, Suser_real_uid, 0, 0, 0,
554 "Return the real uid of Emacs, as an integer.")
555 ()
556{
557 return make_number (getuid ());
558}
559
560DEFUN ("user-full-name", Fuser_full_name, Suser_full_name, 0, 0, 0,
561 "Return the full name of the user logged in, as a string.")
562 ()
563{
564 return Vuser_full_name;
565}
566
567DEFUN ("system-name", Fsystem_name, Ssystem_name, 0, 0, 0,
568 "Return the name of the machine you are running on, as a string.")
569 ()
570{
571 return Vsystem_name;
572}
573
ac988277
KH
574/* For the benefit of callers who don't want to include lisp.h */
575char *
576get_system_name ()
577{
316506b2 578 return (char *) XSTRING (Vsystem_name)->data;
ac988277
KH
579}
580
7fd233b3
RS
581DEFUN ("emacs-pid", Femacs_pid, Semacs_pid, 0, 0, 0,
582 "Return the process ID of Emacs, as an integer.")
583 ()
584{
585 return make_number (getpid ());
586}
587
d940e0e4 588DEFUN ("current-time", Fcurrent_time, Scurrent_time, 0, 0, 0,
956ace37
JB
589 "Return the current time, as the number of seconds since 12:00 AM January 1970.\n\
590The time is returned as a list of three integers. The first has the\n\
591most significant 16 bits of the seconds, while the second has the\n\
592least significant 16 bits. The third integer gives the microsecond\n\
593count.\n\
594\n\
595The microsecond count is zero on systems that do not provide\n\
596resolution finer than a second.")
d940e0e4
JB
597 ()
598{
956ace37
JB
599 EMACS_TIME t;
600 Lisp_Object result[3];
601
602 EMACS_GET_TIME (t);
d2fd0445
KH
603 XSETINT (result[0], (EMACS_SECS (t) >> 16) & 0xffff);
604 XSETINT (result[1], (EMACS_SECS (t) >> 0) & 0xffff);
605 XSETINT (result[2], EMACS_USECS (t));
956ace37
JB
606
607 return Flist (3, result);
d940e0e4
JB
608}
609\f
610
e3120ab5
JB
611static int
612lisp_time_argument (specified_time, result)
613 Lisp_Object specified_time;
614 time_t *result;
615{
616 if (NILP (specified_time))
617 return time (result) != -1;
618 else
619 {
620 Lisp_Object high, low;
621 high = Fcar (specified_time);
622 CHECK_NUMBER (high, 0);
623 low = Fcdr (specified_time);
ae683129 624 if (CONSP (low))
e3120ab5
JB
625 low = Fcar (low);
626 CHECK_NUMBER (low, 0);
627 *result = (XINT (high) << 16) + (XINT (low) & 0xffff);
628 return *result >> 16 == XINT (high);
629 }
630}
631
a82d387c
RS
632DEFUN ("format-time-string", Fformat_time_string, Sformat_time_string, 2, 2, 0,
633 "Use FORMAT-STRING to format the time TIME.\n\
634TIME is specified as (HIGH LOW . IGNORED) or (HIGH . LOW), as from\n\
635`current-time' and `file-attributes'.\n\
636FORMAT-STRING may contain %-sequences to substitute parts of the time.\n\
637%a is replaced by the abbreviated name of the day of week.\n\
638%A is replaced by the full name of the day of week.\n\
639%b is replaced by the abbreviated name of the month.\n\
640%B is replaced by the full name of the month.\n\
641%c is a synonym for \"%x %X\".\n\
642%C is a locale-specific synonym, which defaults to \"%A, %B %e, %Y\" in the C locale.\n\
643%d is replaced by the day of month, zero-padded.\n\
644%D is a synonym for \"%m/%d/%y\".\n\
645%e is replaced by the day of month, blank-padded.\n\
646%h is a synonym for \"%b\".\n\
647%H is replaced by the hour (00-23).\n\
648%I is replaced by the hour (00-12).\n\
649%j is replaced by the day of the year (001-366).\n\
650%k is replaced by the hour (0-23), blank padded.\n\
651%l is replaced by the hour (1-12), blank padded.\n\
652%m is replaced by the month (01-12).\n\
653%M is replaced by the minut (00-59).\n\
654%n is a synonym for \"\\n\".\n\
655%p is replaced by AM or PM, as appropriate.\n\
656%r is a synonym for \"%I:%M:%S %p\".\n\
657%R is a synonym for \"%H:%M\".\n\
658%S is replaced by the seconds (00-60).\n\
659%t is a synonym for \"\\t\".\n\
660%T is a synonym for \"%H:%M:%S\".\n\
661%U is replaced by the week of the year (01-52), first day of week is Sunday.\n\
662%w is replaced by the day of week (0-6), Sunday is day 0.\n\
663%W is replaced by the week of the year (01-52), first day of week is Monday.\n\
664%x is a locale-specific synonym, which defaults to \"%D\" in the C locale.\n\
665%X is a locale-specific synonym, which defaults to \"%T\" in the C locale.\n\
666%y is replaced by the year without century (00-99).\n\
667%Y is replaced by the year with century.\n\
668%Z is replaced by the time zone abbreviation.\n\
669\n\
57937a87 670The number of options reflects the `strftime' function.")
a82d387c
RS
671 (format_string, time)
672 Lisp_Object format_string, time;
673{
674 time_t value;
675 int size;
676
677 CHECK_STRING (format_string, 1);
678
679 if (! lisp_time_argument (time, &value))
680 error ("Invalid time specification");
681
682 /* This is probably enough. */
683 size = XSTRING (format_string)->size * 6 + 50;
684
685 while (1)
686 {
687 char *buf = (char *) alloca (size);
57937a87
RS
688 if (emacs_strftime (buf, size, XSTRING (format_string)->data,
689 localtime (&value)))
a82d387c
RS
690 return build_string (buf);
691 /* If buffer was too small, make it bigger. */
692 size *= 2;
693 }
694}
695
4691c06d
RS
696DEFUN ("decode-time", Fdecode_time, Sdecode_time, 0, 1, 0,
697 "Decode a time value as (SEC MINUTE HOUR DAY MONTH YEAR DOW DST ZONE).\n\
698The optional SPECIFIED-TIME should be a list of (HIGH LOW . IGNORED)\n\
699or (HIGH . LOW), as from `current-time' and `file-attributes', or `nil'\n\
700to use the current time. The list has the following nine members:\n\
701SEC is an integer between 0 and 59. MINUTE is an integer between 0 and 59.\n\
702HOUR is an integer between 0 and 23. DAY is an integer between 1 and 31.\n\
703MONTH is an integer between 1 and 12. YEAR is an integer indicating the\n\
704four-digit year. DOW is the day of week, an integer between 0 and 6, where\n\
7050 is Sunday. DST is t if daylight savings time is effect, otherwise nil.\n\
706ZONE is an integer indicating the number of seconds east of Greenwich.\n\
707(Note that Common Lisp has different meanings for DOW and ZONE.)")
708 (specified_time)
709 Lisp_Object specified_time;
710{
711 time_t time_spec;
3c887943 712 struct tm save_tm;
4691c06d
RS
713 struct tm *decoded_time;
714 Lisp_Object list_args[9];
715
716 if (! lisp_time_argument (specified_time, &time_spec))
717 error ("Invalid time specification");
718
719 decoded_time = localtime (&time_spec);
3c887943
KH
720 XSETFASTINT (list_args[0], decoded_time->tm_sec);
721 XSETFASTINT (list_args[1], decoded_time->tm_min);
722 XSETFASTINT (list_args[2], decoded_time->tm_hour);
723 XSETFASTINT (list_args[3], decoded_time->tm_mday);
724 XSETFASTINT (list_args[4], decoded_time->tm_mon + 1);
725 XSETFASTINT (list_args[5], decoded_time->tm_year + 1900);
726 XSETFASTINT (list_args[6], decoded_time->tm_wday);
4691c06d 727 list_args[7] = (decoded_time->tm_isdst)? Qt : Qnil;
3c887943
KH
728
729 /* Make a copy, in case gmtime modifies the struct. */
730 save_tm = *decoded_time;
731 decoded_time = gmtime (&time_spec);
732 if (decoded_time == 0)
733 list_args[8] = Qnil;
734 else
735 XSETINT (list_args[8], difftm (&save_tm, decoded_time));
4691c06d
RS
736 return Flist (9, list_args);
737}
738
12c091cc
RS
739static char days_per_month[11]
740 = { 31, 30, 31, 30, 31, 31, 30, 31, 30, 31, 31 };
741
cce7b8a0 742DEFUN ("encode-time", Fencode_time, Sencode_time, 6, 7, 0,
d65666d5 743 "Convert SEC, MINUTE, HOUR, DAY, MONTH, YEAR and ZONE to internal time.\n\
167d976b
KH
744This is the reverse operation of `decode-time', which see. ZONE defaults\n\
745to the current time zone and daylight savings time if not specified; if\n\
746specified, it can be either a list (as from `current-time-zone') or an\n\
747integer (as from `decode-time'), and is applied without consideration for\n\
1b8fa736 748daylight savings time.\n\
01ba8cce 749Year numbers less than 100 are treated just like other year numbers.\n\
3d0b6ad5 750If you want them to stand for years above 1900, you must do that yourself.")
d65666d5
RS
751 (sec, minute, hour, day, month, year, zone)
752 Lisp_Object sec, minute, hour, day, month, year, zone;
cce7b8a0 753{
1b8fa736
RS
754 time_t time;
755 int fullyear, mon, days, seconds, tz = 0;
cce7b8a0
RS
756
757 CHECK_NATNUM (sec, 0);
d65666d5 758 CHECK_NATNUM (minute, 1);
cce7b8a0
RS
759 CHECK_NATNUM (hour, 2);
760 CHECK_NATNUM (day, 3);
761 CHECK_NATNUM (month, 4);
762 CHECK_NATNUM (year, 5);
763
764 fullyear = XINT (year);
cce7b8a0 765
ad06e4fc
RS
766 /* Adjust incoming datespec to epoch = March 1, year 0.
767 The "date" March 1, year 0, is an abstraction used purely for its
768 computational convenience; year 0 never existed. */
1b8fa736
RS
769 mon = XINT (month) - 1 + 10;
770 fullyear += mon/12 - 1;
cce7b8a0
RS
771 mon %= 12;
772
1b8fa736
RS
773 days = XINT (day) - 1; /* day of month */
774 while (mon-- > 0) /* day of year */
775 days += days_per_month[mon];
776 days += 146097 * (fullyear/400); /* 400 years = 146097 days */
cce7b8a0 777 fullyear %= 400;
1b8fa736 778 days += 36524 * (fullyear/100); /* 100 years = 36524 days */
cce7b8a0 779 fullyear %= 100;
1b8fa736 780 days += 1461 * (fullyear/4); /* 4 years = 1461 days */
cce7b8a0 781 fullyear %= 4;
1b8fa736
RS
782 days += 365 * fullyear; /* 1 year = 365 days */
783
784 /* Adjust computed datespec to epoch = January 1, 1970. */
785 days += 59; /* March 1 is 59th day. */
786 days -= 719527; /* 1970 years = 719527 days */
787
d65666d5 788 seconds = XINT (sec) + 60 * XINT (minute) + 3600 * XINT (hour);
1b8fa736
RS
789
790 if (sizeof (time_t) == 4
791 && ((days+(seconds/86400) > 24854) || (days+(seconds/86400) < -24854)))
792 error ("the specified time is outside the representable range");
793
794 time = days * 86400 + seconds;
795
796 /* We have the correct value for UTC. Adjust for timezones. */
797 if (NILP (zone))
798 {
799 struct tm gmt, *t;
800 time_t adjusted_time;
801 int adjusted_tz;
802 /* If the system does not use timezones, gmtime returns 0, and we
803 already have the correct value, by definition. */
804 if ((t = gmtime (&time)) != 0)
805 {
806 gmt = *t;
807 t = localtime (&time);
808 tz = difftm (t, &gmt);
809 /* The timezone returned is that at the specified Universal Time,
810 not the local time, which is what we want. Adjust, repeat. */
811 adjusted_time = time - tz;
812 gmt = *gmtime (&adjusted_time); /* this is safe now */
813 t = localtime (&adjusted_time);
814 adjusted_tz = difftm (t, &gmt);
815 /* In case of discrepancy, adjust again for extra accuracy. */
816 if (adjusted_tz != tz)
817 {
818 adjusted_time = time - adjusted_tz;
819 gmt = *gmtime (&adjusted_time);
820 t = localtime (&adjusted_time);
821 adjusted_tz = difftm (t, &gmt);
822 }
823 tz = adjusted_tz;
824 }
825 }
826 else
827 {
828 if (CONSP (zone))
829 zone = Fcar (zone);
830 CHECK_NUMBER (zone, 6);
831 tz = XINT (zone);
832 }
833
834 return make_time (time - tz);
cce7b8a0
RS
835}
836
2148f2b4 837DEFUN ("current-time-string", Fcurrent_time_string, Scurrent_time_string, 0, 1, 0,
35692fe0 838 "Return the current time, as a human-readable string.\n\
2148f2b4
RS
839Programs can use this function to decode a time,\n\
840since the number of columns in each field is fixed.\n\
841The format is `Sun Sep 16 01:03:52 1973'.\n\
842If an argument is given, it specifies a time to format\n\
843instead of the current time. The argument should have the form:\n\
844 (HIGH . LOW)\n\
845or the form:\n\
846 (HIGH LOW . IGNORED).\n\
847Thus, you can use times obtained from `current-time'\n\
848and from `file-attributes'.")
849 (specified_time)
850 Lisp_Object specified_time;
851{
e3120ab5 852 time_t value;
35692fe0 853 char buf[30];
2148f2b4
RS
854 register char *tem;
855
e3120ab5
JB
856 if (! lisp_time_argument (specified_time, &value))
857 value = -1;
2148f2b4 858 tem = (char *) ctime (&value);
35692fe0
JB
859
860 strncpy (buf, tem, 24);
861 buf[24] = 0;
862
863 return build_string (buf);
864}
c2662aea 865
e3120ab5
JB
866#define TM_YEAR_ORIGIN 1900
867
868/* Yield A - B, measured in seconds. */
869static long
8e718b4e 870difftm (a, b)
e3120ab5
JB
871 struct tm *a, *b;
872{
873 int ay = a->tm_year + (TM_YEAR_ORIGIN - 1);
874 int by = b->tm_year + (TM_YEAR_ORIGIN - 1);
8e718b4e 875 /* Some compilers can't handle this as a single return statement. */
68a49b18 876 long days = (
8e718b4e
KH
877 /* difference in day of year */
878 a->tm_yday - b->tm_yday
879 /* + intervening leap days */
880 + ((ay >> 2) - (by >> 2))
881 - (ay/100 - by/100)
882 + ((ay/100 >> 2) - (by/100 >> 2))
883 /* + difference in years * 365 */
884 + (long)(ay-by) * 365
885 );
886 return (60*(60*(24*days + (a->tm_hour - b->tm_hour))
887 + (a->tm_min - b->tm_min))
888 + (a->tm_sec - b->tm_sec));
e3120ab5
JB
889}
890
891DEFUN ("current-time-zone", Fcurrent_time_zone, Scurrent_time_zone, 0, 1, 0,
892 "Return the offset and name for the local time zone.\n\
893This returns a list of the form (OFFSET NAME).\n\
894OFFSET is an integer number of seconds ahead of UTC (east of Greenwich).\n\
895 A negative value means west of Greenwich.\n\
896NAME is a string giving the name of the time zone.\n\
897If an argument is given, it specifies when the time zone offset is determined\n\
898instead of using the current time. The argument should have the form:\n\
899 (HIGH . LOW)\n\
900or the form:\n\
901 (HIGH LOW . IGNORED).\n\
902Thus, you can use times obtained from `current-time'\n\
903and from `file-attributes'.\n\
773c1fd3
JB
904\n\
905Some operating systems cannot provide all this information to Emacs;\n\
2d88f747 906in this case, `current-time-zone' returns a list containing nil for\n\
773c1fd3 907the data it can't find.")
e3120ab5
JB
908 (specified_time)
909 Lisp_Object specified_time;
c2662aea 910{
e3120ab5
JB
911 time_t value;
912 struct tm *t;
c2662aea 913
e3120ab5 914 if (lisp_time_argument (specified_time, &value)
2d88f747 915 && (t = gmtime (&value)) != 0)
e3120ab5 916 {
2d88f747 917 struct tm gmt;
e3120ab5
JB
918 long offset;
919 char *s, buf[6];
2d88f747
RS
920
921 gmt = *t; /* Make a copy, in case localtime modifies *t. */
922 t = localtime (&value);
923 offset = difftm (t, &gmt);
e3120ab5
JB
924 s = 0;
925#ifdef HAVE_TM_ZONE
926 if (t->tm_zone)
5fd4de15 927 s = (char *)t->tm_zone;
a7971c39
RS
928#else /* not HAVE_TM_ZONE */
929#ifdef HAVE_TZNAME
930 if (t->tm_isdst == 0 || t->tm_isdst == 1)
931 s = tzname[t->tm_isdst];
c2662aea 932#endif
a7971c39 933#endif /* not HAVE_TM_ZONE */
e3120ab5
JB
934 if (!s)
935 {
936 /* No local time zone name is available; use "+-NNNN" instead. */
00fc94d0 937 int am = (offset < 0 ? -offset : offset) / 60;
e3120ab5
JB
938 sprintf (buf, "%c%02d%02d", (offset < 0 ? '-' : '+'), am/60, am%60);
939 s = buf;
940 }
941 return Fcons (make_number (offset), Fcons (build_string (s), Qnil));
942 }
943 else
944 return Fmake_list (2, Qnil);
c2662aea
JB
945}
946
35692fe0
JB
947\f
948void
949insert1 (arg)
950 Lisp_Object arg;
951{
952 Finsert (1, &arg);
953}
954
52b14ac0
JB
955
956/* Callers passing one argument to Finsert need not gcpro the
957 argument "array", since the only element of the array will
958 not be used after calling insert or insert_from_string, so
959 we don't care if it gets trashed. */
960
35692fe0
JB
961DEFUN ("insert", Finsert, Sinsert, 0, MANY, 0,
962 "Insert the arguments, either strings or characters, at point.\n\
963Point moves forward so that it ends up after the inserted text.\n\
964Any other markers at the point of insertion remain before the text.")
965 (nargs, args)
966 int nargs;
967 register Lisp_Object *args;
968{
969 register int argnum;
970 register Lisp_Object tem;
971 char str[1];
35692fe0
JB
972
973 for (argnum = 0; argnum < nargs; argnum++)
974 {
975 tem = args[argnum];
976 retry:
ae683129 977 if (INTEGERP (tem))
35692fe0
JB
978 {
979 str[0] = XINT (tem);
980 insert (str, 1);
981 }
ae683129 982 else if (STRINGP (tem))
35692fe0 983 {
be91036a
RS
984 insert_from_string (tem, 0, XSTRING (tem)->size, 0);
985 }
986 else
987 {
988 tem = wrong_type_argument (Qchar_or_string_p, tem);
989 goto retry;
990 }
991 }
992
993 return Qnil;
994}
995
996DEFUN ("insert-and-inherit", Finsert_and_inherit, Sinsert_and_inherit,
997 0, MANY, 0,
998 "Insert the arguments at point, inheriting properties from adjoining text.\n\
999Point moves forward so that it ends up after the inserted text.\n\
1000Any other markers at the point of insertion remain before the text.")
1001 (nargs, args)
1002 int nargs;
1003 register Lisp_Object *args;
1004{
1005 register int argnum;
1006 register Lisp_Object tem;
1007 char str[1];
1008
1009 for (argnum = 0; argnum < nargs; argnum++)
1010 {
1011 tem = args[argnum];
1012 retry:
ae683129 1013 if (INTEGERP (tem))
be91036a
RS
1014 {
1015 str[0] = XINT (tem);
107740f5 1016 insert_and_inherit (str, 1);
be91036a 1017 }
ae683129 1018 else if (STRINGP (tem))
be91036a
RS
1019 {
1020 insert_from_string (tem, 0, XSTRING (tem)->size, 1);
35692fe0
JB
1021 }
1022 else
1023 {
1024 tem = wrong_type_argument (Qchar_or_string_p, tem);
1025 goto retry;
1026 }
1027 }
1028
35692fe0
JB
1029 return Qnil;
1030}
1031
1032DEFUN ("insert-before-markers", Finsert_before_markers, Sinsert_before_markers, 0, MANY, 0,
1033 "Insert strings or characters at point, relocating markers after the text.\n\
1034Point moves forward so that it ends up after the inserted text.\n\
1035Any other markers at the point of insertion also end up after the text.")
1036 (nargs, args)
1037 int nargs;
1038 register Lisp_Object *args;
1039{
1040 register int argnum;
1041 register Lisp_Object tem;
1042 char str[1];
35692fe0
JB
1043
1044 for (argnum = 0; argnum < nargs; argnum++)
1045 {
1046 tem = args[argnum];
1047 retry:
ae683129 1048 if (INTEGERP (tem))
35692fe0
JB
1049 {
1050 str[0] = XINT (tem);
1051 insert_before_markers (str, 1);
1052 }
ae683129 1053 else if (STRINGP (tem))
35692fe0 1054 {
be91036a
RS
1055 insert_from_string_before_markers (tem, 0, XSTRING (tem)->size, 0);
1056 }
1057 else
1058 {
1059 tem = wrong_type_argument (Qchar_or_string_p, tem);
1060 goto retry;
1061 }
1062 }
1063
1064 return Qnil;
1065}
1066
1067DEFUN ("insert-before-markers-and-inherit",
1068 Finsert_and_inherit_before_markers, Sinsert_and_inherit_before_markers,
1069 0, MANY, 0,
1070 "Insert text at point, relocating markers and inheriting properties.\n\
1071Point moves forward so that it ends up after the inserted text.\n\
1072Any other markers at the point of insertion also end up after the text.")
1073 (nargs, args)
1074 int nargs;
1075 register Lisp_Object *args;
1076{
1077 register int argnum;
1078 register Lisp_Object tem;
1079 char str[1];
1080
1081 for (argnum = 0; argnum < nargs; argnum++)
1082 {
1083 tem = args[argnum];
1084 retry:
ae683129 1085 if (INTEGERP (tem))
be91036a
RS
1086 {
1087 str[0] = XINT (tem);
107740f5 1088 insert_before_markers_and_inherit (str, 1);
be91036a 1089 }
ae683129 1090 else if (STRINGP (tem))
be91036a
RS
1091 {
1092 insert_from_string_before_markers (tem, 0, XSTRING (tem)->size, 1);
35692fe0
JB
1093 }
1094 else
1095 {
1096 tem = wrong_type_argument (Qchar_or_string_p, tem);
1097 goto retry;
1098 }
1099 }
1100
35692fe0
JB
1101 return Qnil;
1102}
1103\f
e2eeabbb 1104DEFUN ("insert-char", Finsert_char, Sinsert_char, 2, 3, 0,
35692fe0
JB
1105 "Insert COUNT (second arg) copies of CHAR (first arg).\n\
1106Point and all markers are affected as in the function `insert'.\n\
e2eeabbb
RS
1107Both arguments are required.\n\
1108The optional third arg INHERIT, if non-nil, says to inherit text properties\n\
1109from adjoining text, if those properties are sticky.")
1110 (chr, count, inherit)
1111 Lisp_Object chr, count, inherit;
35692fe0
JB
1112{
1113 register unsigned char *string;
1114 register int strlen;
1115 register int i, n;
1116
1117 CHECK_NUMBER (chr, 0);
1118 CHECK_NUMBER (count, 1);
1119
1120 n = XINT (count);
1121 if (n <= 0)
1122 return Qnil;
1123 strlen = min (n, 256);
1124 string = (unsigned char *) alloca (strlen);
1125 for (i = 0; i < strlen; i++)
1126 string[i] = XFASTINT (chr);
1127 while (n >= strlen)
1128 {
e2eeabbb
RS
1129 if (!NILP (inherit))
1130 insert_and_inherit (string, strlen);
1131 else
1132 insert (string, strlen);
35692fe0
JB
1133 n -= strlen;
1134 }
1135 if (n > 0)
83951f1e
KH
1136 {
1137 if (!NILP (inherit))
1138 insert_and_inherit (string, n);
1139 else
1140 insert (string, n);
1141 }
35692fe0
JB
1142 return Qnil;
1143}
1144
1145\f
ffd56f97
JB
1146/* Making strings from buffer contents. */
1147
1148/* Return a Lisp_String containing the text of the current buffer from
74d6d8c5 1149 START to END. If text properties are in use and the current buffer
eb8c3be9 1150 has properties in the range specified, the resulting string will also
74d6d8c5 1151 have them.
ffd56f97
JB
1152
1153 We don't want to use plain old make_string here, because it calls
1154 make_uninit_string, which can cause the buffer arena to be
1155 compacted. make_string has no way of knowing that the data has
1156 been moved, and thus copies the wrong data into the string. This
1157 doesn't effect most of the other users of make_string, so it should
1158 be left as is. But we should use this function when conjuring
1159 buffer substrings. */
74d6d8c5 1160
ffd56f97
JB
1161Lisp_Object
1162make_buffer_string (start, end)
1163 int start, end;
1164{
36b0d50e 1165 Lisp_Object result, tem, tem1;
ffd56f97
JB
1166
1167 if (start < GPT && GPT < end)
1168 move_gap (start);
1169
1170 result = make_uninit_string (end - start);
1171 bcopy (&FETCH_CHAR (start), XSTRING (result)->data, end - start);
1172
60b96ee7 1173 tem = Fnext_property_change (make_number (start), Qnil, make_number (end));
36b0d50e 1174 tem1 = Ftext_properties_at (make_number (start), Qnil);
60b96ee7
RS
1175
1176#ifdef USE_TEXT_PROPERTIES
36b0d50e 1177 if (XINT (tem) != end || !NILP (tem1))
60b96ee7
RS
1178 copy_intervals_to_string (result, current_buffer, start, end - start);
1179#endif
74d6d8c5 1180
ffd56f97
JB
1181 return result;
1182}
35692fe0
JB
1183
1184DEFUN ("buffer-substring", Fbuffer_substring, Sbuffer_substring, 2, 2, 0,
1185 "Return the contents of part of the current buffer as a string.\n\
1186The two arguments START and END are character positions;\n\
1187they can be in either order.")
1188 (b, e)
1189 Lisp_Object b, e;
1190{
1191 register int beg, end;
35692fe0
JB
1192
1193 validate_region (&b, &e);
1194 beg = XINT (b);
1195 end = XINT (e);
1196
ffd56f97 1197 return make_buffer_string (beg, end);
35692fe0
JB
1198}
1199
1200DEFUN ("buffer-string", Fbuffer_string, Sbuffer_string, 0, 0, 0,
af7bd86c
KH
1201 "Return the contents of the current buffer as a string.\n\
1202If narrowing is in effect, this function returns only the visible part\n\
1203of the buffer.")
35692fe0
JB
1204 ()
1205{
ffd56f97 1206 return make_buffer_string (BEGV, ZV);
35692fe0
JB
1207}
1208
1209DEFUN ("insert-buffer-substring", Finsert_buffer_substring, Sinsert_buffer_substring,
1210 1, 3, 0,
83ea6fc2 1211 "Insert before point a substring of the contents of buffer BUFFER.\n\
35692fe0
JB
1212BUFFER may be a buffer or a buffer name.\n\
1213Arguments START and END are character numbers specifying the substring.\n\
1214They default to the beginning and the end of BUFFER.")
1215 (buf, b, e)
1216 Lisp_Object buf, b, e;
1217{
b1b0ee5a 1218 register int beg, end, temp;
35692fe0 1219 register struct buffer *bp;
3fff2dfa 1220 Lisp_Object buffer;
35692fe0 1221
3fff2dfa
RS
1222 buffer = Fget_buffer (buf);
1223 if (NILP (buffer))
1224 nsberror (buf);
1225 bp = XBUFFER (buffer);
35692fe0 1226
56a98455 1227 if (NILP (b))
35692fe0
JB
1228 beg = BUF_BEGV (bp);
1229 else
1230 {
1231 CHECK_NUMBER_COERCE_MARKER (b, 0);
1232 beg = XINT (b);
1233 }
56a98455 1234 if (NILP (e))
35692fe0
JB
1235 end = BUF_ZV (bp);
1236 else
1237 {
1238 CHECK_NUMBER_COERCE_MARKER (e, 1);
1239 end = XINT (e);
1240 }
1241
1242 if (beg > end)
74d6d8c5 1243 temp = beg, beg = end, end = temp;
35692fe0 1244
b1b0ee5a 1245 if (!(BUF_BEGV (bp) <= beg && end <= BUF_ZV (bp)))
35692fe0
JB
1246 args_out_of_range (b, e);
1247
b1b0ee5a 1248 insert_from_buffer (bp, beg, end - beg, 0);
35692fe0
JB
1249 return Qnil;
1250}
e9cf2084
RS
1251
1252DEFUN ("compare-buffer-substrings", Fcompare_buffer_substrings, Scompare_buffer_substrings,
1253 6, 6, 0,
1254 "Compare two substrings of two buffers; return result as number.\n\
1255the value is -N if first string is less after N-1 chars,\n\
1256+N if first string is greater after N-1 chars, or 0 if strings match.\n\
1257Each substring is represented as three arguments: BUFFER, START and END.\n\
1258That makes six args in all, three for each substring.\n\n\
1259The value of `case-fold-search' in the current buffer\n\
1260determines whether case is significant or ignored.")
1261 (buffer1, start1, end1, buffer2, start2, end2)
1262 Lisp_Object buffer1, start1, end1, buffer2, start2, end2;
1263{
1264 register int begp1, endp1, begp2, endp2, temp, len1, len2, length, i;
1265 register struct buffer *bp1, *bp2;
1266 register unsigned char *trt
1267 = (!NILP (current_buffer->case_fold_search)
1268 ? XSTRING (current_buffer->case_canon_table)->data : 0);
1269
1270 /* Find the first buffer and its substring. */
1271
1272 if (NILP (buffer1))
1273 bp1 = current_buffer;
1274 else
1275 {
3fff2dfa
RS
1276 Lisp_Object buf1;
1277 buf1 = Fget_buffer (buffer1);
1278 if (NILP (buf1))
1279 nsberror (buffer1);
1280 bp1 = XBUFFER (buf1);
e9cf2084
RS
1281 }
1282
1283 if (NILP (start1))
1284 begp1 = BUF_BEGV (bp1);
1285 else
1286 {
1287 CHECK_NUMBER_COERCE_MARKER (start1, 1);
1288 begp1 = XINT (start1);
1289 }
1290 if (NILP (end1))
1291 endp1 = BUF_ZV (bp1);
1292 else
1293 {
1294 CHECK_NUMBER_COERCE_MARKER (end1, 2);
1295 endp1 = XINT (end1);
1296 }
1297
1298 if (begp1 > endp1)
1299 temp = begp1, begp1 = endp1, endp1 = temp;
1300
1301 if (!(BUF_BEGV (bp1) <= begp1
1302 && begp1 <= endp1
1303 && endp1 <= BUF_ZV (bp1)))
1304 args_out_of_range (start1, end1);
1305
1306 /* Likewise for second substring. */
1307
1308 if (NILP (buffer2))
1309 bp2 = current_buffer;
1310 else
1311 {
3fff2dfa
RS
1312 Lisp_Object buf2;
1313 buf2 = Fget_buffer (buffer2);
1314 if (NILP (buf2))
1315 nsberror (buffer2);
e9cf2084
RS
1316 bp2 = XBUFFER (buffer2);
1317 }
1318
1319 if (NILP (start2))
1320 begp2 = BUF_BEGV (bp2);
1321 else
1322 {
1323 CHECK_NUMBER_COERCE_MARKER (start2, 4);
1324 begp2 = XINT (start2);
1325 }
1326 if (NILP (end2))
1327 endp2 = BUF_ZV (bp2);
1328 else
1329 {
1330 CHECK_NUMBER_COERCE_MARKER (end2, 5);
1331 endp2 = XINT (end2);
1332 }
1333
1334 if (begp2 > endp2)
1335 temp = begp2, begp2 = endp2, endp2 = temp;
1336
1337 if (!(BUF_BEGV (bp2) <= begp2
1338 && begp2 <= endp2
1339 && endp2 <= BUF_ZV (bp2)))
1340 args_out_of_range (start2, end2);
1341
1342 len1 = endp1 - begp1;
1343 len2 = endp2 - begp2;
1344 length = len1;
1345 if (len2 < length)
1346 length = len2;
1347
1348 for (i = 0; i < length; i++)
1349 {
1350 int c1 = *BUF_CHAR_ADDRESS (bp1, begp1 + i);
1351 int c2 = *BUF_CHAR_ADDRESS (bp2, begp2 + i);
1352 if (trt)
1353 {
1354 c1 = trt[c1];
1355 c2 = trt[c2];
1356 }
1357 if (c1 < c2)
1358 return make_number (- 1 - i);
1359 if (c1 > c2)
1360 return make_number (i + 1);
1361 }
1362
1363 /* The strings match as far as they go.
1364 If one is shorter, that one is less. */
1365 if (length < len1)
1366 return make_number (length + 1);
1367 else if (length < len2)
1368 return make_number (- length - 1);
1369
1370 /* Same length too => they are equal. */
1371 return make_number (0);
1372}
35692fe0 1373\f
d5a539cd
RS
1374static Lisp_Object
1375subst_char_in_region_unwind (arg)
1376 Lisp_Object arg;
1377{
1378 return current_buffer->undo_list = arg;
1379}
1380
35692fe0
JB
1381DEFUN ("subst-char-in-region", Fsubst_char_in_region,
1382 Ssubst_char_in_region, 4, 5, 0,
1383 "From START to END, replace FROMCHAR with TOCHAR each time it occurs.\n\
1384If optional arg NOUNDO is non-nil, don't record this change for undo\n\
1385and don't mark the buffer as really changed.")
1386 (start, end, fromchar, tochar, noundo)
1387 Lisp_Object start, end, fromchar, tochar, noundo;
1388{
1389 register int pos, stop, look;
60b96ee7 1390 int changed = 0;
d5a539cd 1391 int count = specpdl_ptr - specpdl;
35692fe0
JB
1392
1393 validate_region (&start, &end);
1394 CHECK_NUMBER (fromchar, 2);
1395 CHECK_NUMBER (tochar, 3);
1396
1397 pos = XINT (start);
1398 stop = XINT (end);
1399 look = XINT (fromchar);
1400
d5a539cd
RS
1401 /* If we don't want undo, turn off putting stuff on the list.
1402 That's faster than getting rid of things,
1403 and it prevents even the entry for a first change. */
1404 if (!NILP (noundo))
1405 {
1406 record_unwind_protect (subst_char_in_region_unwind,
1407 current_buffer->undo_list);
1408 current_buffer->undo_list = Qt;
1409 }
1410
35692fe0
JB
1411 while (pos < stop)
1412 {
1413 if (FETCH_CHAR (pos) == look)
1414 {
60b96ee7
RS
1415 if (! changed)
1416 {
1417 modify_region (current_buffer, XINT (start), stop);
7653d030
RS
1418
1419 if (! NILP (noundo))
1420 {
1e158d25
RS
1421 if (MODIFF - 1 == SAVE_MODIFF)
1422 SAVE_MODIFF++;
7653d030
RS
1423 if (MODIFF - 1 == current_buffer->auto_save_modified)
1424 current_buffer->auto_save_modified++;
1425 }
1426
1427 changed = 1;
60b96ee7
RS
1428 }
1429
56a98455 1430 if (NILP (noundo))
35692fe0
JB
1431 record_change (pos, 1);
1432 FETCH_CHAR (pos) = XINT (tochar);
35692fe0
JB
1433 }
1434 pos++;
1435 }
1436
60b96ee7
RS
1437 if (changed)
1438 signal_after_change (XINT (start),
1439 stop - XINT (start), stop - XINT (start));
1440
d5a539cd 1441 unbind_to (count, Qnil);
35692fe0
JB
1442 return Qnil;
1443}
1444
1445DEFUN ("translate-region", Ftranslate_region, Stranslate_region, 3, 3, 0,
1446 "From START to END, translate characters according to TABLE.\n\
1447TABLE is a string; the Nth character in it is the mapping\n\
1448for the character with code N. Returns the number of characters changed.")
1449 (start, end, table)
1450 Lisp_Object start;
1451 Lisp_Object end;
1452 register Lisp_Object table;
1453{
1454 register int pos, stop; /* Limits of the region. */
1455 register unsigned char *tt; /* Trans table. */
1456 register int oc; /* Old character. */
1457 register int nc; /* New character. */
1458 int cnt; /* Number of changes made. */
1459 Lisp_Object z; /* Return. */
1460 int size; /* Size of translate table. */
1461
1462 validate_region (&start, &end);
1463 CHECK_STRING (table, 2);
1464
1465 size = XSTRING (table)->size;
1466 tt = XSTRING (table)->data;
1467
1468 pos = XINT (start);
1469 stop = XINT (end);
04a759c8 1470 modify_region (current_buffer, pos, stop);
35692fe0
JB
1471
1472 cnt = 0;
1473 for (; pos < stop; ++pos)
1474 {
1475 oc = FETCH_CHAR (pos);
1476 if (oc < size)
1477 {
1478 nc = tt[oc];
1479 if (nc != oc)
1480 {
1481 record_change (pos, 1);
1482 FETCH_CHAR (pos) = nc;
1483 signal_after_change (pos, 1, 1);
1484 ++cnt;
1485 }
1486 }
1487 }
1488
55561c63 1489 XSETFASTINT (z, cnt);
35692fe0
JB
1490 return (z);
1491}
1492
1493DEFUN ("delete-region", Fdelete_region, Sdelete_region, 2, 2, "r",
1494 "Delete the text between point and mark.\n\
1495When called from a program, expects two arguments,\n\
1496positions (integers or markers) specifying the stretch to be deleted.")
1497 (b, e)
1498 Lisp_Object b, e;
1499{
1500 validate_region (&b, &e);
1501 del_range (XINT (b), XINT (e));
1502 return Qnil;
1503}
1504\f
1505DEFUN ("widen", Fwiden, Swiden, 0, 0, "",
1506 "Remove restrictions (narrowing) from current buffer.\n\
1507This allows the buffer's full text to be seen and edited.")
1508 ()
1509{
1510 BEGV = BEG;
1511 SET_BUF_ZV (current_buffer, Z);
1512 clip_changed = 1;
52b14ac0
JB
1513 /* Changing the buffer bounds invalidates any recorded current column. */
1514 invalidate_current_column ();
35692fe0
JB
1515 return Qnil;
1516}
1517
1518DEFUN ("narrow-to-region", Fnarrow_to_region, Snarrow_to_region, 2, 2, "r",
1519 "Restrict editing in this buffer to the current region.\n\
1520The rest of the text becomes temporarily invisible and untouchable\n\
1521but is not deleted; if you save the buffer in a file, the invisible\n\
1522text is included in the file. \\[widen] makes all visible again.\n\
1523See also `save-restriction'.\n\
1524\n\
1525When calling from a program, pass two arguments; positions (integers\n\
1526or markers) bounding the text that should remain visible.")
1527 (b, e)
1528 register Lisp_Object b, e;
1529{
35692fe0
JB
1530 CHECK_NUMBER_COERCE_MARKER (b, 0);
1531 CHECK_NUMBER_COERCE_MARKER (e, 1);
1532
1533 if (XINT (b) > XINT (e))
1534 {
b5a6948e
KH
1535 Lisp_Object tem;
1536 tem = b; b = e; e = tem;
35692fe0
JB
1537 }
1538
1539 if (!(BEG <= XINT (b) && XINT (b) <= XINT (e) && XINT (e) <= Z))
1540 args_out_of_range (b, e);
1541
1542 BEGV = XFASTINT (b);
1543 SET_BUF_ZV (current_buffer, XFASTINT (e));
1544 if (point < XFASTINT (b))
1545 SET_PT (XFASTINT (b));
1546 if (point > XFASTINT (e))
1547 SET_PT (XFASTINT (e));
1548 clip_changed = 1;
52b14ac0
JB
1549 /* Changing the buffer bounds invalidates any recorded current column. */
1550 invalidate_current_column ();
35692fe0
JB
1551 return Qnil;
1552}
1553
1554Lisp_Object
1555save_restriction_save ()
1556{
1557 register Lisp_Object bottom, top;
1558 /* Note: I tried using markers here, but it does not win
1559 because insertion at the end of the saved region
1560 does not advance mh and is considered "outside" the saved region. */
55561c63
KH
1561 XSETFASTINT (bottom, BEGV - BEG);
1562 XSETFASTINT (top, Z - ZV);
35692fe0
JB
1563
1564 return Fcons (Fcurrent_buffer (), Fcons (bottom, top));
1565}
1566
1567Lisp_Object
1568save_restriction_restore (data)
1569 Lisp_Object data;
1570{
1571 register struct buffer *buf;
1572 register int newhead, newtail;
1573 register Lisp_Object tem;
1574
1575 buf = XBUFFER (XCONS (data)->car);
1576
1577 data = XCONS (data)->cdr;
1578
1579 tem = XCONS (data)->car;
1580 newhead = XINT (tem);
1581 tem = XCONS (data)->cdr;
1582 newtail = XINT (tem);
1583 if (newhead + newtail > BUF_Z (buf) - BUF_BEG (buf))
1584 {
1585 newhead = 0;
1586 newtail = 0;
1587 }
1588 BUF_BEGV (buf) = BUF_BEG (buf) + newhead;
1589 SET_BUF_ZV (buf, BUF_Z (buf) - newtail);
1590 clip_changed = 1;
1591
1592 /* If point is outside the new visible range, move it inside. */
1593 SET_BUF_PT (buf,
1594 clip_to_bounds (BUF_BEGV (buf), BUF_PT (buf), BUF_ZV (buf)));
1595
1596 return Qnil;
1597}
1598
1599DEFUN ("save-restriction", Fsave_restriction, Ssave_restriction, 0, UNEVALLED, 0,
1600 "Execute BODY, saving and restoring current buffer's restrictions.\n\
1601The buffer's restrictions make parts of the beginning and end invisible.\n\
1602\(They are set up with `narrow-to-region' and eliminated with `widen'.)\n\
1603This special form, `save-restriction', saves the current buffer's restrictions\n\
1604when it is entered, and restores them when it is exited.\n\
1605So any `narrow-to-region' within BODY lasts only until the end of the form.\n\
1606The old restrictions settings are restored\n\
1607even in case of abnormal exit (throw or error).\n\
1608\n\
1609The value returned is the value of the last form in BODY.\n\
1610\n\
1611`save-restriction' can get confused if, within the BODY, you widen\n\
1612and then make changes outside the area within the saved restrictions.\n\
1613\n\
1614Note: if you are using both `save-excursion' and `save-restriction',\n\
1615use `save-excursion' outermost:\n\
1616 (save-excursion (save-restriction ...))")
1617 (body)
1618 Lisp_Object body;
1619{
1620 register Lisp_Object val;
1621 int count = specpdl_ptr - specpdl;
1622
1623 record_unwind_protect (save_restriction_restore, save_restriction_save ());
1624 val = Fprogn (body);
1625 return unbind_to (count, val);
1626}
1627\f
671fbc4d
KH
1628/* Buffer for the most recent text displayed by Fmessage. */
1629static char *message_text;
1630
1631/* Allocated length of that buffer. */
1632static int message_length;
1633
35692fe0
JB
1634DEFUN ("message", Fmessage, Smessage, 1, MANY, 0,
1635 "Print a one-line message at the bottom of the screen.\n\
1636The first argument is a control string.\n\
1637It may contain %s or %d or %c to print successive following arguments.\n\
1638%s means print an argument as a string, %d means print as number in decimal,\n\
1639%c means print a number as a single character.\n\
1640The argument used by %s must be a string or a symbol;\n\
ccdac5be
JB
1641the argument used by %d or %c must be a number.\n\
1642If the first argument is nil, clear any existing message; let the\n\
1643minibuffer contents show.")
35692fe0
JB
1644 (nargs, args)
1645 int nargs;
1646 Lisp_Object *args;
1647{
ccdac5be 1648 if (NILP (args[0]))
f0250249
JB
1649 {
1650 message (0);
1651 return Qnil;
1652 }
ccdac5be
JB
1653 else
1654 {
1655 register Lisp_Object val;
1656 val = Fformat (nargs, args);
671fbc4d
KH
1657 /* Copy the data so that it won't move when we GC. */
1658 if (! message_text)
1659 {
1660 message_text = (char *)xmalloc (80);
1661 message_length = 80;
1662 }
1663 if (XSTRING (val)->size > message_length)
1664 {
1665 message_length = XSTRING (val)->size;
1666 message_text = (char *)xrealloc (message_text, message_length);
1667 }
1668 bcopy (XSTRING (val)->data, message_text, XSTRING (val)->size);
1669 message2 (message_text, XSTRING (val)->size);
ccdac5be
JB
1670 return val;
1671 }
35692fe0
JB
1672}
1673
cacc3e2c
RS
1674DEFUN ("message-box", Fmessage_box, Smessage_box, 1, MANY, 0,
1675 "Display a message, in a dialog box if possible.\n\
1676If a dialog box is not available, use the echo area.\n\
1677The first argument is a control string.\n\
1678It may contain %s or %d or %c to print successive following arguments.\n\
1679%s means print an argument as a string, %d means print as number in decimal,\n\
1680%c means print a number as a single character.\n\
1681The argument used by %s must be a string or a symbol;\n\
1682the argument used by %d or %c must be a number.\n\
1683If the first argument is nil, clear any existing message; let the\n\
1684minibuffer contents show.")
1685 (nargs, args)
1686 int nargs;
1687 Lisp_Object *args;
1688{
1689 if (NILP (args[0]))
1690 {
1691 message (0);
1692 return Qnil;
1693 }
1694 else
1695 {
1696 register Lisp_Object val;
1697 val = Fformat (nargs, args);
1698#ifdef HAVE_X_MENU
1699 {
1700 Lisp_Object pane, menu, obj;
1701 struct gcpro gcpro1;
1702 pane = Fcons (Fcons (build_string ("OK"), Qt), Qnil);
1703 GCPRO1 (pane);
1704 menu = Fcons (val, pane);
1705 obj = Fx_popup_dialog (Qt, menu);
1706 UNGCPRO;
1707 return val;
1708 }
1709#else
1710 /* Copy the data so that it won't move when we GC. */
1711 if (! message_text)
1712 {
1713 message_text = (char *)xmalloc (80);
1714 message_length = 80;
1715 }
1716 if (XSTRING (val)->size > message_length)
1717 {
1718 message_length = XSTRING (val)->size;
1719 message_text = (char *)xrealloc (message_text, message_length);
1720 }
1721 bcopy (XSTRING (val)->data, message_text, XSTRING (val)->size);
1722 message2 (message_text, XSTRING (val)->size);
1723 return val;
1724#endif
1725 }
1726}
1727#ifdef HAVE_X_MENU
1728extern Lisp_Object last_nonmenu_event;
1729#endif
1730DEFUN ("message-or-box", Fmessage_or_box, Smessage_or_box, 1, MANY, 0,
1731 "Display a message in a dialog box or in the echo area.\n\
1732If this command was invoked with the mouse, use a dialog box.\n\
1733Otherwise, use the echo area.\n\
1734\n\
1735The first argument is a control string.\n\
1736It may contain %s or %d or %c to print successive following arguments.\n\
1737%s means print an argument as a string, %d means print as number in decimal,\n\
1738%c means print a number as a single character.\n\
1739The argument used by %s must be a string or a symbol;\n\
1740the argument used by %d or %c must be a number.\n\
1741If the first argument is nil, clear any existing message; let the\n\
1742minibuffer contents show.")
1743 (nargs, args)
1744 int nargs;
1745 Lisp_Object *args;
1746{
1747#ifdef HAVE_X_MENU
1748 if (NILP (last_nonmenu_event) || CONSP (last_nonmenu_event))
0a56ee6b 1749 return Fmessage_box (nargs, args);
cacc3e2c
RS
1750#endif
1751 return Fmessage (nargs, args);
1752}
1753
35692fe0
JB
1754DEFUN ("format", Fformat, Sformat, 1, MANY, 0,
1755 "Format a string out of a control-string and arguments.\n\
1756The first argument is a control string.\n\
1757The other arguments are substituted into it to make the result, a string.\n\
1758It may contain %-sequences meaning to substitute the next argument.\n\
1759%s means print a string argument. Actually, prints any object, with `princ'.\n\
1760%d means print as number in decimal (%o octal, %x hex).\n\
1761%c means print a number as a single character.\n\
1762%S means print any object as an s-expression (using prin1).\n\
52b14ac0
JB
1763 The argument used for %d, %o, %x or %c must be a number.\n\
1764Use %% to put a single % into the output.")
35692fe0
JB
1765 (nargs, args)
1766 int nargs;
1767 register Lisp_Object *args;
1768{
1769 register int n; /* The number of the next arg to substitute */
1770 register int total = 5; /* An estimate of the final length */
1771 char *buf;
1772 register unsigned char *format, *end;
1773 int length;
1774 extern char *index ();
1775 /* It should not be necessary to GCPRO ARGS, because
1776 the caller in the interpreter should take care of that. */
1777
1778 CHECK_STRING (args[0], 0);
1779 format = XSTRING (args[0])->data;
1780 end = format + XSTRING (args[0])->size;
1781
1782 n = 0;
1783 while (format != end)
1784 if (*format++ == '%')
1785 {
1786 int minlen;
1787
1788 /* Process a numeric arg and skip it. */
1789 minlen = atoi (format);
1790 if (minlen > 0)
1791 total += minlen;
1792 else
1793 total -= minlen;
1794 while ((*format >= '0' && *format <= '9')
1795 || *format == '-' || *format == ' ' || *format == '.')
1796 format++;
1797
1798 if (*format == '%')
1799 format++;
1800 else if (++n >= nargs)
60764552 1801 error ("not enough arguments for format string");
35692fe0
JB
1802 else if (*format == 'S')
1803 {
1804 /* For `S', prin1 the argument and then treat like a string. */
1805 register Lisp_Object tem;
1806 tem = Fprin1_to_string (args[n], Qnil);
1807 args[n] = tem;
1808 goto string;
1809 }
ae683129 1810 else if (SYMBOLP (args[n]))
35692fe0 1811 {
d2fd0445 1812 XSETSTRING (args[n], XSYMBOL (args[n])->name);
35692fe0
JB
1813 goto string;
1814 }
ae683129 1815 else if (STRINGP (args[n]))
35692fe0
JB
1816 {
1817 string:
b22e7ecc
KH
1818 if (*format != 's' && *format != 'S')
1819 error ("format specifier doesn't match argument type");
35692fe0
JB
1820 total += XSTRING (args[n])->size;
1821 }
1822 /* Would get MPV otherwise, since Lisp_Int's `point' to low memory. */
ae683129 1823 else if (INTEGERP (args[n]) && *format != 's')
35692fe0 1824 {
4746118a 1825#ifdef LISP_FLOAT_TYPE
eb8c3be9 1826 /* The following loop assumes the Lisp type indicates
35692fe0
JB
1827 the proper way to pass the argument.
1828 So make sure we have a flonum if the argument should
1829 be a double. */
1830 if (*format == 'e' || *format == 'f' || *format == 'g')
1831 args[n] = Ffloat (args[n]);
4746118a 1832#endif
d65666d5 1833 total += 30;
35692fe0 1834 }
4746118a 1835#ifdef LISP_FLOAT_TYPE
ae683129 1836 else if (FLOATP (args[n]) && *format != 's')
35692fe0
JB
1837 {
1838 if (! (*format == 'e' || *format == 'f' || *format == 'g'))
1839 args[n] = Ftruncate (args[n]);
d65666d5 1840 total += 30;
35692fe0 1841 }
4746118a 1842#endif
35692fe0
JB
1843 else
1844 {
1845 /* Anything but a string, convert to a string using princ. */
1846 register Lisp_Object tem;
1847 tem = Fprin1_to_string (args[n], Qt);
1848 args[n] = tem;
1849 goto string;
1850 }
1851 }
1852
1853 {
1854 register int nstrings = n + 1;
50aa2f90
JB
1855
1856 /* Allocate twice as many strings as we have %-escapes; floats occupy
1857 two slots, and we're not sure how many of those we have. */
35692fe0 1858 register unsigned char **strings
50aa2f90
JB
1859 = (unsigned char **) alloca (2 * nstrings * sizeof (unsigned char *));
1860 int i;
35692fe0 1861
50aa2f90 1862 i = 0;
35692fe0
JB
1863 for (n = 0; n < nstrings; n++)
1864 {
1865 if (n >= nargs)
50aa2f90 1866 strings[i++] = (unsigned char *) "";
ae683129 1867 else if (INTEGERP (args[n]))
35692fe0
JB
1868 /* We checked above that the corresponding format effector
1869 isn't %s, which would cause MPV. */
50aa2f90 1870 strings[i++] = (unsigned char *) XINT (args[n]);
4746118a 1871#ifdef LISP_FLOAT_TYPE
ae683129 1872 else if (FLOATP (args[n]))
35692fe0 1873 {
86246708 1874 union { double d; char *half[2]; } u;
35692fe0
JB
1875
1876 u.d = XFLOAT (args[n])->data;
86246708
KH
1877 strings[i++] = (unsigned char *) u.half[0];
1878 strings[i++] = (unsigned char *) u.half[1];
35692fe0 1879 }
4746118a 1880#endif
35692fe0 1881 else
50aa2f90 1882 strings[i++] = XSTRING (args[n])->data;
35692fe0
JB
1883 }
1884
1885 /* Format it in bigger and bigger buf's until it all fits. */
1886 while (1)
1887 {
1888 buf = (char *) alloca (total + 1);
1889 buf[total - 1] = 0;
1890
50aa2f90 1891 length = doprnt (buf, total + 1, strings[0], end, i-1, strings + 1);
35692fe0
JB
1892 if (buf[total - 1] == 0)
1893 break;
1894
1895 total *= 2;
1896 }
1897 }
1898
1899 /* UNGCPRO; */
1900 return make_string (buf, length);
1901}
1902
1903/* VARARGS 1 */
1904Lisp_Object
1905#ifdef NO_ARG_ARRAY
1906format1 (string1, arg0, arg1, arg2, arg3, arg4)
679e18b1 1907 EMACS_INT arg0, arg1, arg2, arg3, arg4;
35692fe0
JB
1908#else
1909format1 (string1)
1910#endif
1911 char *string1;
1912{
1913 char buf[100];
1914#ifdef NO_ARG_ARRAY
679e18b1 1915 EMACS_INT args[5];
35692fe0
JB
1916 args[0] = arg0;
1917 args[1] = arg1;
1918 args[2] = arg2;
1919 args[3] = arg3;
1920 args[4] = arg4;
ea4d2909 1921 doprnt (buf, sizeof buf, string1, (char *)0, 5, args);
35692fe0 1922#else
ea4d2909 1923 doprnt (buf, sizeof buf, string1, (char *)0, 5, &string1 + 1);
35692fe0
JB
1924#endif
1925 return build_string (buf);
1926}
1927\f
1928DEFUN ("char-equal", Fchar_equal, Schar_equal, 2, 2, 0,
1929 "Return t if two characters match, optionally ignoring case.\n\
1930Both arguments must be characters (i.e. integers).\n\
1931Case is ignored if `case-fold-search' is non-nil in the current buffer.")
1932 (c1, c2)
1933 register Lisp_Object c1, c2;
1934{
1935 unsigned char *downcase = DOWNCASE_TABLE;
1936 CHECK_NUMBER (c1, 0);
1937 CHECK_NUMBER (c2, 1);
1938
56a98455 1939 if (!NILP (current_buffer->case_fold_search)
c34beca9
RS
1940 ? (downcase[0xff & XFASTINT (c1)] == downcase[0xff & XFASTINT (c2)]
1941 && (XFASTINT (c1) & ~0xff) == (XFASTINT (c2) & ~0xff))
35692fe0
JB
1942 : XINT (c1) == XINT (c2))
1943 return Qt;
1944 return Qnil;
1945}
b229b8d1
RS
1946\f
1947/* Transpose the markers in two regions of the current buffer, and
1948 adjust the ones between them if necessary (i.e.: if the regions
1949 differ in size).
1950
1951 Traverses the entire marker list of the buffer to do so, adding an
1952 appropriate amount to some, subtracting from some, and leaving the
1953 rest untouched. Most of this is copied from adjust_markers in insdel.c.
1954
03240d11 1955 It's the caller's job to see that (start1 <= end1 <= start2 <= end2). */
b229b8d1
RS
1956
1957void
1958transpose_markers (start1, end1, start2, end2)
1959 register int start1, end1, start2, end2;
1960{
1961 register int amt1, amt2, diff, mpos;
1962 register Lisp_Object marker;
b229b8d1 1963
03240d11 1964 /* Update point as if it were a marker. */
8de1d5f0
KH
1965 if (PT < start1)
1966 ;
1967 else if (PT < end1)
1968 TEMP_SET_PT (PT + (end2 - end1));
1969 else if (PT < start2)
1970 TEMP_SET_PT (PT + (end2 - start2) - (end1 - start1));
1971 else if (PT < end2)
1972 TEMP_SET_PT (PT - (start2 - start1));
1973
03240d11
KH
1974 /* We used to adjust the endpoints here to account for the gap, but that
1975 isn't good enough. Even if we assume the caller has tried to move the
1976 gap out of our way, it might still be at start1 exactly, for example;
1977 and that places it `inside' the interval, for our purposes. The amount
1978 of adjustment is nontrivial if there's a `denormalized' marker whose
1979 position is between GPT and GPT + GAP_SIZE, so it's simpler to leave
1980 the dirty work to Fmarker_position, below. */
b229b8d1
RS
1981
1982 /* The difference between the region's lengths */
1983 diff = (end2 - start2) - (end1 - start1);
1984
1985 /* For shifting each marker in a region by the length of the other
1986 * region plus the distance between the regions.
1987 */
1988 amt1 = (end2 - start2) + (start2 - end1);
1989 amt2 = (end1 - start1) + (start2 - end1);
1990
1e158d25 1991 for (marker = BUF_MARKERS (current_buffer); !NILP (marker);
03240d11 1992 marker = XMARKER (marker)->chain)
b229b8d1 1993 {
03240d11
KH
1994 mpos = Fmarker_position (marker);
1995 if (mpos >= start1 && mpos < end2)
1996 {
1997 if (mpos < end1)
1998 mpos += amt1;
1999 else if (mpos < start2)
2000 mpos += diff;
2001 else
2002 mpos -= amt2;
2003 if (mpos > GPT) mpos += GAP_SIZE;
2004 XMARKER (marker)->bufpos = mpos;
2005 }
b229b8d1
RS
2006 }
2007}
2008
2009DEFUN ("transpose-regions", Ftranspose_regions, Stranspose_regions, 4, 5, 0,
2010 "Transpose region START1 to END1 with START2 to END2.\n\
2011The regions may not be overlapping, because the size of the buffer is\n\
2012never changed in a transposition.\n\
2013\n\
2014Optional fifth arg LEAVE_MARKERS, if non-nil, means don't transpose\n\
2015any markers that happen to be located in the regions.\n\
2016\n\
2017Transposing beyond buffer boundaries is an error.")
2018 (startr1, endr1, startr2, endr2, leave_markers)
2019 Lisp_Object startr1, endr1, startr2, endr2, leave_markers;
2020{
2021 register int start1, end1, start2, end2,
2022 gap, len1, len_mid, len2;
3c6bc7d0 2023 unsigned char *start1_addr, *start2_addr, *temp;
b229b8d1
RS
2024
2025#ifdef USE_TEXT_PROPERTIES
2026 INTERVAL cur_intv, tmp_interval1, tmp_interval_mid, tmp_interval2;
1e158d25 2027 cur_intv = BUF_INTERVALS (current_buffer);
b229b8d1
RS
2028#endif /* USE_TEXT_PROPERTIES */
2029
2030 validate_region (&startr1, &endr1);
2031 validate_region (&startr2, &endr2);
2032
2033 start1 = XFASTINT (startr1);
2034 end1 = XFASTINT (endr1);
2035 start2 = XFASTINT (startr2);
2036 end2 = XFASTINT (endr2);
2037 gap = GPT;
2038
2039 /* Swap the regions if they're reversed. */
2040 if (start2 < end1)
2041 {
2042 register int glumph = start1;
2043 start1 = start2;
2044 start2 = glumph;
2045 glumph = end1;
2046 end1 = end2;
2047 end2 = glumph;
2048 }
2049
b229b8d1
RS
2050 len1 = end1 - start1;
2051 len2 = end2 - start2;
2052
2053 if (start2 < end1)
2054 error ("transposed regions not properly ordered");
2055 else if (start1 == end1 || start2 == end2)
2056 error ("transposed region may not be of length 0");
2057
2058 /* The possibilities are:
2059 1. Adjacent (contiguous) regions, or separate but equal regions
2060 (no, really equal, in this case!), or
2061 2. Separate regions of unequal size.
2062
2063 The worst case is usually No. 2. It means that (aside from
2064 potential need for getting the gap out of the way), there also
2065 needs to be a shifting of the text between the two regions. So
2066 if they are spread far apart, we are that much slower... sigh. */
2067
2068 /* It must be pointed out that the really studly thing to do would
2069 be not to move the gap at all, but to leave it in place and work
2070 around it if necessary. This would be extremely efficient,
2071 especially considering that people are likely to do
2072 transpositions near where they are working interactively, which
2073 is exactly where the gap would be found. However, such code
2074 would be much harder to write and to read. So, if you are
2075 reading this comment and are feeling squirrely, by all means have
2076 a go! I just didn't feel like doing it, so I will simply move
2077 the gap the minimum distance to get it out of the way, and then
2078 deal with an unbroken array. */
3c6bc7d0
RS
2079
2080 /* Make sure the gap won't interfere, by moving it out of the text
2081 we will operate on. */
2082 if (start1 < gap && gap < end2)
2083 {
2084 if (gap - start1 < end2 - gap)
2085 move_gap (start1);
2086 else
2087 move_gap (end2);
2088 }
b229b8d1
RS
2089
2090 /* Hmmm... how about checking to see if the gap is large
2091 enough to use as the temporary storage? That would avoid an
2092 allocation... interesting. Later, don't fool with it now. */
2093
2094 /* Working without memmove, for portability (sigh), so must be
2095 careful of overlapping subsections of the array... */
2096
2097 if (end1 == start2) /* adjacent regions */
2098 {
b229b8d1
RS
2099 modify_region (current_buffer, start1, end2);
2100 record_change (start1, len1 + len2);
2101
2102#ifdef USE_TEXT_PROPERTIES
2103 tmp_interval1 = copy_intervals (cur_intv, start1, len1);
2104 tmp_interval2 = copy_intervals (cur_intv, start2, len2);
2105 Fset_text_properties (start1, end2, Qnil, Qnil);
2106#endif /* USE_TEXT_PROPERTIES */
2107
2108 /* First region smaller than second. */
2109 if (len1 < len2)
2110 {
3c6bc7d0
RS
2111 /* We use alloca only if it is small,
2112 because we want to avoid stack overflow. */
2113 if (len2 > 20000)
2114 temp = (unsigned char *) xmalloc (len2);
2115 else
2116 temp = (unsigned char *) alloca (len2);
03240d11
KH
2117
2118 /* Don't precompute these addresses. We have to compute them
2119 at the last minute, because the relocating allocator might
2120 have moved the buffer around during the xmalloc. */
2121 start1_addr = BUF_CHAR_ADDRESS (current_buffer, start1);
2122 start2_addr = BUF_CHAR_ADDRESS (current_buffer, start2);
2123
b229b8d1
RS
2124 bcopy (start2_addr, temp, len2);
2125 bcopy (start1_addr, start1_addr + len2, len1);
2126 bcopy (temp, start1_addr, len2);
3c6bc7d0
RS
2127 if (len2 > 20000)
2128 free (temp);
b229b8d1
RS
2129 }
2130 else
2131 /* First region not smaller than second. */
2132 {
3c6bc7d0
RS
2133 if (len1 > 20000)
2134 temp = (unsigned char *) xmalloc (len1);
2135 else
2136 temp = (unsigned char *) alloca (len1);
03240d11
KH
2137 start1_addr = BUF_CHAR_ADDRESS (current_buffer, start1);
2138 start2_addr = BUF_CHAR_ADDRESS (current_buffer, start2);
b229b8d1
RS
2139 bcopy (start1_addr, temp, len1);
2140 bcopy (start2_addr, start1_addr, len2);
2141 bcopy (temp, start1_addr + len2, len1);
3c6bc7d0
RS
2142 if (len1 > 20000)
2143 free (temp);
b229b8d1
RS
2144 }
2145#ifdef USE_TEXT_PROPERTIES
2146 graft_intervals_into_buffer (tmp_interval1, start1 + len2,
2147 len1, current_buffer, 0);
2148 graft_intervals_into_buffer (tmp_interval2, start1,
2149 len2, current_buffer, 0);
2150#endif /* USE_TEXT_PROPERTIES */
2151 }
2152 /* Non-adjacent regions, because end1 != start2, bleagh... */
2153 else
2154 {
b229b8d1
RS
2155 if (len1 == len2)
2156 /* Regions are same size, though, how nice. */
2157 {
2158 modify_region (current_buffer, start1, end1);
2159 modify_region (current_buffer, start2, end2);
2160 record_change (start1, len1);
2161 record_change (start2, len2);
2162#ifdef USE_TEXT_PROPERTIES
2163 tmp_interval1 = copy_intervals (cur_intv, start1, len1);
2164 tmp_interval2 = copy_intervals (cur_intv, start2, len2);
2165 Fset_text_properties (start1, end1, Qnil, Qnil);
2166 Fset_text_properties (start2, end2, Qnil, Qnil);
2167#endif /* USE_TEXT_PROPERTIES */
2168
3c6bc7d0
RS
2169 if (len1 > 20000)
2170 temp = (unsigned char *) xmalloc (len1);
2171 else
2172 temp = (unsigned char *) alloca (len1);
03240d11
KH
2173 start1_addr = BUF_CHAR_ADDRESS (current_buffer, start1);
2174 start2_addr = BUF_CHAR_ADDRESS (current_buffer, start2);
b229b8d1
RS
2175 bcopy (start1_addr, temp, len1);
2176 bcopy (start2_addr, start1_addr, len2);
2177 bcopy (temp, start2_addr, len1);
3c6bc7d0
RS
2178 if (len1 > 20000)
2179 free (temp);
b229b8d1
RS
2180#ifdef USE_TEXT_PROPERTIES
2181 graft_intervals_into_buffer (tmp_interval1, start2,
2182 len1, current_buffer, 0);
2183 graft_intervals_into_buffer (tmp_interval2, start1,
2184 len2, current_buffer, 0);
2185#endif /* USE_TEXT_PROPERTIES */
2186 }
2187
2188 else if (len1 < len2) /* Second region larger than first */
2189 /* Non-adjacent & unequal size, area between must also be shifted. */
2190 {
2191 len_mid = start2 - end1;
2192 modify_region (current_buffer, start1, end2);
2193 record_change (start1, (end2 - start1));
2194#ifdef USE_TEXT_PROPERTIES
2195 tmp_interval1 = copy_intervals (cur_intv, start1, len1);
2196 tmp_interval_mid = copy_intervals (cur_intv, end1, len_mid);
2197 tmp_interval2 = copy_intervals (cur_intv, start2, len2);
2198 Fset_text_properties (start1, end2, Qnil, Qnil);
2199#endif /* USE_TEXT_PROPERTIES */
2200
3c6bc7d0
RS
2201 /* holds region 2 */
2202 if (len2 > 20000)
2203 temp = (unsigned char *) xmalloc (len2);
2204 else
2205 temp = (unsigned char *) alloca (len2);
03240d11
KH
2206 start1_addr = BUF_CHAR_ADDRESS (current_buffer, start1);
2207 start2_addr = BUF_CHAR_ADDRESS (current_buffer, start2);
3c6bc7d0 2208 bcopy (start2_addr, temp, len2);
b229b8d1 2209 bcopy (start1_addr, start1_addr + len_mid + len2, len1);
3c6bc7d0
RS
2210 safe_bcopy (start1_addr + len1, start1_addr + len2, len_mid);
2211 bcopy (temp, start1_addr, len2);
2212 if (len2 > 20000)
2213 free (temp);
b229b8d1
RS
2214#ifdef USE_TEXT_PROPERTIES
2215 graft_intervals_into_buffer (tmp_interval1, end2 - len1,
2216 len1, current_buffer, 0);
2217 graft_intervals_into_buffer (tmp_interval_mid, start1 + len2,
2218 len_mid, current_buffer, 0);
2219 graft_intervals_into_buffer (tmp_interval2, start1,
2220 len2, current_buffer, 0);
2221#endif /* USE_TEXT_PROPERTIES */
2222 }
2223 else
2224 /* Second region smaller than first. */
2225 {
2226 len_mid = start2 - end1;
2227 record_change (start1, (end2 - start1));
2228 modify_region (current_buffer, start1, end2);
2229
2230#ifdef USE_TEXT_PROPERTIES
2231 tmp_interval1 = copy_intervals (cur_intv, start1, len1);
2232 tmp_interval_mid = copy_intervals (cur_intv, end1, len_mid);
2233 tmp_interval2 = copy_intervals (cur_intv, start2, len2);
2234 Fset_text_properties (start1, end2, Qnil, Qnil);
2235#endif /* USE_TEXT_PROPERTIES */
2236
3c6bc7d0
RS
2237 /* holds region 1 */
2238 if (len1 > 20000)
2239 temp = (unsigned char *) xmalloc (len1);
2240 else
2241 temp = (unsigned char *) alloca (len1);
03240d11
KH
2242 start1_addr = BUF_CHAR_ADDRESS (current_buffer, start1);
2243 start2_addr = BUF_CHAR_ADDRESS (current_buffer, start2);
3c6bc7d0 2244 bcopy (start1_addr, temp, len1);
b229b8d1 2245 bcopy (start2_addr, start1_addr, len2);
3c6bc7d0
RS
2246 bcopy (start1_addr + len1, start1_addr + len2, len_mid);
2247 bcopy (temp, start1_addr + len2 + len_mid, len1);
2248 if (len1 > 20000)
2249 free (temp);
b229b8d1
RS
2250#ifdef USE_TEXT_PROPERTIES
2251 graft_intervals_into_buffer (tmp_interval1, end2 - len1,
2252 len1, current_buffer, 0);
2253 graft_intervals_into_buffer (tmp_interval_mid, start1 + len2,
2254 len_mid, current_buffer, 0);
2255 graft_intervals_into_buffer (tmp_interval2, start1,
2256 len2, current_buffer, 0);
2257#endif /* USE_TEXT_PROPERTIES */
2258 }
2259 }
2260
2261 /* todo: this will be slow, because for every transposition, we
2262 traverse the whole friggin marker list. Possible solutions:
2263 somehow get a list of *all* the markers across multiple
2264 transpositions and do it all in one swell phoop. Or maybe modify
2265 Emacs' marker code to keep an ordered list or tree. This might
2266 be nicer, and more beneficial in the long run, but would be a
2267 bunch of work. Plus the way they're arranged now is nice. */
2268 if (NILP (leave_markers))
8de1d5f0
KH
2269 {
2270 transpose_markers (start1, end1, start2, end2);
2271 fix_overlays_in_range (start1, end2);
2272 }
b229b8d1
RS
2273
2274 return Qnil;
2275}
35692fe0 2276
35692fe0
JB
2277\f
2278void
2279syms_of_editfns ()
2280{
f43754f6
KH
2281 DEFVAR_LISP ("system-name", &Vsystem_name,
2282 "The name of the machine Emacs is running on.");
2283
2284 DEFVAR_LISP ("user-full-name", &Vuser_full_name,
2285 "The full name of the user logged in.");
2286
35b34f72 2287 DEFVAR_LISP ("user-login-name", &Vuser_login_name,
f43754f6
KH
2288 "The user's name, taken from environment variables if possible.");
2289
35b34f72 2290 DEFVAR_LISP ("user-real-login-name", &Vuser_real_login_name,
f43754f6 2291 "The user's name, based upon the real uid only.");
35692fe0
JB
2292
2293 defsubr (&Schar_equal);
2294 defsubr (&Sgoto_char);
2295 defsubr (&Sstring_to_char);
2296 defsubr (&Schar_to_string);
2297 defsubr (&Sbuffer_substring);
2298 defsubr (&Sbuffer_string);
2299
2300 defsubr (&Spoint_marker);
2301 defsubr (&Smark_marker);
2302 defsubr (&Spoint);
2303 defsubr (&Sregion_beginning);
2304 defsubr (&Sregion_end);
2305/* defsubr (&Smark); */
2306/* defsubr (&Sset_mark); */
2307 defsubr (&Ssave_excursion);
2308
2309 defsubr (&Sbufsize);
2310 defsubr (&Spoint_max);
2311 defsubr (&Spoint_min);
2312 defsubr (&Spoint_min_marker);
2313 defsubr (&Spoint_max_marker);
2314
2315 defsubr (&Sbobp);
2316 defsubr (&Seobp);
2317 defsubr (&Sbolp);
2318 defsubr (&Seolp);
850a8179
JB
2319 defsubr (&Sfollowing_char);
2320 defsubr (&Sprevious_char);
35692fe0
JB
2321 defsubr (&Schar_after);
2322 defsubr (&Sinsert);
2323 defsubr (&Sinsert_before_markers);
be91036a
RS
2324 defsubr (&Sinsert_and_inherit);
2325 defsubr (&Sinsert_and_inherit_before_markers);
35692fe0
JB
2326 defsubr (&Sinsert_char);
2327
2328 defsubr (&Suser_login_name);
2329 defsubr (&Suser_real_login_name);
2330 defsubr (&Suser_uid);
2331 defsubr (&Suser_real_uid);
2332 defsubr (&Suser_full_name);
7fd233b3 2333 defsubr (&Semacs_pid);
d940e0e4 2334 defsubr (&Scurrent_time);
a82d387c 2335 defsubr (&Sformat_time_string);
4691c06d 2336 defsubr (&Sdecode_time);
cce7b8a0 2337 defsubr (&Sencode_time);
35692fe0 2338 defsubr (&Scurrent_time_string);
c2662aea 2339 defsubr (&Scurrent_time_zone);
35692fe0 2340 defsubr (&Ssystem_name);
35692fe0 2341 defsubr (&Smessage);
cacc3e2c
RS
2342 defsubr (&Smessage_box);
2343 defsubr (&Smessage_or_box);
35692fe0 2344 defsubr (&Sformat);
35692fe0
JB
2345
2346 defsubr (&Sinsert_buffer_substring);
e9cf2084 2347 defsubr (&Scompare_buffer_substrings);
35692fe0
JB
2348 defsubr (&Ssubst_char_in_region);
2349 defsubr (&Stranslate_region);
2350 defsubr (&Sdelete_region);
2351 defsubr (&Swiden);
2352 defsubr (&Snarrow_to_region);
2353 defsubr (&Ssave_restriction);
b229b8d1 2354 defsubr (&Stranspose_regions);
35692fe0 2355}