# LibTmux::X::QueryMismatch

- **Module:** LibTmux::X
- **Package:** LibTmux
- **Language:** Perl
- **Kind:** exception
- **Source:** https://github.com/libtmux/libtmux-perl/blob/352715a4fa66a96eed7763b90daaa536aa2f121d/packages/core/lib/LibTmux/X.pm#L57
- **Bases:** [`LibTmux::X`](/en/perl/latest/reference/libtmux-x/)
- **Page:** https://libtmux.org/en/perl/latest/reference/libtmux-x-querymismatch/

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

Native candidates disagree with captured local matches, or an expert native query returned an uncaptured ID. `details->{verification}` contains the detached [`"VERIFICATION REPORT" in LibTmux::Server`](/en/perl/latest/reference/libtmux-server/#LibTmux%3A%3AServer.section.VERIFICATION%2520REPORT). The cause may be concurrent change, a translation defect or backend semantics; the comparison does not identify it. [`"query_panes" in LibTmux::Server`](/en/perl/latest/reference/libtmux-server-query_panes/) throws this for require or expert queries, while auto reports fallback through its optional observer.

## Inherited members

- [`count`](/en/perl/latest/reference/libtmux-x-querymismatch-count/) (method), inherited from `LibTmux::X`: Return the observed cardinality lower bound where applicable.
- [`details`](/en/perl/latest/reference/libtmux-x-querymismatch-details/) (method), inherited from `LibTmux::X`: Return a fresh shallow hashref of diagnostic fields. Causes and entity handles retain their identity.
- [`dispatched`](/en/perl/latest/reference/libtmux-x-querymismatch-dispatched/) (method), inherited from `LibTmux::X`: 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-querymismatch-entity/) (method), inherited from `LibTmux::X`: Return the entity kind, or undef when inapplicable.
- [`expected`](/en/perl/latest/reference/libtmux-x-querymismatch-expected/) (method), inherited from `LibTmux::X`: Return the expected operand description, or undef.
- [`matched_ids`](/en/perl/latest/reference/libtmux-x-querymismatch-matched_ids/) (method), inherited from `LibTmux::X`: Return a fresh arrayref of observed matching IDs, including duplicate occurrences.
- [`message`](/en/perl/latest/reference/libtmux-x-querymismatch-message/) (method), inherited from `LibTmux::X`: Return the human-readable failure description.
- [`new`](/en/perl/latest/reference/libtmux-x-querymismatch-new/) (method), inherited from `LibTmux::X`: `new(%details)` constructs an exception object without throwing or I/O.
- [`path`](/en/perl/latest/reference/libtmux-x-querymismatch-path/) (method), inherited from `LibTmux::X`: Return the criterion or argument path, or undef when inapplicable.
- [`received`](/en/perl/latest/reference/libtmux-x-querymismatch-received/) (method), inherited from `LibTmux::X`: Return the received operand description, or undef.
- [`result`](/en/perl/latest/reference/libtmux-x-querymismatch-result/) (method), inherited from `LibTmux::X`: 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-querymismatch-throw/) (method), inherited from `LibTmux::X`: `throw(%details)` throws one exception object of the receiving class.

## Guides

Pages that discuss `QueryMismatch`.

- [Live query planning](/en/perl/latest/topics/query-planning/)