Next: Internals of Kill Ring, Previous: Yank Commands, Up: The Kill Ring [Contents][Index]
These functions and variables provide access to the kill ring at a lower level, but still convenient for use in Lisp programs. They take care of interaction with X Window selections. They do not exist in Emacs version 18.
The function current-kill
rotates the yanking pointer which
designates the “front” of the kill ring by count places (from newer
kills to older ones), and returns the text at that place in the ring.
If the optional second argument do-not-move is non-nil
,
then current-kill
doesn’t alter the yanking pointer; it just
returns the countth kill, counting from the current yanking pointer.
If count is zero, indicating a request for the latest kill,
current-kill
calls the value of
interprogram-paste-function
(documented below) before consulting
the kill ring.
This function makes the text string the latest entry in the kill
ring, and sets kill-ring-yank-pointer
to point to it.
Normally, string is added to the front of the kill ring as a new
entry. However, if optional argument replace is non-nil
,
the entry previously at the front of the kill ring is discarded, and
string replaces it.
This function runs the functions on kill-hooks
, and also invokes
the value of interprogram-cut-function
(see below).
This function appends the text string to the first entry in the
kill ring. Normally string goes at the end of the entry, but if
before-p is non-nil
, it goes at the beginning. This
function also invokes the value of interprogram-cut-function
(see
below).
This variable provides a way of transferring killed text from other
programs, when you are using a window system. Its value should be
nil
or a function of no arguments.
If the value is a function, current-kill
calls it to get the
“most recent kill”. If the function returns a non-nil
value,
then that value is used as the “most recent kill”. If it returns
nil
, then the first element of kill-ring
is used.
The normal use of this hook is to get the X server’s primary selection as the most recent kill, even if the selection belongs to another X client. See X Selections.
This variable provides a way of communicating killed text to other
programs, when you are using a window system. Its value should be
nil
or a function of one argument.
If the value is a function, kill-new
and kill-append
call
it with the new first element of the kill ring as an argument.
The normal use of this hook is to set the X server’s primary selection to the newly killed text.
Next: Internals of Kill Ring, Previous: Yank Commands, Up: The Kill Ring [Contents][Index]