1 /* Simple built-in editing commands.
3 Copyright (C) 1985, 1993-1998, 2001-2013 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 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 false. N defaults to 1.
51 Validate the new location. Return nil. */
53 move_point (Lisp_Object n
, bool 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.
88 Interactively, N is the numeric prefix argument.
89 If N is omitted or nil, move point 1 character forward.
91 Depending on the bidirectional context, the movement may be to the
92 right or to the left on the screen. This is in contrast with
93 \\[right-char], which see. */)
96 return move_point (n
, 1);
99 DEFUN ("backward-char", Fbackward_char
, Sbackward_char
, 0, 1, "^p",
100 doc
: /* Move point N characters backward (forward if N is negative).
101 On attempt to pass beginning or end of buffer, stop and signal error.
102 Interactively, N is the numeric prefix argument.
103 If N is omitted or nil, move point 1 character backward.
105 Depending on the bidirectional context, the movement may be to the
106 right or to the left on the screen. This is in contrast with
107 \\[left-char], which see. */)
110 return move_point (n
, 0);
113 DEFUN ("forward-line", Fforward_line
, Sforward_line
, 0, 1, "^p",
114 doc
: /* Move N lines forward (backward if N is negative).
115 Precisely, if point is on line I, move to the start of line I + N
116 \("start of line" in the logical order).
117 If there isn't room, go as far as possible (no error).
118 Returns the count of lines left to move. If moving forward,
119 that is N - number of lines moved; if backward, N + number moved.
120 With positive N, a non-empty line at the end counts as one line
121 successfully moved (for the return value). */)
124 ptrdiff_t opoint
= PT
, opoint_byte
= PT_BYTE
;
125 ptrdiff_t pos
, pos_byte
;
126 EMACS_INT count
, shortage
;
137 shortage
= scan_newline (PT
, PT_BYTE
, BEGV
, BEGV_BYTE
, count
- 1, 1);
139 shortage
= scan_newline (PT
, PT_BYTE
, ZV
, ZV_BYTE
, count
, 1);
141 /* Since scan_newline does TEMP_SET_PT_BOTH,
142 and we want to set PT "for real",
143 go back to the old point and then come back here. */
146 TEMP_SET_PT_BOTH (opoint
, opoint_byte
);
147 SET_PT_BOTH (pos
, pos_byte
);
153 && (FETCH_BYTE (PT_BYTE
- 1) != '\n'))))
156 return make_number (count
<= 0 ? - shortage
: shortage
);
159 DEFUN ("beginning-of-line", Fbeginning_of_line
, Sbeginning_of_line
, 0, 1, "^p",
160 doc
: /* Move point to beginning of current line (in the logical order).
161 With argument N not nil or 1, move forward N - 1 lines first.
162 If point reaches the beginning or end of buffer, it stops there.
164 This function constrains point to the current field unless this moves
165 point to a different line than the original, unconstrained result.
166 If N is nil or 1, and a front-sticky field starts at point, the point
167 does not move. To ignore field boundaries bind
168 `inhibit-field-text-motion' to t, or use the `forward-line' function
169 instead. For instance, `(forward-line 0)' does the same thing as
170 `(beginning-of-line)', except that it ignores field boundaries. */)
178 SET_PT (XINT (Fline_beginning_position (n
)));
183 DEFUN ("end-of-line", Fend_of_line
, Send_of_line
, 0, 1, "^p",
184 doc
: /* Move point to end of current line (in the logical order).
185 With argument N not nil or 1, move forward N - 1 lines first.
186 If point reaches the beginning or end of buffer, it stops there.
187 To ignore intangibility, bind `inhibit-point-motion-hooks' to t.
189 This function constrains point to the current field unless this moves
190 point to a different line than the original, unconstrained result. If
191 N is nil or 1, and a rear-sticky field ends at point, the point does
192 not move. To ignore field boundaries bind `inhibit-field-text-motion'
205 newpos
= XINT (Fline_end_position (n
));
209 && FETCH_CHAR (PT
- 1) == '\n')
211 /* If we skipped over a newline that follows
212 an invisible intangible run,
213 move back to the last tangible position
219 else if (PT
> newpos
&& PT
< ZV
220 && FETCH_CHAR (PT
) != '\n')
221 /* If we skipped something intangible
222 and now we're not really at eol,
232 DEFUN ("delete-char", Fdelete_char
, Sdelete_char
, 1, 2, "p\nP",
233 doc
: /* Delete the following N characters (previous if N is negative).
234 Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).
235 Interactively, N is the prefix arg, and KILLFLAG is set if
236 N was explicitly specified.
238 The command `delete-forward-char' is preferable for interactive use. */)
239 (Lisp_Object n
, Lisp_Object killflag
)
251 xsignal0 (Qbeginning_of_buffer
);
258 xsignal0 (Qend_of_buffer
);
265 call1 (Qkill_forward_chars
, n
);
270 static int nonundocount
;
272 /* Note that there's code in command_loop_1 which typically avoids
274 DEFUN ("self-insert-command", Fself_insert_command
, Sself_insert_command
, 1, 1, "p",
275 doc
: /* Insert the character you type.
276 Whichever character you type to run this command is inserted.
277 Before insertion, `expand-abbrev' is executed if the inserted character does
278 not have word syntax and the previous character in the buffer does.
279 After insertion, the value of `auto-fill-function' is called if the
280 `auto-fill-chars' table has a non-nil value for the inserted character.
281 At the end, it runs `post-self-insert-hook'. */)
284 bool remove_boundary
= 1;
287 if (!EQ (Vthis_command
, KVAR (current_kboard
, Vlast_command
)))
290 if (NILP (Vexecuting_kbd_macro
)
291 && !EQ (minibuf_window
, selected_window
))
293 if (nonundocount
<= 0 || nonundocount
>= 20)
302 && CONSP (BVAR (current_buffer
, undo_list
))
303 && NILP (XCAR (BVAR (current_buffer
, undo_list
)))
304 /* Only remove auto-added boundaries, not boundaries
305 added be explicit calls to undo-boundary. */
306 && EQ (BVAR (current_buffer
, undo_list
), last_undo_boundary
))
307 /* Remove the undo_boundary that was just pushed. */
308 bset_undo_list (current_buffer
, XCDR (BVAR (current_buffer
, undo_list
)));
310 /* Barf if the key that invoked this was not a character. */
311 if (!CHARACTERP (last_command_event
))
314 int character
= translate_char (Vtranslation_table_for_input
,
315 XINT (last_command_event
));
316 int val
= internal_self_insert (character
, XFASTINT (n
));
319 frame_make_pointer_invisible ();
325 /* Insert N times character C
327 If this insertion is suitable for direct output (completely simple),
328 return 0. A value of 1 indicates this *might* not have been simple.
329 A value of 2 means this did things that call for an undo boundary. */
331 static Lisp_Object Qexpand_abbrev
;
332 static Lisp_Object Qpost_self_insert_hook
;
335 internal_self_insert (int c
, EMACS_INT n
)
339 register enum syntaxcode synt
;
340 Lisp_Object overwrite
;
341 /* Length of multi-byte form of C. */
343 /* Working buffer and pointer for multi-byte form of C. */
344 unsigned char str
[MAX_MULTIBYTE_LENGTH
];
345 ptrdiff_t chars_to_delete
= 0;
346 ptrdiff_t spaces_to_insert
= 0;
348 overwrite
= BVAR (current_buffer
, overwrite_mode
);
349 if (!NILP (Vbefore_change_functions
) || !NILP (Vafter_change_functions
))
352 /* At first, get multi-byte form of C in STR. */
353 if (!NILP (BVAR (current_buffer
, enable_multibyte_characters
)))
355 len
= CHAR_STRING (c
, str
);
357 /* If C has modifier bits, this makes C an appropriate
363 str
[0] = (SINGLE_BYTE_CHAR_P (c
)
365 : multibyte_char_to_unibyte (c
));
368 if (!NILP (overwrite
)
371 /* In overwrite-mode, we substitute a character at point (C2,
372 hereafter) by C. For that, we delete C2 in advance. But,
373 just substituting C2 by C may move a remaining text in the
374 line to the right or to the left, which is not preferable.
375 So we insert more spaces or delete more characters in the
376 following cases: if C is narrower than C2, after deleting C2,
377 we fill columns with spaces, if C is wider than C2, we delete
378 C2 and several characters following C2. */
380 /* This is the character after point. */
381 int c2
= FETCH_CHAR (PT_BYTE
);
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
))
391 chars_to_delete
= min (n
, PTRDIFF_MAX
);
392 else if (c
!= '\n' && c2
!= '\n'
393 && (cwidth
= XFASTINT (Fchar_width (make_number (c
)))) != 0)
396 ptrdiff_t pos_byte
= PT_BYTE
;
397 ptrdiff_t curcol
= current_column ();
399 if (n
<= (min (MOST_POSITIVE_FIXNUM
, PTRDIFF_MAX
) - curcol
) / cwidth
)
401 /* Column the cursor should be placed at after this insertion.
402 The value should be calculated only when necessary. */
403 ptrdiff_t target_clm
= curcol
+ n
* cwidth
;
405 /* The actual cursor position after the trial of moving
406 to column TARGET_CLM. It is greater than TARGET_CLM
407 if the TARGET_CLM is middle of multi-column
408 character. In that case, the new point is set after
411 = XFASTINT (Fmove_to_column (make_number (target_clm
), Qnil
));
413 chars_to_delete
= PT
- pos
;
415 if (actual_clm
> target_clm
)
417 /* We will delete too many columns. Let's fill columns
418 by spaces so that the remaining text won't move. */
419 ptrdiff_t actual
= PT_BYTE
;
421 if (FETCH_CHAR (actual
) == '\t')
422 /* Rather than add spaces, let's just keep the tab. */
425 spaces_to_insert
= actual_clm
- target_clm
;
428 SET_PT_BOTH (pos
, pos_byte
);
436 if (!NILP (BVAR (current_buffer
, abbrev_mode
))
438 && NILP (BVAR (current_buffer
, read_only
))
440 && (SYNTAX (!NILP (BVAR (current_buffer
, enable_multibyte_characters
))
441 ? XFASTINT (Fprevious_char ())
442 : UNIBYTE_TO_CHAR (XFASTINT (Fprevious_char ())))
445 EMACS_INT modiff
= MODIFF
;
448 sym
= call0 (Qexpand_abbrev
);
450 /* If we expanded an abbrev which has a hook,
451 and the hook has a non-nil `no-self-insert' property,
452 return right away--don't really self-insert. */
453 if (SYMBOLP (sym
) && ! NILP (sym
)
454 && ! NILP (XSYMBOL (sym
)->function
)
455 && SYMBOLP (XSYMBOL (sym
)->function
))
458 prop
= Fget (XSYMBOL (sym
)->function
, intern ("no-self-insert"));
463 if (MODIFF
!= modiff
)
469 int mc
= ((NILP (BVAR (current_buffer
, enable_multibyte_characters
))
470 && SINGLE_BYTE_CHAR_P (c
))
471 ? UNIBYTE_TO_CHAR (c
) : c
);
472 Lisp_Object string
= Fmake_string (make_number (n
), make_number (mc
));
474 if (spaces_to_insert
)
476 tem
= Fmake_string (make_number (spaces_to_insert
),
478 string
= concat2 (string
, tem
);
481 replace_range (PT
, PT
+ chars_to_delete
, string
, 1, 1, 1);
482 Fforward_char (make_number (n
+ spaces_to_insert
));
488 SAFE_NALLOCA (strn
, len
, n
);
489 for (p
= strn
; n
> 0; n
--, p
+= len
)
490 memcpy (p
, str
, len
);
491 insert_and_inherit (strn
, p
- strn
);
495 insert_and_inherit ((char *) str
, len
);
497 if ((CHAR_TABLE_P (Vauto_fill_chars
)
498 ? !NILP (CHAR_TABLE_REF (Vauto_fill_chars
, c
))
499 : (c
== ' ' || c
== '\n'))
500 && !NILP (BVAR (current_buffer
, auto_fill_function
)))
502 Lisp_Object auto_fill_result
;
505 /* After inserting a newline, move to previous line and fill
506 that. Must have the newline in place already so filling and
507 justification, if any, know where the end is going to be. */
508 SET_PT_BOTH (PT
- 1, PT_BYTE
- 1);
509 auto_fill_result
= call0 (BVAR (current_buffer
, auto_fill_function
));
510 /* Test PT < ZV in case the auto-fill-function is strange. */
511 if (c
== '\n' && PT
< ZV
)
512 SET_PT_BOTH (PT
+ 1, PT_BYTE
+ 1);
513 if (!NILP (auto_fill_result
))
517 /* Run hooks for electric keys. */
518 Frun_hooks (1, &Qpost_self_insert_hook
);
523 /* module initialization */
528 DEFSYM (Qkill_backward_chars
, "kill-backward-chars");
529 DEFSYM (Qkill_forward_chars
, "kill-forward-chars");
530 DEFSYM (Qoverwrite_mode_binary
, "overwrite-mode-binary");
531 DEFSYM (Qexpand_abbrev
, "expand-abbrev");
532 DEFSYM (Qpost_self_insert_hook
, "post-self-insert-hook");
534 DEFVAR_LISP ("post-self-insert-hook", Vpost_self_insert_hook
,
535 doc
: /* Hook run at the end of `self-insert-command'.
536 This is run after inserting the character. */);
537 Vpost_self_insert_hook
= Qnil
;
539 defsubr (&Sforward_point
);
540 defsubr (&Sforward_char
);
541 defsubr (&Sbackward_char
);
542 defsubr (&Sforward_line
);
543 defsubr (&Sbeginning_of_line
);
544 defsubr (&Send_of_line
);
546 defsubr (&Sdelete_char
);
547 defsubr (&Sself_insert_command
);
556 initial_define_key (global_map
, Ctl ('I'), "self-insert-command");
557 for (n
= 040; n
< 0177; n
++)
558 initial_define_key (global_map
, n
, "self-insert-command");
560 for (n
= 0200; n
< 0240; n
++)
561 initial_define_key (global_map
, n
, "self-insert-command");
563 for (n
= 0240; n
< 0400; n
++)
564 initial_define_key (global_map
, n
, "self-insert-command");
566 initial_define_key (global_map
, Ctl ('A'), "beginning-of-line");
567 initial_define_key (global_map
, Ctl ('B'), "backward-char");
568 initial_define_key (global_map
, Ctl ('E'), "end-of-line");
569 initial_define_key (global_map
, Ctl ('F'), "forward-char");