# libtmux.query:one

- **Package:** libtmux/query
- **Language:** Common Lisp
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-lisp/blob/c2e5fc4ed3befda21f45dfa5d5868c38fd138311/src/query.lisp#L842
- **Public owner:** libtmux.query
- **Page:** https://libtmux.org/en/lisp/latest/reference/libtmux-query-one/

```
(one values &key (max-items +default-max-selection-items+))
```

Return the only item in finite VALUES.
Signal NO-MATCH for zero items or AMBIGUOUS-MATCH for more than one. The full
bounded container is validated before a candidate is returned. NIL is an item.

## Parameters

- `values`
- `max-items?`

## Guides

Pages that discuss `one`.

- [Native queries](/en/lisp/latest/guides/queries/)