1 /* Simple built-in editing commands.
3 Copyright (C) 1985, 1993-1998, 2001-2015 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/>. */
25 #include "character.h"
31 #include "dispextern.h"
34 static int internal_self_insert (int, EMACS_INT
);
36 DEFUN ("forward-point", Fforward_point
, Sforward_point
, 1, 1, 0,
37 doc
: /* Return buffer position N characters after (before if N negative) point. */)
42 return make_number (PT
+ XINT (n
));
45 /* Add N to point; or subtract N if FORWARD is false. N defaults to 1.
46 Validate the new location. Return nil. */
48 move_point (Lisp_Object n
, bool forward
)
50 /* This used to just set point to point + XINT (n), and then check
51 to see if it was within boundaries. But now that SET_PT can
52 potentially do a lot of stuff (calling entering and exiting
53 hooks, etcetera), that's not a good approach. So we validate the
54 proposed position, then set point. */
63 new_point
= PT
+ (forward
? XINT (n
) : - XINT (n
));
68 xsignal0 (Qbeginning_of_buffer
);
73 xsignal0 (Qend_of_buffer
);
80 DEFUN ("forward-char", Fforward_char
, Sforward_char
, 0, 1, "^p",
81 doc
: /* Move point N characters forward (backward if N is negative).
82 On reaching end or beginning of buffer, stop and signal error.
83 Interactively, N is the numeric prefix argument.
84 If N is omitted or nil, move point 1 character forward.
86 Depending on the bidirectional context, the movement may be to the
87 right or to the left on the screen. This is in contrast with
88 \\[right-char], which see. */)
91 return move_point (n
, 1);
94 DEFUN ("backward-char", Fbackward_char
, Sbackward_char
, 0, 1, "^p",
95 doc
: /* Move point N characters backward (forward if N is negative).
96 On attempt to pass beginning or end of buffer, stop and signal error.
97 Interactively, N is the numeric prefix argument.
98 If N is omitted or nil, move point 1 character backward.
100 Depending on the bidirectional context, the movement may be to the
101 right or to the left on the screen. This is in contrast with
102 \\[left-char], which see. */)
105 return move_point (n
, 0);
108 DEFUN ("forward-line", Fforward_line
, Sforward_line
, 0, 1, "^p",
109 doc
: /* Move N lines forward (backward if N is negative).
110 Precisely, if point is on line I, move to the start of line I + N
111 \("start of line" in the logical order).
112 If there isn't room, go as far as possible (no error).
113 Returns the count of lines left to move. If moving forward,
114 that is N - number of lines moved; if backward, N + number moved.
115 With positive N, a non-empty line at the end counts as one line
116 successfully moved (for the return value). */)
119 ptrdiff_t opoint
= PT
, pos
, pos_byte
, shortage
, count
;
129 shortage
= scan_newline_from_point (count
, &pos
, &pos_byte
);
131 SET_PT_BOTH (pos
, pos_byte
);
137 && (FETCH_BYTE (PT_BYTE
- 1) != '\n'))))
140 return make_number (count
<= 0 ? - shortage
: shortage
);
143 DEFUN ("beginning-of-line", Fbeginning_of_line
, Sbeginning_of_line
, 0, 1, "^p",
144 doc
: /* Move point to beginning of current line (in the logical order).
145 With argument N not nil or 1, move forward N - 1 lines first.
146 If point reaches the beginning or end of buffer, it stops there.
148 This function constrains point to the current field unless this moves
149 point to a different line than the original, unconstrained result.
150 If N is nil or 1, and a front-sticky field starts at point, the point
151 does not move. To ignore field boundaries bind
152 `inhibit-field-text-motion' to t, or use the `forward-line' function
153 instead. For instance, `(forward-line 0)' does the same thing as
154 `(beginning-of-line)', except that it ignores field boundaries. */)
162 SET_PT (XINT (Fline_beginning_position (n
)));
167 DEFUN ("end-of-line", Fend_of_line
, Send_of_line
, 0, 1, "^p",
168 doc
: /* Move point to end of current line (in the logical order).
169 With argument N not nil or 1, move forward N - 1 lines first.
170 If point reaches the beginning or end of buffer, it stops there.
171 To ignore intangibility, bind `inhibit-point-motion-hooks' to t.
173 This function constrains point to the current field unless this moves
174 point to a different line than the original, unconstrained result. If
175 N is nil or 1, and a rear-sticky field ends at point, the point does
176 not move. To ignore field boundaries bind `inhibit-field-text-motion'
189 newpos
= XINT (Fline_end_position (n
));
193 && FETCH_CHAR (PT
- 1) == '\n')
195 /* If we skipped over a newline that follows
196 an invisible intangible run,
197 move back to the last tangible position
203 else if (PT
> newpos
&& PT
< ZV
204 && FETCH_CHAR (PT
) != '\n')
205 /* If we skipped something intangible
206 and now we're not really at eol,
216 static int nonundocount
;
219 remove_excessive_undo_boundaries (void)
221 bool remove_boundary
= true;
223 if (!EQ (Vthis_command
, KVAR (current_kboard
, Vlast_command
)))
226 if (NILP (Vexecuting_kbd_macro
))
228 if (nonundocount
<= 0 || nonundocount
>= 20)
230 remove_boundary
= false;
237 && CONSP (BVAR (current_buffer
, undo_list
))
238 && NILP (XCAR (BVAR (current_buffer
, undo_list
)))
239 /* Only remove auto-added boundaries, not boundaries
240 added by explicit calls to undo-boundary. */
241 && EQ (BVAR (current_buffer
, undo_list
), last_undo_boundary
))
242 /* Remove the undo_boundary that was just pushed. */
243 bset_undo_list (current_buffer
, XCDR (BVAR (current_buffer
, undo_list
)));
246 DEFUN ("delete-char", Fdelete_char
, Sdelete_char
, 1, 2, "p\nP",
247 doc
: /* Delete the following N characters (previous if N is negative).
248 Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).
249 Interactively, N is the prefix arg, and KILLFLAG is set if
250 N was explicitly specified.
252 The command `delete-forward-char' is preferable for interactive use, e.g.
253 because it respects values of `delete-active-region' and `overwrite-mode'. */)
254 (Lisp_Object n
, Lisp_Object killflag
)
260 if (abs (XINT (n
)) < 2)
261 remove_excessive_undo_boundaries ();
269 xsignal0 (Qbeginning_of_buffer
);
276 xsignal0 (Qend_of_buffer
);
283 call1 (Qkill_forward_chars
, n
);
288 /* Note that there's code in command_loop_1 which typically avoids
290 DEFUN ("self-insert-command", Fself_insert_command
, Sself_insert_command
, 1, 1, "p",
291 doc
: /* Insert the character you type.
292 Whichever character you type to run this command is inserted.
293 The numeric prefix argument N says how many times to repeat the insertion.
294 Before insertion, `expand-abbrev' is executed if the inserted character does
295 not have word syntax and the previous character in the buffer does.
296 After insertion, the value of `auto-fill-function' is called if the
297 `auto-fill-chars' table has a non-nil value for the inserted character.
298 At the end, it runs `post-self-insert-hook'. */)
303 if (XFASTINT (n
) < 0)
304 error ("Negative repetition argument %"pI
"d", XFASTINT (n
));
306 if (XFASTINT (n
) < 2)
307 remove_excessive_undo_boundaries ();
309 /* Barf if the key that invoked this was not a character. */
310 if (!CHARACTERP (last_command_event
))
313 int character
= translate_char (Vtranslation_table_for_input
,
314 XINT (last_command_event
));
315 int val
= internal_self_insert (character
, XFASTINT (n
));
318 frame_make_pointer_invisible (SELECTED_FRAME ());
324 /* Insert N times character C
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 (int c
, EMACS_INT n
)
335 register enum syntaxcode synt
;
336 Lisp_Object overwrite
;
337 /* Length of multi-byte form of C. */
339 /* Working buffer and pointer for multi-byte form of C. */
340 unsigned char str
[MAX_MULTIBYTE_LENGTH
];
341 ptrdiff_t chars_to_delete
= 0;
342 ptrdiff_t spaces_to_insert
= 0;
344 overwrite
= BVAR (current_buffer
, overwrite_mode
);
345 if (!NILP (Vbefore_change_functions
) || !NILP (Vafter_change_functions
))
348 /* At first, get multi-byte form of C in STR. */
349 if (!NILP (BVAR (current_buffer
, enable_multibyte_characters
)))
351 len
= CHAR_STRING (c
, str
);
353 /* If C has modifier bits, this makes C an appropriate
359 str
[0] = SINGLE_BYTE_CHAR_P (c
) ? c
: CHAR_TO_BYTE8 (c
);
362 if (!NILP (overwrite
)
365 /* In overwrite-mode, we substitute a character at point (C2,
366 hereafter) by C. For that, we delete C2 in advance. But,
367 just substituting C2 by C may move a remaining text in the
368 line to the right or to the left, which is not preferable.
369 So we insert more spaces or delete more characters in the
370 following cases: if C is narrower than C2, after deleting C2,
371 we fill columns with spaces, if C is wider than C2, we delete
372 C2 and several characters following C2. */
374 /* This is the character after point. */
375 int c2
= FETCH_CHAR (PT_BYTE
);
379 /* Overwriting in binary-mode always replaces C2 by C.
380 Overwriting in textual-mode doesn't always do that.
381 It inserts newlines in the usual way,
382 and inserts any character at end of line
383 or before a tab if it doesn't use the whole width of the tab. */
384 if (EQ (overwrite
, Qoverwrite_mode_binary
))
385 chars_to_delete
= min (n
, PTRDIFF_MAX
);
386 else if (c
!= '\n' && c2
!= '\n'
387 && (cwidth
= XFASTINT (Fchar_width (make_number (c
)))) != 0)
390 ptrdiff_t pos_byte
= PT_BYTE
;
391 ptrdiff_t curcol
= current_column ();
393 if (n
<= (min (MOST_POSITIVE_FIXNUM
, PTRDIFF_MAX
) - curcol
) / cwidth
)
395 /* Column the cursor should be placed at after this insertion.
396 The value should be calculated only when necessary. */
397 ptrdiff_t target_clm
= curcol
+ n
* cwidth
;
399 /* The actual cursor position after the trial of moving
400 to column TARGET_CLM. It is greater than TARGET_CLM
401 if the TARGET_CLM is middle of multi-column
402 character. In that case, the new point is set after
405 = XFASTINT (Fmove_to_column (make_number (target_clm
), Qnil
));
407 chars_to_delete
= PT
- pos
;
409 if (actual_clm
> target_clm
)
411 /* We will delete too many columns. Let's fill columns
412 by spaces so that the remaining text won't move. */
413 ptrdiff_t actual
= PT_BYTE
;
415 if (FETCH_CHAR (actual
) == '\t')
416 /* Rather than add spaces, let's just keep the tab. */
419 spaces_to_insert
= actual_clm
- target_clm
;
422 SET_PT_BOTH (pos
, pos_byte
);
430 if (!NILP (BVAR (current_buffer
, abbrev_mode
))
432 && NILP (BVAR (current_buffer
, read_only
))
434 && (SYNTAX (!NILP (BVAR (current_buffer
, enable_multibyte_characters
))
435 ? XFASTINT (Fprevious_char ())
436 : UNIBYTE_TO_CHAR (XFASTINT (Fprevious_char ())))
439 EMACS_INT modiff
= MODIFF
;
442 sym
= call0 (Qexpand_abbrev
);
444 /* If we expanded an abbrev which has a hook,
445 and the hook has a non-nil `no-self-insert' property,
446 return right away--don't really self-insert. */
447 if (SYMBOLP (sym
) && ! NILP (sym
)
448 && ! NILP (XSYMBOL (sym
)->function
)
449 && SYMBOLP (XSYMBOL (sym
)->function
))
452 prop
= Fget (XSYMBOL (sym
)->function
, intern ("no-self-insert"));
457 if (MODIFF
!= modiff
)
463 int mc
= ((NILP (BVAR (current_buffer
, enable_multibyte_characters
))
464 && SINGLE_BYTE_CHAR_P (c
))
465 ? UNIBYTE_TO_CHAR (c
) : c
);
466 Lisp_Object string
= Fmake_string (make_number (n
), make_number (mc
));
468 if (spaces_to_insert
)
470 tem
= Fmake_string (make_number (spaces_to_insert
),
472 string
= concat2 (string
, tem
);
475 replace_range (PT
, PT
+ chars_to_delete
, string
, 1, 1, 1);
476 Fforward_char (make_number (n
+ spaces_to_insert
));
482 SAFE_NALLOCA (strn
, len
, n
);
483 for (p
= strn
; n
> 0; n
--, p
+= len
)
484 memcpy (p
, str
, len
);
485 insert_and_inherit (strn
, p
- strn
);
489 insert_and_inherit ((char *) str
, len
);
491 if ((CHAR_TABLE_P (Vauto_fill_chars
)
492 ? !NILP (CHAR_TABLE_REF (Vauto_fill_chars
, c
))
493 : (c
== ' ' || c
== '\n'))
494 && !NILP (BVAR (current_buffer
, auto_fill_function
)))
496 Lisp_Object auto_fill_result
;
499 /* After inserting a newline, move to previous line and fill
500 that. Must have the newline in place already so filling and
501 justification, if any, know where the end is going to be. */
502 SET_PT_BOTH (PT
- 1, PT_BYTE
- 1);
503 auto_fill_result
= call0 (BVAR (current_buffer
, auto_fill_function
));
504 /* Test PT < ZV in case the auto-fill-function is strange. */
505 if (c
== '\n' && PT
< ZV
)
506 SET_PT_BOTH (PT
+ 1, PT_BYTE
+ 1);
507 if (!NILP (auto_fill_result
))
511 /* Run hooks for electric keys. */
512 run_hook (Qpost_self_insert_hook
);
517 /* module initialization */
522 DEFSYM (Qkill_backward_chars
, "kill-backward-chars");
523 DEFSYM (Qkill_forward_chars
, "kill-forward-chars");
525 /* A possible value for a buffer's overwrite-mode variable. */
526 DEFSYM (Qoverwrite_mode_binary
, "overwrite-mode-binary");
528 DEFSYM (Qexpand_abbrev
, "expand-abbrev");
529 DEFSYM (Qpost_self_insert_hook
, "post-self-insert-hook");
531 DEFVAR_LISP ("post-self-insert-hook", Vpost_self_insert_hook
,
532 doc
: /* Hook run at the end of `self-insert-command'.
533 This is run after inserting the character. */);
534 Vpost_self_insert_hook
= Qnil
;
536 defsubr (&Sforward_point
);
537 defsubr (&Sforward_char
);
538 defsubr (&Sbackward_char
);
539 defsubr (&Sforward_line
);
540 defsubr (&Sbeginning_of_line
);
541 defsubr (&Send_of_line
);
543 defsubr (&Sdelete_char
);
544 defsubr (&Sself_insert_command
);
553 initial_define_key (global_map
, Ctl ('I'), "self-insert-command");
554 for (n
= 040; n
< 0177; n
++)
555 initial_define_key (global_map
, n
, "self-insert-command");
557 for (n
= 0200; n
< 0240; n
++)
558 initial_define_key (global_map
, n
, "self-insert-command");
560 for (n
= 0240; n
< 0400; n
++)
561 initial_define_key (global_map
, n
, "self-insert-command");
563 initial_define_key (global_map
, Ctl ('A'), "beginning-of-line");
564 initial_define_key (global_map
, Ctl ('B'), "backward-char");
565 initial_define_key (global_map
, Ctl ('E'), "end-of-line");
566 initial_define_key (global_map
, Ctl ('F'), "forward-char");