C++ API

method libtmux-cxx latest

Window.next_layout

Step through tmux's preset arrangements, and turn the panes within the one in use.

Source and package

Qualified name: libtmux::Window::next_layout
Namespace: libtmux
Declared in: Window
Package: libtmux-cxx
Source: include/libtmux/entities.hpp
Other languages: Perl Erlang PowerShell Julia Elixir Haskell Common Lisp Python Ruby Lua TypeScriptRustGoJavaC#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<void, CommandFailure> next_layout() const; method readonly [source] ¶: Description#

The layouts are tmux's list, not a caller's: asking for "the next one" is the only way to reach them without naming each. Rotating is a different act — it moves which pane occupies which cell and leaves the cells where they are.
None of the three refuses a window holding a single pane. tmux accepts all of them there and changes nothing, which is worth knowing before treating success as evidence that something moved.

tmux command#

The tmux commands behind next_layout.

The C declarations in tmux that implement these commands.

Apply a window's next layout preset

Equivalents of Apply a window's next layout preset in other languages
Language	Equivalent
Python	`libtmux.Window.next_layout`
Haskell	No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing.
TypeScript	`window.Window.nextLayout`
Rust	`window.Window.next_layout`
Go	`tmux.Window.NextLayout`
Java	`io.github.libtmux.Window.nextLayout`
C#	`LibTmux.Window.SelectNextLayoutAsync`
Swift	`Server.nextLayout(_:)`
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#.