1 /* kill.c -- kill ring management. */
3 /* Copyright (C) 1994-2020 Free Software Foundation, Inc.
5 This file is part of the GNU Readline Library (Readline), a library
6 for reading lines of text with interactive input and history editing.
8 Readline is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 Readline is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with Readline. If not, see <http://www.gnu.org/licenses/>.
22 #define READLINE_LIBRARY
24 #if defined (HAVE_CONFIG_H)
28 #include <sys/types.h>
30 #if defined (HAVE_UNISTD_H)
31 # include <unistd.h> /* for _POSIX_VERSION */
32 #endif /* HAVE_UNISTD_H */
34 #if defined (HAVE_STDLIB_H)
37 # include "ansi_stdlib.h"
38 #endif /* HAVE_STDLIB_H */
42 /* System-specific feature definitions and include files. */
45 /* Some standard library routines. */
49 #include "rlprivate.h"
52 /* **************************************************************** */
54 /* Killing Mechanism */
56 /* **************************************************************** */
58 /* What we assume for a max number of kills. */
59 #define DEFAULT_MAX_KILLS 10
61 /* The real variable to look at to find out when to flush kills. */
62 static int rl_max_kills
= DEFAULT_MAX_KILLS
;
64 /* Where to store killed text. */
65 static char **rl_kill_ring
= (char **)NULL
;
67 /* Where we are in the kill ring. */
68 static int rl_kill_index
;
70 /* How many slots we have in the kill ring. */
71 static int rl_kill_ring_length
;
73 static int _rl_copy_to_kill_ring
PARAMS((char *, int));
74 static int region_kill_internal
PARAMS((int));
75 static int _rl_copy_word_as_kill
PARAMS((int, int));
76 static int rl_yank_nth_arg_internal
PARAMS((int, int, int));
78 /* How to say that you only want to save a certain amount
81 rl_set_retained_kills (int num
)
86 /* Add TEXT to the kill ring, allocating a new kill ring slot as necessary.
87 This uses TEXT directly, so the caller must not free it. If APPEND is
88 non-zero, and the last command was a kill, the text is appended to the
89 current kill ring slot, otherwise prepended. */
91 _rl_copy_to_kill_ring (char *text
, int append
)
96 /* First, find the slot to work with. */
97 if (_rl_last_command_was_kill
== 0 || rl_kill_ring
== 0)
100 if (rl_kill_ring
== 0)
102 /* If we don't have any defined, then make one. */
103 rl_kill_ring
= (char **)
104 xmalloc (((rl_kill_ring_length
= 1) + 1) * sizeof (char *));
105 rl_kill_ring
[slot
= 0] = (char *)NULL
;
109 /* We have to add a new slot on the end, unless we have
110 exceeded the max limit for remembering kills. */
111 slot
= rl_kill_ring_length
;
112 if (slot
== rl_max_kills
)
115 xfree (rl_kill_ring
[0]);
116 for (i
= 0; i
< slot
; i
++)
117 rl_kill_ring
[i
] = rl_kill_ring
[i
+ 1];
121 slot
= rl_kill_ring_length
+= 1;
122 rl_kill_ring
= (char **)xrealloc (rl_kill_ring
, (slot
+ 1) * sizeof (char *));
124 rl_kill_ring
[--slot
] = (char *)NULL
;
128 slot
= rl_kill_ring_length
- 1;
130 /* If the last command was a kill, prepend or append. */
131 if (_rl_last_command_was_kill
&& rl_kill_ring
[slot
] && rl_editing_mode
!= vi_mode
)
133 old
= rl_kill_ring
[slot
];
134 new = (char *)xmalloc (1 + strlen (old
) + strlen (text
));
148 rl_kill_ring
[slot
] = new;
151 rl_kill_ring
[slot
] = text
;
153 rl_kill_index
= slot
;
157 /* The way to kill something. This appends or prepends to the last
158 kill, if the last command was a kill command. if FROM is less
159 than TO, then the text is appended, otherwise prepended. If the
160 last command was not a kill command, then a new slot is made for
163 rl_kill_text (int from
, int to
)
167 /* Is there anything to kill? */
170 _rl_last_command_was_kill
++;
174 text
= rl_copy_text (from
, to
);
176 /* Delete the copied text from the line. */
177 rl_delete_text (from
, to
);
179 _rl_copy_to_kill_ring (text
, from
< to
);
181 _rl_last_command_was_kill
++;
185 /* Now REMEMBER! In order to do prepending or appending correctly, kill
186 commands always make rl_point's original position be the FROM argument,
187 and rl_point's extent be the TO argument. */
189 /* **************************************************************** */
191 /* Killing Commands */
193 /* **************************************************************** */
195 /* Delete the word at point, saving the text in the kill ring. */
197 rl_kill_word (int count
, int key
)
202 return (rl_backward_kill_word (-count
, key
));
205 orig_point
= rl_point
;
206 rl_forward_word (count
, key
);
208 if (rl_point
!= orig_point
)
209 rl_kill_text (orig_point
, rl_point
);
211 rl_point
= orig_point
;
212 if (rl_editing_mode
== emacs_mode
)
218 /* Rubout the word before point, placing it on the kill ring. */
220 rl_backward_kill_word (int count
, int key
)
225 return (rl_kill_word (-count
, key
));
228 orig_point
= rl_point
;
229 rl_backward_word (count
, key
);
231 if (rl_point
!= orig_point
)
232 rl_kill_text (orig_point
, rl_point
);
234 if (rl_editing_mode
== emacs_mode
)
240 /* Kill from here to the end of the line. If DIRECTION is negative, kill
241 back to the line start instead. */
243 rl_kill_line (int direction
, int key
)
248 return (rl_backward_kill_line (1, key
));
251 orig_point
= rl_point
;
252 rl_end_of_line (1, key
);
253 if (orig_point
!= rl_point
)
254 rl_kill_text (orig_point
, rl_point
);
255 rl_point
= orig_point
;
256 if (rl_editing_mode
== emacs_mode
)
262 /* Kill backwards to the start of the line. If DIRECTION is negative, kill
263 forwards to the line end instead. */
265 rl_backward_kill_line (int direction
, int key
)
270 return (rl_kill_line (1, key
));
277 orig_point
= rl_point
;
278 rl_beg_of_line (1, key
);
279 if (rl_point
!= orig_point
)
280 rl_kill_text (orig_point
, rl_point
);
281 if (rl_editing_mode
== emacs_mode
)
288 /* Kill the whole line, no matter where point is. */
290 rl_kill_full_line (int count
, int key
)
292 rl_begin_undo_group ();
294 rl_kill_text (rl_point
, rl_end
);
296 rl_end_undo_group ();
300 /* The next two functions mimic unix line editing behaviour, except they
301 save the deleted text on the kill ring. This is safer than not saving
302 it, and since we have a ring, nobody should get screwed. */
304 /* This does what C-w does in Unix. We can't prevent people from
305 using behaviour that they expect. */
307 rl_unix_word_rubout (int count
, int key
)
315 orig_point
= rl_point
;
321 while (rl_point
&& whitespace (rl_line_buffer
[rl_point
- 1]))
324 while (rl_point
&& (whitespace (rl_line_buffer
[rl_point
- 1]) == 0))
325 rl_point
--; /* XXX - multibyte? */
328 rl_kill_text (orig_point
, rl_point
);
329 if (rl_editing_mode
== emacs_mode
)
336 /* This deletes one filename component in a Unix pathname. That is, it
337 deletes backward to directory separator (`/') or whitespace. */
339 rl_unix_filename_rubout (int count
, int key
)
347 orig_point
= rl_point
;
353 c
= rl_line_buffer
[rl_point
- 1];
354 while (rl_point
&& (whitespace (c
) || c
== '/'))
357 c
= rl_line_buffer
[rl_point
- 1];
360 while (rl_point
&& (whitespace (c
) == 0) && c
!= '/')
362 rl_point
--; /* XXX - multibyte? */
363 c
= rl_line_buffer
[rl_point
- 1];
367 rl_kill_text (orig_point
, rl_point
);
368 if (rl_editing_mode
== emacs_mode
)
375 /* Here is C-u doing what Unix does. You don't *have* to use these
376 key-bindings. We have a choice of killing the entire line, or
377 killing from where we are to the start of the line. We choose the
378 latter, because if you are a Unix weenie, then you haven't backspaced
379 into the line at all, and if you aren't, then you know what you are
382 rl_unix_line_discard (int count
, int key
)
388 rl_kill_text (rl_point
, 0);
390 if (rl_editing_mode
== emacs_mode
)
396 /* Copy the text in the `region' to the kill ring. If DELETE is non-zero,
397 delete the text from the line as well. */
399 region_kill_internal (int delete)
403 if (rl_mark
!= rl_point
)
405 text
= rl_copy_text (rl_point
, rl_mark
);
407 rl_delete_text (rl_point
, rl_mark
);
408 _rl_copy_to_kill_ring (text
, rl_point
< rl_mark
);
412 _rl_last_command_was_kill
++;
416 /* Copy the text in the region to the kill ring. */
418 rl_copy_region_to_kill (int count
, int key
)
420 return (region_kill_internal (0));
423 /* Kill the text between the point and mark. */
425 rl_kill_region (int count
, int key
)
429 npoint
= (rl_point
< rl_mark
) ? rl_point
: rl_mark
;
430 r
= region_kill_internal (1);
436 /* Copy COUNT words to the kill ring. DIR says which direction we look
437 to find the words. */
439 _rl_copy_word_as_kill (int count
, int dir
)
447 rl_forward_word (count
, 0);
449 rl_backward_word (count
, 0);
454 rl_backward_word (count
, 0);
456 rl_forward_word (count
, 0);
458 r
= region_kill_internal (0);
467 rl_copy_forward_word (int count
, int key
)
470 return (rl_copy_backward_word (-count
, key
));
472 return (_rl_copy_word_as_kill (count
, 1));
476 rl_copy_backward_word (int count
, int key
)
479 return (rl_copy_forward_word (-count
, key
));
481 return (_rl_copy_word_as_kill (count
, -1));
484 /* Yank back the last killed text. This ignores arguments. */
486 rl_yank (int count
, int key
)
488 if (rl_kill_ring
== 0)
490 _rl_abort_internal ();
494 _rl_set_mark_at_pos (rl_point
);
495 rl_insert_text (rl_kill_ring
[rl_kill_index
]);
499 /* If the last command was yank, or yank_pop, and the text just
500 before point is identical to the current kill item, then
501 delete that text from the line, rotate the index down, and
502 yank back some other text. */
504 rl_yank_pop (int count
, int key
)
508 if (((rl_last_func
!= rl_yank_pop
) && (rl_last_func
!= rl_yank
)) ||
511 _rl_abort_internal ();
515 l
= strlen (rl_kill_ring
[rl_kill_index
]);
517 if (n
>= 0 && STREQN (rl_line_buffer
+ n
, rl_kill_ring
[rl_kill_index
], l
))
519 rl_delete_text (n
, rl_point
);
522 if (rl_kill_index
< 0)
523 rl_kill_index
= rl_kill_ring_length
- 1;
529 _rl_abort_internal ();
534 #if defined (VI_MODE)
536 rl_vi_yank_pop (int count
, int key
)
540 if (((rl_last_func
!= rl_vi_yank_pop
) && (rl_last_func
!= rl_vi_put
)) ||
543 _rl_abort_internal ();
547 l
= strlen (rl_kill_ring
[rl_kill_index
]);
549 if (n
>= 0 && STREQN (rl_line_buffer
+ n
, rl_kill_ring
[rl_kill_index
], l
))
551 rl_delete_text (n
, rl_point
);
554 if (rl_kill_index
< 0)
555 rl_kill_index
= rl_kill_ring_length
- 1;
561 _rl_abort_internal ();
567 /* Yank the COUNTh argument from the previous history line, skipping
568 HISTORY_SKIP lines before looking for the `previous line'. */
570 rl_yank_nth_arg_internal (int count
, int key
, int history_skip
)
572 register HIST_ENTRY
*entry
;
576 pos
= where_history ();
580 for (i
= 0; i
< history_skip
; i
++)
581 entry
= previous_history ();
584 entry
= previous_history ();
586 history_set_pos (pos
);
594 arg
= history_arg_extract (count
, count
, entry
->line
);
602 rl_begin_undo_group ();
604 _rl_set_mark_at_pos (rl_point
);
606 #if defined (VI_MODE)
607 /* Vi mode always inserts a space before yanking the argument, and it
608 inserts it right *after* rl_point. */
609 if (rl_editing_mode
== vi_mode
&& _rl_keymap
== vi_movement_keymap
)
611 rl_vi_append_mode (1, key
);
612 rl_insert_text (" ");
616 rl_insert_text (arg
);
619 rl_end_undo_group ();
623 /* Yank the COUNTth argument from the previous history line. */
625 rl_yank_nth_arg (int count
, int key
)
627 return (rl_yank_nth_arg_internal (count
, key
, 0));
630 /* Yank the last argument from the previous history line. This `knows'
631 how rl_yank_nth_arg treats a count of `$'. With an argument, this
632 behaves the same as rl_yank_nth_arg. */
634 rl_yank_last_arg (int count
, int key
)
636 static int history_skip
= 0;
637 static int explicit_arg_p
= 0;
638 static int count_passed
= 1;
639 static int direction
= 1;
640 static int undo_needed
= 0;
643 if (rl_last_func
!= rl_yank_last_arg
)
646 explicit_arg_p
= rl_explicit_arg
;
647 count_passed
= count
;
654 if (count
< 0) /* XXX - was < 1 */
655 direction
= -direction
;
656 history_skip
+= direction
;
657 if (history_skip
< 0)
662 retval
= rl_yank_nth_arg_internal (count_passed
, key
, history_skip
);
664 retval
= rl_yank_nth_arg_internal ('$', key
, history_skip
);
666 undo_needed
= retval
== 0;
670 /* Having read the special escape sequence denoting the beginning of a
671 `bracketed paste' sequence, read the rest of the pasted input until the
672 closing sequence and return the pasted text. */
674 _rl_bracketed_text (size_t *lenp
)
681 buf
= xmalloc (cap
= 64);
684 RL_SETSTATE (RL_STATE_MOREINPUT
);
685 while ((c
= rl_read_key ()) >= 0)
687 if (RL_ISSTATE (RL_STATE_MACRODEF
))
688 _rl_add_macro_char (c
);
690 if (c
== '\r') /* XXX */
694 buf
= xrealloc (buf
, cap
*= 2);
697 if (len
>= BRACK_PASTE_SLEN
&& c
== BRACK_PASTE_LAST
&&
698 STREQN (buf
+ len
- BRACK_PASTE_SLEN
, BRACK_PASTE_SUFF
, BRACK_PASTE_SLEN
))
700 len
-= BRACK_PASTE_SLEN
;
704 RL_UNSETSTATE (RL_STATE_MOREINPUT
);
709 buf
= xrealloc (buf
, cap
+ 1);
718 /* Having read the special escape sequence denoting the beginning of a
719 `bracketed paste' sequence, read the rest of the pasted input until the
720 closing sequence and insert the pasted text as a single unit without
721 interpretation. Temporarily highlight the inserted text. */
723 rl_bracketed_paste_begin (int count
, int key
)
729 buf
= _rl_bracketed_text (&len
);
731 retval
= rl_insert_text (buf
) == len
? 0 : 1;
732 if (_rl_enable_active_region
)
740 _rl_read_bracketed_paste_prefix (int c
)
742 char pbuf
[BRACK_PASTE_SLEN
+1], *pbpref
;
745 pbpref
= BRACK_PASTE_PREF
; /* XXX - debugging */
749 while (ind
< BRACK_PASTE_SLEN
-1 &&
750 (RL_ISSTATE (RL_STATE_INPUTPENDING
|RL_STATE_MACROINPUT
) == 0) &&
751 _rl_pushed_input_available () == 0 &&
752 _rl_input_queued (0))
754 key
= rl_read_key (); /* XXX - for now */
758 if (pbuf
[ind
] != pbpref
[ind
])
762 if (ind
< BRACK_PASTE_SLEN
-1) /* read incomplete sequence */
765 _rl_unget_char (pbuf
[ind
--]);
766 return (key
< 0 ? key
: 0);
768 return (key
< 0 ? key
: 1);
771 /* Get a character from wherever we read input, handling input in bracketed
772 paste mode. If we don't have or use bracketed paste mode, this can be
773 used in place of rl_read_key(). */
775 _rl_bracketed_read_key ()
781 RL_SETSTATE(RL_STATE_MOREINPUT
);
783 RL_UNSETSTATE(RL_STATE_MOREINPUT
);
788 /* read pasted data with bracketed-paste mode enabled. */
789 if (_rl_enable_bracketed_paste
&& c
== ESC
&& (r
= _rl_read_bracketed_paste_prefix (c
)) == 1)
791 pbuf
= _rl_bracketed_text (&pblen
);
797 c
= (unsigned char)pbuf
[0];
801 _rl_unget_char ((unsigned char)pbuf
[pblen
]);
809 /* Get a character from wherever we read input, handling input in bracketed
810 paste mode. If we don't have or use bracketed paste mode, this can be
811 used in place of rl_read_key(). */
813 _rl_bracketed_read_mbstring (char *mb
, int mlen
)
817 c
= _rl_bracketed_read_key ();
821 #if defined (HANDLE_MULTIBYTE)
822 if (MB_CUR_MAX
> 1 && rl_byte_oriented
== 0)
823 c
= _rl_read_mbstring (c
, mb
, mlen
);
827 mb
[mlen
] = '\0'; /* just in case */
832 /* A special paste command for Windows users. */
837 rl_paste_from_clipboard (int count
, int key
)
842 if (OpenClipboard (NULL
) == 0)
845 data
= (char *)GetClipboardData (CF_TEXT
);
848 ptr
= strchr (data
, '\r');
852 ptr
= (char *)xmalloc (len
+ 1);
854 strncpy (ptr
, data
, len
);
858 _rl_set_mark_at_pos (rl_point
);
859 rl_insert_text (ptr
);