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.

method libtmux-rs latest

Session.next_window

Move to the next window, and return it.

Source and package
Qualified name
libtmux::session::Session::next_window
Module
session
Declared in
Session
Package
libtmux
Source
crates/libtmux/src/session.rs
Other languages
Perl Erlang PowerShell Julia Elixir Haskell Common Lisp Python Ruby Lua TypeScript GoJavaC#C++Swift Kotlin Scala OCaml F# Clojure
pub async fn next_window(&self) -> Result< Option<Window>, Error >

Description#

None when there is no next window, which a session holding one window never has. That is an ordinary state rather than a failure, so it is reported as absence; an error means tmux could not be reached or refused the move for some other reason.

Errors

Returns an error when tmux cannot be reached or refuses the move.

Examples#

let guard = libtmux::test::TestServer::new().await?;
let session = guard.server().new_session("moving").await?;
// One window, so there is nowhere to go and nothing broke.
assert!(session.next_window().await?.is_none());
session.new_window("second").await?;
assert!(session.next_window().await?.is_some());
guard.shutdown().await?;

tmux command#

The tmux commands behind 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
Go tmux.Session.NextWindow
Java io.github.libtmux.Session.nextWindow
C# LibTmux.Session.SelectNextWindowAsync
C++ libtmux::Session::select_next_window
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