Rust API

pane.Pane.break_out

Rust

Module: pane
Declared in: Pane
Package: libtmux
Source: crates/libtmux/src/pane.rs
Other languages: Python TypeScript Go Java .NET C++Swift

break_out ( self ) → Result<Self, Error> method [source] ¶ method [source] ¶ break_out

Move this pane out into a window of its own.

This consumes the handle, because the pane's window changes and any snapshot of its old position is now wrong.

A pane that is already alone in its window is a no-op, not a refusal. tmux relinks the window rather than rejecting the command -- see cmd-break-pane.c, which links the window into the target session and unlinks it from the source when the pane count is one -- so within one session nothing moves and the call still succeeds. The returned handle names the window it is in either way, which is how a caller tells the two apart.

Errors

Returns an error when tmux refuses the command. Being the window's only pane is not one of those, and neither is it a no-op: tmux relinks the window rather than breaking a pane out of it, which moves the window to a free index. The window and pane ids are unchanged, so a Window held across this call keeps its identity and loses its index.

In other ports Move a pane out into a window of its own

Python libtmux.Pane.break_pane
TypeScript pane.Pane.breakOut
Go tmux.Pane.BreakPane
Java io.github.libtmux.Pane.Pane.breakOut
.NET LibTmux.Pane.BreakAsync
C++ libtmux::Pane::break_out
Swift Server.breakPane(_:from:named:)

Examples

Rust Python TypeScript

use libtmux::{SplitDirection, SplitOptions};

let guard = libtmux::test::TestServer::new().await?;
let session = guard.server().new_session("broken-out").await?;
let pane = session.panes().await?.remove(0);
let stays = pane.window_id().clone();

let moved = pane.split(SplitOptions::new(SplitDirection::Below)).await?;
let moved = moved.break_out().await?;

// The window it landed in, without listing the server to find it.
assert_ne!(moved.window_id(), &stays);

>>> pane_to_break = window.split(shell='sleep 1m')
>>> new_window = pane_to_break.break_pane(window_name='broken')
>>> new_window.window_name
'broken'

await pane.breakOut("extracted");

0 declared, 0 inherited