# LibTmux.Filter.new!/3

- **Module:** LibTmux
- **Package:** libtmux
- **Language:** Elixir
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-elixir/blob/66b9b1c3f3f3186428abdfda2c76f5cf87446710/lib/libtmux/filter.ex#L98
- **Page:** https://libtmux.org/en/elixir/latest/reference/libtmux-filter-new-bang-3/

```
new!(entity, criteria, options \\ [])
@spec new!(LibTmux.Schema.entity_selector(), input(), [
        limit_option()
      ]) :: t()
```

Constructs a filter or raises its structured validation error.

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

## Parameters

- `entity` (`LibTmux.Schema.entity_selector()`)
- `criteria` (`input()`)
- `options` (`[limit_option()]`)