Session.search_panes
Panes in this session, optionally filtered by tmux.
Source and package
-
Description#
Like
Session.panesbut with afilterkwarg passed to$ tmux list-panes -s -t <session> -f <filter>.Examples#
>>> target_pane = session.active_window.split()>>> matches = session.search_panes(... filter=f'#{{m:{target_pane.pane_id},#{{pane_id}}}}'... )>>> [p.pane_id for p in matches] == [target_pane.pane_id]True- Parameters
-
-
filter(str | None) # – tmux format expression (-fflag). tmux silently expands a malformed filter (unclosed#{...}, unknown format token) to empty, which the filter treats as false — every row is suppressed and no stderr is emitted. A bad filter is indistinguishable from "filter matched nothing"; verify filter syntax against the FORMATS section oftmux(1). Warning: added 0.57
-
In other ports Filter a session's panes with a tmux expression
- PowerShell No source-verified PowerShell equivalent is recorded for this operation.
- Julia No source-verified Julia equivalent is recorded for this operation.
- Ruby No source-verified Ruby equivalent is recorded for this operation.
- Lua No source-verified Lua equivalent is recorded for this operation.
- TypeScript no equivalent on
Session - Rust no equivalent on
Session - Go
- Java no equivalent on
Session - C#
- C++ no equivalent on
Session - Swift no equivalent on
Session - Kotlin No source-verified Kotlin equivalent is recorded for this operation.
- Scala No source-verified Scala equivalent is recorded for this operation.
- F# No source-verified F# equivalent is recorded for this operation.