Struct Registers 

pub struct Registers {
    pub unnamed: Slot,
    pub yank_zero: Slot,
    pub delete_ring: [Slot; 9],
    pub small_delete: Slot,
    pub named: [Slot; 26],
    pub clip: Slot,
    pub filename: Option<String>,
    /* private fields */
}

Fields

unnamed: Slot

" — written by every yank / delete / change.

yank_zero: Slot

"0 — last yank only.

delete_ring: [Slot; 9]

"1–"9 — last 9 line-sized deletes ("1 newest).

small_delete: Slot

"- — small-delete register: last delete/change of less than one line, when no register was named.

named: [Slot; 26]

"a–"z — named user registers.

clip: Slot

"+ / "* — system clipboard register. Both selectors alias the same slot (matches the typical Linux/macOS/Windows setup where there’s no separate primary selection in our pipeline). The host (the host) syncs this slot from the OS clipboard before paste and from the slot back out on yank.

filename: Option<String>

"% — synthetic read-only register: current buffer filename. Set by the host whenever the active slot changes.

Implementations

impl Registers

pub fn record_yank( &mut self, text: String, linewise: bool, target: Option<char>, )

Record a yank operation. Writes to ", "0, and (if target is set) the named slot. When target is '_' (black-hole register) all writes are suppressed — vim discards the text without touching any register.

pub fn record_delete( &mut self, text: String, linewise: bool, target: Option<char>, )

Record a delete / change. Writes to " and routes the text to a numbered or small-delete register (and, if target is set, the named slot). Empty deletes are dropped — vim doesn’t pollute the ring with no-ops. When target is '_' (black-hole register) all writes are suppressed, preserving the previous register state.

Register routing follows vim (:help quote1, :help quote_-):

• a named target suppresses both the numbered ring and "-;
• otherwise a delete of a whole line or spanning more than one line shifts the "1–"9 ring;
• a smaller (sub-line) delete goes to "- and leaves the ring alone.

pub fn read(&self, reg: char) -> Option<&Slot>

Read a register by its single-char selector. Returns None for unrecognised selectors.

'%' is a synthetic read-only register: returns the current buffer filename when one has been set via Registers::set_filename.

pub fn set_filename(&mut self, name: Option<String>)

Host hook: set the "% register to the given filename. Call this whenever the active buffer changes.

pub fn set_clipboard(&mut self, text: String, linewise: bool)

Replace the clipboard slot’s contents — host hook for syncing from the OS clipboard before a paste from "+ / "*.

Trait Implementations

impl Clone for Registers

fn clone(&self) -> Registers

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Registers

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Registers

fn default() -> Registers

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Registers

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Registers

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.