# LibTmux::X

- **Module:** LibTmux
- **Package:** LibTmux
- **Language:** Perl
- **Kind:** class
- **Source:** https://github.com/libtmux/libtmux-perl/blob/352715a4fa66a96eed7763b90daaa536aa2f121d/packages/core/lib/LibTmux/X.pm#L1
- **Page:** https://libtmux.org/en/perl/latest/reference/libtmux-x/

```
package LibTmux::X;
```

Typed failures with readable diagnostics


## DESCRIPTION

Errors stringify with class, path, and message. [`"Creation"`](/en/perl/latest/reference/libtmux-x-creation/) retains its original acquisition exception separately through `cause`. `details` returns diagnostic fields. Acquisition failures never represent an empty selection.


## CARDINALITY AND DATA FAILURES


## DIAGNOSTICS

`message`, `path`, `entity`, `expected`, `received`, `matched_ids`, `count`, `result`, `dispatched`, and `details` expose applicable fields. See [`"one" in LibTmux::Selection`](/en/perl/latest/reference/libtmux-selection-one/), [`"new" in LibTmux::Filter`](/en/perl/latest/reference/libtmux-filter-new/), and [`LibTmux::Server`](/en/perl/latest/reference/libtmux-server/) for failure boundaries.



## Members

### Common operations

- [`details`](/en/perl/latest/reference/libtmux-x-details/) (method): Return a fresh shallow hashref of diagnostic fields. Causes and entity handles retain their identity.

### Other members

- [`count`](/en/perl/latest/reference/libtmux-x-count/) (method): Return the observed cardinality lower bound where applicable.
- [`dispatched`](/en/perl/latest/reference/libtmux-x-dispatched/) (method): Return whether the request was submitted where known; undef means no dispatch evidence was recorded. This never proves rollback.
- [`entity`](/en/perl/latest/reference/libtmux-x-entity/) (method): Return the entity kind, or undef when inapplicable.
- [`expected`](/en/perl/latest/reference/libtmux-x-expected/) (method): Return the expected operand description, or undef.
- [`matched_ids`](/en/perl/latest/reference/libtmux-x-matched_ids/) (method): Return a fresh arrayref of observed matching IDs, including duplicate occurrences.
- [`message`](/en/perl/latest/reference/libtmux-x-message/) (method): Return the human-readable failure description.
- [`new`](/en/perl/latest/reference/libtmux-x-new/) (method): `new(%details)` constructs an exception object without throwing or I/O.
- [`path`](/en/perl/latest/reference/libtmux-x-path/) (method): Return the criterion or argument path, or undef when inapplicable.
- [`received`](/en/perl/latest/reference/libtmux-x-received/) (method): Return the received operand description, or undef.
- [`result`](/en/perl/latest/reference/libtmux-x-result/) (method): Return a completed or bounded partial [`LibTmux::CommandResult`](/en/perl/latest/reference/libtmux-commandresult/), or undef before process dispatch.
- [`throw`](/en/perl/latest/reference/libtmux-x-throw/) (method): `throw(%details)` throws one exception object of the receiving class.

## Guides

Pages that discuss `X`.

- [Errors and recovery](/en/perl/latest/topics/errors/)