doc / ch.tutteli.atrium.api.cc.en_UK / butAtMost

# butAtMost

`fun <T : CharSequence, S : CharSequenceContains.SearchBehaviour> AtLeastCheckerOption<T, S>.`~~butAtMost~~(times: Int): ButAtMostCheckerOption<T, S>

**Deprecated:** Use pendant from package en_GB; will be removed with 1.0.0

Restricts a `contains at least`

assertion by specifying that the number of occurrences of the object which we
are looking for, occurs `at most`

number of times within the search input.

The resulting restriction will be a `contains at least but at most`

assertion.

### Parameters

`times`

- The number which the check will compare against the actual number of times an expected object is
found in the input of the search.

### Exceptions

`IllegalArgumentException`

- In case times is smaller than zero.

`IllegalArgumentException`

- In case times equals to zero; use containsNot instead.

`IllegalArgumentException`

- In case times of this `at most`

restriction equals to the number of the
`at least`

restriction; use the exactly restriction instead.

**Return**

The newly created builder.

`fun <T : CharSequence, S : CharSequenceContains.SearchBehaviour> `~~butAtMost~~(checkerBuilder: CharSequenceContainsAtLeastCheckerBuilder<T, S>, times: Int): CharSequenceContainsButAtMostCheckerBuilder<T, S>

**Deprecated:** Use the extension fun `butAtMost`. This fun is only here to retain binary compatibility; will be removed with 1.0.0

`fun <E, T : Iterable<E>> `~~butAtMost~~(checkerBuilder: IterableContainsAtLeastCheckerBuilder<E, T>, times: Int): IterableContainsButAtMostCheckerBuilder<E, T>

**Deprecated:** Use the extension fun `butAtMost` instead. This fun is only here to retain binary compatibility; will be removed with 1.0.0

`fun <E, T : Iterable<E>, S : InAnyOrderSearchBehaviour> AtLeastCheckerOption<E, T, S>.`~~butAtMost~~(times: Int): ButAtMostCheckerOption<E, T, S>

**Deprecated:** Use pendant from package en_GB; will be removed with 1.0.0

Restricts a `contains at least`

assertion by specifying that the number of occurrences of the entry which we
are looking for, occurs `at most`

number of times within the Iterable.

The resulting restriction will be a `contains at least but at most`

assertion.

### Parameters

`times`

- The number which the check will compare against the actual number of times an expected entry is
found in the Iterable.

### Exceptions

`IllegalArgumentException`

- In case times is smaller than zero.

`IllegalArgumentException`

- In case times equals to zero; use containsNot instead.

`IllegalArgumentException`

- In case times of this `at most`

restriction equals to the number of the
`at least`

restriction; use the exactly restriction instead.

**Return**

The newly created builder.