Rust API

method libtmux-rs latest

Window.select

Make this window active in the session it was reached through.

Source and package

Qualified name: libtmux::window::Window::select
Module: window
Declared in: Window
Package: libtmux
Source: crates/libtmux/src/window.rs
Other languages: Perlmethod Erlangfunction PowerShell Julia Elixir Haskell Common Lisp Python Ruby LuaTypeScriptGoJavaC#C++Swift Kotlin Scala OCaml F# Clojure

pub async fn select(&mut self) -> Result<&mut Self, Error> method async [source] ¶: Description#

Targeted by id rather than by index. An index is a slot, not an identity: anything that renumbers windows -- breaking a lone pane out of one moves it to a free index -- leaves a handle's cached index pointing at whatever occupies that slot now, which is a different live window rather than nothing. tmux answers such a target without complaint, so an index-scoped select would switch to the wrong window and report success.
Errors
Returns an error when tmux refuses the command, and Error::ObjectGone when the window is no longer on the server.

tmux command#

The tmux commands behind select.

The C declarations in tmux that implement these commands.

Make a window active

Equivalents of Make a window active in other languages
Language	Equivalent
Python	`libtmux.Window.select`
Lua	`libtmux.WindowLink:select`
Erlang	`tmux_window_link:select/1` Selects a captured membership in its session.
Haskell	No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing.
TypeScript	`window.Window.select`
Go	`tmux.Window.Select`
Java	`io.github.libtmux.Window.select`
C#	`LibTmux.Window.SelectAsync`
C++	`libtmux::Window::select`
Swift	`Server.select(_:)`
OCaml	`Libtmux_unix.Client.select_window_at`
Perl	`LibTmux::Server::select_window` Requires an explicit WindowLink or session_id:index context; a physical window alone does not select a session placement.

No equivalent is recorded in Ruby, PowerShell, Julia, Elixir, Common Lisp, Clojure, Kotlin, Scala or F#.