Server.search_windows
All windows across sessions, optionally filtered by tmux.
Source and package
-
Description#
Like
Server.windowsbut with afilterkwarg passed to$ tmux list-windows -a -f <filter>.Examples#
>>> sess = server.new_session(session_name='gap7_win_demo')>>> _ = sess.new_window(window_name='gap7_target')>>> _ = sess.new_window(window_name='other_window')>>> matches = server.search_windows(filter='#{m:gap7_*,#{window_name}}')>>> any(w.window_name == 'gap7_target' for w in matches)True>>> any(w.window_name == 'other_window' for w in matches)False- 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
-
tmux command#
The tmux commands behind search_windows.
list-windows -a server scope, cmd_list_windows_exec tmux C API#
The C declarations in tmux that implement these commands.
In other ports#
Filter every window with a tmux expression
| Language | Equivalent |
|---|---|
| Haskell | No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing. |
| TypeScript | no equivalent on Server |
| Rust | no equivalent on Server |
| Go | tmux |
| Java | no equivalent on Server |
| C# | Lib |
| C++ | no equivalent on Server |
| Swift | no equivalent on 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, Lua, PowerShell, Julia, Erlang, Elixir, Common Lisp, Clojure, Kotlin, Scala or F#.