Core Library0.xAPI Reference

Choose documentation 3

latest

Current version

latest
English

Early release libtmux is released, and its APIs may still change between releases. This site's structure and URLs may change too.

Rust API

constant libtmux-rs latest

Error.LinkGone

A target found nothing, which does not prove the object is gone.

Source and package
Qualified name
libtmux::error::Error::LinkGone
Module
error
Declared in
Error
Package
libtmux
Source
crates/libtmux/src/error.rs

Description#

Distinct from Self::ObjectGone, and the distinction decides whether a caller may discard a handle: the object may be perfectly alive, linked into another session or sitting at another index. What is known is only that this target resolved to nothing.

tmux answers a missing target by echoing it back, and the echo settles which of the two happened for some target forms and not others. A coordinate -- an index, or a window name, written session:index -- is scoped to one session and is not unique on the server, so its absence is always this error and never the other. An identity carries its kind's sigil (@ a window, % a pane) and echoes identically whether the object died or merely lives under another session's link, so telling those apart costs a lookup and belongs to the caller that can afford one.

Self::is_object_gone() answers false: a handle whose object is still running must not be dropped on this evidence.

Fields2#

LinkGone fields
NameTypeDescription
kind ObjectKind The kind of object the target named.
target String The target that found nothing, spelled as it was sent.
Esc

Type to search.

Reference previewOpen reference