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