1 /* Simple built-in editing commands.
2 Copyright (C) 1985, 93, 94, 95, 96, 97, 1998 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 2, or (at your option)
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs; see the file COPYING. If not, write to
18 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 Boston, MA 02111-1307, USA. */
30 #include "dispextern.h"
32 Lisp_Object Qkill_forward_chars
, Qkill_backward_chars
, Vblink_paren_function
;
34 /* A possible value for a buffer's overwrite-mode variable. */
35 Lisp_Object Qoverwrite_mode_binary
;
37 /* Non-nil means put this face on the next self-inserting character. */
38 Lisp_Object Vself_insert_face
;
40 /* This is the command that set up Vself_insert_face. */
41 Lisp_Object Vself_insert_face_command
;
43 extern Lisp_Object Qface
;
45 DEFUN ("forward-point", Fforward_point
, Sforward_point
, 1, 1, 0,
46 "Return buffer position N characters after (before if N negative) point.")
52 return make_number (PT
+ XINT (n
));
55 DEFUN ("forward-char", Fforward_char
, Sforward_char
, 0, 1, "p",
56 "Move point right N characters (left if N is negative).\n\
57 On reaching end of buffer, stop and signal error.")
66 /* This used to just set point to point + XINT (n), and then check
67 to see if it was within boundaries. But now that SET_PT can
68 potentially do a lot of stuff (calling entering and exiting
69 hooks, etcetera), that's not a good approach. So we validate the
70 proposed position, then set point. */
72 int new_point
= PT
+ XINT (n
);
77 Fsignal (Qbeginning_of_buffer
, Qnil
);
82 Fsignal (Qend_of_buffer
, Qnil
);
91 DEFUN ("backward-char", Fbackward_char
, Sbackward_char
, 0, 1, "p",
92 "Move point left N characters (right if N is negative).\n\
93 On attempt to pass beginning or end of buffer, stop and signal error.")
102 XSETINT (n
, - XINT (n
));
103 return Fforward_char (n
);
106 DEFUN ("forward-line", Fforward_line
, Sforward_line
, 0, 1, "p",
107 "Move N lines forward (backward if N is negative).\n\
108 Precisely, if point is on line I, move to the start of line I + N.\n\
109 If there isn't room, go as far as possible (no error).\n\
110 Returns the count of lines left to move. If moving forward,\n\
111 that is N - number of lines moved; if backward, N + number moved.\n\
112 With positive N, a non-empty line at the end counts as one line\n\
113 successfully moved (for the return value).")
117 int opoint
= PT
, opoint_byte
= PT_BYTE
;
131 shortage
= scan_newline (PT
, PT_BYTE
, BEGV
, BEGV_BYTE
, count
- 1, 1);
133 shortage
= scan_newline (PT
, PT_BYTE
, ZV
, ZV_BYTE
, count
, 1);
135 /* Since scan_newline does TEMP_SET_PT_BOTH,
136 and we want to set PT "for real",
137 go back to the old point and then come back here. */
140 TEMP_SET_PT_BOTH (opoint
, opoint_byte
);
141 SET_PT_BOTH (pos
, pos_byte
);
147 && (FETCH_BYTE (PT_BYTE
- 1) != '\n'))))
150 return make_number (count
<= 0 ? - shortage
: shortage
);
153 DEFUN ("beginning-of-line", Fbeginning_of_line
, Sbeginning_of_line
,
155 "Move point to beginning of current line.\n\
156 With argument N not nil or 1, move forward N - 1 lines first.\n\
157 If scan reaches end of buffer, stop there without error.")
166 SET_PT (XINT (Fline_beginning_position (n
)));
170 DEFUN ("end-of-line", Fend_of_line
, Send_of_line
,
172 "Move point to end of current line.\n\
173 With argument N not nil or 1, move forward N - 1 lines first.\n\
174 If scan reaches end of buffer, stop there without error.")
186 SET_PT (XINT (Fline_end_position (n
)));
191 DEFUN ("delete-char", Fdelete_char
, Sdelete_char
, 1, 2, "p\nP",
192 "Delete the following N characters (previous if N is negative).\n\
193 Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).\n\
194 Interactively, N is the prefix arg, and KILLFLAG is set if\n\
195 N was explicitly specified.")
197 Lisp_Object n
, killflag
;
209 Fsignal (Qbeginning_of_buffer
, Qnil
);
216 Fsignal (Qend_of_buffer
, Qnil
);
223 call1 (Qkill_forward_chars
, n
);
228 DEFUN ("delete-backward-char", Fdelete_backward_char
, Sdelete_backward_char
,
230 "Delete the previous N characters (following if N is negative).\n\
231 Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).\n\
232 Interactively, N is the prefix arg, and KILLFLAG is set if\n\
233 N was explicitly specified.")
235 Lisp_Object n
, killflag
;
238 int deleted_special
= 0;
239 int pos
, pos_byte
, i
;
243 /* See if we are about to delete a tab or newline backwards. */
246 for (i
= 0; i
< XINT (n
) && pos_byte
> BEGV_BYTE
; i
++)
250 DEC_BOTH (pos
, pos_byte
);
251 c
= FETCH_BYTE (pos_byte
);
252 if (c
== '\t' || c
== '\n')
259 /* In overwrite mode, back over columns while clearing them out,
260 unless at end of line. */
262 && ! NILP (current_buffer
->overwrite_mode
)
264 && ! (PT
== ZV
|| FETCH_BYTE (PT_BYTE
) == '\n'))
266 int column
= current_column ();
268 value
= Fdelete_char (make_number (-XINT (n
)), killflag
);
269 i
= column
- current_column ();
270 Finsert_char (make_number (' '), make_number (i
), Qnil
);
271 /* Whitespace chars are ASCII chars, so we can simply subtract. */
272 SET_PT_BOTH (PT
- i
, PT_BYTE
- i
);
275 value
= Fdelete_char (make_number (-XINT (n
)), killflag
);
280 DEFUN ("self-insert-command", Fself_insert_command
, Sself_insert_command
, 1, 1, "p",
281 "Insert the character you type.\n\
282 Whichever character you type to run this command is inserted.")
286 int character
= XINT (last_command_char
);
290 /* Barf if the key that invoked this was not a character. */
291 if (!INTEGERP (last_command_char
))
293 else if (XINT (n
) >= 2 && NILP (current_buffer
->overwrite_mode
))
295 int modified_char
= character
;
296 /* Add the offset to the character, for Finsert_char.
297 We pass internal_self_insert the unmodified character
298 because it itself does this offsetting. */
299 if (! NILP (current_buffer
->enable_multibyte_characters
))
300 modified_char
= unibyte_char_to_multibyte (modified_char
);
302 XSETFASTINT (n
, XFASTINT (n
) - 2);
303 /* The first one might want to expand an abbrev. */
304 internal_self_insert (character
, 1);
305 /* The bulk of the copies of this char can be inserted simply.
306 We don't have to handle a user-specified face specially
307 because it will get inherited from the first char inserted. */
308 Finsert_char (make_number (modified_char
), n
, Qt
);
309 /* The last one might want to auto-fill. */
310 internal_self_insert (character
, 0);
315 /* Ok since old and new vals both nonneg */
316 XSETFASTINT (n
, XFASTINT (n
) - 1);
317 internal_self_insert (character
, XFASTINT (n
) != 0);
323 /* Insert character C. If NOAUTOFILL is nonzero, don't do autofill
324 even if it is enabled.
326 If this insertion is suitable for direct output (completely simple),
327 return 0. A value of 1 indicates this *might* not have been simple.
328 A value of 2 means this did things that call for an undo boundary. */
331 internal_self_insert (c
, noautofill
)
335 extern Lisp_Object
Fexpand_abbrev ();
338 register enum syntaxcode synt
;
339 Lisp_Object overwrite
, string
;
340 /* Length of multi-byte form of C. */
342 /* Working buffer and pointer for multi-byte form of C. */
343 unsigned char workbuf
[4], *str
;
344 int chars_to_delete
= 0;
345 int spaces_to_insert
= 0;
347 overwrite
= current_buffer
->overwrite_mode
;
348 if (!NILP (Vbefore_change_function
) || !NILP (Vafter_change_function
)
349 || !NILP (Vbefore_change_functions
) || !NILP (Vafter_change_functions
))
352 /* At first, get multi-byte form of C in STR. */
353 if (!NILP (current_buffer
->enable_multibyte_characters
))
355 c
= unibyte_char_to_multibyte (c
);
356 len
= CHAR_STRING (c
, workbuf
, str
);
360 workbuf
[0] = (SINGLE_BYTE_CHAR_P (c
)
362 : multibyte_char_to_unibyte (c
, Qnil
));
366 if (!NILP (overwrite
)
369 /* In overwrite-mode, we substitute a character at point (C2,
370 hereafter) by C. For that, we delete C2 in advance. But,
371 just substituting C2 by C may move a remaining text in the
372 line to the right or to the left, which is not preferable.
373 So we insert more spaces or delete more characters in the
374 following cases: if C is narrower than C2, after deleting C2,
375 we fill columns with spaces, if C is wider than C2, we delete
376 C2 and several characters following C2. */
378 /* This is the character after point. */
379 int c2
= FETCH_CHAR (PT_BYTE
);
381 /* Column the cursor should be placed at after this insertion.
382 The correct value should be calculated only when necessary. */
385 /* Overwriting in binary-mode always replaces C2 by C.
386 Overwriting in textual-mode doesn't always do that.
387 It inserts newlines in the usual way,
388 and inserts any character at end of line
389 or before a tab if it doesn't use the whole width of the tab. */
390 if (EQ (overwrite
, Qoverwrite_mode_binary
)
394 && XINT (current_buffer
->tab_width
) > 0
395 && XFASTINT (current_buffer
->tab_width
) < 20
396 && (target_clm
= (current_column ()
397 + XINT (Fchar_width (make_number (c2
)))),
398 target_clm
% XFASTINT (current_buffer
->tab_width
)))))
401 int pos_byte
= PT_BYTE
;
407 /* The actual cursor position after the trial of moving
408 to column TARGET_CLM. It is greater than TARGET_CLM
409 if the TARGET_CLM is middle of multi-column
410 character. In that case, the new point is set after
413 = XFASTINT (Fmove_to_column (make_number (target_clm
), Qnil
));
415 chars_to_delete
= PT
- pos
;
417 if (actual_clm
> target_clm
)
419 /* We will delete too many columns. Let's fill columns
420 by spaces so that the remaining text won't move. */
421 spaces_to_insert
= actual_clm
- target_clm
;
424 SET_PT_BOTH (pos
, pos_byte
);
429 if (!NILP (current_buffer
->abbrev_mode
)
430 && SYNTAX (c
) != Sword
431 && NILP (current_buffer
->read_only
)
432 && PT
> BEGV
&& SYNTAX (XFASTINT (Fprevious_char ())) == Sword
)
437 sym
= Fexpand_abbrev ();
439 /* If we expanded an abbrev which has only a hook,
440 and the hook has a non-nil `no-self-insert' property,
441 return right away--don't really self-insert. */
442 if (! NILP (sym
) && ! NILP (XSYMBOL (sym
)->function
)
443 && SYMBOLP (XSYMBOL (sym
)->function
))
446 prop
= Fget (XSYMBOL (sym
)->function
, intern ("no-self-insert"));
451 if (MODIFF
!= modiff
)
457 string
= make_string_from_bytes (str
, 1, len
);
458 if (spaces_to_insert
)
460 tem
= Fmake_string (make_number (spaces_to_insert
),
462 string
= concat2 (tem
, string
);
465 replace_range (PT
, PT
+ chars_to_delete
, string
, 1, 1, 0);
466 Fforward_char (make_number (1 + spaces_to_insert
));
469 insert_and_inherit (str
, len
);
471 if ((c
== ' ' || c
== '\n')
473 && !NILP (current_buffer
->auto_fill_function
))
478 /* After inserting a newline, move to previous line and fill
479 that. Must have the newline in place already so filling and
480 justification, if any, know where the end is going to be. */
481 SET_PT_BOTH (PT
- 1, PT_BYTE
- 1);
482 tem
= call0 (current_buffer
->auto_fill_function
);
484 SET_PT_BOTH (PT
+ 1, PT_BYTE
+ 1);
490 /* If previous command specified a face to use, use it. */
491 if (!NILP (Vself_insert_face
)
492 && EQ (current_kboard
->Vlast_command
, Vself_insert_face_command
))
494 Fput_text_property (make_number (PT
- 1), make_number (PT
),
495 Qface
, Vself_insert_face
, Qnil
);
496 Vself_insert_face
= Qnil
;
501 if ((synt
== Sclose
|| synt
== Smath
)
502 && !NILP (Vblink_paren_function
) && INTERACTIVE
505 call0 (Vblink_paren_function
);
511 /* module initialization */
516 Qkill_backward_chars
= intern ("kill-backward-chars");
517 staticpro (&Qkill_backward_chars
);
519 Qkill_forward_chars
= intern ("kill-forward-chars");
520 staticpro (&Qkill_forward_chars
);
522 Qoverwrite_mode_binary
= intern ("overwrite-mode-binary");
523 staticpro (&Qoverwrite_mode_binary
);
525 DEFVAR_LISP ("self-insert-face", &Vself_insert_face
,
526 "If non-nil, set the face of the next self-inserting character to this.\n\
527 See also `self-insert-face-command'.");
528 Vself_insert_face
= Qnil
;
530 DEFVAR_LISP ("self-insert-face-command", &Vself_insert_face_command
,
531 "This is the command that set up `self-insert-face'.\n\
532 If `last-command' does not equal this value, we ignore `self-insert-face'.");
533 Vself_insert_face_command
= Qnil
;
535 DEFVAR_LISP ("blink-paren-function", &Vblink_paren_function
,
536 "Function called, if non-nil, whenever a close parenthesis is inserted.\n\
537 More precisely, a char with closeparen syntax is self-inserted.");
538 Vblink_paren_function
= Qnil
;
540 defsubr (&Sforward_point
);
541 defsubr (&Sforward_char
);
542 defsubr (&Sbackward_char
);
543 defsubr (&Sforward_line
);
544 defsubr (&Sbeginning_of_line
);
545 defsubr (&Send_of_line
);
547 defsubr (&Sdelete_char
);
548 defsubr (&Sdelete_backward_char
);
550 defsubr (&Sself_insert_command
);
558 initial_define_key (global_map
, Ctl ('I'), "self-insert-command");
559 for (n
= 040; n
< 0177; n
++)
560 initial_define_key (global_map
, n
, "self-insert-command");
562 for (n
= 0200; n
< 0240; n
++)
563 initial_define_key (global_map
, n
, "self-insert-command");
565 for (n
= 0240; n
< 0400; n
++)
566 initial_define_key (global_map
, n
, "self-insert-command");
568 initial_define_key (global_map
, Ctl ('A'), "beginning-of-line");
569 initial_define_key (global_map
, Ctl ('B'), "backward-char");
570 initial_define_key (global_map
, Ctl ('D'), "delete-char");
571 initial_define_key (global_map
, Ctl ('E'), "end-of-line");
572 initial_define_key (global_map
, Ctl ('F'), "forward-char");
573 initial_define_key (global_map
, 0177, "delete-backward-char");