Core LibraryalphaAPI 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.

method libtmux-cxx latest

Session.select_next_window

Move the selection, and answer with the window it landed on.

Source and package
Qualified name
libtmux::Session::select_next_window
Namespace
libtmux
Declared in
Session
Package
libtmux-cxx
Source
include/libtmux/entities.hpp
Other languages
Perl Erlang PowerShell Julia Elixir Haskell Common Lisp Python Ruby Lua TypeScript RustGoJavaC#Swift Kotlin Scala OCaml F# Clojure
[[C++ nodiscard attributeAsks the compiler to warn when a result is discarded. An explicit cast to void acknowledges that the result is intentionally ignored.Language documentation]] expected<Window, CommandFailure> select_next_window() const;

Description#

Named for what they do rather than for what they return: next_window() would read as a question, and these change which window is active.

Relative navigation is tmux's to perform, not a caller's to compute. Next and previous wrap around the window list, and "last" means the previously selected window — state only the server holds, which a caller listing windows has no way to reconstruct.

Each fails when there is nowhere to go, as tmux does: a session with one window refuses all three rather than selecting the window already active.

tmux command#

The tmux commands behind select_next_window.

tmux C API#

The C declarations in tmux that implement these commands.

In other ports#

Move to the next window of a session

Equivalents of Move to the next window of a session in other languages
Language Equivalent
Python libtmux.Session.next_window
Haskell No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing.
TypeScript Session.selectWindow takes next, previous or last
Rust session.Session.next_window
Go tmux.Session.NextWindow
Java io.github.libtmux.Session.nextWindow
C# LibTmux.Session.SelectNextWindowAsync
Swift Server.selectNextWindow(in:)
OCaml No direct public OCaml equivalent is recorded for this operation.
Perl No dedicated equivalent in the selected Perl surface. Explicit Server::cmd remains available for native tmux commands.

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

Esc

Type to search.

Reference previewOpen reference