# `Machete.MaybeMatcher`
[🔗](https://github.com/mtrudel/machete/blob/main/lib/machete/matchers/maybe_matcher.ex#L1)

Defines a matcher that matches against another matcher & also matches nil

# `t`

```elixir
@opaque t()
```

Describes an instance of this matcher

# `maybe`

```elixir
@spec maybe(Machete.Matchable.t()) :: t()
```

Matches against another matcher & also matches nil

Takes another matcher as its sole (mandatory) argument

Examples:

    iex> assert nil ~> maybe(string())
    true

    iex> assert "abc" ~> maybe(string())
    true

---

*Consult [api-reference.md](api-reference.md) for complete listing*