1 /* kill.c -- kill ring management. */
3 /* Copyright (C) 1994 Free Software Foundation, Inc.
5 This file is part of the GNU Readline Library, a library for
6 reading lines of text with interactive input and history editing.
8 The GNU Readline Library is free software; you can redistribute it
9 and/or modify it under the terms of the GNU General Public License
10 as published by the Free Software Foundation; either version 1, or
11 (at your option) any later version.
13 The GNU Readline Library is distributed in the hope that it will be
14 useful, but WITHOUT ANY WARRANTY; without even the implied warranty
15 of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 The GNU General Public License is often shipped with GNU software, and
19 is generally kept in a file called COPYING or LICENSE. If you do not
20 have a copy of the license, write to the Free Software Foundation,
21 675 Mass Ave, Cambridge, MA 02139, USA. */
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 extern int _rl_last_command_was_kill
;
50 extern int rl_editing_mode
;
51 extern int rl_explicit_arg
;
52 extern Function
*rl_last_func
;
54 extern void _rl_init_argument ();
55 extern int _rl_set_mark_at_pos ();
56 extern void _rl_fix_point ();
57 extern void _rl_abort_internal ();
59 extern char *xmalloc (), *xrealloc ();
61 /* **************************************************************** */
63 /* Killing Mechanism */
65 /* **************************************************************** */
67 /* What we assume for a max number of kills. */
68 #define DEFAULT_MAX_KILLS 10
70 /* The real variable to look at to find out when to flush kills. */
71 static int rl_max_kills
= DEFAULT_MAX_KILLS
;
73 /* Where to store killed text. */
74 static char **rl_kill_ring
= (char **)NULL
;
76 /* Where we are in the kill ring. */
77 static int rl_kill_index
;
79 /* How many slots we have in the kill ring. */
80 static int rl_kill_ring_length
;
82 /* How to say that you only want to save a certain amount
85 rl_set_retained_kills (num
)
91 /* Add TEXT to the kill ring, allocating a new kill ring slot as necessary.
92 This uses TEXT directly, so the caller must not free it. If APPEND is
93 non-zero, and the last command was a kill, the text is appended to the
94 current kill ring slot, otherwise prepended. */
96 _rl_copy_to_kill_ring (text
, append
)
103 /* First, find the slot to work with. */
104 if (_rl_last_command_was_kill
== 0)
106 /* Get a new slot. */
107 if (rl_kill_ring
== 0)
109 /* If we don't have any defined, then make one. */
110 rl_kill_ring
= (char **)
111 xmalloc (((rl_kill_ring_length
= 1) + 1) * sizeof (char *));
112 rl_kill_ring
[slot
= 0] = (char *)NULL
;
116 /* We have to add a new slot on the end, unless we have
117 exceeded the max limit for remembering kills. */
118 slot
= rl_kill_ring_length
;
119 if (slot
== rl_max_kills
)
122 free (rl_kill_ring
[0]);
123 for (i
= 0; i
< slot
; i
++)
124 rl_kill_ring
[i
] = rl_kill_ring
[i
+ 1];
128 slot
= rl_kill_ring_length
+= 1;
129 rl_kill_ring
= (char **)xrealloc (rl_kill_ring
, slot
* sizeof (char *));
131 rl_kill_ring
[--slot
] = (char *)NULL
;
135 slot
= rl_kill_ring_length
- 1;
137 /* If the last command was a kill, prepend or append. */
138 if (_rl_last_command_was_kill
&& rl_editing_mode
!= vi_mode
)
140 old
= rl_kill_ring
[slot
];
141 new = xmalloc (1 + strlen (old
) + strlen (text
));
155 rl_kill_ring
[slot
] = new;
158 rl_kill_ring
[slot
] = text
;
160 rl_kill_index
= slot
;
164 /* The way to kill something. This appends or prepends to the last
165 kill, if the last command was a kill command. if FROM is less
166 than TO, then the text is appended, otherwise prepended. If the
167 last command was not a kill command, then a new slot is made for
170 rl_kill_text (from
, to
)
175 /* Is there anything to kill? */
178 _rl_last_command_was_kill
++;
182 text
= rl_copy_text (from
, to
);
184 /* Delete the copied text from the line. */
185 rl_delete_text (from
, to
);
187 _rl_copy_to_kill_ring (text
, from
< to
);
189 _rl_last_command_was_kill
++;
193 /* Now REMEMBER! In order to do prepending or appending correctly, kill
194 commands always make rl_point's original position be the FROM argument,
195 and rl_point's extent be the TO argument. */
197 /* **************************************************************** */
199 /* Killing Commands */
201 /* **************************************************************** */
203 /* Delete the word at point, saving the text in the kill ring. */
205 rl_kill_word (count
, key
)
208 int orig_point
= rl_point
;
211 return (rl_backward_kill_word (-count
, key
));
214 rl_forward_word (count
, key
);
216 if (rl_point
!= orig_point
)
217 rl_kill_text (orig_point
, rl_point
);
219 rl_point
= orig_point
;
224 /* Rubout the word before point, placing it on the kill ring. */
226 rl_backward_kill_word (count
, ignore
)
229 int orig_point
= rl_point
;
232 return (rl_kill_word (-count
, ignore
));
235 rl_backward_word (count
, ignore
);
237 if (rl_point
!= orig_point
)
238 rl_kill_text (orig_point
, rl_point
);
243 /* Kill from here to the end of the line. If DIRECTION is negative, kill
244 back to the line start instead. */
246 rl_kill_line (direction
, ignore
)
247 int direction
, ignore
;
249 int orig_point
= rl_point
;
252 return (rl_backward_kill_line (1, ignore
));
255 rl_end_of_line (1, ignore
);
256 if (orig_point
!= rl_point
)
257 rl_kill_text (orig_point
, rl_point
);
258 rl_point
= orig_point
;
263 /* Kill backwards to the start of the line. If DIRECTION is negative, kill
264 forwards to the line end instead. */
266 rl_backward_kill_line (direction
, ignore
)
267 int direction
, ignore
;
269 int orig_point
= rl_point
;
272 return (rl_kill_line (1, ignore
));
279 rl_beg_of_line (1, ignore
);
280 rl_kill_text (orig_point
, rl_point
);
286 /* Kill the whole line, no matter where point is. */
288 rl_kill_full_line (count
, ignore
)
291 rl_begin_undo_group ();
293 rl_kill_text (rl_point
, rl_end
);
294 rl_end_undo_group ();
298 /* The next two functions mimic unix line editing behaviour, except they
299 save the deleted text on the kill ring. This is safer than not saving
300 it, and since we have a ring, nobody should get screwed. */
302 /* This does what C-w does in Unix. We can't prevent people from
303 using behaviour that they expect. */
305 rl_unix_word_rubout (count
, key
)
314 orig_point
= rl_point
;
320 while (rl_point
&& whitespace (rl_line_buffer
[rl_point
- 1]))
323 while (rl_point
&& (whitespace (rl_line_buffer
[rl_point
- 1]) == 0))
327 rl_kill_text (orig_point
, rl_point
);
332 /* Here is C-u doing what Unix does. You don't *have* to use these
333 key-bindings. We have a choice of killing the entire line, or
334 killing from where we are to the start of the line. We choose the
335 latter, because if you are a Unix weenie, then you haven't backspaced
336 into the line at all, and if you aren't, then you know what you are
339 rl_unix_line_discard (count
, key
)
346 rl_kill_text (rl_point
, 0);
352 /* Copy the text in the `region' to the kill ring. If DELETE is non-zero,
353 delete the text from the line as well. */
355 region_kill_internal (delete)
360 if (rl_mark
== rl_point
)
362 _rl_last_command_was_kill
++;
366 text
= rl_copy_text (rl_point
, rl_mark
);
368 rl_delete_text (rl_point
, rl_mark
);
369 _rl_copy_to_kill_ring (text
, rl_point
< rl_mark
);
371 _rl_last_command_was_kill
++;
375 /* Copy the text in the region to the kill ring. */
377 rl_copy_region_to_kill (count
, ignore
)
380 return (region_kill_internal (0));
383 /* Kill the text between the point and mark. */
385 rl_kill_region (count
, ignore
)
390 r
= region_kill_internal (1);
395 /* Copy COUNT words to the kill ring. DIR says which direction we look
396 to find the words. */
398 _rl_copy_word_as_kill (count
, dir
)
407 rl_forward_word (count
, 0);
409 rl_backward_word (count
, 0);
414 rl_backward_word (count
, 0);
416 rl_forward_word (count
, 0);
418 r
= region_kill_internal (0);
427 rl_copy_forward_word (count
, key
)
431 return (rl_copy_backward_word (-count
, key
));
433 return (_rl_copy_word_as_kill (count
, 1));
437 rl_copy_backward_word (count
, key
)
441 return (rl_copy_forward_word (-count
, key
));
443 return (_rl_copy_word_as_kill (count
, -1));
446 /* Yank back the last killed text. This ignores arguments. */
448 rl_yank (count
, ignore
)
451 if (rl_kill_ring
== 0)
453 _rl_abort_internal ();
457 _rl_set_mark_at_pos (rl_point
);
458 rl_insert_text (rl_kill_ring
[rl_kill_index
]);
462 /* If the last command was yank, or yank_pop, and the text just
463 before point is identical to the current kill item, then
464 delete that text from the line, rotate the index down, and
465 yank back some other text. */
467 rl_yank_pop (count
, key
)
472 if (((rl_last_func
!= rl_yank_pop
) && (rl_last_func
!= rl_yank
)) ||
475 _rl_abort_internal ();
479 l
= strlen (rl_kill_ring
[rl_kill_index
]);
481 if (n
>= 0 && STREQN (rl_line_buffer
+ n
, rl_kill_ring
[rl_kill_index
], l
))
483 rl_delete_text (n
, rl_point
);
486 if (rl_kill_index
< 0)
487 rl_kill_index
= rl_kill_ring_length
- 1;
493 _rl_abort_internal ();
498 /* Yank the COUNTh argument from the previous history line, skipping
499 HISTORY_SKIP lines before looking for the `previous line'. */
501 rl_yank_nth_arg_internal (count
, ignore
, history_skip
)
502 int count
, ignore
, history_skip
;
504 register HIST_ENTRY
*entry
;
510 for (i
= 0; i
< history_skip
; i
++)
511 entry
= previous_history ();
514 entry
= previous_history ();
519 for (i
= 0; i
< history_skip
; i
++)
530 arg
= history_arg_extract (count
, count
, entry
->line
);
537 rl_begin_undo_group ();
539 #if defined (VI_MODE)
540 /* Vi mode always inserts a space before yanking the argument, and it
541 inserts it right *after* rl_point. */
542 if (rl_editing_mode
== vi_mode
)
544 rl_vi_append_mode (1, ignore
);
545 rl_insert_text (" ");
549 rl_insert_text (arg
);
552 rl_end_undo_group ();
556 /* Yank the COUNTth argument from the previous history line. */
558 rl_yank_nth_arg (count
, ignore
)
561 return (rl_yank_nth_arg_internal (count
, ignore
, 0));
564 /* Yank the last argument from the previous history line. This `knows'
565 how rl_yank_nth_arg treats a count of `$'. With an argument, this
566 behaves the same as rl_yank_nth_arg. */
568 rl_yank_last_arg (count
, key
)
571 static int history_skip
= 0;
572 static int explicit_arg_p
= 0;
573 static int count_passed
= 1;
574 static int direction
= 1;
575 static int undo_needed
= 0;
578 if (rl_last_func
!= rl_yank_last_arg
)
581 explicit_arg_p
= rl_explicit_arg
;
582 count_passed
= count
;
590 direction
= -direction
;
591 history_skip
+= direction
;
592 if (history_skip
< 0)
597 retval
= rl_yank_nth_arg_internal (count_passed
, key
, history_skip
);
599 retval
= rl_yank_nth_arg_internal ('$', key
, history_skip
);
601 undo_needed
= retval
== 0;
605 /* A special paste command for users of Cygnus's cygwin32. */
606 #if defined (__CYGWIN32__)
610 rl_paste_from_clipboard (count
, key
)
616 if (OpenClipboard (NULL
) == 0)
619 data
= (char *)GetClipboardData (CF_TEXT
);
622 ptr
= strchr (data
, '\r');
626 ptr
= xmalloc (len
+ 1);
628 strncpy (ptr
, data
, len
);
632 rl_insert_text (ptr
);
639 #endif /* __CYGWIN32__ */