Function: evil-get-selection

evil-get-selection is a function alias for gui-get-selection, defined in select.el.gz.

Signature

(evil-get-selection &optional TYPE DATA-TYPE)

Documentation

Return the value of an X Windows selection.

The argument TYPE (default PRIMARY) says which selection, and the argument DATA-TYPE (default STRING) says how to convert the data.

TYPE may be any symbol (but nil stands for PRIMARY). However, only a few symbols are commonly used. They conventionally have all upper-case names. The most often used ones, in addition to PRIMARY, are SECONDARY and CLIPBOARD.

DATA-TYPE is usually STRING, but can also be one of the symbols in selection-converter-alist, which see. On X, we recommend to always use a specific DATA-TYPE expected from the selection owner. In particular, if the data is expected to be non-ASCII text, in many cases using 'UTF8_STRING is the most reasonable value for DATA-TYPE.

Window systems other than X usually support only a small subset of these symbols, in addition to STRING; MS-Windows supports TARGETS, which reports the formats available in the clipboard if TYPE is CLIPBOARD.

Aliases

evil-get-selection x-get-selection (obsolete since 25.1)