1 /* Simple built-in editing commands.
3 Copyright (C) 1985, 1993-1998, 2001-2012 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
26 #include "character.h"
31 #include "dispextern.h"
34 static Lisp_Object Qkill_forward_chars
, Qkill_backward_chars
;
36 /* A possible value for a buffer's overwrite-mode variable. */
37 static Lisp_Object Qoverwrite_mode_binary
;
39 static int internal_self_insert (int, EMACS_INT
);
41 DEFUN ("forward-point", Fforward_point
, Sforward_point
, 1, 1, 0,
42 doc
: /* Return buffer position N characters after (before if N negative) point. */)
47 return make_number (PT
+ XINT (n
));
50 /* Add N to point; or subtract N if FORWARD is zero. N defaults to 1.
51 Validate the new location. Return nil. */
53 move_point (Lisp_Object n
, int forward
)
55 /* This used to just set point to point + XINT (n), and then check
56 to see if it was within boundaries. But now that SET_PT can
57 potentially do a lot of stuff (calling entering and exiting
58 hooks, etcetera), that's not a good approach. So we validate the
59 proposed position, then set point. */
68 new_point
= PT
+ (forward
? XINT (n
) : - XINT (n
));
73 xsignal0 (Qbeginning_of_buffer
);
78 xsignal0 (Qend_of_buffer
);
85 DEFUN ("forward-char", Fforward_char
, Sforward_char
, 0, 1, "^p",
86 doc
: /* Move point N characters forward (backward if N is negative).
87 On reaching end or beginning of buffer, stop and signal error.
89 Depending on the bidirectional context, the movement may be to the
90 right or to the left on the screen. This is in contrast with
91 \\[right-char], which see. */)
94 return move_point (n
, 1);
97 DEFUN ("backward-char", Fbackward_char
, Sbackward_char
, 0, 1, "^p",
98 doc
: /* Move point N characters backward (forward if N is negative).
99 On attempt to pass beginning or end of buffer, stop and signal error.
101 Depending on the bidirectional context, the movement may be to the
102 right or to the left on the screen. This is in contrast with
103 \\[left-char], which see. */)
106 return move_point (n
, 0);
109 DEFUN ("forward-line", Fforward_line
, Sforward_line
, 0, 1, "^p",
110 doc
: /* Move N lines forward (backward if N is negative).
111 Precisely, if point is on line I, move to the start of line I + N
112 \("start of line" in the logical order).
113 If there isn't room, go as far as possible (no error).
114 Returns the count of lines left to move. If moving forward,
115 that is N - number of lines moved; if backward, N + number moved.
116 With positive N, a non-empty line at the end counts as one line
117 successfully moved (for the return value). */)
120 ptrdiff_t opoint
= PT
, opoint_byte
= PT_BYTE
;
121 ptrdiff_t pos
, pos_byte
;
122 EMACS_INT count
, shortage
;
133 shortage
= scan_newline (PT
, PT_BYTE
, BEGV
, BEGV_BYTE
, count
- 1, 1);
135 shortage
= scan_newline (PT
, PT_BYTE
, ZV
, ZV_BYTE
, count
, 1);
137 /* Since scan_newline does TEMP_SET_PT_BOTH,
138 and we want to set PT "for real",
139 go back to the old point and then come back here. */
142 TEMP_SET_PT_BOTH (opoint
, opoint_byte
);
143 SET_PT_BOTH (pos
, pos_byte
);
149 && (FETCH_BYTE (PT_BYTE
- 1) != '\n'))))
152 return make_number (count
<= 0 ? - shortage
: shortage
);
155 DEFUN ("beginning-of-line", Fbeginning_of_line
, Sbeginning_of_line
, 0, 1, "^p",
156 doc
: /* Move point to beginning of current line (in the logical order).
157 With argument N not nil or 1, move forward N - 1 lines first.
158 If point reaches the beginning or end of buffer, it stops there.
160 This function constrains point to the current field unless this moves
161 point to a different line than the original, unconstrained result.
162 If N is nil or 1, and a front-sticky field starts at point, the point
163 does not move. To ignore field boundaries bind
164 `inhibit-field-text-motion' to t, or use the `forward-line' function
165 instead. For instance, `(forward-line 0)' does the same thing as
166 `(beginning-of-line)', except that it ignores field boundaries. */)
174 SET_PT (XINT (Fline_beginning_position (n
)));
179 DEFUN ("end-of-line", Fend_of_line
, Send_of_line
, 0, 1, "^p",
180 doc
: /* Move point to end of current line (in the logical order).
181 With argument N not nil or 1, move forward N - 1 lines first.
182 If point reaches the beginning or end of buffer, it stops there.
183 To ignore intangibility, bind `inhibit-point-motion-hooks' to t.
185 This function constrains point to the current field unless this moves
186 point to a different line than the original, unconstrained result. If
187 N is nil or 1, and a rear-sticky field ends at point, the point does
188 not move. To ignore field boundaries bind `inhibit-field-text-motion'
201 newpos
= XINT (Fline_end_position (n
));
205 && FETCH_CHAR (PT
- 1) == '\n')
207 /* If we skipped over a newline that follows
208 an invisible intangible run,
209 move back to the last tangible position
215 else if (PT
> newpos
&& PT
< ZV
216 && FETCH_CHAR (PT
) != '\n')
217 /* If we skipped something intangible
218 and now we're not really at eol,
228 DEFUN ("delete-char", Fdelete_char
, Sdelete_char
, 1, 2, "p\nP",
229 doc
: /* Delete the following N characters (previous if N is negative).
230 Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).
231 Interactively, N is the prefix arg, and KILLFLAG is set if
232 N was explicitly specified.
234 The command `delete-forward-char' is preferable for interactive use. */)
235 (Lisp_Object n
, Lisp_Object killflag
)
247 xsignal0 (Qbeginning_of_buffer
);
254 xsignal0 (Qend_of_buffer
);
261 call1 (Qkill_forward_chars
, n
);
266 static int nonundocount
;
268 /* Note that there's code in command_loop_1 which typically avoids
270 DEFUN ("self-insert-command", Fself_insert_command
, Sself_insert_command
, 1, 1, "p",
271 doc
: /* Insert the character you type.
272 Whichever character you type to run this command is inserted.
273 Before insertion, `expand-abbrev' is executed if the inserted character does
274 not have word syntax and the previous character in the buffer does.
275 After insertion, the value of `auto-fill-function' is called if the
276 `auto-fill-chars' table has a non-nil value for the inserted character.
277 At the end, it runs `post-self-insert-hook'. */)
280 int remove_boundary
= 1;
283 if (!EQ (Vthis_command
, KVAR (current_kboard
, Vlast_command
)))
286 if (NILP (Vexecuting_kbd_macro
)
287 && !EQ (minibuf_window
, selected_window
))
289 if (nonundocount
<= 0 || nonundocount
>= 20)
298 && CONSP (BVAR (current_buffer
, undo_list
))
299 && NILP (XCAR (BVAR (current_buffer
, undo_list
))))
300 /* Remove the undo_boundary that was just pushed. */
301 BVAR (current_buffer
, undo_list
) = XCDR (BVAR (current_buffer
, undo_list
));
303 /* Barf if the key that invoked this was not a character. */
304 if (!CHARACTERP (last_command_event
))
307 int character
= translate_char (Vtranslation_table_for_input
,
308 XINT (last_command_event
));
309 int val
= internal_self_insert (character
, XFASTINT (n
));
312 frame_make_pointer_invisible ();
318 /* Insert N times character C
320 If this insertion is suitable for direct output (completely simple),
321 return 0. A value of 1 indicates this *might* not have been simple.
322 A value of 2 means this did things that call for an undo boundary. */
324 static Lisp_Object Qexpand_abbrev
;
325 static Lisp_Object Qpost_self_insert_hook
;
328 internal_self_insert (int c
, EMACS_INT n
)
332 register enum syntaxcode synt
;
333 Lisp_Object overwrite
;
334 /* Length of multi-byte form of C. */
336 /* Working buffer and pointer for multi-byte form of C. */
337 unsigned char str
[MAX_MULTIBYTE_LENGTH
];
338 ptrdiff_t chars_to_delete
= 0;
339 ptrdiff_t spaces_to_insert
= 0;
341 overwrite
= BVAR (current_buffer
, overwrite_mode
);
342 if (!NILP (Vbefore_change_functions
) || !NILP (Vafter_change_functions
))
345 /* At first, get multi-byte form of C in STR. */
346 if (!NILP (BVAR (current_buffer
, enable_multibyte_characters
)))
348 len
= CHAR_STRING (c
, str
);
350 /* If C has modifier bits, this makes C an appropriate
356 str
[0] = (SINGLE_BYTE_CHAR_P (c
)
358 : multibyte_char_to_unibyte (c
));
361 if (!NILP (overwrite
)
364 /* In overwrite-mode, we substitute a character at point (C2,
365 hereafter) by C. For that, we delete C2 in advance. But,
366 just substituting C2 by C may move a remaining text in the
367 line to the right or to the left, which is not preferable.
368 So we insert more spaces or delete more characters in the
369 following cases: if C is narrower than C2, after deleting C2,
370 we fill columns with spaces, if C is wider than C2, we delete
371 C2 and several characters following C2. */
373 /* This is the character after point. */
374 int c2
= FETCH_CHAR (PT_BYTE
);
378 /* Overwriting in binary-mode always replaces C2 by C.
379 Overwriting in textual-mode doesn't always do that.
380 It inserts newlines in the usual way,
381 and inserts any character at end of line
382 or before a tab if it doesn't use the whole width of the tab. */
383 if (EQ (overwrite
, Qoverwrite_mode_binary
))
384 chars_to_delete
= min (n
, PTRDIFF_MAX
);
385 else if (c
!= '\n' && c2
!= '\n'
386 && (cwidth
= XFASTINT (Fchar_width (make_number (c
)))) != 0)
389 ptrdiff_t pos_byte
= PT_BYTE
;
390 ptrdiff_t curcol
= current_column ();
392 if (n
<= (min (MOST_POSITIVE_FIXNUM
, PTRDIFF_MAX
) - curcol
) / cwidth
)
394 /* Column the cursor should be placed at after this insertion.
395 The value should be calculated only when necessary. */
396 ptrdiff_t target_clm
= curcol
+ n
* cwidth
;
398 /* The actual cursor position after the trial of moving
399 to column TARGET_CLM. It is greater than TARGET_CLM
400 if the TARGET_CLM is middle of multi-column
401 character. In that case, the new point is set after
404 = XFASTINT (Fmove_to_column (make_number (target_clm
), Qnil
));
406 chars_to_delete
= PT
- pos
;
408 if (actual_clm
> target_clm
)
410 /* We will delete too many columns. Let's fill columns
411 by spaces so that the remaining text won't move. */
412 ptrdiff_t actual
= PT_BYTE
;
414 if (FETCH_CHAR (actual
) == '\t')
415 /* Rather than add spaces, let's just keep the tab. */
418 spaces_to_insert
= actual_clm
- target_clm
;
421 SET_PT_BOTH (pos
, pos_byte
);
429 if (!NILP (BVAR (current_buffer
, abbrev_mode
))
431 && NILP (BVAR (current_buffer
, read_only
))
433 && (SYNTAX (!NILP (BVAR (current_buffer
, enable_multibyte_characters
))
434 ? XFASTINT (Fprevious_char ())
435 : UNIBYTE_TO_CHAR (XFASTINT (Fprevious_char ())))
441 sym
= call0 (Qexpand_abbrev
);
443 /* If we expanded an abbrev which has a hook,
444 and the hook has a non-nil `no-self-insert' property,
445 return right away--don't really self-insert. */
446 if (SYMBOLP (sym
) && ! NILP (sym
) && ! NILP (XSYMBOL (sym
)->function
)
447 && SYMBOLP (XSYMBOL (sym
)->function
))
450 prop
= Fget (XSYMBOL (sym
)->function
, intern ("no-self-insert"));
455 if (MODIFF
!= modiff
)
461 int mc
= ((NILP (BVAR (current_buffer
, enable_multibyte_characters
))
462 && SINGLE_BYTE_CHAR_P (c
))
463 ? UNIBYTE_TO_CHAR (c
) : c
);
464 Lisp_Object string
= Fmake_string (make_number (n
), make_number (mc
));
466 if (spaces_to_insert
)
468 tem
= Fmake_string (make_number (spaces_to_insert
),
470 string
= concat2 (string
, tem
);
473 replace_range (PT
, PT
+ chars_to_delete
, string
, 1, 1, 1);
474 Fforward_char (make_number (n
+ spaces_to_insert
));
480 SAFE_NALLOCA (strn
, len
, n
);
481 for (p
= strn
; n
> 0; n
--, p
+= len
)
482 memcpy (p
, str
, len
);
483 insert_and_inherit (strn
, p
- strn
);
487 insert_and_inherit ((char *) str
, len
);
489 if ((CHAR_TABLE_P (Vauto_fill_chars
)
490 ? !NILP (CHAR_TABLE_REF (Vauto_fill_chars
, c
))
491 : (c
== ' ' || c
== '\n'))
492 && !NILP (BVAR (current_buffer
, auto_fill_function
)))
494 Lisp_Object auto_fill_result
;
497 /* After inserting a newline, move to previous line and fill
498 that. Must have the newline in place already so filling and
499 justification, if any, know where the end is going to be. */
500 SET_PT_BOTH (PT
- 1, PT_BYTE
- 1);
501 auto_fill_result
= call0 (BVAR (current_buffer
, auto_fill_function
));
502 /* Test PT < ZV in case the auto-fill-function is strange. */
503 if (c
== '\n' && PT
< ZV
)
504 SET_PT_BOTH (PT
+ 1, PT_BYTE
+ 1);
505 if (!NILP (auto_fill_result
))
509 /* Run hooks for electric keys. */
510 Frun_hooks (1, &Qpost_self_insert_hook
);
515 /* module initialization */
520 DEFSYM (Qkill_backward_chars
, "kill-backward-chars");
521 DEFSYM (Qkill_forward_chars
, "kill-forward-chars");
522 DEFSYM (Qoverwrite_mode_binary
, "overwrite-mode-binary");
523 DEFSYM (Qexpand_abbrev
, "expand-abbrev");
524 DEFSYM (Qpost_self_insert_hook
, "post-self-insert-hook");
526 DEFVAR_LISP ("post-self-insert-hook", Vpost_self_insert_hook
,
527 doc
: /* Hook run at the end of `self-insert-command'.
528 This is run after inserting the character. */);
529 Vpost_self_insert_hook
= Qnil
;
531 defsubr (&Sforward_point
);
532 defsubr (&Sforward_char
);
533 defsubr (&Sbackward_char
);
534 defsubr (&Sforward_line
);
535 defsubr (&Sbeginning_of_line
);
536 defsubr (&Send_of_line
);
538 defsubr (&Sdelete_char
);
539 defsubr (&Sself_insert_command
);
548 initial_define_key (global_map
, Ctl ('I'), "self-insert-command");
549 for (n
= 040; n
< 0177; n
++)
550 initial_define_key (global_map
, n
, "self-insert-command");
552 for (n
= 0200; n
< 0240; n
++)
553 initial_define_key (global_map
, n
, "self-insert-command");
555 for (n
= 0240; n
< 0400; n
++)
556 initial_define_key (global_map
, n
, "self-insert-command");
558 initial_define_key (global_map
, Ctl ('A'), "beginning-of-line");
559 initial_define_key (global_map
, Ctl ('B'), "backward-char");
560 initial_define_key (global_map
, Ctl ('E'), "end-of-line");
561 initial_define_key (global_map
, Ctl ('F'), "forward-char");