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