# Traversal

Source: https://libtmux.org/en/csharp/latest/topics/traversal/

> Moving up and down the server/session/window/pane tree, and the two questions that come up once you have more than one object.

Use relationships to move between sessions, windows, and panes. [Server,
session, window, pane](https://libtmux.org/en/csharp/latest/concepts/server-session-window-pane/) explains the
hierarchy and snapshot model. This page covers relationship calls, collection
membership, and object identity.

## Down the hierarchy

List children through the parent object or a captured snapshot. Whether a read
issues another tmux command depends on the API, independently of whether the
call is async; see [Server, session, window,
pane](https://libtmux.org/en/csharp/latest/concepts/server-session-window-pane/).

Use [`Server.GetSessionsAsync`](<https://libtmux.org/en/csharp/latest/reference/libtmux-server-getsessionsasync/>), [`Session.GetWindowsAsync`](<https://libtmux.org/en/csharp/latest/reference/libtmux-session-getwindowsasync/>), and
[`Window.GetPanesAsync`](<https://libtmux.org/en/csharp/latest/reference/libtmux-window-getpanesasync/>) to read each level of the hierarchy.

## All panes in a session

Use a session-wide pane collection when the task spans several windows, such
as finding a command or capturing output from every pane. A window linked to
multiple sessions still refers to the same tmux panes. Check whether the API
reads live state or traverses a captured graph before reusing its result.

[`LibTmux.Session.Panes`](<https://libtmux.org/en/csharp/latest/reference/libtmux-session-panes/>) reads the session's captured relations. It does not
issue a tmux command; an incomplete capture may lack the required relation.

## Up the hierarchy

Parent lookups may read captured data or query tmux again. Check the method's
read and failure semantics; [Server, session, window,
pane](https://libtmux.org/en/csharp/latest/concepts/server-session-window-pane/) introduces that distinction:

Read the [`Pane.Window`](<https://libtmux.org/en/csharp/latest/reference/libtmux-pane-window/>) and [`Window.Session`](<https://libtmux.org/en/csharp/latest/reference/libtmux-window-session/>) properties.

[`.Window`](<https://libtmux.org/en/csharp/latest/reference/libtmux-window/>), [`.Session`](<https://libtmux.org/en/csharp/latest/reference/libtmux-session/>), [`.ActiveWindow`](<https://libtmux.org/en/csharp/latest/reference/libtmux-session-activewindow/>), and `.ActivePane` read captured state
synchronously. They throw [`IncompleteSnapshotException`](<https://libtmux.org/en/csharp/latest/reference/libtmux-incompletesnapshotexception/>) when the capture lacks
the required context.

## One walk, down and back up

List a session's windows, then look up a parent and compare its identity with
the starting object:

```csharp
Session session = (await server.GetSessionsAsync())[0];
Window window = (await session.GetWindowsAsync())[0];

Session back = window.Session; // property, read from the captured snapshot
back.Equals(session);
```

## The active child

The active window and pane identify where untargeted input goes. Use their
accessors or inspect the active flags in a captured snapshot:

Read the [`Session.ActiveWindow`](<https://libtmux.org/en/csharp/latest/reference/libtmux-session-activewindow/>) and [`Window.ActivePane`](<https://libtmux.org/en/csharp/latest/reference/libtmux-window-activepane/>) properties.

[Format-token fields](https://libtmux.org/en/csharp/latest/topics/format-tokens/) describes the underlying
`window_active` and `pane_active` fields.

## Is it in that collection?

Checking membership generally goes through whatever your language uses for
collection membership, since most of these calls already return an ordinary
array, slice, or list:

Use standard collection membership operations with the object identity
comparison described below.

## Is this the same object?

Compare IDs to determine whether two handles refer to the same tmux object on
the same server. Check what handle equality includes before using it as an
identity test:

[`Pane.Equals`](<https://libtmux.org/en/csharp/latest/reference/libtmux-pane-equals/>) compares a generation counter and the pane ID.