swap_next_window

Synopsis

/bind <key> swap_next_window

Description

Perform the window next operation on the current window, swapping it with an eligible invisible window. This built-in action calls the window-command handler directly, then updates window displays.

Selection uses window reference numbers: choose the eligible invisible window with the smallest number greater than the current window's number. If none has a greater number, wrap to the eligible invisible window with the smallest number. Candidates marked skip on or swappable off through window are excluded. Selection is global across invisible windows, rather than limited to a server.

The incoming window becomes visible in the outgoing window's screen position and becomes current. Input focus transfers when the outgoing window was the screen's input window. The outgoing window becomes invisible; its contents remain available. EPIC adjusts the incoming window's display size for its status lines and toplines, resets its notification/activity indicators, and requests redraws.

If no eligible invisible window is found, the action reports There are no invisible windows and makes no swap. If the outgoing window has swapping disabled, it reports Window <name-or-number> is not swappable. Swapping also requires the outgoing window to be visible; otherwise the helper reports You can only SWAP an invisible window with a visible window.

The action takes no arguments or options; extra text supplied with the binding is ignored. It has no default key assignment and sends no IRC request.

Example

/bind ^X^N swap_next_window

With current window 2 and eligible invisible windows 1, 4, and 7, pressing Control-X followed by Control-N swaps window 4 into view. Repeating selects 7; after that, selection wraps to 1 if it remains eligible and invisible.

See bind for key sequence syntax, swap_previous_window for the opposite reference-number order, and next_window to move focus among windows already visible on the screen.

Source references

• source/keys.c: action registration and default key assignments.
• source/window.c: swap_next_window invokes windowcmd_next; that handler selects invisible candidates and calls swap_window, which checks eligibility, transfers screen placement and focus, and requests redraws.