# LibTmux.Selection.one_or_nil!/2

- **Module:** LibTmux
- **Package:** libtmux
- **Language:** Elixir
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-elixir/blob/66b9b1c3f3f3186428abdfda2c76f5cf87446710/lib/libtmux/selection.ex#L160
- **Page:** https://libtmux.org/en/elixir/latest/reference/libtmux-selection-one_or_nil-bang-2/

```
one_or_nil!(selection, criteria \\ [])
@spec one_or_nil!(t(item), LibTmux.Filter.input()) ::
        item | nil
      when item: LibTmux.Schema.observation()
```

Returns one match or nil, raising on multiple matches.

See the [worked example](api-examples.html#local-graph-and-filtering).

## Type parameters

- `item` (bound `LibTmux.Schema.observation()`)

## Parameters

- `selection` (`t(item)`)
- `criteria` (`LibTmux.Filter.input()`)