A register is a sort of variable used in Emacs editing that can hold a marker, a string, a rectangle, a window configuration (of one frame), or a frame configuration (of all frames). Each register is named by a single character. All characters, including control and meta characters (but with the exception of C-g), can be used to name registers. Thus, there are 255 possible registers. A register is designated in Emacs Lisp by a character that is its name.
The functions in this section return unpredictable values unless otherwise stated.
(name .
contents)
. Normally, there is one element for each Emacs
register that has been used.
The object name is a character (an integer) identifying the register. The object contents is a string, marker, or list representing the register contents. A string represents text stored in the register. A marker represents a position. A list represents a rectangle; its elements are strings, one per line of the rectangle.
nil
if it has no contents.
Normally, this command puts point before the inserted text, and the
mark after it. However, if the optional second argument beforep
is non-nil
, it puts the mark before and point after.
You can pass a non-nil
second argument beforep to this
function interactively by supplying any prefix argument.
If the register contains a rectangle, then the rectangle is inserted with its upper left corner at point. This means that text is inserted in the current line and underneath it on successive lines.
If the register contains something other than saved text (a string) or a rectangle (a list), currently useless things happen. This may be changed in the future.
Go to the first, previous, next, last section, table of contents.