# libtmux::StringFieldHandle

- **Module:** libtmux
- **Package:** libtmux-cxx
- **Language:** C++
- **Kind:** struct
- **Source:** https://github.com/libtmux/libtmux-cxx/blob/393d4b0ad666f18a6581f1eb281741a75a7503f0/include/libtmux/filter_expr.hpp#L221
- **Page:** https://libtmux.org/en/cxx/latest/reference/libtmux-stringfieldhandle/

A typed field handle.

Only the operations a field's type actually supports are declared, so `pane::active.starts_with(...)` is a compile error rather than a runtime surprise.

A handle also reads a row, so the same name serves as a ranges projection — and a flag handle as a predicate — rather than a lambda that spells the accessor a second time. `sort(panes, {}, pane::index)` then orders by the number tmux rendered, where projecting the text puts `%10` before `%9`.

## Members

- `field` (attribute)
- `iequals` (method)
- `contains` (method)
- `starts_with` (method)
- `ends_with` (method)