Window.Swap
Swap exchanges the receiver and Target exact winlinks. Their stable WindowIDs move to the opposite session-and-index views; a WindowID alone does not identify either endpoint. Unless Detach is set, tmux may change the affected sessions' current-window selection; this is not a global client-focus guarantee.
Source and package
- Qualified name
-
tmux.Window. Swap - Package
- tmux
- Declared in
Window- Distribution
- github.com/libtmux/libtmux-go/tmux
- Source
- tmux/window_pane_swap.go
- Other languages
- Perl Erlang PowerShell Julia Elixir Haskell Common Lisp Python Ruby LuaTypeScriptRust Java C#C++Swift Kotlin Scala OCaml F# Clojure
- func (w Window) Swap( ctx context
.Context , request SwapWindow , ) (WindowRequest Swap , error)Result -
Description#
Swap returns both freshly materialized exact endpoint views. If exact refresh fails after the command, it returns a predicted
WindowSwapResultcarrying both stable IDs and post-swap session/index contexts with the error. Earlier failures return zero; transport errors are delivery-ambiguous.- Parameters
tmux command#
The tmux commands behind Swap.
tmux C API#
The C declarations in tmux that implement these commands.
In other ports#
Exchange two windows
| Language | Equivalent |
|---|---|
| Python | libtmux |
| Lua | libtmux |
| Erlang | tmux |
| Haskell | No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing. |
| TypeScript | window |
| Rust | window |
| Java | no equivalent on Window |
| C# | Lib |
| C++ | libtmux:: |
| Swift | Server |
| 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, PowerShell, Julia, Elixir, Common Lisp, Clojure, Kotlin, Scala or F#.