*** empty log message ***
[emacs.git] / src / editfns.c
blob0ef059aa055b3a5671781078fa2b7715539a7f32
1 /* Lisp functions pertaining to editing.
2 Copyright (C) 1985, 1986, 1987, 1989, 1992 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
6 GNU Emacs is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 1, or (at your option)
9 any later version.
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs; see the file COPYING. If not, write to
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
21 #include "config.h"
23 #ifdef VMS
24 #include "vms-pwd.h"
25 #else
26 #include <pwd.h>
27 #endif
29 #include "lisp.h"
30 #include "buffer.h"
31 #include "window.h"
33 #include "systime.h"
35 #define min(a, b) ((a) < (b) ? (a) : (b))
36 #define max(a, b) ((a) > (b) ? (a) : (b))
38 /* Some static data, and a function to initialize it for each run */
40 Lisp_Object Vsystem_name;
41 Lisp_Object Vuser_real_name; /* login name of current user ID */
42 Lisp_Object Vuser_full_name; /* full name of current user */
43 Lisp_Object Vuser_name; /* user name from USER or LOGNAME. */
45 void
46 init_editfns ()
48 char *user_name;
49 register unsigned char *p, *q, *r;
50 struct passwd *pw; /* password entry for the current user */
51 extern char *index ();
52 Lisp_Object tem;
54 /* Set up system_name even when dumping. */
56 Vsystem_name = build_string (get_system_name ());
57 p = XSTRING (Vsystem_name)->data;
58 while (*p)
60 if (*p == ' ' || *p == '\t')
61 *p = '-';
62 p++;
65 #ifndef CANNOT_DUMP
66 /* Don't bother with this on initial start when just dumping out */
67 if (!initialized)
68 return;
69 #endif /* not CANNOT_DUMP */
71 pw = (struct passwd *) getpwuid (getuid ());
72 Vuser_real_name = build_string (pw ? pw->pw_name : "unknown");
74 /* Get the effective user name, by consulting environment variables,
75 or the effective uid if those are unset. */
76 user_name = (char *) getenv ("USER");
77 if (!user_name)
78 user_name = (char *) getenv ("LOGNAME");
79 if (!user_name)
81 pw = (struct passwd *) getpwuid (geteuid ());
82 user_name = (char *) (pw ? pw->pw_name : "unknown");
84 Vuser_name = build_string (user_name);
86 /* If the user name claimed in the environment vars differs from
87 the real uid, use the claimed name to find the full name. */
88 tem = Fstring_equal (Vuser_name, Vuser_real_name);
89 if (NILP (tem))
90 pw = (struct passwd *) getpwnam (XSTRING (Vuser_name)->data);
92 p = (unsigned char *) (pw ? USER_FULL_NAME : "unknown");
93 q = (unsigned char *) index (p, ',');
94 Vuser_full_name = make_string (p, q ? q - p : strlen (p));
96 #ifdef AMPERSAND_FULL_NAME
97 p = XSTRING (Vuser_full_name)->data;
98 q = (char *) index (p, '&');
99 /* Substitute the login name for the &, upcasing the first character. */
100 if (q)
102 r = (char *) alloca (strlen (p) + XSTRING (Vuser_name)->size + 1);
103 bcopy (p, r, q - p);
104 r[q - p] = 0;
105 strcat (r, XSTRING (Vuser_name)->data);
106 r[q - p] = UPCASE (r[q - p]);
107 strcat (r, q + 1);
108 Vuser_full_name = build_string (r);
110 #endif /* AMPERSAND_FULL_NAME */
113 DEFUN ("char-to-string", Fchar_to_string, Schar_to_string, 1, 1, 0,
114 "Convert arg CHAR to a one-character string containing that character.")
116 Lisp_Object n;
118 char c;
119 CHECK_NUMBER (n, 0);
121 c = XINT (n);
122 return make_string (&c, 1);
125 DEFUN ("string-to-char", Fstring_to_char, Sstring_to_char, 1, 1, 0,
126 "Convert arg STRING to a character, the first character of that string.")
127 (str)
128 register Lisp_Object str;
130 register Lisp_Object val;
131 register struct Lisp_String *p;
132 CHECK_STRING (str, 0);
134 p = XSTRING (str);
135 if (p->size)
136 XFASTINT (val) = ((unsigned char *) p->data)[0];
137 else
138 XFASTINT (val) = 0;
139 return val;
142 static Lisp_Object
143 buildmark (val)
144 int val;
146 register Lisp_Object mark;
147 mark = Fmake_marker ();
148 Fset_marker (mark, make_number (val), Qnil);
149 return mark;
152 DEFUN ("point", Fpoint, Spoint, 0, 0, 0,
153 "Return value of point, as an integer.\n\
154 Beginning of buffer is position (point-min)")
157 Lisp_Object temp;
158 XFASTINT (temp) = point;
159 return temp;
162 DEFUN ("point-marker", Fpoint_marker, Spoint_marker, 0, 0, 0,
163 "Return value of point, as a marker object.")
166 return buildmark (point);
170 clip_to_bounds (lower, num, upper)
171 int lower, num, upper;
173 if (num < lower)
174 return lower;
175 else if (num > upper)
176 return upper;
177 else
178 return num;
181 DEFUN ("goto-char", Fgoto_char, Sgoto_char, 1, 1, "NGoto char: ",
182 "Set point to POSITION, a number or marker.\n\
183 Beginning of buffer is position (point-min), end is (point-max).")
185 register Lisp_Object n;
187 CHECK_NUMBER_COERCE_MARKER (n, 0);
189 SET_PT (clip_to_bounds (BEGV, XINT (n), ZV));
190 return n;
193 static Lisp_Object
194 region_limit (beginningp)
195 int beginningp;
197 register Lisp_Object m;
198 m = Fmarker_position (current_buffer->mark);
199 if (NILP (m)) error ("There is no region now");
200 if ((point < XFASTINT (m)) == beginningp)
201 return (make_number (point));
202 else
203 return (m);
206 DEFUN ("region-beginning", Fregion_beginning, Sregion_beginning, 0, 0, 0,
207 "Return position of beginning of region, as an integer.")
210 return (region_limit (1));
213 DEFUN ("region-end", Fregion_end, Sregion_end, 0, 0, 0,
214 "Return position of end of region, as an integer.")
217 return (region_limit (0));
220 #if 0 /* now in lisp code */
221 DEFUN ("mark", Fmark, Smark, 0, 0, 0,
222 "Return this buffer's mark value as integer, or nil if no mark.\n\
223 If you are using this in an editing command, you are most likely making\n\
224 a mistake; see the documentation of `set-mark'.")
227 return Fmarker_position (current_buffer->mark);
229 #endif /* commented out code */
231 DEFUN ("mark-marker", Fmark_marker, Smark_marker, 0, 0, 0,
232 "Return this buffer's mark, as a marker object.\n\
233 Watch out! Moving this marker changes the mark position.\n\
234 If you set the marker not to point anywhere, the buffer will have no mark.")
237 return current_buffer->mark;
240 #if 0 /* this is now in lisp code */
241 DEFUN ("set-mark", Fset_mark, Sset_mark, 1, 1, 0,
242 "Set this buffer's mark to POS. Don't use this function!\n\
243 That is to say, don't use this function unless you want\n\
244 the user to see that the mark has moved, and you want the previous\n\
245 mark position to be lost.\n\
247 Normally, when a new mark is set, the old one should go on the stack.\n\
248 This is why most applications should use push-mark, not set-mark.\n\
250 Novice programmers often try to use the mark for the wrong purposes.\n\
251 The mark saves a location for the user's convenience.\n\
252 Most editing commands should not alter the mark.\n\
253 To remember a location for internal use in the Lisp program,\n\
254 store it in a Lisp variable. Example:\n\
256 (let ((beg (point))) (forward-line 1) (delete-region beg (point))).")
257 (pos)
258 Lisp_Object pos;
260 if (NILP (pos))
262 current_buffer->mark = Qnil;
263 return Qnil;
265 CHECK_NUMBER_COERCE_MARKER (pos, 0);
267 if (NILP (current_buffer->mark))
268 current_buffer->mark = Fmake_marker ();
270 Fset_marker (current_buffer->mark, pos, Qnil);
271 return pos;
273 #endif /* commented-out code */
275 Lisp_Object
276 save_excursion_save ()
278 register int visible = XBUFFER (XWINDOW (selected_window)->buffer) == current_buffer;
280 return Fcons (Fpoint_marker (),
281 Fcons (Fcopy_marker (current_buffer->mark), visible ? Qt : Qnil));
284 Lisp_Object
285 save_excursion_restore (info)
286 register Lisp_Object info;
288 register Lisp_Object tem;
290 tem = Fmarker_buffer (Fcar (info));
291 /* If buffer being returned to is now deleted, avoid error */
292 /* Otherwise could get error here while unwinding to top level
293 and crash */
294 /* In that case, Fmarker_buffer returns nil now. */
295 if (NILP (tem))
296 return Qnil;
297 Fset_buffer (tem);
298 tem = Fcar (info);
299 Fgoto_char (tem);
300 unchain_marker (tem);
301 tem = Fcar (Fcdr (info));
302 Fset_marker (current_buffer->mark, tem, Fcurrent_buffer ());
303 unchain_marker (tem);
304 tem = Fcdr (Fcdr (info));
305 if (!NILP (tem) && current_buffer != XBUFFER (XWINDOW (selected_window)->buffer))
306 Fswitch_to_buffer (Fcurrent_buffer (), Qnil);
307 return Qnil;
310 DEFUN ("save-excursion", Fsave_excursion, Ssave_excursion, 0, UNEVALLED, 0,
311 "Save point, mark, and current buffer; execute BODY; restore those things.\n\
312 Executes BODY just like `progn'.\n\
313 The values of point, mark and the current buffer are restored\n\
314 even in case of abnormal exit (throw or error).")
315 (args)
316 Lisp_Object args;
318 register Lisp_Object val;
319 int count = specpdl_ptr - specpdl;
321 record_unwind_protect (save_excursion_restore, save_excursion_save ());
323 val = Fprogn (args);
324 return unbind_to (count, val);
327 DEFUN ("buffer-size", Fbufsize, Sbufsize, 0, 0, 0,
328 "Return the number of characters in the current buffer.")
331 Lisp_Object temp;
332 XFASTINT (temp) = Z - BEG;
333 return temp;
336 DEFUN ("point-min", Fpoint_min, Spoint_min, 0, 0, 0,
337 "Return the minimum permissible value of point in the current buffer.\n\
338 This is 1, unless a clipping restriction is in effect.")
341 Lisp_Object temp;
342 XFASTINT (temp) = BEGV;
343 return temp;
346 DEFUN ("point-min-marker", Fpoint_min_marker, Spoint_min_marker, 0, 0, 0,
347 "Return a marker to the minimum permissible value of point in this buffer.\n\
348 This is the beginning, unless a clipping restriction is in effect.")
351 return buildmark (BEGV);
354 DEFUN ("point-max", Fpoint_max, Spoint_max, 0, 0, 0,
355 "Return the maximum permissible value of point in the current buffer.\n\
356 This is (1+ (buffer-size)), unless a clipping restriction is in effect,\n\
357 in which case it is less.")
360 Lisp_Object temp;
361 XFASTINT (temp) = ZV;
362 return temp;
365 DEFUN ("point-max-marker", Fpoint_max_marker, Spoint_max_marker, 0, 0, 0,
366 "Return a marker to the maximum permissible value of point in this buffer.\n\
367 This is (1+ (buffer-size)), unless a clipping restriction is in effect,\n\
368 in which case it is less.")
371 return buildmark (ZV);
374 DEFUN ("following-char", Ffollowing_char, Sfollowing_char, 0, 0, 0,
375 "Return the character following point, as a number.\n\
376 At the end of the buffer or accessible region, return 0.")
379 Lisp_Object temp;
380 if (point >= ZV)
381 XFASTINT (temp) = 0;
382 else
383 XFASTINT (temp) = FETCH_CHAR (point);
384 return temp;
387 DEFUN ("preceding-char", Fprevious_char, Sprevious_char, 0, 0, 0,
388 "Return the character preceding point, as a number.\n\
389 At the beginning of the buffer or accessible region, return 0.")
392 Lisp_Object temp;
393 if (point <= BEGV)
394 XFASTINT (temp) = 0;
395 else
396 XFASTINT (temp) = FETCH_CHAR (point - 1);
397 return temp;
400 DEFUN ("bobp", Fbobp, Sbobp, 0, 0, 0,
401 "Return T if point is at the beginning of the buffer.\n\
402 If the buffer is narrowed, this means the beginning of the narrowed part.")
405 if (point == BEGV)
406 return Qt;
407 return Qnil;
410 DEFUN ("eobp", Feobp, Seobp, 0, 0, 0,
411 "Return T if point is at the end of the buffer.\n\
412 If the buffer is narrowed, this means the end of the narrowed part.")
415 if (point == ZV)
416 return Qt;
417 return Qnil;
420 DEFUN ("bolp", Fbolp, Sbolp, 0, 0, 0,
421 "Return T if point is at the beginning of a line.")
424 if (point == BEGV || FETCH_CHAR (point - 1) == '\n')
425 return Qt;
426 return Qnil;
429 DEFUN ("eolp", Feolp, Seolp, 0, 0, 0,
430 "Return T if point is at the end of a line.\n\
431 `End of a line' includes point being at the end of the buffer.")
434 if (point == ZV || FETCH_CHAR (point) == '\n')
435 return Qt;
436 return Qnil;
439 DEFUN ("char-after", Fchar_after, Schar_after, 1, 1, 0,
440 "Return character in current buffer at position POS.\n\
441 POS is an integer or a buffer pointer.\n\
442 If POS is out of range, the value is nil.")
443 (pos)
444 Lisp_Object pos;
446 register Lisp_Object val;
447 register int n;
449 CHECK_NUMBER_COERCE_MARKER (pos, 0);
451 n = XINT (pos);
452 if (n < BEGV || n >= ZV) return Qnil;
454 XFASTINT (val) = FETCH_CHAR (n);
455 return val;
458 DEFUN ("user-login-name", Fuser_login_name, Suser_login_name, 0, 0, 0,
459 "Return the name under which the user logged in, as a string.\n\
460 This is based on the effective uid, not the real uid.\n\
461 Also, if the environment variable USER or LOGNAME is set,\n\
462 that determines the value of this function.")
465 return Vuser_name;
468 DEFUN ("user-real-login-name", Fuser_real_login_name, Suser_real_login_name,
469 0, 0, 0,
470 "Return the name of the user's real uid, as a string.\n\
471 Differs from `user-login-name' when running under `su'.")
474 return Vuser_real_name;
477 DEFUN ("user-uid", Fuser_uid, Suser_uid, 0, 0, 0,
478 "Return the effective uid of Emacs, as an integer.")
481 return make_number (geteuid ());
484 DEFUN ("user-real-uid", Fuser_real_uid, Suser_real_uid, 0, 0, 0,
485 "Return the real uid of Emacs, as an integer.")
488 return make_number (getuid ());
491 DEFUN ("user-full-name", Fuser_full_name, Suser_full_name, 0, 0, 0,
492 "Return the full name of the user logged in, as a string.")
495 return Vuser_full_name;
498 DEFUN ("system-name", Fsystem_name, Ssystem_name, 0, 0, 0,
499 "Return the name of the machine you are running on, as a string.")
502 return Vsystem_name;
505 DEFUN ("current-time", Fcurrent_time, Scurrent_time, 0, 0, 0,
506 "Return the current time, as the number of seconds since 12:00 AM January 1970.\n\
507 The time is returned as a list of three integers. The first has the\n\
508 most significant 16 bits of the seconds, while the second has the\n\
509 least significant 16 bits. The third integer gives the microsecond\n\
510 count.\n\
512 The microsecond count is zero on systems that do not provide\n\
513 resolution finer than a second.")
516 EMACS_TIME t;
517 Lisp_Object result[3];
519 EMACS_GET_TIME (t);
520 XSET (result[0], Lisp_Int, (EMACS_SECS (t) >> 16) & 0xffff);
521 XSET (result[1], Lisp_Int, (EMACS_SECS (t) >> 0) & 0xffff);
522 XSET (result[2], Lisp_Int, EMACS_USECS (t));
524 return Flist (3, result);
528 DEFUN ("current-time-string", Fcurrent_time_string, Scurrent_time_string, 0, 0, 0,
529 "Return the current time, as a human-readable string.\n\
530 Programs can use it too, since the number of columns in each field is fixed.\n\
531 The format is `Sun Sep 16 01:03:52 1973'.\n\
532 In a future Emacs version, the time zone may be added at the end,\n\
533 if we can figure out a reasonably easy way to get that information.")
536 long current_time = time ((long *) 0);
537 char buf[30];
538 register char *tem = (char *) ctime (&current_time);
540 strncpy (buf, tem, 24);
541 buf[24] = 0;
543 return build_string (buf);
546 #ifdef unix
548 DEFUN ("set-default-file-mode", Fset_default_file_mode, Sset_default_file_mode, 1, 1, "p",
549 "Set Unix `umask' value to ARGUMENT, and return old value.\n\
550 The `umask' value is the default protection mode for new files.")
551 (nmask)
552 Lisp_Object nmask;
554 CHECK_NUMBER (nmask, 0);
555 return make_number (umask (XINT (nmask)));
558 DEFUN ("unix-sync", Funix_sync, Sunix_sync, 0, 0, "",
559 "Tell Unix to finish all pending disk updates.")
562 sync ();
563 return Qnil;
566 #endif /* unix */
568 void
569 insert1 (arg)
570 Lisp_Object arg;
572 Finsert (1, &arg);
576 /* Callers passing one argument to Finsert need not gcpro the
577 argument "array", since the only element of the array will
578 not be used after calling insert or insert_from_string, so
579 we don't care if it gets trashed. */
581 DEFUN ("insert", Finsert, Sinsert, 0, MANY, 0,
582 "Insert the arguments, either strings or characters, at point.\n\
583 Point moves forward so that it ends up after the inserted text.\n\
584 Any other markers at the point of insertion remain before the text.")
585 (nargs, args)
586 int nargs;
587 register Lisp_Object *args;
589 register int argnum;
590 register Lisp_Object tem;
591 char str[1];
593 for (argnum = 0; argnum < nargs; argnum++)
595 tem = args[argnum];
596 retry:
597 if (XTYPE (tem) == Lisp_Int)
599 str[0] = XINT (tem);
600 insert (str, 1);
602 else if (XTYPE (tem) == Lisp_String)
604 insert_from_string (tem, 0, XSTRING (tem)->size);
606 else
608 tem = wrong_type_argument (Qchar_or_string_p, tem);
609 goto retry;
613 return Qnil;
616 DEFUN ("insert-before-markers", Finsert_before_markers, Sinsert_before_markers, 0, MANY, 0,
617 "Insert strings or characters at point, relocating markers after the text.\n\
618 Point moves forward so that it ends up after the inserted text.\n\
619 Any other markers at the point of insertion also end up after the text.")
620 (nargs, args)
621 int nargs;
622 register Lisp_Object *args;
624 register int argnum;
625 register Lisp_Object tem;
626 char str[1];
628 for (argnum = 0; argnum < nargs; argnum++)
630 tem = args[argnum];
631 retry:
632 if (XTYPE (tem) == Lisp_Int)
634 str[0] = XINT (tem);
635 insert_before_markers (str, 1);
637 else if (XTYPE (tem) == Lisp_String)
639 insert_from_string_before_markers (tem, 0, XSTRING (tem)->size);
641 else
643 tem = wrong_type_argument (Qchar_or_string_p, tem);
644 goto retry;
648 return Qnil;
651 DEFUN ("insert-char", Finsert_char, Sinsert_char, 2, 2, 0,
652 "Insert COUNT (second arg) copies of CHAR (first arg).\n\
653 Point and all markers are affected as in the function `insert'.\n\
654 Both arguments are required.")
655 (chr, count)
656 Lisp_Object chr, count;
658 register unsigned char *string;
659 register int strlen;
660 register int i, n;
662 CHECK_NUMBER (chr, 0);
663 CHECK_NUMBER (count, 1);
665 n = XINT (count);
666 if (n <= 0)
667 return Qnil;
668 strlen = min (n, 256);
669 string = (unsigned char *) alloca (strlen);
670 for (i = 0; i < strlen; i++)
671 string[i] = XFASTINT (chr);
672 while (n >= strlen)
674 insert (string, strlen);
675 n -= strlen;
677 if (n > 0)
678 insert (string, n);
679 return Qnil;
683 /* Return a string with the contents of the current region */
685 DEFUN ("buffer-substring", Fbuffer_substring, Sbuffer_substring, 2, 2, 0,
686 "Return the contents of part of the current buffer as a string.\n\
687 The two arguments START and END are character positions;\n\
688 they can be in either order.")
689 (b, e)
690 Lisp_Object b, e;
692 register int beg, end;
693 Lisp_Object result;
695 validate_region (&b, &e);
696 beg = XINT (b);
697 end = XINT (e);
699 if (beg < GPT && end > GPT)
700 move_gap (beg);
702 /* Plain old make_string calls make_uninit_string, which can cause
703 the buffer arena to be compacted. make_string has no way of
704 knowing that the data has been moved, and thus copies the wrong
705 data into the string. This doesn't effect most of the other
706 users of make_string, so it should be left as is. */
707 result = make_uninit_string (end - beg);
708 bcopy (&FETCH_CHAR (beg), XSTRING (result)->data, end - beg);
710 return result;
713 DEFUN ("buffer-string", Fbuffer_string, Sbuffer_string, 0, 0, 0,
714 "Return the contents of the current buffer as a string.")
717 if (BEGV < GPT && ZV > GPT)
718 move_gap (BEGV);
719 return make_string (BEGV_ADDR, ZV - BEGV);
722 DEFUN ("insert-buffer-substring", Finsert_buffer_substring, Sinsert_buffer_substring,
723 1, 3, 0,
724 "Insert before point a substring of the contents buffer BUFFER.\n\
725 BUFFER may be a buffer or a buffer name.\n\
726 Arguments START and END are character numbers specifying the substring.\n\
727 They default to the beginning and the end of BUFFER.")
728 (buf, b, e)
729 Lisp_Object buf, b, e;
731 register int beg, end, exch;
732 register struct buffer *bp;
734 buf = Fget_buffer (buf);
735 bp = XBUFFER (buf);
737 if (NILP (b))
738 beg = BUF_BEGV (bp);
739 else
741 CHECK_NUMBER_COERCE_MARKER (b, 0);
742 beg = XINT (b);
744 if (NILP (e))
745 end = BUF_ZV (bp);
746 else
748 CHECK_NUMBER_COERCE_MARKER (e, 1);
749 end = XINT (e);
752 if (beg > end)
753 exch = beg, beg = end, end = exch;
755 /* Move the gap or create enough gap in the current buffer. */
757 if (point != GPT)
758 move_gap (point);
759 if (GAP_SIZE < end - beg)
760 make_gap (end - beg - GAP_SIZE);
762 if (!(BUF_BEGV (bp) <= beg
763 && beg <= end
764 && end <= BUF_ZV (bp)))
765 args_out_of_range (b, e);
767 /* Now the actual insertion will not do any gap motion,
768 so it matters not if BUF is the current buffer. */
769 if (beg < BUF_GPT (bp))
771 insert (BUF_CHAR_ADDRESS (bp, beg), min (end, BUF_GPT (bp)) - beg);
772 beg = min (end, BUF_GPT (bp));
774 if (beg < end)
775 insert (BUF_CHAR_ADDRESS (bp, beg), end - beg);
777 return Qnil;
780 DEFUN ("subst-char-in-region", Fsubst_char_in_region,
781 Ssubst_char_in_region, 4, 5, 0,
782 "From START to END, replace FROMCHAR with TOCHAR each time it occurs.\n\
783 If optional arg NOUNDO is non-nil, don't record this change for undo\n\
784 and don't mark the buffer as really changed.")
785 (start, end, fromchar, tochar, noundo)
786 Lisp_Object start, end, fromchar, tochar, noundo;
788 register int pos, stop, look;
790 validate_region (&start, &end);
791 CHECK_NUMBER (fromchar, 2);
792 CHECK_NUMBER (tochar, 3);
794 pos = XINT (start);
795 stop = XINT (end);
796 look = XINT (fromchar);
798 modify_region (pos, stop);
799 if (! NILP (noundo))
801 if (MODIFF - 1 == current_buffer->save_modified)
802 current_buffer->save_modified++;
803 if (MODIFF - 1 == current_buffer->auto_save_modified)
804 current_buffer->auto_save_modified++;
807 while (pos < stop)
809 if (FETCH_CHAR (pos) == look)
811 if (NILP (noundo))
812 record_change (pos, 1);
813 FETCH_CHAR (pos) = XINT (tochar);
814 if (NILP (noundo))
815 signal_after_change (pos, 1, 1);
817 pos++;
820 return Qnil;
823 DEFUN ("translate-region", Ftranslate_region, Stranslate_region, 3, 3, 0,
824 "From START to END, translate characters according to TABLE.\n\
825 TABLE is a string; the Nth character in it is the mapping\n\
826 for the character with code N. Returns the number of characters changed.")
827 (start, end, table)
828 Lisp_Object start;
829 Lisp_Object end;
830 register Lisp_Object table;
832 register int pos, stop; /* Limits of the region. */
833 register unsigned char *tt; /* Trans table. */
834 register int oc; /* Old character. */
835 register int nc; /* New character. */
836 int cnt; /* Number of changes made. */
837 Lisp_Object z; /* Return. */
838 int size; /* Size of translate table. */
840 validate_region (&start, &end);
841 CHECK_STRING (table, 2);
843 size = XSTRING (table)->size;
844 tt = XSTRING (table)->data;
846 pos = XINT (start);
847 stop = XINT (end);
848 modify_region (pos, stop);
850 cnt = 0;
851 for (; pos < stop; ++pos)
853 oc = FETCH_CHAR (pos);
854 if (oc < size)
856 nc = tt[oc];
857 if (nc != oc)
859 record_change (pos, 1);
860 FETCH_CHAR (pos) = nc;
861 signal_after_change (pos, 1, 1);
862 ++cnt;
867 XFASTINT (z) = cnt;
868 return (z);
871 DEFUN ("delete-region", Fdelete_region, Sdelete_region, 2, 2, "r",
872 "Delete the text between point and mark.\n\
873 When called from a program, expects two arguments,\n\
874 positions (integers or markers) specifying the stretch to be deleted.")
875 (b, e)
876 Lisp_Object b, e;
878 validate_region (&b, &e);
879 del_range (XINT (b), XINT (e));
880 return Qnil;
883 DEFUN ("widen", Fwiden, Swiden, 0, 0, "",
884 "Remove restrictions (narrowing) from current buffer.\n\
885 This allows the buffer's full text to be seen and edited.")
888 BEGV = BEG;
889 SET_BUF_ZV (current_buffer, Z);
890 clip_changed = 1;
891 /* Changing the buffer bounds invalidates any recorded current column. */
892 invalidate_current_column ();
893 return Qnil;
896 DEFUN ("narrow-to-region", Fnarrow_to_region, Snarrow_to_region, 2, 2, "r",
897 "Restrict editing in this buffer to the current region.\n\
898 The rest of the text becomes temporarily invisible and untouchable\n\
899 but is not deleted; if you save the buffer in a file, the invisible\n\
900 text is included in the file. \\[widen] makes all visible again.\n\
901 See also `save-restriction'.\n\
903 When calling from a program, pass two arguments; positions (integers\n\
904 or markers) bounding the text that should remain visible.")
905 (b, e)
906 register Lisp_Object b, e;
908 register int i;
910 CHECK_NUMBER_COERCE_MARKER (b, 0);
911 CHECK_NUMBER_COERCE_MARKER (e, 1);
913 if (XINT (b) > XINT (e))
915 i = XFASTINT (b);
916 b = e;
917 XFASTINT (e) = i;
920 if (!(BEG <= XINT (b) && XINT (b) <= XINT (e) && XINT (e) <= Z))
921 args_out_of_range (b, e);
923 BEGV = XFASTINT (b);
924 SET_BUF_ZV (current_buffer, XFASTINT (e));
925 if (point < XFASTINT (b))
926 SET_PT (XFASTINT (b));
927 if (point > XFASTINT (e))
928 SET_PT (XFASTINT (e));
929 clip_changed = 1;
930 /* Changing the buffer bounds invalidates any recorded current column. */
931 invalidate_current_column ();
932 return Qnil;
935 Lisp_Object
936 save_restriction_save ()
938 register Lisp_Object bottom, top;
939 /* Note: I tried using markers here, but it does not win
940 because insertion at the end of the saved region
941 does not advance mh and is considered "outside" the saved region. */
942 XFASTINT (bottom) = BEGV - BEG;
943 XFASTINT (top) = Z - ZV;
945 return Fcons (Fcurrent_buffer (), Fcons (bottom, top));
948 Lisp_Object
949 save_restriction_restore (data)
950 Lisp_Object data;
952 register struct buffer *buf;
953 register int newhead, newtail;
954 register Lisp_Object tem;
956 buf = XBUFFER (XCONS (data)->car);
958 data = XCONS (data)->cdr;
960 tem = XCONS (data)->car;
961 newhead = XINT (tem);
962 tem = XCONS (data)->cdr;
963 newtail = XINT (tem);
964 if (newhead + newtail > BUF_Z (buf) - BUF_BEG (buf))
966 newhead = 0;
967 newtail = 0;
969 BUF_BEGV (buf) = BUF_BEG (buf) + newhead;
970 SET_BUF_ZV (buf, BUF_Z (buf) - newtail);
971 clip_changed = 1;
973 /* If point is outside the new visible range, move it inside. */
974 SET_BUF_PT (buf,
975 clip_to_bounds (BUF_BEGV (buf), BUF_PT (buf), BUF_ZV (buf)));
977 return Qnil;
980 DEFUN ("save-restriction", Fsave_restriction, Ssave_restriction, 0, UNEVALLED, 0,
981 "Execute BODY, saving and restoring current buffer's restrictions.\n\
982 The buffer's restrictions make parts of the beginning and end invisible.\n\
983 \(They are set up with `narrow-to-region' and eliminated with `widen'.)\n\
984 This special form, `save-restriction', saves the current buffer's restrictions\n\
985 when it is entered, and restores them when it is exited.\n\
986 So any `narrow-to-region' within BODY lasts only until the end of the form.\n\
987 The old restrictions settings are restored\n\
988 even in case of abnormal exit (throw or error).\n\
990 The value returned is the value of the last form in BODY.\n\
992 `save-restriction' can get confused if, within the BODY, you widen\n\
993 and then make changes outside the area within the saved restrictions.\n\
995 Note: if you are using both `save-excursion' and `save-restriction',\n\
996 use `save-excursion' outermost:\n\
997 (save-excursion (save-restriction ...))")
998 (body)
999 Lisp_Object body;
1001 register Lisp_Object val;
1002 int count = specpdl_ptr - specpdl;
1004 record_unwind_protect (save_restriction_restore, save_restriction_save ());
1005 val = Fprogn (body);
1006 return unbind_to (count, val);
1009 DEFUN ("message", Fmessage, Smessage, 1, MANY, 0,
1010 "Print a one-line message at the bottom of the screen.\n\
1011 The first argument is a control string.\n\
1012 It may contain %s or %d or %c to print successive following arguments.\n\
1013 %s means print an argument as a string, %d means print as number in decimal,\n\
1014 %c means print a number as a single character.\n\
1015 The argument used by %s must be a string or a symbol;\n\
1016 the argument used by %d or %c must be a number.")
1017 (nargs, args)
1018 int nargs;
1019 Lisp_Object *args;
1021 register Lisp_Object val;
1023 val = Fformat (nargs, args);
1024 message ("%s", XSTRING (val)->data);
1025 return val;
1028 DEFUN ("format", Fformat, Sformat, 1, MANY, 0,
1029 "Format a string out of a control-string and arguments.\n\
1030 The first argument is a control string.\n\
1031 The other arguments are substituted into it to make the result, a string.\n\
1032 It may contain %-sequences meaning to substitute the next argument.\n\
1033 %s means print a string argument. Actually, prints any object, with `princ'.\n\
1034 %d means print as number in decimal (%o octal, %x hex).\n\
1035 %c means print a number as a single character.\n\
1036 %S means print any object as an s-expression (using prin1).\n\
1037 The argument used for %d, %o, %x or %c must be a number.\n\
1038 Use %% to put a single % into the output.")
1039 (nargs, args)
1040 int nargs;
1041 register Lisp_Object *args;
1043 register int n; /* The number of the next arg to substitute */
1044 register int total = 5; /* An estimate of the final length */
1045 char *buf;
1046 register unsigned char *format, *end;
1047 int length;
1048 extern char *index ();
1049 /* It should not be necessary to GCPRO ARGS, because
1050 the caller in the interpreter should take care of that. */
1052 CHECK_STRING (args[0], 0);
1053 format = XSTRING (args[0])->data;
1054 end = format + XSTRING (args[0])->size;
1056 n = 0;
1057 while (format != end)
1058 if (*format++ == '%')
1060 int minlen;
1062 /* Process a numeric arg and skip it. */
1063 minlen = atoi (format);
1064 if (minlen > 0)
1065 total += minlen;
1066 else
1067 total -= minlen;
1068 while ((*format >= '0' && *format <= '9')
1069 || *format == '-' || *format == ' ' || *format == '.')
1070 format++;
1072 if (*format == '%')
1073 format++;
1074 else if (++n >= nargs)
1076 else if (*format == 'S')
1078 /* For `S', prin1 the argument and then treat like a string. */
1079 register Lisp_Object tem;
1080 tem = Fprin1_to_string (args[n], Qnil);
1081 args[n] = tem;
1082 goto string;
1084 else if (XTYPE (args[n]) == Lisp_Symbol)
1086 XSET (args[n], Lisp_String, XSYMBOL (args[n])->name);
1087 goto string;
1089 else if (XTYPE (args[n]) == Lisp_String)
1091 string:
1092 total += XSTRING (args[n])->size;
1094 /* Would get MPV otherwise, since Lisp_Int's `point' to low memory. */
1095 else if (XTYPE (args[n]) == Lisp_Int && *format != 's')
1097 #ifdef LISP_FLOAT_TYPE
1098 /* The following loop issumes the Lisp type indicates
1099 the proper way to pass the argument.
1100 So make sure we have a flonum if the argument should
1101 be a double. */
1102 if (*format == 'e' || *format == 'f' || *format == 'g')
1103 args[n] = Ffloat (args[n]);
1104 #endif
1105 total += 10;
1107 #ifdef LISP_FLOAT_TYPE
1108 else if (XTYPE (args[n]) == Lisp_Float && *format != 's')
1110 if (! (*format == 'e' || *format == 'f' || *format == 'g'))
1111 args[n] = Ftruncate (args[n]);
1112 total += 20;
1114 #endif
1115 else
1117 /* Anything but a string, convert to a string using princ. */
1118 register Lisp_Object tem;
1119 tem = Fprin1_to_string (args[n], Qt);
1120 args[n] = tem;
1121 goto string;
1126 register int nstrings = n + 1;
1127 register unsigned char **strings
1128 = (unsigned char **) alloca (nstrings * sizeof (unsigned char *));
1130 for (n = 0; n < nstrings; n++)
1132 if (n >= nargs)
1133 strings[n] = (unsigned char *) "";
1134 else if (XTYPE (args[n]) == Lisp_Int)
1135 /* We checked above that the corresponding format effector
1136 isn't %s, which would cause MPV. */
1137 strings[n] = (unsigned char *) XINT (args[n]);
1138 #ifdef LISP_FLOAT_TYPE
1139 else if (XTYPE (args[n]) == Lisp_Float)
1141 union { double d; int half[2]; } u;
1143 u.d = XFLOAT (args[n])->data;
1144 strings[n++] = (unsigned char *) u.half[0];
1145 strings[n] = (unsigned char *) u.half[1];
1147 #endif
1148 else
1149 strings[n] = XSTRING (args[n])->data;
1152 /* Format it in bigger and bigger buf's until it all fits. */
1153 while (1)
1155 buf = (char *) alloca (total + 1);
1156 buf[total - 1] = 0;
1158 length = doprnt (buf, total + 1, strings[0], end, nargs, strings + 1);
1159 if (buf[total - 1] == 0)
1160 break;
1162 total *= 2;
1166 /* UNGCPRO; */
1167 return make_string (buf, length);
1170 /* VARARGS 1 */
1171 Lisp_Object
1172 #ifdef NO_ARG_ARRAY
1173 format1 (string1, arg0, arg1, arg2, arg3, arg4)
1174 int arg0, arg1, arg2, arg3, arg4;
1175 #else
1176 format1 (string1)
1177 #endif
1178 char *string1;
1180 char buf[100];
1181 #ifdef NO_ARG_ARRAY
1182 int args[5];
1183 args[0] = arg0;
1184 args[1] = arg1;
1185 args[2] = arg2;
1186 args[3] = arg3;
1187 args[4] = arg4;
1188 doprnt (buf, sizeof buf, string1, 0, 5, args);
1189 #else
1190 doprnt (buf, sizeof buf, string1, 0, 5, &string1 + 1);
1191 #endif
1192 return build_string (buf);
1195 DEFUN ("char-equal", Fchar_equal, Schar_equal, 2, 2, 0,
1196 "Return t if two characters match, optionally ignoring case.\n\
1197 Both arguments must be characters (i.e. integers).\n\
1198 Case is ignored if `case-fold-search' is non-nil in the current buffer.")
1199 (c1, c2)
1200 register Lisp_Object c1, c2;
1202 unsigned char *downcase = DOWNCASE_TABLE;
1203 CHECK_NUMBER (c1, 0);
1204 CHECK_NUMBER (c2, 1);
1206 if (!NILP (current_buffer->case_fold_search)
1207 ? downcase[0xff & XFASTINT (c1)] == downcase[0xff & XFASTINT (c2)]
1208 : XINT (c1) == XINT (c2))
1209 return Qt;
1210 return Qnil;
1214 void
1215 syms_of_editfns ()
1217 DEFVAR_LISP ("system-name", &Vsystem_name,
1218 "The name of the machine Emacs is running on.");
1220 DEFVAR_LISP ("user-full-name", &Vuser_full_name,
1221 "The full name of the user logged in.");
1223 DEFVAR_LISP ("user-name", &Vuser_name,
1224 "The user's name, based on the effective uid.");
1226 DEFVAR_LISP ("user-real-name", &Vuser_real_name,
1227 "The user's name, base upon the real uid.");
1229 defsubr (&Schar_equal);
1230 defsubr (&Sgoto_char);
1231 defsubr (&Sstring_to_char);
1232 defsubr (&Schar_to_string);
1233 defsubr (&Sbuffer_substring);
1234 defsubr (&Sbuffer_string);
1236 defsubr (&Spoint_marker);
1237 defsubr (&Smark_marker);
1238 defsubr (&Spoint);
1239 defsubr (&Sregion_beginning);
1240 defsubr (&Sregion_end);
1241 /* defsubr (&Smark); */
1242 /* defsubr (&Sset_mark); */
1243 defsubr (&Ssave_excursion);
1245 defsubr (&Sbufsize);
1246 defsubr (&Spoint_max);
1247 defsubr (&Spoint_min);
1248 defsubr (&Spoint_min_marker);
1249 defsubr (&Spoint_max_marker);
1251 defsubr (&Sbobp);
1252 defsubr (&Seobp);
1253 defsubr (&Sbolp);
1254 defsubr (&Seolp);
1255 defsubr (&Sfollowing_char);
1256 defsubr (&Sprevious_char);
1257 defsubr (&Schar_after);
1258 defsubr (&Sinsert);
1259 defsubr (&Sinsert_before_markers);
1260 defsubr (&Sinsert_char);
1262 defsubr (&Suser_login_name);
1263 defsubr (&Suser_real_login_name);
1264 defsubr (&Suser_uid);
1265 defsubr (&Suser_real_uid);
1266 defsubr (&Suser_full_name);
1267 defsubr (&Scurrent_time);
1268 defsubr (&Scurrent_time_string);
1269 defsubr (&Ssystem_name);
1270 defsubr (&Sset_default_file_mode);
1271 defsubr (&Sunix_sync);
1272 defsubr (&Smessage);
1273 defsubr (&Sformat);
1275 defsubr (&Sinsert_buffer_substring);
1276 defsubr (&Ssubst_char_in_region);
1277 defsubr (&Stranslate_region);
1278 defsubr (&Sdelete_region);
1279 defsubr (&Swiden);
1280 defsubr (&Snarrow_to_region);
1281 defsubr (&Ssave_restriction);